Deletes custom images in batches. After a custom image is deleted, simple application servers created from the image cannot use it to reset the system.
Operation description
If a custom image is being shared, you must unshare the shared image before you delete the custom image. After the shared image is unshared, you cannot query the custom image in the Elastic Computing Service console or by calling Elastic Computing Service API operations. If you still need to use the image on an Elastic Computing Service server, we recommend that you perform image replication before you delete the custom image. For more information, see Image replication.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
swas-open:DeleteCustomImages |
delete |
*CustomImage
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID. You can call ListRegions to query available regions. |
cn-hangzhou |
| ImageIds |
string |
Yes |
The instance IDs of the simple application servers. The value can be a JSON array that consists of multiple instance IDs. You can specify up to 15 IDs. Separate multiple IDs with commas (,). |
["m-2zehv38jjmwva1ee****", "m-bp1hj0zhmheyq2kz****"] |
| ClientToken |
string |
No |
Ensures the idempotence of the request. Generate the value from your client and ensure that it is unique across different requests. ClientToken supports only ASCII characters and can be up to 64 characters in length. For more information, see Ensure idempotence. |
123e4567-e89b-12d3-a456-426655440000 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
The request ID. |
30637AD6-D977-4833-A54C-CC89483E**** |
Examples
Success response
JSON format
{
"RequestId": "30637AD6-D977-4833-A54C-CC89483E****"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | CustomImageInShare | The custom image is in sharing,please unshare first then to retry. | The custom image is being shared, please unshare. |
| 500 | InternalError | An error occurred while processing your request. | |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.