CreateContainerGroup - 建立Elastic Container Instance - Elastic Container Instance - 阿里雲 - Elastic Container Instance

呼叫 CreateContainerGroup 建立一個 ECI 執行個體（即容器組）。

介面說明

呼叫 CreateContainerGroup 建立 ECI 執行個體時，系統將自動為您建立一個服務關聯角色 AliyunServiceRoleForECI，用於存取 ECS、VPC 等相關雲端服務。更多資訊，請參見彈性容器執行個體服務關聯角色。

建立 ECI 執行個體時，您可以根據需要設定執行個體、映像、儲存等相關功能。各功能涉及的參數及其說明，請參見以下功能文件：

執行個體。

ECI 支援以下兩種方式建立執行個體：

以下功能兩種建立方式均支援：

映像

網路

儲存

容器設定

日誌與維運

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

eci:CreateContainerGroup

create

*ContainerGroup

acs:eci:{#regionId}:{#accountId}:containergroup/*

eci:tag

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	地域 ID。	cn-hangzhou
RegionId	string	是	地域 ID。	cn-hangzhou
ZoneId	string	否	執行個體所屬的可用區。如果取值為空，則表示由系統選擇。預設值為空。	cn-hangzhou-b
SecurityGroupId	string	否	執行個體所屬的安全性群組 ID。同一個安全性群組內的執行個體之間可以互相存取。如果沒有指定安全性群組，系統將自動使用您選擇的地域下的預設安全性群組，您需要確保該安全性群組的入方向規則中包含容器需要暴露的協定和連接埠。如果您在該地域下沒有預設安全性群組，系統將自動建立一個預設安全性群組，並將您聲明的容器協定和連接埠新增到該安全性群組的入方向規則中。	sg-uf66jeqopgqa9hdn****
VSwitchId	string	否	執行個體所屬的交換器 ID。支援指定多個交換器 ID（單次最多 10 個），各交換器 ID 之間可以用半形逗號（,）進行分割，例如`vsw-*,vsw-*`。如果沒有指定交換器，系統將自動使用您選擇的地域下的預設 VPC 下的預設交換器，如果您在該地域下沒有預設 VPC 和預設交換器，系統將自動建立一個預設 VPC 和一個預設交換器。說明交換器網段內的 IP 個數決定了該交換器下最大可以建立的 ECI 執行個體數量，請務必提前規劃好網段。	vsw-bp1xpiowfm5vo8o3c**,vsw-bp1rkyjgr1xwoho6k**
ContainerGroupName	string	是	ECI 執行個體名稱，即容器組名稱。格式要求如下：長度為 2~128 個字元。支援英文小寫字母、數字或者短劃線（-），不能以短劃線開頭或者結尾。	nginx-test
RestartPolicy	string	否	執行個體重新啟動策略。取值範圍： Always：總是重新啟動 Never：從不重新啟動 OnFailure：失敗時重新啟動預設值：Always。	Always
EipInstanceId	string	否	彈性公網 IP ID。	eip-uf66jeqopgqa9hdn****
Cpu	number	否	執行個體級別 vCPU 大小。單位：核。	1.0
Memory	number	否	執行個體級別記憶體大小。單位：GiB。	2.0
ResourceGroupId	string	否	資源群組 ID。	rg-uf66jeqopgqa9hdn****
DnsPolicy	string	否	DNS 策略。取值範圍： None：使用 DnsConfig 欄位設定的 DNS。 Default：繼承執行環境的 DNS 設定。	Default
ClientToken	string	否	保證請求冪等性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。只支援 ASCII 字元，且不能超過 64 個字元。更多詳情，請參閱如何保證冪等性。	123e4567-xxxx-12d3-xxxx-426655440000
InstanceType	string	否	指定的 ECS 執行個體規格，支援多規格。更多資訊，請參見指定 ECS 規格建立執行個體。	ecs.c5.xlarge
ImageSnapshotId	string	否	映像快取 ID。更多資訊，請參見使用映像快取加速建立執行個體。	imc-2zebxkiifuyzzlhl****
RamRoleName	string	否	執行個體 RAM 角色名稱。ECI 與 ECS 共用執行個體 RAM 角色，更多資訊，請參見透過 API 使用執行個體 RAM 角色。	RamTestRole
TerminationGracePeriodSeconds	integer	否	程式的緩衝時間，用於處理關閉之前的操作。單位為秒。	60
AutoMatchImageCache	boolean	否	是否自動匹配映像快取。預設為 false。	false
Ipv6AddressCount	integer	否	IPv6 位址數。固定為 1，即一個 ECI 執行個體支援繫結一個 IPv6 位址。	1
ActiveDeadlineSeconds	integer	否	ECI 執行個體的有效期限，超出該時間後，執行個體會被強制退出。單位為秒。	1000
SpotStrategy	string	否	執行個體的搶佔策略。取值範圍： NoSpot：正常按量付費執行個體。 SpotWithPriceLimit：設定上限價格的搶佔式執行個體。 SpotAsPriceGo：系統自動出價，跟隨當前市場實際價格的搶佔式執行個體。預設值：NoSpot。	SpotWithPriceLimit
SpotPriceLimit	number	否	設定搶佔式執行個體的每小時最高價格，最多精確到小數點後 3 位。當 SpotStrategy 取值為 SpotWithPriceLimit 時，必須設定 SpotPriceLimit。	0.025
ScheduleStrategy	string	否	設定了多可用區（透過 VSwitchId 參數指定多個交換器）時，ECI 執行個體的調度策略。取值範圍： VSwitchOrdered：按順序調度 VSwitchRandom：阿里雲最佳策略調度更多資訊，請參見多可用區建立執行個體。	VSwitchOrdered
CorePattern	string	否	自訂設定 coredump 產生的 core 檔案的儲存目錄。更多資訊，請參見設定 core 檔案儲存到資料卷。說明設定的路徑不能以`\|`開頭，即不能透過 Core dump 來設定可執行程式。	/xx/xx/core
ShareProcessNamespace	boolean	否	是否使用共用命名空間。預設為 false。	false
AutoCreateEip	boolean	否	是否自動建立一個 EIP，並繫結到 ECI 執行個體上。	true
EipBandwidth	integer	否	EIP 的頻寬，預設為 5 Mbps。當 AutoCreateEip 取值為 true 時，可以設定該參數。	5
EipISP	string	否	設定 EIP 的線路類型。取值範圍： BGP（預設值）：BGP（多線）線路 BGP_PRO：BGP（多線）精品線路。	BGP
EipCommonBandwidthPackage	string	否	繫結已有的共用頻寬包。	cbwp-2zeukbj916scmj51m****
HostName	string	否	主機名稱。	test
IngressBandwidth	integer	否	入方向頻寬限制。單位：Bps。	1024000
EgressBandwidth	integer	否	出方向頻寬限制。單位：Bps。	1024000
CpuOptionsCore	integer	否	CPU 物理核心數。僅部分規格支援自訂設定。	2
CpuOptionsThreadsPerCore	integer	否	每核執行緒數。僅部分規格支援自訂設定。設定為 1 時表示關閉超執行緒。	2
CpuOptionsNuma	string	否	該參數暫不支援設定。	1
EphemeralStorage	integer	否	增加的暫存空間大小。單位：GiB。更多資訊，請參見自訂暫存空間大小。	20
Tag	array<object>	否	標籤列表。最多可以繫結 20 個。更多資訊，請參見使用標籤管理執行個體。
	object	否	標籤列表。最多可以繫結 20 個。更多資訊，請參見使用標籤管理執行個體。
Key	string	否	標籤鍵。如果傳入該值，則不允許為空字串，且不允許重複。最多支援 64 個字元，不能以`aliyun`和`acs:`開頭，不能包含`http://`或者`https://`。	version
Value	string	否	標籤值。如果傳入該值，可以為空字串。最多支援 128 個字元，不能以`acs:`開頭，不能包含`http://`或者`https://`。	3
ImageRegistryCredential	array<object>	否	映像倉庫資訊。
	object	否	映像倉庫資訊。
Password	string	否	映像倉庫密碼。	yourpassword
Server	string	否	映像倉庫註冊位址。	registry-vpc.cn-shanghai.aliyuncs.com
UserName	string	否	映像倉庫使用者名稱。	yourusername
Container	array<object>	是	容器資訊。
	array<object>	否	容器資訊。
ReadinessProbe.TimeoutSeconds	integer	否	检查超时的时间，默认为 1 秒，最小为 1 秒。	1
ReadinessProbe.SuccessThreshold	integer	否	从上次检查失败后重新认定检查成功的检查次数阈值（必须是连续成功），默认为 1。当前必须为 1。	1
SecurityContext.Capability.Add	array	否	为容器内的进程授予某些特定的权限。目前仅支持配置为 NET_ADMIN 和 NET_RAW。說明 NET_RAW 默认不支持，需提交工单申请。
	string	否	为容器内的进程授予某些特定的权限。目前仅支持配置为 NET_ADMIN 和 NET_RAW。說明 NET_RAW 默认不支持，需提交工单申请。	NET_ADMIN
ReadinessProbe.TcpSocket.Port	integer	否	使用 TCP Socket 方式进行健康检查时，TCP Socket 检测的端口。說明设置 ReadinessProbe 相关参数时，HttpGet、Exec 和 TcpSocket 这三种检查方式，只能选择其中一种。	8000
ReadinessProbe.HttpGet.Scheme	string	否	使用 HTTP 请求方式进行健康检查时，HTTP Get 请求对应的协议类型，取值范围： HTTP HTTPS 說明设置 ReadinessProbe 相关参数时，HttpGet、Exec 和 TcpSocket 这三种检查方式，只能选择其中一种。	HTTP
LivenessProbe.PeriodSeconds	integer	否	检查执行的周期，默认为 10 秒，最小为 1 秒。	5
SecurityContext.ReadOnlyRootFilesystem	boolean	否	容器运行的根文件系统是否为只读，目前仅支持配置为 true。	true
EnvironmentVar	array<object>	否	容器的環境變數值。
	object	否	容器的環境變數值。
Key	string	否	環境變數名。長度為 1~128 位。格式要求：`[0-9a-zA-Z]`，以及底線，不能以數字開頭。	PATH
Value	string	否	環境變數值。長度為 0~256 位。	/usr/local/bin
FieldRef.FieldPath	string	否	环境变量值引用。目前只支持配置为 status.podIP。	status.podIP
LivenessProbe.TcpSocket.Port	integer	否	使用 TCP Socket 方式进行健康检查时，TCP Socket 检测的端口。說明设置 LivenessProbe 相关参数时，HttpGet、Exec 和 TcpSocket 这三种检查方式，只能选择其中一种。	8080
Tty	boolean	否	是否開啟互動。預設為 false。當 Command 為 /bin/bash 命令時，需要設定為 true。	false
WorkingDir	string	否	容器工作目錄。	/usr/local/
Arg	array	否	容器啟動命令對應的參數。最多 10 個。	100
	string	否	容器啟動命令對應的參數。最多 10 個。	100
Stdin	boolean	否	此容器是否應在容器執行時為標準輸入分配緩衝區。如果未設定，則容器中標準輸入的讀取值將導致 EOF。預設為 false。	false
LivenessProbe.InitialDelaySeconds	integer	否	检查开始执行的时间，以容器启动完成为起点计算。	5
VolumeMount	array<object>	否	資料卷資訊。
	object	否	資料卷資訊。
MountPropagation	string	否	資料卷的掛載傳播設定。掛載傳播允許將 Container 掛載的卷共用到同一 Pod 中的其他 Container，甚至可以共用到同一節點上的其他 Pod。取值範圍： None：該卷不感知任何後續在此卷或其子目錄上執行的掛載操作。 HostToContainer：該卷將會感知到後續在此卷或其子目錄上的掛載操作。 Bidirectional：和 HostToContainer 類似，能感知掛載操作。另外，該卷將被傳播回主機和使用同一卷的所有 Pod 的所有容器。預設值：None。	None
MountPath	string	否	容器掛載資料卷的目錄。說明容器掛載目錄下的內容會被 Volume 的內容直接覆蓋，請謹慎使用。	/pod/data
ReadOnly	boolean	否	資料卷是否唯讀。預設為 false。	false
SubPath	string	否	資料卷子路徑。	data2/
Name	string	否	資料卷名稱。同 Volume 中的 Name。	default-volume1
ImagePullPolicy	string	否	映像拉取策略。取值範圍： Always：總是拉取。每次都拉取映像。 IfNotPresent：按需拉取。優先使用本機映像，本機沒有映像時則拉取映像。 Never：從不拉取。使用本機映像，不拉取映像。	Always
StdinOnce	boolean	否	當標準輸入為 true 時，標準輸入流將在多個附加工作階段中是否保持開啟狀態。如果 StdinOnce 設為 true，標準輸入在容器開啟時被打開，在首個用戶端附加到標準輸入之前都為空，然後會一直保持開啟狀態，接收資料，直到用戶端連線斷開，此時標準輸入被關閉，在容器重新啟動前一直保持關閉狀態。	false
LifecyclePreStopHandlerTcpSocketPort	integer	否	使用 TCPSocket 方式設定 preStop 回呼函數時，TCP Socket 檢測的連接埠。	90
LifecyclePostStartHandlerHttpGetScheme	string	否	使用 HTTP 請求方式設定 postStart 回呼函數時，HTTP Get 請求對應的協定類型，取值範圍： HTTP HTTPS。	HTTPS
ReadinessProbe.PeriodSeconds	integer	否	检查执行的周期，默认为 10 秒，最小为 1 秒。	3
LivenessProbe.SuccessThreshold	integer	否	从上次检查失败后重新认定检查成功的检查次数阈值（必须是连续成功），默认为 1。当前必须为 1。	1
Command	array	否	容器啟動命令。最多 20 個。每個命令最多包含 256 個字元。	sleep
	string	否	容器啟動命令。最多 20 個。每個命令最多包含 256 個字元。	sleep
LifecyclePostStartHandlerHttpGetHost	string	否	使用 HTTP 請求方式設定 postStart 回呼函數時，接收 HTTP Get 請求的主機位址。	10.0.XX.XX
TerminationMessagePolicy	string	否	訊息通知策略，預設為空，目前僅支援輕量訊息佇列的訊息通知。	FallbackToLogsOnError
ReadinessProbe.HttpGet.Path	string	否	使用 HTTP 请求方式进行健康检查时，HTTP Get 请求检测的路径。說明设置 ReadinessProbe 相关参数时，HttpGet、Exec 和 TcpSocket 这三种检查方式，只能选择其中一种。	/healthz
LivenessProbe.Exec.Command	array	否	使用命令行方式进行健康检查时，在容器内执行的命令。說明设置 LivenessProbe 相关参数时，HttpGet、Exec 和 TcpSocket 这三种检查方式，只能选择其中一种。
	string	否	使用命令行方式进行健康检查时，在容器内执行的命令。	cat /tmp/healthy
LifecyclePostStartHandlerTcpSocketPort	integer	否	使用 TCPSocket 方式設定 postStart 回呼函數時，TCP Socket 檢測的連接埠。	80
LifecyclePostStartHandlerHttpGetPath	string	否	使用 HTTP 請求方式設定 postStart 回呼函數時，HTTP Get 請求檢測的路徑。	/healthyz
LifecyclePostStartHandlerExec	array	否	使用命令列方式設定 postStart 回呼函數時，在容器內執行的命令。	["/bin/sh", "-c", "echo Hello from the postStart handler > /usr/share/message"]
	string	否	使用命令列方式設定 postStart 回呼函數時，在容器內執行的命令。	["/bin/sh", "-c", "echo Hello from the postStart handler > /usr/share/message"]
LifecyclePreStopHandlerHttpGetPath	string	否	使用 HTTP 請求方式設定 preStop 回呼函數時，HTTP Get 請求檢測的路徑。	/healthyz
Port	array<object>	否	連接埠號。
	object	否	連接埠號。
Protocol	string	否	協定類型。取值範圍： TCP UDP。	TCP
Port	integer	否	連接埠號。取值範圍：1~65535。	80
TerminationMessagePath	string	否	容器的報錯位址。	/tmp/termination-log
LifecyclePreStopHandlerHttpGetScheme	string	否	使用 HTTP 請求方式設定 preStop 回呼函數時，HTTP Get 請求對應的協定類型，取值範圍： HTTP HTTPS。	HTTP
LivenessProbe.HttpGet.Scheme	string	否	使用 HTTP 请求方式进行健康检查时，HTTP Get 请求对应的协议类型，取值范围： HTTP HTTPS 說明设置 LivenessProbe 相关参数时，HttpGet、Exec 和 TcpSocket 这三种检查方式，只能选择其中一种。	HTTP
ReadinessProbe.HttpGet.Port	integer	否	使用 HTTP 请求方式进行健康检查时，HTTP Get 请求检测的端口号。說明设置 ReadinessProbe 相关参数时，HttpGet、Exec 和 TcpSocket 这三种检查方式，只能选择其中一种。	8080
LifecyclePostStartHandlerTcpSocketHost	string	否	使用 TCP Socket 方式設定 postStart 回呼函數時，TCP Socket 檢測的主機位址。	10.0.XX.XX
Gpu	integer	否	指定容器使用的 GPU 個數。	1
ReadinessProbe.InitialDelaySeconds	integer	否	检查开始执行的时间，以容器启动完成为起点计算。	3
LifecyclePreStopHandlerExec	array	否	使用命令列方式設定 preStop 回呼函數時，在容器內執行的命令。	["/bin/sh", "-c","echo Hello from the preStop handler > /usr/share/message"]
	string	否	使用命令列方式設定 preStop 回呼函數時，在容器內執行的命令。	["/bin/sh", "-c","echo Hello from the preStop handler > /usr/share/message"]
Memory	number	否	容器的記憶體大小。單位：GiB。	0.5
Name	string	是	容器名稱。	nginx
LifecyclePreStopHandlerHttpGetHost	string	否	使用 HTTP 請求方式設定 preStop 回呼函數時，接收 HTTP Get 請求的主機位址。	10.0.XX.XX
LifecyclePreStopHandlerTcpSocketHost	string	否	使用 TCP Socket 方式設定 preStop 回呼函數時，TCP Socket 檢測的主機位址。	10.0.XX.XX
Image	string	是	容器映像。	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:latest
LifecyclePreStopHandlerHttpGetPort	integer	否	使用 HTTP 請求方式設定 preStop 回呼函數時，HTTP Get 請求檢測的連接埠號。	88
LivenessProbe.FailureThreshold	integer	否	从上次检查成功后认定检查失败的检查次数阈值（必须是连续失败），默认为 3。	3
ReadinessProbe.Exec.Command	array	否	使用命令行方式进行健康检查时，在容器内执行的命令。說明设置 ReadinessProbe 相关参数时，HttpGet、Exec 和 TcpSocket 这三种检查方式，只能选择其中一种。
	string	否	使用命令行方式进行健康检查时，在容器内执行的命令。	cat /tmp/healthy
LifecyclePreStopHandlerHttpGetHttpHeader	array<object>	否	產生的 HTTP 請求標頭參數。
	object	否	產生的 HTTP 請求標頭參數。
Value	string	否	使用 HTTP 請求方式設定 preStop 回呼函數時，HTTP Get 請求標頭中自訂設定的欄位值。	test-preStop
Name	string	否	使用 HTTP 請求方式設定 preStop 回呼函數時，HTTP Get 請求標頭中自訂設定的欄位名。	Xiao-Custom-Header
ReadinessProbe.FailureThreshold	integer	否	从上次检查成功后认定检查失败的检查次数阈值（必须是连续失败），默认为 3。	3
Cpu	number	否	容器的 vCPU 大小。單位：核。	0.25
LivenessProbe.HttpGet.Port	integer	否	使用 HTTP 请求方式进行健康检查时，HTTP Get 请求检测的端口号。說明设置 LivenessProbe 相关参数时，HttpGet、Exec 和 TcpSocket 这三种检查方式，只能选择其中一种。	8888
LivenessProbe.HttpGet.Path	string	否	使用 HTTP 请求方式进行健康检查时，HTTP Get 请求检测的路径。說明设置 LivenessProbe 相关参数时，HttpGet、Exec 和 TcpSocket 这三种检查方式，只能选择其中一种。	/healthz
LivenessProbe.TimeoutSeconds	integer	否	检查超时的时间，默认为 1 秒，最小为 1 秒。	1
SecurityContext.RunAsUser	integer	否	设置运行容器的用户 ID。	1000
LifecyclePostStartHandlerHttpGetPort	integer	否	使用 HTTP 請求方式設定 postStart 回呼函數時，HTTP Get 請求檢查的連接埠號。	5050
LifecyclePostStartHandlerHttpGetHttpHeader	array<object>	否	產生的 HTTP 請求標頭參數。
	object	否	產生的 HTTP 請求標頭參數。
Value	string	否	使用 HTTP 請求方式設定 postStart 回呼函數時，HTTP Get 請求標頭中自訂設定的欄位值。	test-postStart
Name	string	否	使用 HTTP 請求方式設定 postStart 回呼函數時，HTTP Get 請求標頭中自訂設定的欄位名。	Xiao-Custom-Header
EnvironmentVarHide	boolean	否	查詢 ECI 執行個體詳情時，是否隱藏環境變數資訊。取值範圍： false（預設值）：查詢 ECI 執行個體詳情時，不隱藏環境變數資訊。 true：查詢 ECI 執行個體詳情時，不傳回環境變數資訊。在環境變數帶有敏感資訊時，設定為 true 可以提高安全性。	false
SecurityContextRunAsGroup	integer	否	設定執行容器的使用者群組。	3000
SecurityContextRunAsNonRoot	boolean	否	是否以非 root 模式執行容器。取值範圍： true：非 root 模式 false（預設值）：root 模式。	true
SecurityContextPrivileged	boolean	否	容器是否啟用特權，即是否以特權模式執行容器。取值範圍： true：啟用特權 false（預設值）：不啟用特權說明特權容器功能正在內測中。如需體驗，請提交工單申請。	true
Volume	array<object>	否	資料卷資訊。
	array<object>	否	資料卷資訊。
Type	string	否	資料卷類型。取值範圍： -。	ConfigFileVolume
DiskVolume.DiskSize	integer	否	DiskVolume 的大小。单位为 GiB。	15
NFSVolume.Path	string	否	NFS 数据卷路径。	/share
DiskVolume.FsType	string	否	DiskVolume 的系统类型。	xfs
FlexVolume.FsType	string	否	挂载的文件系统类型，默认取决于 FlexVolume 的 script。	ext4
HostPathVolume.Type	string	否	HostPath Volume 的类型。取值范围： Directory：目录。 File：文件。說明 HostPath Volume 仅对白名单用户开放使用。	Directory
ConfigFileVolume.DefaultMode	integer	否	ConfigFileVolume 默认的权限。	0644
NFSVolume.ReadOnly	boolean	否	NFS 数据卷是否只读。默认为 false。	false
ConfigFileVolume.ConfigFileToPath	array<object>	否	ConfigFile 类型的数据卷信息。如果配置多个 ConfigFileToPath，对应的多个 Content 的总长度不能超过 60 KB。
	object	否	ConfigFile 类型的数据卷信息。
Path	string	否	相对于挂载目录，配置文件所在的相对文件路径。	test/config-test.cnf
Mode	integer	否	配置文件的权限，如果没有设置，则采用 ConfigFileVolume.DefaultMode 的值。采用四位八进制数表示，例如 0644 表示权限为 rw-r–r--，即用户权限为 rw-，用户所在组权限为 r--，其他用户权限为 r--。权限说明如下： `---`：没有任何权限，八进制值为 0。 `--x`：只有执行权限，八进制值为 1。 `-w-`：只有写入权限，八进制值为 2。 `-wx`：有写入和执行权限，八进制值为 3。 `r--`：只有读取权限，八进制值为 4。 `r-x`：有读取和执行权限，八进制值为 5。 `rw-`：有读取和写入权限，八进制值为 6。 `rwx`：具有读取、写入和执行权限，八进制值为 7。	0644
Content	string	否	配置文件内容，需要将内容进行 Base64 编码。单个配置文件不能大于 32 KB。	bGl1bWk=
HostPathVolume.Path	string	否	HostPath Volume 在主机上的目录路径。	/pod/data
FlexVolume.Options	string	否	FlexVolume 对象选项列表。为 KV 形式，采用 JSON 传递。例如通过 FlexVolume 挂载云盘时，Options 表示云盘的配置参数，可配置的参数如下： volumeId：已有云盘 ID。 volumeSize：云盘大小，单位为 GiB。取值范围为 20~32768。 performanceLevel：云盘性能等级。更多信息，请参见云盘性能等级。 deleteWithInstance：是否随实例释放，默认为 false。 encrypted：是否加密云盘，默认为 false。更多信息，请参见加密概述。 kmsKeyId：加密云盘时，云盘使用的 KMS 密钥 ID。	{"volumeId":"d-2zehdahrwoa7srg****","performanceLevel": "PL2"}
FlexVolume.Driver	string	否	使用 FlexVolume 插件挂载数据卷时的驱动类型。取值范围如下： alicloud/disk：挂载云盘。 alicloud/nas：挂载 NAS。 alicloud/oss：挂载 OSS。	alicloud/disk
NFSVolume.Server	string	否	NFS 服务器地址。	3f9cd4a596-naw76.cn-shanghai.nas.aliyuncs.com
DiskVolume.DiskId	string	否	DiskVolume 的 ID。	d-xx
Name	string	否	数据卷名称。	default-volume1
EmptyDirVolume.Medium	string	否	EmptyDirVolume 的存储媒介，默认为空，使用 node 文件系统；支持 memory，表示使用内存。	memory
EmptyDirVolume.SizeLimit	string	否	EmptyDirVolume 的大小。单位为 GiB。	2
InitContainer	array<object>	否	Init 容器列表。
	array<object>	否	Init 容器列表。
SecurityContext.Capability.Add	array	否	为容器内的进程授予某些特定的权限。目前仅支持配置为 NET_ADMIN 和 NET_RAW。說明 NET_RAW 默认不支持，需提交工单申请。
	string	否	为容器内的进程授予某些特定的权限。目前仅支持配置为 NET_ADMIN 和 NET_RAW。說明 NET_RAW 默认不支持，需提交工单申请。	NET_ADMIN
Image	string	否	容器使用的镜像。	nginx
VolumeMount	array<object>	否	挂载数据卷信息列表。
	object	否	挂载数据卷信息列表。
MountPropagation	string	否	資料卷的掛載傳播設定。掛載傳播允許將 Container 掛載的卷共用到同一 Pod 中的其他 Container，甚至可以共用到同一節點上的其他 Pod。取值範圍： None：該卷不感知任何後續在此卷或其子目錄上執行的掛載操作。 HostToContainer：該卷將會感知到後續在此卷或其子目錄上的掛載操作。 Bidirectional：和 HostToContainer 類似，能感知掛載操作。另外，該卷將被傳播回主機和使用同一卷的所有 Pod 的所有容器。預設值：None。	None
MountPath	string	否	挂载目录，容器的挂载目录下的内容被 volume 的内容直接覆盖，所以要慎用。	/usr/share/
ReadOnly	boolean	否	挂载路径是否只读。默认为 false。	false
SubPath	string	否	数据卷下的子目录，方便 Pod 将同一个 Volume 下不同目录挂载到容器不同目录。	/usr/sub/
Name	string	否	挂载数据卷的名称。	test-empty
Port	array<object>	否	init 容器端口号。
	object	否	init 容器端口号。
Protocol	string	否	協定類型。取值範圍： TCP UDP。	TCP
Port	integer	否	連接埠號。取值範圍：1~65535。	8888
SecurityContext.ReadOnlyRootFilesystem	boolean	否	容器运行的根文件系统是否为只读。目前仅支持配置为 true。	true
TerminationMessagePath	string	否	容器退出的消息来源。当容器退出时，从指定的终止消息文件中检索终止消息。	/tmp/termination-log
EnvironmentVar	array<object>	否	容器的环境变量信息列表。
	object	否	容器的环境变量信息列表。
Key	string	否	環境變數名。長度為 1~128 位。格式要求：`[0-9a-zA-Z]`，以及底線，不能以數字開頭。	Path
Value	string	否	環境變數值。長度為 0~256 位。	/usr/bin/
FieldRef.FieldPath	string	否	环境变量值引用。目前只支持配置为 status.podIP。	status.podIP
ImagePullPolicy	string	否	镜像拉取策略。取值范围： Always：总是拉取。每次都拉取镜像。 IfNotPresent：按需拉取。优先使用本地镜像，本地没有镜像时则拉取镜像。 Never：从不拉取。使用本地镜像，不拉取镜像。	Always
WorkingDir	string	否	工作目录。	/usr/local
Cpu	number	否	容器的 vCPU 大小。單位：核。	0.5
Arg	array	否	容器启动参数。	10
	string	否	容器启动参数。	10
Command	array	否	容器启动指令。	sleep
	string	否	容器启动指令。	sleep
Gpu	integer	否	指定容器使用的 GPU 個數。	1
SecurityContext.RunAsUser	integer	否	设置运行容器的用户 ID。	587
Memory	number	否	容器的記憶體大小。單位：GiB。	1.0
TerminationMessagePolicy	string	否	挂载信息，默认为空。	*****
Name	string	否	容器名稱。	test-init
DnsConfig.NameServer	array	否	DNS 服务器的 IP 地址列表。	172.10..*
	string	否	DNS 服务器的 IP 地址列表。	172.10..*
DnsConfig.Search	array	否	DNS 搜索域列表。	svc.local.kubenetes
	string	否	DNS 搜索域列表。	svc.local.kubernetes
DnsConfig.Option	array<object>	否	对象的选项列表。
	object	否	对象的选项列表。
Value	string	否	对象的 Value。	value
Name	string	否	对象的 Name。	name
HostAliase	array<object>	否	添加一个 ECI 的别名。
	object	否	添加一个 ECI 的别名。
Ip	string	否	添加 IP。	1.1.1.1
Hostname	array	否	添加主机名。	hehe.com
	string	否	添加主机名。	hehe.com
SecurityContext.Sysctl	array<object>	否	通过安全上下文修改安全 sysctl 参数。更多信息，请参见配置 Security Context。
	object	否	通过安全上下文修改安全 sysctl 参数。更多信息，请参见配置 Security Context。
Value	string	否	通过安全上下文修改 sysctl 参数时，安全 sysctl 参数的取值。	65536
Name	string	否	通过安全上下文修改 sysctl 参数时，安全 sysctl 参数的名称。取值范围： net.ipv4.ping_group_range net.ipv4.ip_unprivileged_port_start	net.ipv4.ping_group_range
HostSecurityContext.Sysctl	array<object>	否	通过安全上下文修改非安全 sysctl 参数。更多信息，请参见配置 Security Context。
	object	否	通过安全上下文修改非安全 sysctl 参数。更多信息，请参见配置 Security Context。
Value	string	否	通过安全上下文修改 sysctl 参数时，非安全 sysctl 参数的取值。	65536
Name	string	否	通过安全上下文修改 sysctl 参数时，非安全 sysctl 参数的名称。取值范围： kernel.shm（kernel.shm_rmid_forced 除外） kernel.msg kernel.sem fs.mqueue.* net.*（net.ipv4.tcp_syncookies、net.ipv4.ping_group_range、net.ipv4.ip_unprivileged_port_start 除外）	kernel.msgmax
NtpServer	array	否	NTP 服务器。	ntp.cloud.aliyuncs.com
	string	否	NTP 服务器。	ntp.cloud.aliyuncs.com
AcrRegistryInfo	array<object>	否	ACR 企业版实例信息列表。更多信息，请参见免密拉取 ACR 镜像。
	object	否	ACR 企业版实例信息列表。
Domain	array	否	ACR 企业版实例的域名。默认为相应实例的所有域名。支持指定个别域名，多个以半角逗号分隔。	***-**-registry.cn-beijing.cr.aliyuncs.com
	string	否	ACR 企业版实例的域名。默认为相应实例的所有域名。支持指定个别域名，多个以半角逗号分隔。	***-**-registry.cn-beijing.cr.aliyuncs.com
InstanceName	string	否	ACR 企业版实例的名称。	acr-test
InstanceId	string	否	ACR 企业版实例 ID。	cri-nwj395hgf6f3****
RegionId	string	否	ACR 企业版实例所属地域。	cn-beijing
ArnService	string	否	ECI 实例等资源归属账号下的 RAM 角色的 ARN。	acs:ram::1609982529******:role/role-assume
ArnUser	string	否	ACR 实例归属账号下的 RAM 角色的 ARN。	acs:ram::1298452580******:role/role-acr
SpotDuration	integer	否	抢占式实例的保护期。单位为小时。默认为 1。可设置为 0，表示无保护期。	1
StrictSpot	boolean	否	是否周期执行： true：周期执行。 false：非周期行执行。	true
PlainHttpRegistry	string	否	自建镜像仓库地址。使用 HTTP 协议的自建镜像仓库中的镜像创建 ECI 实例时，需配置该参数，使得 ECI 使用 HTTP 协议拉取镜像，避免因协议不同而导致镜像拉取失败。	"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"
InsecureRegistry	string	否	自建镜像仓库地址。使用自签发证书的自建镜像仓库中的镜像创建 ECI 实例时，需配置该参数来跳过证书认证，避免因证书认证失败而导致镜像拉取失败。	"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"
ImageAccelerateMode	string	否	镜像加速模式。取值范围： nydus：使用 Nydus 加速，需镜像本身支持。 dadi：使用 DADI 加速，需镜像本身支持。 p2p：使用 P2P 加速，需镜像本身支持。 imc：使用镜像缓存加速。	imc
Ipv6GatewayBandwidthEnable	boolean	否	是否开通 ECI 的 IPv6 公网通信能力。	true
Ipv6GatewayBandwidth	string	否	当 Ipv6GatewayBandwidthEnable 配置为 true 时，配置 IPv6 地址的公网带宽峰值。取值如下：当 IPv6 网关的公网带宽计费方式为按固定带宽计费时，IPv6 地址的公网带宽范围为 1~2000 Mbps。当 IPv6 网关的公网带宽计费方式为按使用流量计费时，IPv6 地址的公网带宽范围受网关规格约束。网关为免费版，IPv6 地址的公网带宽范围为 1~200 Mbps。网关为企业版，IPv6 地址的公网带宽范围为 1~500 Mbps。网关为企业增强版，IPv6 地址的公网带宽范围为 1~1000 Mbps。默认值为网关对应带宽范围的最大值。	100
ContainerResourceView	boolean	否	当 ECI 规格比申请规格大时，可以开启该配置，确保容器内看到的资源跟申请的资源保持一致。	false
FixedIp	string	否	配置为 true 表示实例启用固定 IP 地址。具体请参见配置 ECI 实例使用固定 IP 地址。	true
FixedIpRetainHour	integer	否	固定 IP 地址空闲后的保留时长，即启用固定 IP 地址的实例释放后，其固定 IP 地址的保留时长，单位为小时。默认值为 48。	24
DataCacheBucket	string	否	数据缓存 Bucket。	default
DataCachePL	string	否	数据缓存使用的云盘的性能等级。优先使用 ESSD 云盘，性能等级默认为 PL1。	PL1
DataCacheProvisionedIops	integer	否	数据缓存使用 ESSD AutoPL 云盘时，ESSD AutoPL 云盘预配置的读写 IOPS。取值范围：0~min{50000, 1000 * 容量-基准性能}。基准性能=min{1800+50 * 容量, 50000}。更多信息，请参见ESSD AutoPL 云盘。	40000
DataCacheBurstingEnabled	boolean	否	数据缓存使用 ESSD AutoPL 云盘时，是否开启 Burst（性能突发）。更多信息，请参见ESSD AutoPL 云盘。	false
DryRun	boolean	否	是否只预检此次请求。取值范围： true：发送检查请求，不会创建 ECI 实例。检查项包括是否填写了必填参数、请求格式、业务限制和库存。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码 DryRun.Success。 false（默认）：发送正常请求，通过检查后直接创建 ECI 实例。	false
PrivateIpAddress	string	否	指定 ECI 实例的私网 IP 地址。目前仅支持指定 IPv4 地址，请确保该 IP 地址没有被占用。	172.16.0.1
OsType	string	否	指定 ECI 实例的操作系统。取值范围： Linux（默认值） Windows 說明 Windows 实例正在邀测中，如需使用，请提交工单申请。	Windows
CpuArchitecture	string	否	指定 ECI 实例的 CPU 架构。取值范围： AMD64（默认值） ARM64	ARM64
ComputeCategory	array	否	指定算力类别。更多信息，请参见指定算力类别创建实例。
	string	否	指定算力类别。取值范围： economy：经济型 general：通用型支持设置多个算力类别，系统会按照设置顺序创建。	economy
GpuDriverVersion	string	否	指定 GPU 驱动版本。說明仅部分规格支持切换 GPU 驱动版本。更多信息，请参见指定 GPU 规格创建实例。	tesla=535
MaxPendingMinute	integer	否

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	请求 ID，唯一标识。	89945DD3-9072-47D0-A318-353284CFC7B3
ContainerGroupId	string	实例 ID，即容器组 ID。	eci-uf6fonnghi50u374****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "89945DD3-9072-47D0-A318-353284CFC7B3",
  "ContainerGroupId": "eci-uf6fonnghi50u374****"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
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	InvalidParameter.DuplicatedName	The container group include containers with duplicate names.
400	InvalidParameter.DuplicatedVolumeName	The container group includes volumes with duplicate names.
400	IncorrectStatus	%s
400	ServiceNotEnabled	%s
400	ImageSnapshot.IncorrectStatus	%s
400	ImageSnapshot.NotSupport	%s
400	DiskVolume.NotSupport	The disk volume is not supported.
400	RamRole.NotSupport	The RAM role is not supported.
400	DiskNumber.LimitExceed	The maximum number of disks in an instance is exceeded.
400	InvalidPaymentMethod.InsufficientBalance	No payment method is specified for your account. We recommend that you add a payment method or add funds to the prepayment balance.
400	DiskVolume.NotInSameZone	The instance to be created and the disk are not in the same zone.
400	NoPermission	You are not authorized to use the "Product on ECI" feature.
400	HighCpuMemConfigRequired	You need to apply to be added to the whitelist of the specified CPU and memory.
400	RecommendEmpty.InstanceTypeFamilyNotMatched	The recommended instance type is unavailable in the current zone. Try again later.
400	LocalDiskAmountNotMatch	The number of local volumes does not match the instance type.
400	Payfor.CreditPayInsufficientBalance	Your payment credit line is insufficient.
400	InvalidOperation.KMS.InstanceTypeNotSupport	The specified instance is invalid. Only I/O optimized instances support KMS key.
400	InvalidParameter.Encrypted.KmsNotEnabled	KMS must be enabled for encrypted disks.
400	InvalidParameter.KMS.EncryptedIllegal	After configuring the parameter KmsKeyId, you must enable encryption.
400	InvalidSpotCpuMemorySpec	The specified CPU and memory are not allowed. You must create spot ECI using standard ECS specifications for CPU and memory.
400	Ipv6AddressNotSupportVsw	IPv6 is not supported in the specified vSwitch.
400	Ipv6AddressNotSupport	Ipv6 is not supported in specified region.
400	Ipv6AddressNotSupportInstanceType	IPv6 is not supported for the specified instance type.
400	EipPayInsufficientBalance	Your account does not have enough balance to purchase eip.
400	EipPurchaseFlowControl	Request was denied due to eip frequent purchase.
400	Throttling	You have made too many requests within a short time; your request is denied due to request throttling
400	JobInstanceBatchCreateNotSupport	ECI job instance not support batch create
400	JobInstanceDiskNotSupport	ECI job instance not support disk volume
400	JobInstanceEipNotSupport	ECI job instance not support eip
400	JobInstanceFeatureNotMatch	ECI job instance feature not match
400	JobInstanceImageCacheNotSupport	ECI job instance not support image cache
400	JobInstanceIPv6NotSupport	ECI job instance not support IPv6
400	JobInstanceRamRoleNotSupport	ECI job instance not support ram role
400	JobInstanceRegionNotSupport	ECI job instance not support in this region
400	JobInstanceSpotNotSupport	ECI job instance not support spot
400	InvalidInstanceTypeForEciSpotDurationBuy	Current instance type does not support spot duration instance.
400	InvalidInstanceTypeForEciBuy	Sales of this current instance type is not supported in eci.
400	InstanceTypeNotMatchCpuArch	%s.
400	JobInstanceEcsInstanceTypeNotSupport	Job-optimized elastic container instances cannot be created by specifying ECS instance types.
400	PrivatePoolInstanceSpotNotSupport	Spot is not supported for PrivatePool.
400	DryRun.Success	This request is a dryrun request with successful result.
400	PrivateIpAddress.Already.InUse	The specific PrivateIpAddress already in use.
400	IncorrectOperation	%s
400	FeatureBasedConstraintConflict	A conflict occurs in specified feature constraints: [%s].
400	OperationFailed.RiskControl	%s.
400	RISK.RISK_CONTROL_REJECTION	To protect the security of your account, your request has been denied by the risk control system. Please contact Alibaba Cloud Customer Service for details.
400	InvalidInstanceTypeForRaid	%s.
400	RegionDissolved	%s.
400	MultiAttachedCloudDiskNotSupport	%s.
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	NoPermission	The RAM role does not belong to ECS.
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://www.alibabacloud.com/help/document_detail/157290.html
403	InvalidParameter.KMS.KeyId.Forbidden	You are not authorized to access the specified KMSKeyId.
403	Forbidden.AccountClosed	The operation is forbidden. Your account has been closed.
403	InvalidOperation.ResourceManagedByCloudProduct	The operation is forbidden. The security group has been managed by another cloud product.
403	Spot.NotMatched	%s. We recommend that you use the create multi-zone function to avoid insufficient inventory. For more information, see https://www.alibabacloud.com/help/document_detail/157290.html
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.
403	Throttling.Vcpu.PerDay	The maximum number of request for the day has been exceeded.
403	FeatureAccessRestricted	Access to this feature:[%s] is restricted. Please contact Alibaba Cloud ECI support to request access.
404	ImageSnapshot.NotFound	The specified snapshot does not exist.
404	InvalidDiskId.NotFound	The specified disk does not exist.
404	InvalidParameter.KMS.KeyId.NotFound	The specified KMSKeyId does not exist.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。