Consulta os detalhes de uma ou mais imagens em uma região especificada.
Descrição
Consulte detalhes sobre uma ou mais imagens em uma região específica, incluindo IDs, nomes e tipos das imagens.
Limites de QPS
O limite de consultas por segundo (QPS) para um único usuário nesta operação de API é de 10 chamadas por minuto. Se o número de chamadas por segundo exceder esse limite, o throttling será acionado, o que pode afetar seus negócios. Recomendamos observar esse limite ao chamar esta operação. Para mais informações, consulte Limite de QPS.
Parâmetros de solicitação
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | ListImages |
A operação a ser executada. Defina o valor como ListImages. |
| RegionId | String | Sim | cn-hangzhou |
O ID da região das imagens. Chame a operação ListRegions para consultar a lista de regiões mais recente. |
| ImageIds | String | Não | ["fe9c66133a9d4688872869726b52****", "794c230fd3e64ea19f83f4d7a0ad****"] |
Os IDs das imagens. O valor pode ser um array JSON composto por até 50 IDs de imagem, no formato |
| ImageType | String | Não | system |
O tipo da imagem. Valores válidos:
|
Parâmetros de resposta
| Parâmetro | Tipo | Exemplo | Descrição |
| RequestId | String | 20758A-585D-4A41-A9B2-28DA8F4F534F |
O ID da solicitação. |
| Images | Array of Image |
Detalhes das imagens. |
|
| ImageType | String | app |
O tipo da imagem. 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. |
A descrição da imagem. |
| ImageName | String | WordPress-4.8.1 |
O nome da imagem. |
| ImageId | String | 794c230fd3e64ea19f83f4d7a0ad**** |
O ID da imagem. |
| Platform | String | Linux |
O tipo de sistema operacional da imagem. Valores válidos:
|
Exemplos
Exemplos de solicitações
https://swas.cn-hangzhou.aliyuncs.com/?Action=ListImages
&ImageIds=["fe9c66133a9d4688872869726b52****", "794c230fd3e64ea19f83f4d7a0ad****"]
&<Common request parameters>Exemplos de respostas de sucesso
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 erro
|
HttpCode |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
InvalidImageType.ValueNotSupported |
The specified parameter ImageType is invalid. |
O parâmetro ImageType especificado é inválido. |
|
403 |
InvalidParam |
The specified parameter value is invalid. |
Um parâmetro especificado é inválido. |
|
500 |
InternalError |
An error occurred while processing your request. |
Ocorreu um erro interno. Tente novamente mais tarde. Se o problema persistir, envie um ticket. |
Para obter uma lista de códigos de erro, visite o API Error Center.