调用CreateImageComponent创建一个镜像组件。镜像组件用于存储您在构建镜像时,常用的构建模板命令。

接口说明

创建镜像组件前,您需要注意:

  • 仅支持创建您自定义的镜像组件。
  • 仅支持Linux系统,即SystemType=Linux
  • 仅支持设置为镜像构建组件类型,即ComponentType=Build
  • 镜像组件的内容可以通过Dockerfile编辑,然后将内容传入Content参数。内容大小不能超过16 KB,不支持FROM命令,一个镜像组件最大支持127个命令。支持的命令详情,请参见镜像构建服务支持的命令说明

不支持通过API使用镜像组件快速完成镜像模板的创建,仅控制台操作支持该功能。更多信息,请参见镜像构建概述

调试

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

请求参数

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

系统规定参数。取值:CreateImageComponent

RegionId String cn-hangzhou

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

Tag.N.Key String TestKey

标签键。N的取值范围:1~20。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以aliyun和acs:开头,不能包含http://或者https://。

Tag.N.Value String TestValue

标签值。N的取值范围:1~20。一旦传入该值,可以为空字符串。最多支持128个字符,不能以acs:开头,不能包含http://或者https://。

ResourceGroupId String rg-bp67acfmxazb4p****

企业资源组ID。

Name String testComponent

组件名称。长度为2~128个字符,必须以大小字母或中文开头,不能以http://和https://开头。可以包含中文、英文、数字、半角冒号(:)、下划线(_)、英文句号(.)或者短划线(-)。

说明 不设置 Name时,默认使用 ImageComponentId返回值。
Description String This is description.

描述信息。长度为2~256个英文或中文字符,不能以http://和https://开头。

SystemType String Linux

组件支持的操作系统。目前仅支持Linux系统。取值:Linux

默认值:Linux

ComponentType String Build

组件类型。目前仅支持镜像构建组件。取值:Build

默认值:Build

Content String RUN yum update -y

组件内容。由多条命令组成,命令最大条数不能超过127条。支持的命令和命令格式详情,请参见镜像构建服务支持的命令说明

ClientToken String 123e4567-e89b-12d3-a456-426655440000

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性

返回数据

名称 类型 示例值 描述
ImageComponentId String ic-bp67acfmxazb4p****

镜像组件ID。

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

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=CreateImageComponent
&RegionId=cn-hangzhou
&Name=testComponent
&Description=This is description.
&SystemType=Linux
&ComponentType=Build
&Content=RUN yum update -y
&<公共请求参数>

正常返回示例

XML格式

<CreateImageComponentResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
      <ImageComponentId>ic-bp67acfmxazb4p****</ImageComponentId>
</CreateImageComponentResponse>

JSON格式

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E", 
    "ImageComponentId": "ic-bp67acfmxazb4p****"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. 资源组并不在记录中。

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