Queries the information about images in a region.
Operation description
You can query information about images in a region, including the IDs, names, and types of the images.
QPS limit
You can call this API operation up to 10 times per minute per account. Requests that exceed this limit are dropped and you may experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID of the images. You can call the ListRegions operation to query the most recent region list. | cn-hangzhou |
ImageIds | string | No | The image IDs. The value can be a JSON array that consists of up to 50 image IDs. Format: | ["fe9c66133a9d4688872869726b52****", "794c230fd3e64ea19f83f4d7a0ad****"] |
ImageType | string | No | The type of the images. Valid values:
| system |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "20758A-585D-4A41-A9B2-28DA8F4F534F",
"Images": [
{
"ImageType": "app",
"Description": "",
"ImageName": "WordPress-4.8.1",
"ImageId": "794c230fd3e64ea19f83f4d7a0ad****",
"Platform": "Linux"
}
]
}
Error codes
HTTP status code | Error code | Error message |
---|---|---|
400 | InvalidImageType.ValueNotSupported | The specified parameter ImageType is invalid. |
403 | InvalidParam | The specified parameter value is invalid. |
500 | InternalError | An error occurred while processing your request. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
2023-09-18 | API Description Update. The Error code has changed | see changesets | ||||||||||
|