調用CreateContainerGroup建立一個ECI執行個體(即容器組)。
介面說明
調用 CreateContainerGroup 建立 ECI 執行個體時,系統將自動為您建立一個服務關聯角色 AliyunServiceRoleForECI,用於訪問 ECS、VPC 等相關雲端服務。更多資訊,請參見Elastic Container Instance服務關聯角色。
建立 ECI 執行個體時,您可以根據需要配置執行個體、鏡像、儲存等相關功能。各功能涉及的參數及其說明,請參見以下功能文檔:
執行個體
ECI 支援以下兩種方式建立執行個體:
以下功能兩種建立方式均支援:
鏡像
網路
儲存
容器配置
日誌與營運
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
eci:CreateContainerGroup |
create |
*ContainerGroup
|
|
無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| 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 之間可以用半形逗號(,)進行分割,例如 如果沒有指定交換器,系統將自動使用您選擇的地區下的預設 VPC 下的預設交換器,如果您在該地區下沒有預設 VPC 和預設交換器,系統將自動建立一個預設 VPC 和一個預設交換器。 說明
交換器網段內的 IP 個數決定了該交換器下最大可以建立的 ECI 執行個體數量,請務必提前規劃好網段。 |
vsw-bp1xpiowfm5vo8o3c****,vsw-bp1rkyjgr1xwoho6k**** |
| ContainerGroupName |
string |
是 |
ECI 執行個體名稱,即容器組名稱。格式要求如下:
|
nginx-test |
| RestartPolicy |
string |
否 |
執行個體重啟策略。取值範圍:
預設值: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 策略。取值範圍:
|
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 |
| SpotPriceLimit |
number |
否 |
設定搶佔式執行個體的每小時最高價格,最多精確到小數點後 3 位。 當 SpotStrategy 取值為 SpotWithPriceLimit 時,必須設定 SpotPriceLimit。 |
0.025 |
| ScheduleStrategy |
string |
否 |
配置了多可用性區域(通過 VSwitchId 參數指定多個交換器)時,ECI 執行個體的調度策略。取值範圍:
更多資訊,請參見多可用性區域建立執行個體。 |
VSwitchOrdered |
| CorePattern |
string |
否 |
自訂設定 coredump 產生的 core 檔案的儲存目錄。更多資訊,請參見設定 core 檔案儲存到資料卷。 說明
配置的路徑不能以 |
/xx/xx/core |
| ShareProcessNamespace |
boolean |
否 |
是否使用共用命名空間。預設為 false。 |
false |
| AutoCreateEip |
boolean |
否 |
是否自動建立一個 EIP,並綁定到 ECI 執行個體上。 |
true |
| EipBandwidth |
integer |
否 |
EIP 的頻寬,預設為 5 Mbps。 |
5 |
| EipISP |
string |
否 |
設定 EIP 的線路類型。取值範圍:
|
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 個字元,不能以 |
version |
| Value |
string |
否 |
標籤值。如果傳入該值,可以為空白字串。最多支援 128 個字元,不能以 |
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 請求對應的協議類型,取值範圍:
說明
設定 ReadinessProbe 相關參數時,HttpGet、Exec 和 TcpSocket 這三種檢查方式,只能選擇其中一種。 |
HTTP |
| LivenessProbe.PeriodSeconds |
integer |
否 |
檢查執行的周期,預設為 10 秒,最小為 1 秒。 |
5 |
| SecurityContext.ReadOnlyRootFilesystem |
boolean |
否 |
容器啟動並執行根檔案系統是否為唯讀,目前僅支援配置為 true。 |
true |
| EnvironmentVar |
array<object> |
否 |
容器的環境變數值。 |
|
|
object |
否 |
容器的環境變數值。 |
||
| Key |
string |
否 |
環境變數名。長度為 1~128 位。格式要求: |
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 |
None |
| MountPath |
string |
否 |
容器掛載資料卷的目錄。 說明
容器掛載目錄下的內容會被 Volume 的內容直接覆蓋,請謹慎使用。 |
/pod/data |
| ReadOnly |
boolean |
否 |
資料卷是否唯讀。預設為 false。 |
false |
| SubPath |
string |
否 |
資料卷子路徑。 |
data2/ |
| Name |
string |
否 |
資料卷名稱。同 Volume 中的 Name。 |
default-volume1 |
| ImagePullPolicy |
string |
否 |
鏡像拉取策略。取值範圍:
|
Always |
| StdinOnce |
boolean |
否 |
當標準輸入為 true 時,標準輸入資料流將在多個附加會話中是否保持開啟狀態。 |
false |
| LifecyclePreStopHandlerTcpSocketPort |
integer |
否 |
使用 TCPSocket 方式設定 preStop 回呼函數時,TCP Socket 檢測的連接埠。 |
90 |
| LifecyclePostStartHandlerHttpGetScheme |
string |
否 |
使用 HTTP 要求方式設定 postStart 回呼函數時,HTTP Get 請求對應的協議類型,取值範圍:
|
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 |
| Port |
integer |
否 |
連接埠號碼。取值範圍:1~65535。 |
80 |
| TerminationMessagePath |
string |
否 |
容器的報錯地址。 |
/tmp/termination-log |
| LifecyclePreStopHandlerHttpGetScheme |
string |
否 |
使用 HTTP 要求方式設定 preStop 回呼函數時,HTTP Get 請求對應的協議類型,取值範圍:
|
HTTP |
| LivenessProbe.HttpGet.Scheme |
string |
否 |
使用 HTTP 要求方式進行健全狀態檢查時,HTTP Get 請求對應的協議類型,取值範圍:
說明
設定 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 |
否 |
設定運行容器的使用者識別碼。 |
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 |
| SecurityContextRunAsGroup |
integer |
否 |
設定運行容器的使用者組。 |
3000 |
| SecurityContextRunAsNonRoot |
boolean |
否 |
是否以非 root 模式運行容器。取值範圍:
|
true |
| SecurityContextPrivileged |
boolean |
否 |
容器是否啟用特權,即是否以特權模式運行容器。取值範圍:
說明
特權容器功能正在內測中。如需體驗,請提交工單申請。 |
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 的類型。取值範圍:
說明
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--。 許可權說明如下:
|
0644 |
| Content |
string |
否 |
設定檔內容,需要將內容進行 Base 64 編碼。 |
bGl1bWk= |
| HostPathVolume.Path |
string |
否 |
HostPath Volume 在主機上的目錄路徑。 |
/pod/data |
| FlexVolume.Options |
string |
否 |
FlexVolume 對象選項列表。為 KV 形式,採用 JSON 傳遞。 例如通過 FlexVolume 掛載雲端硬碟時,Options 表示雲端硬碟的配置參數,可配置的參數如下: |
{"volumeId":"d-2zehdahrwoa7srg****","performanceLevel": "PL2"} |
| FlexVolume.Driver |
string |
否 |
使用 FlexVolume 外掛程式掛載資料卷時的驅動類型。取值範圍如下:
|
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 |
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 |
| Port |
integer |
否 |
連接埠號碼。取值範圍:1~65535。 |
8888 |
| SecurityContext.ReadOnlyRootFilesystem |
boolean |
否 |
容器啟動並執行根檔案系統是否為唯讀。目前僅支援配置為 true。 |
true |
| TerminationMessagePath |
string |
否 |
容器退出的訊息來源。當容器退出時,從指定的終止訊息檔案中檢索終止訊息。 |
/tmp/termination-log |
| EnvironmentVar |
array<object> |
否 |
容器的環境變數資訊列表。 |
|
|
object |
否 |
容器的環境變數資訊列表。 |
||
| Key |
string |
否 |
環境變數名。長度為 1~128 位。格式要求: |
Path |
| Value |
string |
否 |
環境變數值。長度為 0~256 位。 |
/usr/bin/ |
| FieldRef.FieldPath |
string |
否 |
環境變數值引用。目前只支援配置為 status.podIP。 |
status.podIP |
| ImagePullPolicy |
string |
否 |
鏡像拉取策略。取值範圍:
|
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 |
否 |
設定運行容器的使用者識別碼。 |
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 |
| HostSecurityContext.Sysctl |
array<object> |
否 |
通過安全上下文修改非安全 sysctl 參數。更多資訊,請參見配置 Security Context。 |
|
|
object |
否 |
通過安全上下文修改非安全 sysctl 參數。更多資訊,請參見配置 Security Context。 |
||
| Value |
string |
否 |
通過安全上下文修改 sysctl 參數時,非安全 sysctl 參數的取值。 |
65536 |
| Name |
string |
否 |
通過安全上下文修改 sysctl 參數時,非安全 sysctl 參數的名稱。取值範圍:
|
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 |
| 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 |
否 |
鏡像加速模式。取值範圍:
|
imc |
| Ipv6GatewayBandwidthEnable |
boolean |
否 |
是否開通 ECI 的 IPv6 公網通訊能力。 |
true |
| Ipv6GatewayBandwidth |
string |
否 |
當 Ipv6GatewayBandwidthEnable 配置為 true 時,配置 IPv6 地址的公網頻寬峰值。取值如下:
預設值為網關對應頻寬範圍的最大值。 |
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 |
否 |
資料緩衝使用的雲端硬碟的效能等級。 |
PL1 |
| DataCacheProvisionedIops |
integer |
否 |
資料緩衝使用 ESSD AutoPL 雲端硬碟時,ESSD AutoPL 雲端硬碟預配置的讀寫 IOPS。 |
40000 |
| DataCacheBurstingEnabled |
boolean |
否 |
資料緩衝使用 ESSD AutoPL 雲端硬碟時,是否開啟 Burst(效能突發)。更多資訊,請參見ESSD AutoPL 雲端硬碟。 |
false |
| DryRun |
boolean |
否 |
是否只預檢此次請求。取值範圍:
|
false |
| PrivateIpAddress |
string |
否 |
指定 ECI 執行個體的私網 IP 位址。目前僅支援指定 IPv4 地址,請確保該 IP 位址沒有被佔用。 |
172.16.0.1 |
| OsType |
string |
否 |
指定 ECI 執行個體的作業系統。取值範圍:
說明
Windows 執行個體正在邀測中,如需使用,請提交工單申請。 |
Windows |
| CpuArchitecture |
string |
否 |
指定 ECI 執行個體的 CPU 架構。取值範圍:
|
ARM64 |
| ComputeCategory |
array |
否 |
指定算力類別。更多資訊,請參見指定算力類別建立執行個體。 |
|
|
string |
否 |
指定算力類別。取值範圍:
支援設定多個算力類別,系統會按照設定順序建立。 |
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. | 此次DryRun預檢請求合格。 |
| 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. | ram執行個體角色不支援。 |
| 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. | 您需要申請CPU高配白名單。 |
| 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. | 指定的執行個體無效,只有 I/O 最佳化類型的執行個體支援設定“KMS Key”。 |
| 400 | InvalidParameter.Encrypted.KmsNotEnabled | KMS must be enabled for encrypted disks. | 加密磁碟需要啟用Key Management Service。 |
| 400 | InvalidParameter.KMS.EncryptedIllegal | After configuring the parameter KmsKeyId, you must enable encryption. | 設定參數“KmsKeyId”後,您必須開啟加密屬性。 |
| 400 | InvalidSpotCpuMemorySpec | The specified CPU and memory are not allowed. You must create spot ECI using standard ECS specifications for CPU and memory. | 必須採用標準的ECS規格來建立ECI spot。 |
| 400 | Ipv6AddressNotSupportVsw | IPv6 is not supported in the specified vSwitch. | 該交換器暫未開通ipv6地址。 |
| 400 | Ipv6AddressNotSupport | Ipv6 is not supported in specified region. | 當前地區還不支援IPV6地址。 |
| 400 | Ipv6AddressNotSupportInstanceType | IPv6 is not supported for the specified instance type. | 當前建立的規格不支援IPv6。 |
| 400 | EipPayInsufficientBalance | Your account does not have enough balance to purchase eip. | 當前賬戶餘額不足以購買eip。 |
| 400 | EipPurchaseFlowControl | Request was denied due to eip frequent purchase. | 當前購買eip過於頻繁,請稍後重試。 |
| 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. | 當前規格不支援eci自訂時間長度類型的spot執行個體。 |
| 400 | InvalidInstanceTypeForEciBuy | Sales of this current instance type is not supported in eci. | 當前規格不在eci售賣規格範圍內。 |
| 400 | InstanceTypeNotMatchCpuArch | %s. | 您指定的ECS規格的CPU架構與您指定的CPU架構不匹配。 |
| 400 | JobInstanceEcsInstanceTypeNotSupport | Job-optimized elastic container instances cannot be created by specifying ECS instance types. | ECI Job最佳化型執行個體不支援指定ECS規格建立 |
| 400 | PrivatePoolInstanceSpotNotSupport | Spot is not supported for PrivatePool. | |
| 400 | DryRun.Success | This request is a dryrun request with successful result. | 該dryrun請求校正已經通過。 |
| 400 | PrivateIpAddress.Already.InUse | The specific PrivateIpAddress already in use. | 私網ip地址已經被佔用 |
| 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. | 當前規格不支援Raid |
| 400 | RegionDissolved | %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. | 建立執行個體的可用性區域已經關閉售賣,請更換其他可用性區域。或者無法在該可用性區域使用指定 VPC 的虛擬交換器。 |
| 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. | 子帳號使用者沒有許可權使用RAM執行個體角色。 |
| 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. | 無權訪問指定的 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. | 請確保帳號擁有ram:CreateServiceLinkedRole許可權。 |
| 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. | 使用該特性需要申請白名單,請聯絡阿里雲ECI團隊申請加白。 |
| 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. | 指定的參數“KMSKeyId”不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。