调用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查看最新的阿里云地域列表。 |
| 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://开头。可以包含中文、英文、数字、半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。 说明 不设置 |
| 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
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
ic-bp67acfmxazb4p****
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. | 资源组并不在记录中。 |
访问错误中心查看更多错误码。
腾讯云1折，限时活动，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/153373.html
