全部產品
Search
文件中心

Elastic Container Instance:CreateContainerGroup - 建立一個容器組

更新時間:Oct 17, 2025

調用CreateContainerGroup建立一個ECI執行個體(即容器組)。

介面說明

調用 CreateContainerGroup 建立 ECI 執行個體時,系統將自動為您建立一個服務關聯角色 AliyunServiceRoleForECI,用於訪問 ECS、VPC 等相關雲端服務。更多資訊,請參見Elastic Container Instance服務關聯角色

建立 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 個字元,不能以aliyunacs:開頭,不能包含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

設定運行容器的使用者識別碼。

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

資料卷類型。取值範圍:

  • EmptyDirVolume:EmptyDir 類型的資料卷,表示空目錄。

  • NFSVolume:NFS 類型的資料卷,表示網路檔案系統。

  • ConfigFileVolume:ConfigFile 類型的資料卷,表示設定檔。

  • FlexVolume:使用 FlexVolume 外掛程式擴充儲存類型,支援掛載雲端硬碟。

  • HostPathVolume:HostPath 類型的資料卷,表示主機節點的檔案或目錄。該類型僅對白名單使用者開放使用。

  • DiskVolume(不推薦):雲端硬碟資料卷。建議使用 FlexVolume 掛載雲端硬碟。

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

設定檔內容,需要將內容進行 Base 64 編碼。
單個設定檔不能大於 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 金鑰識別碼。

{"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

設定運行容器的使用者識別碼。

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. 此次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”不存在。

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

變更歷史

更多資訊,參考變更詳情