Consulta los detalles de una o más imágenes en una región específica.
Descripción
Puede consultar los detalles de una o más imágenes en una región específica, incluidos los ID, nombres y tipos de imagen.
Límites de QPS
El límite de consultas por segundo (QPS) para un solo usuario en esta operación de API es de 10 llamadas por minuto. Si el número de llamadas por segundo supera este límite, se activa el control de flujo, lo cual podría afectar su negocio. Se recomienda tener en cuenta este límite al invocar esta operación. Para obtener más información, consulte Límite de QPS.
Parámetros de solicitud
| Parámetro | Tipo | Obligatorio | Ejemplo | Descripción |
| Action | String | Sí | ListImages |
La operación que desea ejecutar. Establezca el valor en ListImages. |
| RegionId | String | Sí | cn-hangzhou |
ID de la región de las imágenes. Puede llamar a la operación ListRegions para consultar la lista de regiones más reciente. |
| ImageIds | String | No | ["fe9c66133a9d4688872869726b52****", "794c230fd3e64ea19f83f4d7a0ad****"] |
ID de las imágenes. El valor puede ser un arreglo JSON compuesto por hasta 50 ID de imagen, con el formato |
| ImageType | String | No | system |
Tipo de imagen. Valores válidos:
|
Parámetros de respuesta
| Parámetro | Tipo | Ejemplo | Descripción |
| RequestId | String | 20758A-585D-4A41-A9B2-28DA8F4F534F |
ID de la solicitud. |
| Images | Array of Image |
Detalles de las imágenes. |
|
| ImageType | String | app |
Tipo de imagen. Valores válidos:
|
| Description | String | WordPress is a platform that allows you to build blogs and content management websites and implement custom features by using third-party templates and plug-ins. The image is based on the CentOS 7.3 64-bit operating system. |
Descripción de la imagen. |
| ImageName | String | WordPress-4.8.1 |
Nombre de la imagen. |
| ImageId | String | 794c230fd3e64ea19f83f4d7a0ad**** |
ID de la imagen. |
| Platform | String | Linux |
Tipo de sistema operativo de la imagen. Valores válidos:
|
Ejemplos
Solicitudes de ejemplo
https://swas.cn-hangzhou.aliyuncs.com/?Action=ListImages
&ImageIds=["fe9c66133a9d4688872869726b52****", "794c230fd3e64ea19f83f4d7a0ad****"]
&<Common request parameters>Respuestas exitosas de ejemplo
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<ListImagesResponse>
<RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F</RequestId>
<Images>
<ImageType>app</ImageType>
<Description>WordPress is a platform that allows you to build blogs and content management websites and implement custom features by using third-party templates and plug-ins. The image is based on the CentOS 7.3 64-bit operating system. </Description>
<ImageName>WordPress-4.8.1</ImageName>
<ImageId>794c230fd3e64ea19f83f4d7a0ad****</ImageId>
<Platform>Linux</Platform>
</Images>
</ListImagesResponse>Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F534F",
"Images" : {
"ImageType" : "app",
"Description" : "WordPress is a platform that allows you to build blogs and content management websites and implement custom features by using third-party templates and plug-ins. The image is based on the CentOS 7.3 64-bit operating system.",
"ImageName" : "WordPress-4.8.1",
"ImageId" : "794c230fd3e64ea19f83f4d7a0ad****",
"Platform" : "Linux"
}
}Códigos de error
|
HttpCode |
Código de error |
Mensaje de error |
Descripción |
|
400 |
InvalidImageType.ValueNotSupported |
The specified parameter ImageType is invalid. |
Mensaje de error devuelto porque el parámetro ImageType especificado no es válido. |
|
403 |
InvalidParam |
The specified parameter value is invalid. |
Mensaje de error devuelto porque un parámetro especificado no es válido. |
|
500 |
InternalError |
An error occurred while processing your request. |
Mensaje de error devuelto porque ocurrió un error interno. Inténtelo de nuevo más tarde. Si el problema persiste, envíe un ticket. |
Para consultar la lista de códigos de error, visite el Centro de errores de API.