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

接口说明

仅支持处于启动中（Pending）或运行中（Running）状态的 ECI 实例进行更新。更新操作后，ECI 实例状态将变更为更新中（Updating）。
更新 RestartPolicy 配置为 Never 的 ECI 实例可能会有容器 Failed 的风险，请慎重更新。

流控信息

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

授权信息

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

具体说明如下：展开详情

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

eci:UpdateContainerGroup	Update	containergroup acs:eci:{#regionId}:{#accountId}:containergroup/{#containergroupId}	eci:tag	无

请求参数

字段名称	字段详情
RegionIdstring	地域 ID。示例值:cn-hangzhou参考取值来源: DescribeRegions
ContainerGroupIdstring	指定需要更新的 ECI 实例 ID，即容器组 ID。示例值:eci-2zelg8vwnlzdhf8hv****参考取值来源: CreateContainerGroup DescribeContainerGroups CommitContainer
RestartPolicystring	实例重启策略。取值范围：展开详情示例值:Always
ClientTokenstring	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。只支持 ASCII 字符，且不能超过 64 个字符。更多详情，请参阅如何保证幂等性。示例值:123e4567-e89b-12d3-a456-426655440000
Cpunumber<float>	实例级别（容器组）的 vCPU 数。示例值:2.0
Memorynumber<float>	实例级别的（容器组）的内存数。单位为 GiB。示例值:4.0
ResourceGroupIdstring	所属资源组 ID。示例值:rg-2df3isufhi38**** 参考取值来源: DescribeContainerGroups
Tagarray<object>	实例绑定的标签列表。子级条数 <= 21
Volumearray<object>	数据卷列表。子级条数 <= 61
DnsConfig.Searcharray<string>	DNS 搜索域列表。示例值:my.dns.search.suffix子级条数 <= 21
DnsConfig.NameServerarray<string>	DNS 服务器的 IP 地址列表。示例值:1.2.3.4子级条数 <= 21
DnsConfig.Optionarray<object>	DNS 配置信息。子级条数 <= 21
Containerarray<object>	指定新的容器组配置信息。子级条数 <= 21
InitContainerarray<object>	指定新的 Init 容器信息。子级条数 <= 21
ImageRegistryCredentialarray<object>	镜像仓库凭证信息列表。子级条数 <= 21
AcrRegistryInfoarray<object>	ACR 企业版实例信息。子级条数 <= 21
UpdateTypestring	更新类型。取值范围：展开详情示例值:RenewUpdate

请求说明

参数说明

Container 和 InitContainer InitContainer 和 Container 均仅支持全量更新。更新 InitContainer 需要重启实例。更新包括以下几种情况：

原 ECI 实例同时有 InitContainer 和 Container，但只更新 InitContainer。
原 ECI 实例同时有 InitContainer 和 Container，但只更新 Container。
原 ECI 实例同时有 InitContainer 和 Container，InitContainer 和 Container 全部更新。
原 ECI 实例只有 Container，更新 Container。
原 ECI 实例只有 Container，增加 InitContainer。
原 ECI 实例只有 Container，增加 InitContainer，同时更新 Container。

ImageRegistryCredentials

仅支持全量更新。
如果单独更新 ImageRegistryCredentials，且更新后的 ImageRegistryCredentials 的数量不超过之前原 ImageRegistryCredentials，则无需重启 ECI 实例，其他情况需要重启 ECI 实例。

说明全量更新：如果参数是一个 List，不支持单独更新某个 item，如果参数是一个结构体，不支持单独更新某个内部成员。

返回参数

字段名称	字段详情
RequestIdstring	请求 ID，唯一标识。示例值:CB8D2B22-D636-4182-****-1FC9DBDAD66F

返回示例

错误码

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

全局错误码

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

400	InvalidParameter.CPU.Memory	The specified cpu and memory are not allowed	诊断
400	InvalidParameter.DuplicatedName	The container group include containers with duplicate names.	诊断
400	InvalidParameter.DuplicatedVolumeName	The container group includes volumes with duplicate names.	诊断
400	InvalidParameter.LengthExceeded	%s	诊断
400	InvalidParameter.ValueExceeded	%s	诊断
400	IncorrectStatus	%s	诊断
400	InvalidParam.CpuOrMemorySpec	The specified specification is invalid.	诊断
400	InvalidParameter	%s	诊断
400	MissingParameter	%s	诊断
400	NoNeedUpdate	There are no changes to be updated for current resource.	诊断
403	InvalidAction	The specified action is invalid	诊断
404	InvalidParameter.NotFound	%s	诊断

变更历史

	变更时间	变更内容概要	操作
	2022-09-15	新增请求参数AcrRegistryInfo