调用CreateImageCache创建镜像缓存。通过镜像缓存创建ECI实例可以加速镜像拉取,减少实例启动耗时。

接口说明

  • 创建镜像缓存前,您需要评估待缓存镜像的总大小,如果镜像总大小超过设置的缓存大小,将会创建失败。
  • 创建镜像缓存时,系统将自动创建一个ECI实例和一块ESSD PL1类型的云盘用于中转创建镜像缓存。创建过程中,请勿删除ECI实例和云盘,否则镜像缓存将创建失败。创建完成后,该实例和云盘将立即自动释放并停止计费。
  • 创建完成后,系统将生成一份镜像缓存快照,快照会收取相应的费用。请勿删除快照,否则镜像缓存将会失效。
  • 如果使用SDK,则对应版本为:Java 1.0.10以上,Python 1.0.7以上。
  • 如果开启了极速镜像缓存功能,则会额外收取极速快照的费用。
说明 调用CreateImageCache创建镜像缓存时,系统将自动为您创建一个服务关联角色AliyunServiceRoleForECI,用于访问ECS、VPC等相关云服务。更多信息,请参见 弹性容器实例服务关联角色

调试

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

请求参数

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

系统规定参数。取值:CreateImageCache。

RegionId String cn-hangzhou

地域ID。

ImageCacheName String testcache

镜像缓存名称。

Image.N RepeatList registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

用于制作镜像缓存的容器镜像。

SecurityGroupId String sg-uf66jeqopgqa9hdn****

安全组ID。

VSwitchId String vsw-uf6h3rbwbm90urjwa****

交换机ID。

ZoneId String cn-hangzhou-g

可用区。

ImageRegistryCredential.N.Server String registry-vpc.cn-hangzhou.aliyuncs.com

不带 http://https:// 前缀的镜像仓库地址。

ImageRegistryCredential.N.UserName String username

镜像仓库用户名。

ImageRegistryCredential.N.Password String password

镜像仓库密码。

EipInstanceId String eip-2zedsm5mfl3uhdj2d****

弹性公网IP。如果需要拉取公网镜像,需要确保ECI实例能够访问公网,您可以配置EIP或者NAT网关实现公网访问。

ImageCacheSize Integer 20

镜像缓存的大小。默认为20 GiB。

RetentionDays Integer 7

镜像缓存保留时间,过期将会被清理,默认永不过期。

说明 创建失败的镜像缓存仅保留一天。
ResourceGroupId String rg-aekzh43v*****

资源组ID。

ClientToken String 123e4567-xxx-xxx-xxxx-42665544xxxx

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

AutoMatchImageCache Boolean true

是否开启镜像缓存复用。开启后,新创建的镜像缓存可以复用已有镜像缓存的镜像层,加快镜像缓存的制作速度。取值范围:

  • true:开启
  • false:不开启

默认为false。

Flash Boolean true

是否开启极速镜像缓存功能,开启后,可以加速镜像缓存创建。取值范围:

  • true:开启
  • false:不开启

默认为false。

Tag.N.Key String imc

镜像缓存标签键。N的取值范围为:1~20。

Tag.N.Value String test

镜像缓存标签值。N的取值范围为:1~20。

返回数据

名称 类型 示例值 描述
ContainerGroupId String eci-2zebxkiifuyzzlhl****

用于中转创建镜像缓存的ECI实例ID。

ImageCacheId String imc-2zebxkiifuyzzlhl****

镜像缓存ID。

RequestId String 0E234675-3465-4CC3-9D0F-9A864BC391DD

请求ID,唯一标识。

示例

请求示例

https://eci.aliyuncs.com/?Action=CreateImageCache
&RegionId=cn-hangzhou
&ImageCacheName=testcache
&Image.1=registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
&SecurityGroupId=sg-uf66jeqopgqa9hdn****
&VSwitchId=vsw-uf6h3rbwbm90urjwa****
&<公共请求参数>

正常返回示例

XML格式

<CreateImageCacheResponse>
      <ImageCacheId>imc-2zebxkiifuyzzlhl****</ImageCacheId>
      <RequestId>0E234675-3465-4CC3-9D0F-9A864BC391DD</RequestId>
      <ContainerGroupId>eci-2zebxkiifuyzzlhl****</ContainerGroupId>
</CreateImageCacheResponse>

JSON格式

{
	"ImageCacheId": "imc-2zebxkiifuyzzlhl****",
	"RequestId": "0E234675-3465-4CC3-9D0F-9A864BC391DD",
	"ContainerGroupId": "eci-2zebxkiifuyzzlhl****"
}

错误码

HttpCode 错误码 错误信息 描述
400 Account.Arrearage Your account has an outstanding payment. 账号已经欠费。
400 DryRunOperation Request validation has been passed with DryRun flag set. 此次DryRun预检请求合格。
400 InvalidParameter.CPU.Memory The specified cpu and memory are not allowed cpu,mem不符合规格
400 IncorrectStatus %s 指定的实例状态不正确。
400 ServiceNotEnabled %s 该次请求所依赖的服务没有开通,请开通后再试。
400 DiskVolume.NotSupport The disk volume is not supported. 云盘卷暂不支持,如有需要请联系我们。
400 RamRole.NotSupport The RAM role is not supported. ram实例角色不支持
400 ImageCache.IncorrectStatus %s 镜像缓存当前的状态不对。
400 ImageCacheNotSupport Image cache is not available for all users. If you want to enable this function, contact us. 镜像缓存功能还未全网开放,如果有需要请联系我们。
403 OperationDenied.VswZoneMisMatch The specified VSwitchId is not in the specified Zone. 指定的交换机不在可用区
403 QuotaExceeded %s quota exceeded. 用户允许创建的实例已经超过限制
403 Zone.NotOnSale The specified zone is not available for purchase. 创建实例的可用区已经关闭售卖,请更换其他可用区。或者无法在该可用区使用指定 VPC 的虚拟交换机。
403 Forbidden.RiskControl This operation has been identified as an abnormal operation and cannot be processed. 此操作已被确定为一个操作异常,无法处理。
403 Forbidden.SubUser The specified action is not available for you. 当前用户无法执行该操作
403 Forbidden.OnlyForInvitedTest Eci create action is only open to invited users during public beta. Eci公测阶段只对受邀的用户开放。
403 OperationDenied.SecurityGroupMisMatch The specified VSwitchId and SecurityGroupId are not in the same VPC. 指定的交换机和安全组不在同一个VPC下
403 InvalidVSwitchId.IpNotEnough The specified VSwitch does not have enough IP addresses. 交换机没有足够ip地址
403 Forbidden.UserBussinessStatus This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again. 用户处于欠费状态不允许创建,请充值后再尝试。
403 Forbidden.UserNotRealNameAuthentication This operation is not allowed, because you have not passed the real-name verification. 操作被禁止,因为用户还未进行实名认证。
403 InvalidUser.PassRoleForbidden The RAM user is not authorized to assume a RAM role. 子账号用户没有权限使用RAM实例角色
403 OperationDenied.NoStock Sales of this resource are temporarily suspended in the specified zone. We recommend that you use the multi-zone creation function to avoid the risk of insufficient resource. For more information, see https://help.aliyun.com/document_detail/157290.html 库存不足,请尝试其它系列或者其它可用区/地域的实例,推荐使用多可用区多规格配置来避免库存不足,更多信息见:https://help.aliyun.com/document_detail/157290.html
403 NoPermission The RAM role AliyunECIContainerGroupRole does not belong to eci.aliyuncs.com. Please check and try again. RAM 角色 "AliyunECIContainerGroupRole" 不属于 "eci.aliyuncs.com",请检查后重试。
403 SecurityRisk.3DVerification We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. 我们检测到您的默认信用卡或借记卡存在安全风险。请通过电子邮件中的链接进行验证。
403 CreateServiceLinkedRole.Denied Please make sure the account has ram:CreateServiceLinkedRole permission. 请确保账号拥有ram:CreateServiceLinkedRole权限

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