Cloud Phone:UpdateInstanceImage

Changes the image of an instance in a cloud phone matrix. You can change the image for an instance only when the instance is in the Running, Stopped, or Failed to change the image state. The GPU vendor of the target image must match the GPU vendor of the server where the instance runs. If you change the image across major versions, such as from Android 10 to Android 12, the system clears all data. This operation is equivalent to changing the image and then resetting the instance.

Operation description

This feature is not available on the Alibaba Cloud international site (www.alibabacloud.com).

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST  HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
InstanceIdList	array	No	The list of instances.
	string	No	The list of instance IDs.	acp-dvbhknfasf123****
ImageId	string	No	The ID of the image. Call DescribeImageList to query the list of images for cloud phones.	imgc-075cllfeuazh0****
Reset	boolean	No	Specifies whether to reset the instance. If you reset the instance, all user data on the instance is cleared.	false

Response elements

Element	Type	Description	Example
	object	The response elements.
RequestId	string	The request ID.	1A923337-44D9-5CAD-9A53-95084BD4****
TaskId	string	The task ID.	t-1ljew7on6ay0j****

Examples

Success response

JSON format

{
  "RequestId": "1A923337-44D9-5CAD-9A53-95084BD4****",
  "TaskId": "t-1ljew7on6ay0j****"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.