CreateImageComponent - 云服务器 ECS

接口说明

创建镜像组件前，您需要注意：

仅支持创建您自定义的镜像组件。
仅支持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查看最新的阿里云地域列表。
ResourceGroupId	String	否	rg-bp67acfmxazb4p****	企业资源组ID。
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://。
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格式

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

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

JSON格式

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

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

错误码

HttpCode	错误码	错误信息	描述
400	EmptyCommandContent.RUN	%s.	模版内容中，若有RUN命令，则RUN的值不能为空。
400	EmptyCommandContent.ENV	%s.	模版内容中，若有ENV，则ENV的值不能为空。
400	EmptyCommandContent.LABEL	%s.	模版内容中，若有LABEL，则LABEL的值不能为空。
400	EmptyCommandContent.COPY	%s.	模版内容中，若有COPY命令，则COPY的值不能为空。
400	EmptyCommandContent.ENTRYPOINT	%s.	模版内容中，若有ENTRYPOINT，则ENTRYPOINT的值不能为空。
400	EmptyCommandContent.CMD	%s.	模版内容中，若有CMD命令，则CMD的值不能为空。
400	NotEmptyCommandContent.RESTART	%s.	模版内容中，若有RESTART命令，则RESTART的值必须为空。
400	EmptyCommandContent.WORKDIR	%s.	模版内容中，若有WORKDIR命令，则WORKDIR的值不能为空。
400	EmptyCommandContent.USER	%s.	模版内容中，若有USER命令，则USER的值不能为空。
400	QuotaExceed.ImageComponent	%s.	当前地域的镜像组件额度已用完。
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	资源组并不在记录中。

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