调用ListCustomImages查询E-HPC支持的自定义镜像和共享镜像列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListCustomImages

系统规定参数。取值：ListCustomImages
ImageOwnerAlias String 否 self

镜像来源。取值范围：

  • self：自定义镜像
  • others：共享镜像
BaseOsTag String 否 CentOS_7.2_64

基础镜像操作系统标签，仅管控节点使用。
InstanceType String 否 ecs.n1.tiny

指定实例规格。如果不指定实例规格，则默认查询所有实例规格支持的镜像列表。
ClusterId String 否 ehpc-hz-FYUr32****

指定集群ID。如果该集群支持多操作系统，则查询集群所在地域下的所有镜像列表。

如果不指定集群ID，则默认查询所有集群支持的镜像列表。

返回数据

名称 类型 示例值 描述
Images Array of ImageInfo

E-HPC支持的自定义镜像和共享镜像的列表。
ImageInfo
BaseOsTag Struct

对应的基础镜像操作系统标签。
Architecture String i386

操作系统架构。可能值：

  • i386
  • x86_64
OsTag String CentOS_7.2_64

操作系统镜像标签。
Platform String CentOS

操作系统发行版。可能值：

  • CentOS
  • Ubuntu
  • SUSE
  • OpenSUSE
  • Debian
  • CoreOS
  • Aliyun
  • Windows Server 2003
  • Windows Server 2008
  • Windows Server 2012
  • Others Linux
  • Customized Linux
Version String 7.2

操作系统版本。
Description String ExampleDescription

镜像描述。
ImageId String m-bp181x855551ww5yq****

镜像ID。
ImageName String CHESS5V5.0.27

镜像名称。
ImageOwnerAlias String self

镜像类型。可能值：

  • self：自定义镜像
  • others：共享镜像
OsTag Struct

E-HPC支持的操作系统镜像。
Architecture String x86_64

操作系统架构。可能值：

  • i386
  • x86_64
BaseOsTag String CentOS_7.2_64

对应的基础镜像操作系统标签。
OsTag String CentOS_7.2_64

操作系统镜像标签。
Platform String CentOS

操作系统平台。
Version String 7.2

操作系统版本。
PostInstallScript String example.sh

安装镜像后执行的脚本。
PricingCycle String Month

镜像计费单位，可能值：

  • Hour：按小时付费。
  • Month：按月付费。
  • Year：按年付费。
ProductCode String cmjj028279

云市场的商品标识。
Size Integer 40

镜像大小。单位：GiB
SkuCode String ECS

商品规格码。可能值：

-ECS：按量付费

-package：预付费
Status String Available

镜像状态。可能值：

  • UnAvailable：不可用
  • Available：可用
  • Creating：创建中
  • CreateFailed：创建失败
Uid String 127****

镜像所有者。
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

请求ID。

示例

请求示例

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=ListCustomImages
&<公共请求参数>

正常返回示例

XML格式 

<ListCustomImagesResponse>
      <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
      <PricingCycle>Month</PricingCycle>
      <Status>Available</Status>
      <ImageId>m-bp1h8aoe73p71iow****</ImageId>
      <Description></Description>
      <ImageName>CHESS5V5.0.27</ImageName>
      <ProductCode>cmjj028279</ProductCode>
      <ImageOwnerAlias>marketplace</ImageOwnerAlias>
      <Uid>127****</Uid>
      <Size>40</Size>
      <SkuCode>ECS</SkuCode>
      <BaseOsTag>
            <Architecture>x86_64</Architecture>
            <Version>7.2</Version>
            <Platform>CentOS</Platform>
            <OsTag>CentOS_7.2_64</OsTag>
            <BaseOsTag>CentOS_7.2_64</BaseOsTag>
      </BaseOsTag>
      <OsTag>
            <Architecture>x86_64</Architecture>
            <Version>7.2</Version>
            <Platform>CentOS</Platform>
            <OsTag>CentOS_7.2_64</OsTag>
      </OsTag>
</ListCustomImagesResponse>

JSON格式 

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "PricingCycle": "Month",
    "Status": "Available",
    "ImageId": "m-bp1h8aoe73p71iow****",
    "Description": "",
    "ImageName": "CHESS5V5.0.27",
    "ProductCode": "cmjj028279",
    "ImageOwnerAlias": "marketplace",
    "Uid": "127****",
    "Size": "40",
    "SkuCode": "ECS",
    "BaseOsTag": {
        "Architecture": "x86_64",
        "Version": "7.2",
        "Platform": "CentOS",
        "OsTag": "CentOS_7.2_64",
        "BaseOsTag": "CentOS_7.2_64"
    },
     "OsTag": 
        {
            "Architecture": "x86_64",
            "Version": "7.2",
            "Platform": "CentOS",
            "OsTag": "CentOS_7.2_64"
        }
}

错误码

HttpCode 错误码 错误信息 描述
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败，服务暂时不可用

访问错误中心查看更多错误码。