详情页标题前

阿里云ECS云服务器DescribeImageComponents-云淘科技

详情页1

调用DescribeImageComponents查询一个或多个镜像组件的详细信息

接口说明

您可以设置NextToken查询凭证(Token),其取值是上一次调用DescribeImageComponents返回NextToken参数值,再通过MaxResults设置单页查询的最大条目数进行查询。

调试

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

请求参数

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

系统规定参数。取值:DescribeImageComponents

RegionId String cn-hangzhou

所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

ResourceGroupId String rg-bp67acfmxazb4p****

资源组ID。使用该参数过滤资源时,资源数量不能超过1000个。


说明 不支持默认资源组过滤。

Tag.N.Key String TestKey

标签键。N的取值范围:1~20

Tag.N.Value String TestValue

标签值。N的取值范围:1~20

Name String testComponent

镜像组件名称。仅支持精确查找。

NextToken String AAAAAdDWBF2****

查询凭证(Token)。取值为上一次调用该接口返回的NextToken参数值,初次调用接口时无需设置该参数。

MaxResults Integer 50

分页查询时每页行数。取值范围:1~500

默认值:50。

Owner String SELF

镜像组件类型。取值范围:

  • SELF:您创建的自定义镜像组件。
  • ALIYUN:阿里云提供的系统组件。
ImageComponentId.N String ic-bp67acfmxazb4p****

待查询的镜像组件ID。N取值范围:1~20

返回数据

名称 类型 示例值 描述
NextToken String AAAAAdDWBF2****

本次调用返回的查询凭证(Token)。具体使用方式请参见接口说明。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

TotalCount Integer 1

返回的镜像组件数量。

MaxResults Integer 50

分页查询时每页行数。

ImageComponent Array of ImageComponentSet

镜像组件的详细信息组成的列表。

ImageComponentSet
CreationTime String 2020-11-24T06:00:00Z

组件创建时间。

Description String This is description.

描述信息。

SystemType String Linux

组件支持的操作系统。

ImageComponentId String ic-bp67acfmxazb4p****

镜像组件ID。

ComponentType String Build

组件类型。

ResourceGroupId String rg-bp67acfmxazb4p****

资源组ID。

Name String testComponent

组件名称。

Content String RESTART

组件内容。

Owner String SELF

镜像组件类型。可能值:

  • SELF:您创建的自定义镜像组件。
  • ALIYUN:阿里云提供的系统组件。
Tags Array of Tag

标签键值对列表。

Tag
TagValue String TestValue

标签值。

TagKey String TestKey

标签键。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeImageComponents
&RegionId=cn-hangzhou
&ImageComponentId.1=ic-bp67acfmxazb4p****
&

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml


    1
    AAAAAdDWBF2****
    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    
        
            Build
            This is description.
            rg-bp67acfmxazb4p****
            SELF
            RESTART
            2020-11-24T06:00:00Z
            Linux
            ic-bp67acfmxazb4p****
            testComponent
        
        
            
                
                    TestKey
                    TestValue
                
            
        
    
    50

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "NextToken" : "AAAAAdDWBF2****",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "ImageComponent" : {
    "ImageComponentSet" : [ {
      "ComponentType" : "Build",
      "Description" : "This is description.",
      "ResourceGroupId" : "rg-bp67acfmxazb4p****",
      "Owner" : "SELF",
      "Content" : "RESTART",
      "CreationTime" : "2020-11-24T06:00:00Z",
      "SystemType" : "Linux",
      "ImageComponentId" : "ic-bp67acfmxazb4p****",
      "Name" : "testComponent"
    }, {
      "Tags" : {
        "Tag" : [ {
          "TagKey" : "TestKey",
          "TagValue" : "TestValue"
        } ]
      }
    } ]
  },
  "MaxResults" : 50
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidImageComponentIdSize.ExceededMaxNumber %s 指定的参数值有误,具体信息请参见错误信息%s占位符的实际返回结果。

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

腾讯云1折,限时活动,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠

转转请注明出处:https://www.yunxiaoer.com/153375.html

(0)
上一篇 2023年12月9日
下一篇 2023年12月9日
详情页2

相关推荐

联系我们

400-800-8888

在线咨询: QQ交谈

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

关注微信
本站为广大会员提供阿里云、腾讯云、华为云、百度云等一线大厂的购买,续费优惠,保证底价,买贵退差。