弹性容器实例：CreateContainerGroup

系统规定参数。取值：CreateContainerGroup

容器镜像。

容器名称。

ECI实例名称，即容器组名称。格式要求如下：

• 长度为2~128个字符。
• 支持英文小写字母、数字或者短划线（-），不能以短划线开头或者结尾。

地域ID。

实例所属的可用区。如果取值为空，则表示由系统选择。

默认值为空。

实例所属的安全组ID。同一个安全组内的实例之间可以互相访问。

如果没有指定安全组，系统将自动使用您选择的地域下的默认安全组，您需要确保该安全组的入方向规则中包含容器需要暴露的协议和端口。如果您在该地域下没有默认安全组，系统将自动创建一个默认安全组，并将您声明的容器协议和端口添加到该安全组的入方向规则中。

实例所属的交换机ID。支持指定多个交换机ID（单次最多10个），各交换机ID之间可以用半角逗号（,）进行分割，例如vsw-***,vsw-***。

如果没有指定交换机，系统将自动使用您选择的地域下的默认VPC下的默认交换机，如果您在该地域下没有默认VPC和默认交换机，系统将自动创建一个默认VPC和一个默认交换机。

实例重启策略。取值范围：

• Always：总是重启
• Never：从不重启

• OnFailure：失败时重启

  默认值：Always。

弹性公网IP ID。

实例级别vCPU大小。单位：核。

实例级别内存大小。单位：GiB。

资源组ID。

DNS策略。取值范围：

• None：使用DnsConfig字段设置的DNS。
• Default：继承运行环境的DNS设置。

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

指定的ECS实例规格，支持多规格。更多信息，请参见指定ECS规格创建实例。

镜像缓存ID。

实例RAM角色名称。ECI与ECS共用实例RAM角色，更多信息，请参见通过API使用实例RAM角色。

程序的缓冲时间，用于处理关闭之前的操作。

是否自动匹配镜像缓存。默认为false。

IPv6地址数。固定为1，即一个ECI实例支持绑定一个IPv6地址。

ECI实例的有效期限，超出该时间后，实例会被强制退出。单位为秒。

实例的抢占策略。取值范围：

• NoSpot：正常按量付费实例。
• SpotWithPriceLimit：设置上限价格的抢占式实例。
• SpotAsPriceGo：系统自动出价，跟随当前市场实际价格的抢占式实例。

默认值：NoSpot。

设置抢占式实例的每小时最高价格，最多精确到小数点后3位。

当SpotStrategy取值为SpotWithPriceLimit时，必须设置SpotPriceLimit。

自定义设置Core dump文件的保存目录。

是否自动创建弹性公网IP，并绑定ECI实例。

弹性公网IP的带宽。默认为5M。

主机名称，即容器组名称。

入方向带宽限制。单位：Byte。

出方向带宽限制。单位：Byte。

CPU物理核心数。仅部分规格支持自定义设置。更多信息，请参见自定义CPU选项。

每核线程数。仅部分规格支持自定义设置。配置为1时表示关闭超线程。更多信息，请参见自定义CPU选项。

临时存储空间大小，默认使用ESSD PL1类型的云盘。单位为：GiB。

抢占式实例的保护期。单位为小时。取值范围为0~6，默认为1。

标签键。

标签值。

镜像仓库密码。

镜像仓库注册地址。

镜像仓库用户名。

检查超时的时间，默认为1秒，最小为1秒。

从上次检查失败后重新认定检查成功的检查次数阈值（必须是连续成功），默认为1。当前必须为1。

为容器内的进程授予某些特定的权限。目前仅支持配置为NET_ADMIN和NET_RAW。

使用TCP Socket方式进行健康检查时，TCP Socket检测的端口。

使用HTTP请求方式进行健康检查时，HTTP Get请求对应的协议类型，取值范围：

• HTTP
• HTTPS

检查执行的周期，默认为10秒，最小为1秒

容器运行的根文件系统是否为只读，目前仅支持配置为true。

环境变量名。长度为1~128位。格式要求：[0-9a-zA-Z]，以及下划线，不能以数字开头。

环境变量值。长度为0~256位。

环境变量值引用。目前只支持配置为status.podIP。

使用TCP Socket方式进行健康检查时，TCP Socket检测的端口。

是否开启交互。默认为false。

当Command为/bin/bash命令时，需要设置为true。

容器工作目录。

容器启动命令对应的参数。最多10个。

此容器是否应在容器运行时为标准输入分配缓冲区。如果未设置，则容器中标准输入的读取值将导致EOF。默认为false。

检查开始执行的时间，以容器启动完成为起点计算。

数据卷的挂载传播设置。挂载传播允许将Container挂载的卷共享到同一Pod中的其他Container，甚至可以共享到同一节点上的其他Pod。取值范围：

• None：该卷不感知任何后续在此卷或其子目录上执行的挂载操作。
• HostToContainer：该卷将会感知到后续在此卷或其子目录上的挂载操作。
• Bidirectional：和HostToContainer类似，能感知挂载操作。另外，该卷将被传播回主机和使用同一卷的所有Pod的所有容器。

默认值：None

容器挂载数据卷的目录。

数据卷是否只读。默认为false。

数据卷子路径。

数据卷名称。同Volume中的Name。

镜像拉取策略。取值范围：

• Always：总是拉取。每次都拉取镜像。
• IfNotPresent：按需拉取。优先使用本地镜像，本地没有镜像时则拉取镜像。
• Never：从不拉取。使用本地镜像，不拉取镜像。

当标准输入为true时，标准输入流将在多个附加会话中是否保持开启状态。

如果StdinOnce设为true，标准输入在容器开启时被打开，在首个客户端附加到标准输入之前都为空，然后会一直保持开启状态，接收数据，直到客户端连接断开，此时标准输入被关闭，在容器重启前一直保持关闭状态。

使用TCPSocket方式设置preStop回调函数时，TCP Socket检测的端口。

使用HTTP请求方式设置postStart回调函数时，HTTP Get请求检测的路径。

检查执行的周期，默认为10秒，最小为1秒。

从上次检查失败后重新认定检查成功的检查次数阈值（必须是连续成功），默认为1。当前必须为1。

容器启动命令。最多20个。每个命令最多包含256个字符。

使用TCPSocket方式设置postStart回调函数时，TCP Socket检测的端口。

使用HTTP请求方式进行健康检查时，HTTP Get请求检测的路径。

使用命令行方式进行健康检查时，在容器内执行的命令。

使用命令行方式设置postStart回调函数时，在容器内执行的命令。

使用HTTP请求方式设置postStart回调函数时，HTTP Get请求对应的协议类型，取值范围：

• HTTP
• HTTPS

使用HTTP请求方式设置postStart回调函数时，接收HTTP Get请求的主机地址。

使用HTTP请求方式设置preStop回调函数时，HTTP Get请求检测的路径。

协议类型。取值范围：

• TCP
• UDP

端口号。取值范围：1~65535。

使用HTTP请求方式设置preStop回调函数时，HTTP Get请求对应的协议类型，取值范围：

• HTTP
• HTTPS

使用HTTP请求方式进行健康检查时，HTTP Get请求对应的协议类型，取值范围：

• HTTP
• HTTPS

使用HTTP请求方式进行健康检查时，HTTP Get请求检测的端口号。

使用TCP Socket方式设置postStart回调函数时，TCP Socket检测的端口。

指定容器使用的GPU个数。

检查开始执行的时间，以容器启动完成为起点计算。

使用命令行方式设置preStop回调函数时，在容器内执行的命令。

容器的内存大小。单位：GiB。

使用HTTP请求方式设置preStop回调函数时，接收HTTP Get请求的主机地址。

使用TCP Socket方式设置preStop回调函数时，TCP Socket检测的主机地址。

使用HTTP请求方式设置preStop回调函数时，HTTP Get请求检测的端口号。

从上次检查成功后认定检查失败的检查次数阈值（必须是连续失败），默认为3。

使用命令行方式进行健康检查时，在容器内执行的命令。

使用HTTP请求方式设置preStop回调函数时，HTTP Get请求头中自定义设置的字段值。

使用HTTP请求方式设置preStop回调函数时，HTTP Get请求头中自定义设置的字段名。

从上次检查成功后认定检查失败的检查次数阈值（必须是连续失败），默认为3。

容器的vCPU大小。单位：核。

使用HTTP请求方式进行健康检查时，HTTP Get请求检测的端口号。

使用HTTP请求方式进行健康检查时，HTTP Get请求检测的路径。

检查超时的时间，默认为1秒，最小为1秒。

设置运行容器的用户ID。

使用HTTP请求方式设置postStart回调函数时，HTTP Get请求检查的端口号。

使用HTTP请求方式设置postStart回调函数时，HTTP Get请求头中自定义设置的字段值。

使用HTTP请求方式设置postStart回调函数时，HTTP Get请求头中自定义设置的字段名。

数据卷类型。取值范围：

• EmptyDirVolume：EmptyDir类型的数据卷，表示空目录。
• NFSVolume：NFS类型的数据卷，表示网络文件系统。
• ConfigFileVolume：ConfigFile类型的数据卷，表示配置文件。
• FlexVolume：使用FlexVolume插件扩展存储类型，支持挂载云盘。
• HostPathVolume：HostPath类型的数据卷，表示主机节点的文件或目录。
• DiskVolume（不推荐）：云盘数据卷。建议使用FlexVolume挂载云盘。

DiskVolume的大小。单位为GiB。

NFS数据卷路径。

DiskVolume的系统类型。

挂载的文件系统类型，默认取决于FlexVolume的script。

HostPath Volume的类型。取值范围：

• Directory：目录
• File：文件

配置文件的默认权限，采用四位八进制数表示。

例如0644表示权限为-rw-r--r--，0对应-，表示文件类型为普通文件，644对应后续9位字符，表示3组权限，即用户权限为rw-，用户所在组权限为r--，其他用户权限为r--。

权限说明如下：

• ---：没有任何权限，八进制值为0。
• --x：只有执行权限，八进制值为1。
• -w-：只有写入权限，八进制值为2。
• -wx：有写入和执行权限，八进制值为3。
• r--：只有读取权限，八进制值为4。
• r-x：有读取和执行权限，八进制值为5。
• rw-：有读取和写入权限，八进制值为6。
• rwx：具有读取、写入和执行权限，八进制值为7。

NFSVolume的读取权限。取值范围：

• true：只读
• false：可读可写

默认为false。

配置文件所在的相对文件路径。

配置文件的权限，如果没有设置，则采用ConfigFileVolume.DefaultMode的值。采用四位八进制数表示。 例如0644表示权限为-rw-r--r--，0对应-，表示文件类型为普通文件，644对应后续9位字符，表示3组权限，即用户权限为rw-，用户所在组权限为r--，其他用户权限为r--。

权限说明如下：

• ---：没有任何权限，八进制值为0。
• --x：只有执行权限，八进制值为1。
• -w-：只有写入权限，八进制值为2。
• -wx：有写入和执行权限，八进制值为3。
• r--：只有读取权限，八进制值为4。
• r-x：有读取和执行权限，八进制值为5。
• rw-：有读取和写入权限，八进制值为6。
• rwx：具有读取、写入和执行权限，八进制值为7。

配置文件内容 (32KB)。

HostPath Volume在主机上的目录路径。

FlexVolume对象选项列表。为KV形式，采用JSON传递。

例如通过FlexVolume挂载云盘时，Options表示云盘的配置参数，可配置的参数如下：

• volumeId：已有云盘ID。
• volumeSize：云盘大小，单位为GiB。取值范围为20~32768。
• performanceLevel：云盘性能等级。更多信息，请参见云盘性能等级。
• deleteWithInstance：是否随实例释放，默认为false。
• encrypted：是否加密云盘，默认为false。更多信息，请参见加密概述。
• kmsKeyId：加密云盘时，云盘使用的KMS密钥ID。

使用FlexVolume插件挂载数据卷时的驱动类型。目前支持alicloud/disk，表示挂载阿里云云盘。

NFS服务器地址。

DiskVolume的ID。

数据卷名称。

EmptyDirVolume的存储媒介，默认为空，使用node文件系统；支持 memory，表示使用内存。

为容器内的进程授予某些特定的权限。目前仅支持配置为NET_ADMIN和NET_RAW。

容器使用的镜像。

数据卷的挂载传播设置。挂载传播允许将Container挂载的卷共享到同一Pod中的其他Container，甚至可以共享到同一节点上的其他Pod。取值范围：

• None：该卷不感知任何后续在此卷或其子目录上执行的挂载操作。
• HostToContainer：该卷将会感知到后续在此卷或其子目录上的挂载操作。
• Bidirectional：和HostToContainer类似，能感知挂载操作。另外，该卷将被传播回主机和使用同一卷的所有Pod的所有容器。

默认值：None

挂载目录，容器的挂载目录下的内容被volume的内容直接覆盖，所以要慎用。

挂载路径是否只读。默认为false。

数据卷下的子目录，方便Pod将同一个Volume下不同目录挂载到容器不同目录。

挂载数据卷的名称。

协议类型。取值范围：

• TCP
• UDP

端口号。取值范围：1~65535。

容器运行的根文件系统是否为只读。目前仅支持配置为true。

环境变量名。长度为1~128位。格式要求：[0-9a-zA-Z]，以及下划线，不能以数字开头。

环境变量值。长度为0~256位。

环境变量值引用。目前只支持配置为status.podIP。

镜像拉取策略。取值范围：

• Always：总是拉取。每次都拉取镜像。
• IfNotPresent：按需拉取。优先使用本地镜像，本地没有镜像时则拉取镜像。
• Never：从不拉取。使用本地镜像，不拉取镜像。

工作目录。

容器的vCPU大小。单位：核。

容器启动参数。

容器启动指令。

指定容器使用的GPU个数。

设置运行容器的用户ID。

容器的内存大小。单位：GiB。

容器名称。

DNS服务器的IP地址列表。

DNS搜索域列表。

对象的Value。

对象的Name。

添加IP。

添加主机名。

实例运行的安全上下文的参数值。

实例运行的安全上下文的参数名称。

NTP服务器。

ACR企业版实例的域名。默认为相应实例的所有域名。支持指定个别域名，多个以半角逗号分隔。

ACR企业版实例的名称。

ACR企业版实例ID。

ACR企业版实例所属地域。

自建镜像仓库地址。使用HTTP协议的自建镜像仓库中的镜像创建ECI实例时，需配置该参数，使得ECI使用HTTP协议拉取镜像，避免因协议不同而导致镜像拉取失败。

自建镜像仓库地址。使用自签发证书的自建镜像仓库中的镜像创建ECI实例时，需配置该参数来跳过证书认证，避免因证书认证失败而导致镜像拉取失败。

镜像加速模式。取值范围：

• nydus：使用Nydus加速，需镜像本身支持。
• dadi：使用DADI加速，需镜像本身支持。
• p2p：使用P2P加速，需镜像本身支持。
• imc：使用镜像缓存加速。

EmptyDirVolume的大小。单位为GiB。

实例ID，即容器组ID。

请求ID，唯一标识。