# Alibaba Cloud Elastic Cloud Phone API

> Alibaba Cloud Elastic Cloud Phone API on Apizie: 36 endpoints (Cancels a task that is currently being executed on a cloud phone, Copies a custom image from the current region to a destination region, Creates a custom image for a cloud phone, Batch deletes custom images, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-cloudphone`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/cloudphone
- Page: https://zieapi.vercel.app/api/cloud/aliyun-cloudphone
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-cloudphone/openapi.json

Alibaba Cloud OpenAPI for Elastic Cloud Phone (cloudphone, version 2020-12-30). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Cancels a task that is currently being executed on a cloud phone
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/cancel-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| TaskId | string | yes | The task ID |

### Copies a custom image from the current region to a destination region
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/copy-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The source region from which the image is copied |
| ImageId | string | yes | The ID of the custom image to be copied |
| DestinationRegionId | string | yes | The destination region to which the image is copied |
| ImageName | string | no | The name of the image. The name must be 2 to 128 characters in length and can contain letters, digits, colons (:), underscores (_), and… |
| Description | string | no | The description of the image. The description must be 2 to 256 characters in length and cannot start with http:// or https:// |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that… |

### Creates a custom image for a cloud phone
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/create-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID of the cloud phone instance |
| InstanceId | string | no | The instance ID of the cloud phone |
| ImageName | string | no | The name of the image. The name must be 2 to 128 characters in length and can contain letters, digits, colons (:), underscores (_), and… |
| Description | string | no | The description of the image. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://` |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that… |

### Batch deletes custom images
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/delete-images` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region |
| ImageId | string | yes | The list of image IDs. A maximum of 100 IDs are supported (JSON-encoded) |
| Force | string | no | Specifies whether to force delete the image. Default value: false |

### Deletes cloud phone instances in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/delete-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region to which the cloud phone instances belong |
| InstanceId | string | yes | The instance ID of the cloud phone. Valid values of N: 1 to 100 (JSON-encoded) |
| Force | string | no | Specifies whether to forcibly release cloud phone instances that are in the Running state. Default value: false. true: Forcibly releases… |

### Deletes one or more cloud phone key pairs
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/delete-key-pairs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| KeyPairName | string | yes | The name of the cloud phone key pair. The value can be a JSON array that consists of multiple key pair names. A maximum of 100 SSH key… |

### Pulls a file from a cloud phone and saves it to Object Storage Service (OSS)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/fetch-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceId | string | yes | The instance ID of the instance on which to execute the command. Valid values of N: 1 to 10 |
| OssBucket | string | yes | The OSS bucket where the file to be sent is stored. Before importing an APK file to the OSS bucket for the first time, add a RAM… |
| OssObject | string | yes | The name of the object to be saved in OSS |
| Path | string | yes | The path of the file to be saved on the cloud phone |

### Imports a local image to Cloud Phone as a custom image in the specified region
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/import-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region to which the image is imported |
| Format | string | no | The Format |
| OssBucket | string | yes | The OSS bucket where the image file is stored |
| OssObject | string | yes | The key of the OSS object where the image file is stored |
| ImageName | string | no | The image name. The name must be 2 to 128 characters in length and can contain letters, digits, colons (:), underscores (_), and hyphens… |
| Description | string | no | The description of the image. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://` |
| Platform | string | no | The operating system distribution. Valid values: Android 9.0 |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that… |

### Imports the public key portion of an RSA key pair generated by another tool
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/import-key-pair` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| KeyPairName | string | yes | The name of the key pair. The name must be unique. The name must be 2 to 128 characters in length and can contain letters, digits, colons… |
| PublicKeyBody | string | yes | The public key content of the key pair |

### Installs an application on a cloud phone
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/install-application` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceId | string | no | The instance ID of the instance on which to execute the command. Valid values of N: 1 to 10 (JSON-encoded) |
| OssBucket | string | yes | The OSS bucket where the application file is stored. Before importing an application file to the OSS bucket for the first time, add a RAM… |
| OssObject | string | yes | The name (key) of the OSS object where the application file is stored |

### Queries the list of users with whom a custom image has been shared
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-image-share-permission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ImageId | string | yes | The ID of the newly imported cloud phone image |

### Queries image resources that are available to you
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-images` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ImageId | string | no | The image IDs. Valid values of N: 1 to 100 (JSON-encoded) |
| ImageName | string | no | The image name. The name must be 2 to 128 characters in length. It must start with a letter or a Chinese character and cannot start with… |
| ImageCategory | string | no | The source of the image. Valid values: system: a public image provided by Alibaba Cloud. self: a custom image that you created. others: an… |
| InstanceType | string | no | The instance type |
| Status | string | no | The status of the image to query. Valid values: Waiting: The image is waiting in the task queue. Creating: The image is being created.… |
| NextToken | string | no | The pagination token. Set the value to the NextToken value returned in the previous API call. You do not need to set this parameter for… |
| MaxResults | integer | no | The maximum number of entries to return. Valid values: 1 to 100 |

### Queries the list of cloud phone instance types
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-instance-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceType | string | no | The list of instance type names. Valid values of N: 1 to 100 (JSON-encoded) |
| InstanceTypeFamily | string | no | The instance family |

### Queries the web management terminal URL of a cloud phone instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-instance-vnc-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region in which the cloud phone instance resides |
| InstanceId | string | yes | The instance ID of the cloud phone instance |

### Queries a list of cloud phone instances
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region where the cloud phone instances reside |
| InstanceId | string | no | The instance IDs of the cloud phone instances. Valid values of N: 1 to 100 (JSON-encoded) |
| InstanceName | string | no | The name of the cloud phone instance |
| Status | string | no | The instance status. Valid values: Pending: being created. Running: running. Starting: being started. Stopping: being stopped. Stopped:… |
| KeyPairName | string | no | The name of the key pair. The name must be unique. The name must be 2 to 128 characters in length and can contain letters, digits, colons… |
| NextToken | string | no | The query token. Set this parameter to the NextToken value returned in the previous API call. You do not need to set this parameter for… |
| MaxResults | integer | no | The maximum number of entries to return. Valid values: 1 to 100 |
| ZoneId | string | no | The zone where the cloud phone resides |
| Resolution | string | no | The resolution used by the cloud phone |
| ChargeType | string | no | The billing method. Valid values: PrePaid: subscription. PostPaid: pay-as-you-go |
| InstanceType | string | no | The instance type |
| ImageId | string | no | The image ID |
| ShowWebRtcToken | string | no | Specifies whether to return webRtcToken in the query results |
| Tag | string | no | The tags used to filter instances (JSON-encoded) |
| Filter | string | no | The filter conditions for querying resources (JSON-encoded) |

### Queries one or more key pairs
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-key-pairs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID of the key pair |
| KeyPairName | string | no | The name of the key pair |
| KeyPairFingerPrint | string | no | The fingerprint of the key pair. The fingerprint is in the public key fingerprint format defined in RFC 4716 and uses the MD5 message… |
| NextToken | string | no | The pagination token. Set this parameter to the NextToken value returned in the previous API call. You do not need to set this parameter… |
| MaxResults | integer | no | The maximum number of entries to return. Valid values: 1 to 100 |

### Queries the regions where Cloud Phone is available for purchase
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-regions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID |

### Queries a list of tag keys
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-tag-keys` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| NextToken | string | no | The pagination token for the next query. If this parameter is not specified, the first page of results is returned |
| ResourceType | string | yes | The resource type. Valid values: instance: Elastic Cloud Phone instance |

### Queries the tags bound to multiple cloud resources
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| NextToken | string | no | The token that determines the start point of the next query |
| ResourceType | string | yes | The resource type. Valid values: instance: elastic cloud phone instance |
| ResourceId | string | no | The resource ID. You can specify up to 50 resource IDs (JSON-encoded) |
| Tag | string | no | The list of tags. You can specify up to 20 tags (JSON-encoded) |

### Queries the tag values that correspond to a specified tag key
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-tag-values` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| NextToken | string | no | The token for the next query |
| ResourceType | string | yes | The resource type. Valid values: instance: elastic cloud phone instance |
| Key | string | yes | The tag key to query |

### Retrieves the current task list of a cloud phone instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| TaskId | string | no | The list of task IDs. Valid values of N: 1 to 100 (JSON-encoded) |
| TaskStatus | string | no | The task status. Valid values: Finished: The task is completed. Processing: The task is running. Failed: The task has failed. Default… |
| TaskType | string | no | The name of the API operation for the task. Valid values: Shell: runs a shell command. InstallApplication: installs an application.… |
| InstanceId | string | no | The instance ID |
| NextToken | string | no | The pagination token. Set this parameter to the NextToken value returned in the previous API call. You do not need to set this parameter… |
| MaxResults | integer | no | The maximum number of entries to return. Valid values: 1 to 100. Default value: 50 |

### Queries the list of zones supported in a specified region
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/list-zones` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |

### Restarts an instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/reboot-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region to which the cloud phone instance belongs |
| InstanceId | string | yes | The instance ID of the cloud phone (JSON-encoded) |
| Force | string | no | Specifies whether to forcibly restart the instance. Valid values: true: forcibly restarts the instance. This is equivalent to a typical… |

### Renews multiple subscription Cloud Phone instances in a batch
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/renew-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceId | string | yes | The list of instance IDs to renew. The list can contain a maximum of 20 elements (JSON-encoded) |
| Period | integer | no | The renewal period. Default value: 1 |
| PeriodUnit | string | no | The unit of the renewal period. Valid values: Year: subscription. Valid values for the period: 1, 2, 3, 4, and 5. Month: subscription.… |
| AutoPay | string | no | Specifies whether to enable automatic payment. Default value: true |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that… |

### Resets instances to their initial state at the time of creation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/reset-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceId | string | yes | The list of cloud phone instance IDs. Valid values of N: 1 to 100 (JSON-encoded) |
| ImageId | string | no | The cloud phone image ID. If this parameter is not specified, the instance is reset by using its current image |

### Executes a command on cloud phones
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/run-command` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceId | string | no | The instance ID of the instance on which to execute the command. Valid values of N: 1 to 10 (JSON-encoded) |
| Command | string | yes | The command to execute. The command can be up to 1024 bytes in length and can contain only letters, digits, underscores (_), periods (.),… |

### Creates and starts instances in a batch
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/run-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceName | string | no | The instance name. The name must be 2 to 128 characters in length and must start with a letter or a Chinese character. It cannot start… |
| Description | string | no | The description of the instance. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://` |
| InstanceType | string | yes | The instance type |
| ImageId | string | yes | The image ID |
| SecurityGroupId | string | yes | The security group ID. The same security group as ECS is used |
| VSwitchId | string | yes | The vSwitch ID |
| EipBandwidth | integer | no | The bandwidth value of the elastic IP address (EIP). Valid values: 1 to 200. Settings this parameter triggers the automatic creation of an… |
| Resolution | string | no | The resolution of the cloud phone instance. You can call the DescribeInstanceTypes operation to query the resolutions supported by the… |
| Amount | integer | no | The number of ECS instances that you want to create. Valid values: 1 to 100. Default value: 1 |
| KeyPairName | string | no | The name of the key pair for the cloud phone instance. You can call the ImportKeyPair operation to import a key pair |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that… |
| ChargeType | string | no | The billing method of the instance. Valid values: PrePaid: subscription. PostPaid (default): pay-as-you-go |
| PeriodUnit | string | no | The unit of the subscription billing duration. Billable methods include subscription. Valid values: Year Month (default) |
| AutoRenew | string | no | Specifies whether to enable auto-renewal. This parameter takes effect only when InstanceChargeType is set to PrePaid. Valid values: true:… |
| AutoPay | string | no | Specifies whether to enable automatic payment. Default value: true |
| Period | integer | no | The subscription duration. Default value: 1. If PeriodUnit is set to Month, valid values are 1, 2, 3, and 6. If PeriodUnit is set to Year,… |
| Tag | string | no | The tags of the instance (JSON-encoded) |
| PrivateIpAddress | string | no | The private IP address of the cloud phone instance. When you specify a private IP address for the cloud phone instance, select an… |

### Pushes a file to a cloud phone
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/send-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceId | string | no | The instance ID of the instance on which to execute the command. Valid values of N: 1 to 10 (JSON-encoded) |
| OssBucket | string | yes | The OSS bucket where the file to be sent is stored. Before importing an APK file to the OSS bucket for the first time, add a RAM… |
| OssObject | string | yes | The name (key) of the OSS object where the file is stored |
| Path | string | yes | The full path of the file on the cloud phone |

### Starts instances in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/start-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceId | string | yes | The list of instance IDs. You can start up to 100 cloud phones at a time (JSON-encoded) |

### Stops multiple instances in a batch
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/stop-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region to which the cloud phone instances belong |
| InstanceId | string | yes | The list of instance IDs. Valid values of N: 1 to 100 (JSON-encoded) |
| Force | string | no | Specifies whether to forcefully stop the instances. Valid values: true: Forcefully stops the instances. This is equivalent to a typical… |

### Creates and attaches tags to multiple cloud resources at a time
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ResourceType | string | yes | The resource type. Valid values: instance: elastic cloud phone instance |
| ResourceId | string | yes | The resource IDs. A maximum of 50 subkeys are supported (JSON-encoded) |
| Tag | string | yes | The labels. A maximum of 20 subkeys are supported (JSON-encoded) |

### Uninstalls an application
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/uninstall-application` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceId | string | no | The instance ID of the instance on which the command is to be executed. Valid values of N: 1 to 10 (JSON-encoded) |
| PackageName | string | yes | The name of the application to uninstall. The name can be up to 1024 bytes in length and can contain uppercase letters, lowercase letters,… |

### Unbinds tags from multiple cloud resources at a time
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/untag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ResourceType | string | yes | The resource type. Valid values: instance: elastic cloud phone instance |
| All | string | no | Specifies whether to delete all tags. This parameter takes effect only when TagKey.N is empty. Valid values: true, false, True, and False.… |
| ResourceId | string | yes | The resource ID. You can specify up to 50 subkeys (JSON-encoded) |
| TagKey | string | no | The tag key. You can specify up to 20 subkeys (JSON-encoded) |

### Modifies the name and description of a custom image and manages the sharing permissions of the image
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/update-image-attribute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| AddAccount | string | no | The list of Alibaba Cloud account IDs for authorization of the shared image. The list can contain up to 10 elements (JSON-encoded) |
| RemoveAccount | string | no | The list of Alibaba Cloud account IDs from which you want to remove the image sharing permissions. The list can contain up to 10 elements… |
| ImageId | string | yes | The image ID |
| ImageName | string | no | The name of the custom image. The name must be 2 to 128 characters in length. It must start with a letter or a Chinese character and can… |
| Description | string | no | The description of the custom image. The description must be 2 to 256 characters in length. It cannot start with `http://` or `https://`.… |

### Modifies the attributes of a cloud phone instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/update-instance-attribute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| InstanceId | string | yes | The instance ID of the cloud phone |
| InstanceName | string | no | The name of the cloud phone instance. The name must be 2 to 128 characters in length and can contain letters, digits, colons (:),… |
| KeyPairName | string | no | The name of the key pair for the cloud phone. To improve instance security, use a key pair for connection |
| Description | string | no | The description of the cloud phone instance. The description must be 2 to 256 characters in length and cannot start with `http://` or… |
| VncPassword | string | no | The VNC password of the cloud phone. The password must be exactly six characters in length and must contain uppercase letters, lowercase… |
| Resolution | string | no | The resolution of the cloud phone, such as 1920×1080 |
| Tag | string | no | The list of tags (JSON-encoded) |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://cloudphone.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/cancel-task" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Elastic Cloud Phone API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-cloudphone/cancel-task with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Elastic Cloud Phone API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Elastic Cloud Phone itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Elastic Cloud Phone API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-cloudphone.

### What is the status of the Alibaba Cloud Elastic Cloud Phone API?
Needs your own provider key (bring your own key)