All Products
Search
Document Center

ENS:DescribeImageInfos

Last Updated:Mar 12, 2024

Queries available images.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
OsTypestringNo

The operating system (OS). You can specify only one OS in a request. If you do not specify a value for this parameter, images for all supported OSs are queried. Valid values:

  • linux
  • windows
linux

Response parameters

ParameterTypeDescriptionExample
object
Codeinteger

The HTTP status code that is returned.

0
Imagesobject []

The information about images.

Descriptionstring

The description of the image.

centos_6_08_64_20G_alibase_2017****
ImageIdstring

The ID of the image.

centos_6_08_64_20G_alibase_2017****
ImageSizestring

The size of the image. Unit: GiB.

20
ImageVersionstring

The version of the image.

6.8
OSNamestring

The type of the image. Valid values: centos, debian, ubuntu, and windows.

centos
OSTypestring

The type of the operating system.

linux
ComputeTypestring

The computing type of the image. Valid values:

  • ens_vm: x86 computing.
  • arm_vm: ARM computing.
  • bare_metal: x86 bare machine.
  • pcfarm: heterogeneous computing.
ens_vm
RequestIdstring

The request ID.

5568A08C-10A9-47F3-902F-647298B463FB

Examples

Sample success responses

JSONformat

{
  "Code": 0,
  "Images": {
    "Image": [
      {
        "Description": "centos_6_08_64_20G_alibase_2017****",
        "ImageId": "centos_6_08_64_20G_alibase_2017****",
        "ImageSize": "20",
        "ImageVersion": "6.8",
        "OSName": "centos",
        "OSType": "linux",
        "ComputeType": "ens_vm"
      }
    ]
  },
  "RequestId": "5568A08C-10A9-47F3-902F-647298B463FB"
}

Error codes

HTTP status codeError codeError messageDescription
400MissingParameterThe input parameter domainName that is mandatory for processing this request is not supplied.-
400InstanceIdNotFoundThe input parameter instancdId that is not found.-
400NoPermissionPermission denied.-
400CallInterfaceCall Interface Happen Error.An error occurred when you call the operation.
400InvalidParameter.%sThe specified field %s invalid. Please check it again.-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-05-09API Description Update. The Error code has changedsee changesets
Change itemChange content
API DescriptionAPI Description Update.
Error CodesThe Error code has changed.
    Error Codes 400 change