UpdateImageCache_弹性容器实例_API文档-阿里云OpenAPI开发者门户

接口说明

仅支持更新状态为 Ready（创建完成）或者 UpdateFailed（更新失败）的镜像缓存。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

eci:UpdateImageCache	Update	ImageCache acs:eci:{#regionId}:{#accountId}:imagecache/{#ImageCacheId}	eci:tag	无

请求参数

字段名称	字段详情
RegionIdstring	地域 ID。示例值:cn-hangzhou 参考取值来源: DescribeRegions
ImageCacheIdstring	镜像缓存 ID。示例值:imc-bp195erqe9o2pb09**** 参考取值来源: CreateImageCache DescribeImageCaches
SecurityGroupIdstring	安全组 ID。示例值:sg-uf66jeqopgqa9hdn**** 参考取值来源: DescribeContainerGroups
VSwitchIdstring	交换机 ID。示例值:vsw-uf6h3rbwbm90urjwa****
ImageCacheNamestring	镜像缓存名称。示例值:testcache参考取值来源: CreateImageCache DescribeImageCaches
EipInstanceIdstring	弹性公网 IP。如果需要拉取公网镜像，需要确保 ECI 实例能够访问公网，您可以配置 EIP 或者 NAT 网关实现公网访问。示例值:eip-2zedsm5mfl3uhdj2d****
ResourceGroupIdstring	资源组 ID。示例值:rg-aekzh43v***** 参考取值来源: DescribeContainerGroups
ClientTokenstring	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。示例值:123e4567-xxx-xxx-xxxx-42665544xxxx
ImageCacheSizeinteger<int32>	镜像缓存的大小。默认为 20 GiB。示例值:20
RetentionDaysinteger<int32>	镜像缓存保留时间，过期将会被清理，默认永不过期。展开详情示例值:7
AutoMatchImageCacheboolean	是否开启镜像缓存复用。开启后，新创建的镜像缓存可以复用已有镜像缓存的镜像层，加快镜像缓存的制作速度。取值范围：展开详情示例值:true
ImageRegistryCredentialarray<object>	镜像仓库信息。子级条数 <= 11
Imagearray<string>	用于制作镜像缓存的容器镜像列表。展开详情示例值:registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl子级条数 <= 101
Tagarray<object>	镜像缓存绑定的标签信息，最多 20 个。子级条数 <= 21
Flashboolean	是否开启极速镜像缓存功能，开启后，可以加速镜像缓存创建。取值范围：展开详情示例值:true
AcrRegistryInfoarray<object>	ACR 企业版实例信息。子级条数 <= 21
StandardCopyCountinteger<int32>	标准快照副本数。默认情况下，一个镜像缓存对应一个快照。如果该镜像缓存将用于批量创建多个 ECI 实例，建议您配置该参数实现快照多副本。推荐每 1000 个 ECI 实例增加一个快照副本。展开详情示例值:7
FlashCopyCountinteger<int32>	本地快照副本数。默认情况下，一个镜像缓存对应一个快照。如果该镜像缓存将用于批量创建多个 ECI 实例，建议您配置该参数实现快照多副本。推荐每 1000 个 ECI 实例增加一个快照副本。展开详情示例值:7
EliminationStrategystring	镜像缓存的淘汰策略。默认为空，表示一直保留。展开详情示例值:LRU

返回参数

字段名称	字段详情
RequestIdstring	请求 ID，唯一标识。示例值:0E234675-3465-4CC3-9D0F-9A864BC391DD

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	Account.Arrearage	Your account has an outstanding payment.	诊断
400	DryRunOperation	Request validation has been passed with DryRun flag set.	诊断
400	InvalidParameter.CPU.Memory	The specified cpu and memory are not allowed	诊断
400	IncorrectStatus	%s	诊断
400	ServiceNotEnabled	%s	诊断
400	DiskVolume.NotSupport	The disk volume is not supported.	诊断
400	RamRole.NotSupport	The RAM role is not supported.	诊断
400	ImageCache.IncorrectStatus	%s	诊断
400	ImageCacheNotSupport	Image cache is not available for all users. If you want to enable this function, contact us.	诊断
400	OperationConflict	Request was denied due to conflict with a previous request.	诊断
400	NoNeedUpdate	There are no changes to be updated for current resource.	诊断
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.	诊断
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.	诊断
403	OperationDenied.SecurityGroupMisMatch	The specified VSwitchId and SecurityGroupId are not in the same VPC.	诊断
403	InvalidVSwitchId.IpNotEnough	The specified VSwitch does not have enough IP addresses.	诊断
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.	诊断
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	诊断
403	NoPermission	The RAM role AliyunECIContainerGroupRole does not belong to eci.aliyuncs.com. Please check and try again.	诊断
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.	诊断

变更历史

	变更时间	变更内容概要	操作
	2023-09-18	删除返回参数
	2021-09-10	新增请求参数Annotations
	2021-08-20	新增OpenAPI，更新一个镜像缓存

UpdateImageCache_弹性容器实例_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例