UpdateContainerGroup
更新实例
服务地址：
华东1 金融云
输入参数
只看必填
RegionId地域ID
ContainerGroupId指定需要更新的ECI实例ID
RestartPolicy实例重启策略
Cpu实例级别（容器组）的vCPU数
Memory实例级别的（容器组）的内存数
ResourceGroupId所属资源组ID
Tag实例绑定的标签列表
0实例绑定的标签列表
Key标签键
Value标签值
添加
Volume数据卷列表
0数据卷列表
Name数据卷名称
Type数据卷类型
NFSVolume.PathNFS数据卷要挂载的路径
NFSVolume.ServerNFS数据卷的挂载点地址
NFSVolume.ReadOnlyNFS数据卷的读取权限
请选择布尔值
ConfigFileVolume.ConfigFileToPathConfigFile数据卷对应的配置文件信息
0ConfigFile数据卷对应的配置文件信息
Path配置文件的相对文件路径
Content配置文件的内容
添加
EmptyDirVolume.MediumEmptyDir数据卷的存储媒介
EmptyDirVolume.SizeLimitEmptyDir数据卷的大小
FlexVolume.FsType使用FlexVolume插件挂载云盘时
FlexVolume.Driver使用FlexVolume插件挂载数据卷...
FlexVolume.OptionsFlexVolume对象选项列表
HostPathVolume.PathHostPath数据卷在宿主机上的路径
HostPathVolume.TypeHostPath数据卷的类型
添加
DnsConfig.SearchDNS搜索域列表
0DNS搜索域列表
添加
DnsConfig.NameServerDNS服务器的IP地址列表
0DNS服务器的IP地址列表
添加
DnsConfig.OptionDNS配置信息
0DNS配置信息
ValueDNS配置的选项变量值
NameDNS配置的选项变量名
添加
Container指定新的容器组配置信息
0指定新的容器组配置信息
ReadinessProbe.TimeoutSeconds检查超时的时间
ReadinessProbe.SuccessThreshold从上次检查失败后重新认定检查成功的检查...
SecurityContext.Capability.Add为容器内的进程授予某些特定的权限
0为容器内的进程授予某些特定的权限
添加
ReadinessProbe.TcpSocket.PortTcpSocket检测的端口
ReadinessProbe.HttpGet.Scheme使用HTTP请求方式进行健康检查时
LivenessProbe.PeriodSeconds检查执行的周期
SecurityContext.ReadOnlyRootFilesystem是否只读根文件系统
请选择布尔值
EnvironmentVar容器的环境变量信息列表
0容器的环境变量信息列表
Key容器的环境变量名
Value容器的环境变量值
FieldRef.FieldPath使用Pod字段作为环境变量
添加
LivenessProbe.TcpSocket.PortTcpSocket检测的端口
Tty是否开启交互
请选择布尔值
WorkingDir容器工作目录
Arg容器启动参数
0容器启动参数
添加
Stdin此容器是否应在容器运行时为标准输入分配缓冲区
请选择布尔值
LivenessProbe.InitialDelaySeconds检查开始执行的时间
VolumeMount容器的数据卷信息列表
0容器的数据卷信息列表
MountPropagation数据卷的挂载传播设置
MountPath容器挂载的目录
ReadOnly是否只读
请选择布尔值
SubPath数据卷的子目录
Name容器挂载的数据卷名称
添加
ImagePullPolicy镜像拉取策略
StdinOnce当标准输入为true时
请选择布尔值
LifecyclePreStopHandlerTcpSocketPort使用TCPSocket方式设置preS...
LifecyclePostStartHandlerHttpGetScheme使用HTTP请求方式设置postSta...
ReadinessProbe.PeriodSeconds检查执行的周期
LivenessProbe.SuccessThreshold从上次检查失败后重新认定检查成功的检查...
Command容器启动命令
0容器启动命令
添加
LifecyclePostStartHandlerHttpGetHost使用HTTP请求方式设置postSta...
ReadinessProbe.HttpGet.PathHttpGet检测的路径
LivenessProbe.Exec.Command容器内检测命令
0容器内检测命令
添加
LifecyclePostStartHandlerTcpSocketPort使用TCPSocket方式设置post...
LifecyclePostStartHandlerHttpGetPath使用HTTP请求方式设置postSta...
LifecyclePostStartHandlerExec使用命令行方式设置postStart回...
0使用命令行方式设置postStart回...
添加
LifecyclePreStopHandlerHttpGetPath使用HTTP请求方式设置preStop...
Port容器端口号
0容器端口号
ProtocolTCP/UDP
Port端口号
添加
LifecyclePreStopHandlerHttpGetScheme使用HTTP请求方式设置preStop...
LivenessProbe.HttpGet.Scheme使用HTTP请求方式进行健康检查时
LifecyclePostStartHandlerHttpGetHttpHeaders生成的http请求头中
0生成的http请求头中
Value使用HTTP请求方式设置postSta...
Name使用HTTP请求方式设置postSta...
添加
ReadinessProbe.HttpGet.PortHttpGet检测的端口号
LifecyclePostStartHandlerTcpSocketHost使用TCP Socket方式设置pos...
Gpu指定容器使用的GPU个数
ReadinessProbe.InitialDelaySeconds检查开始执行的时间
LifecyclePreStopHandlerExec使用命令行方式设置preStop回调函数时
0使用命令行方式设置preStop回调函数时
添加
Memory容器内存大小
Name容器名称
LifecyclePreStopHandlerHttpGetHost使用HTTP请求方式设置preStop...
LifecyclePreStopHandlerTcpSocketHost使用TCP Socket方式设置pre...
Image容器镜像
LifecyclePreStopHandlerHttpGetPort使用HTTP请求方式设置preStop...
LivenessProbe.FailureThreshold从上次检查成功后认定检查失败的检查次数...
ReadinessProbe.Exec.Command容器内检测的命令
0容器内检测的命令
添加
LifecyclePreStopHandlerHttpGetHttpHeader生成的http请求头信息
0生成的http请求头信息
Value使用HTTP请求方式设置preStop...
Name使用HTTP请求方式设置preStop...
添加
ReadinessProbe.FailureThreshold从上次检查成功后认定检查失败的检查次数...
Cpu容器vCPU大小
LivenessProbe.HttpGet.PortHttpGet检测的端口号
LivenessProbe.HttpGet.PathHttpGet检测的路径
LivenessProbe.TimeoutSeconds检查超时的时间
SecurityContext.RunAsUser用于运行容器进程入口点的UID
LifecyclePostStartHandlerHttpGetPort使用HTTP请求方式设置postSta...
添加
InitContainer指定新的Init容器信息
0指定新的Init容器信息
SecurityContext.Capability.Add为容器内的进程授予某些特定的权限
0为容器内的进程授予某些特定的权限
添加
ImageInit容器镜像
VolumeMount挂载数据卷信息列表
0挂载数据卷信息列表
MountPropagation数据卷的挂载传播设置
MountPathInit容器挂载目录
ReadOnly是否只读
请选择布尔值
SubPath数据卷的子目录
NameInit容器挂载的数据卷名称
添加
Port端口号
0端口号
ProtocolTCP/UDP
PortInit容器端口号
添加
SecurityContext.ReadOnlyRootFilesystem容器运行的根文件系统是否为只读
请选择布尔值
EnvironmentVar容器的环境变量信息列表
0容器的环境变量信息列表
KeyInit容器的环境变量名
ValueInit容器的环境变量值
FieldRef.FieldPath环境变量值引用
添加
ImagePullPolicy镜像拉取策略
StdinOnce当标准输入为true时
请选择布尔值
CpuInit容器vCPU大小
Tty是否开启交互
请选择布尔值
WorkingDirInit容器工作目录
CommandInit容器指令
0Init容器指令
添加
ArgInit容器启动参数
0Init容器启动参数
添加
SecurityContext.RunAsUser设置运行容器的用户ID
Gpu指定Init容器使用的GPU个数
MemoryInit容器内存大小
Stdin此容器是否应在容器运行时为标准输入分配缓冲区
请选择布尔值
NameInit容器名称
添加
ImageRegistryCredential镜像仓库凭证信息列表
0镜像仓库凭证信息列表
Password镜像仓库密码
Server不带http://或https://前...
UserName镜像仓库用户名
添加
AcrRegistryInfoACR企业版实例信息
0ACR企业版实例信息
InstanceIdACR企业版实例ID
InstanceNameACR企业版实例的名称
RegionIdACR企业版实例所属地域
DomainACR企业版实例的域名
0ACR企业版实例的域名
添加
添加
UpdateType更新类型
幂等性参数
ClientToken保证请求幂等性
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

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

请求参数

字段名称字段详情
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
变更历史
变更时间变更内容概要操作
2022-09-15
新增请求参数AcrRegistryInfo