Elastic Compute Service：CreateAutoProvisioningGroup

彈性供應群組所在地域的 ID，您可以呼叫 DescribeRegions 檢視最新的阿里雲地域清單。

彈性供應群組所在的企業資源群組 ID。

彈性供應群組的名稱。長度為 2~128 個英文或中文字元。必須以大小寫字母或中文開頭，不能以http://和https://開頭。可以包含數字、半形冒號（:）、底線（_）或短橫線（-）。

彈性供應群組的交付類型。取值範圍：

• request：一次性非同步交付。供應群組僅在啟動時非同步交付執行個體叢集，調度失敗後不再重試。

• instant：一次性同步交付。供應群組僅在啟動時同步建立執行個體，並在請求回應中傳回建立成功的執行個體清單和建立失敗的原因。

• maintain：持續供應。供應群組在啟動時嘗試交付執行個體叢集，並監控即時容量，未達到目標容量則嘗試繼續建立 ECS 執行個體。

預設值：maintain。

建立搶佔式執行個體的策略。取值範圍：

• lowest-price：成本最佳化策略。選擇價格最低的執行個體規格。

• diversified：均衡可用區分佈策略。在擴充啟動範本指定的可用區內建立執行個體，均勻分佈到各可用區。

• capacity-optimized：容量最佳化分佈策略。根據庫存情況，選擇最佳的執行個體規格和可用區進行建立。

預設值：lowest-price。

競價執行個體中斷時的行為。取值範圍：

• stop：停止執行個體。

• terminate：釋放執行個體。

預設值：terminate。

在SpotAllocationStrategy為lowest-price時生效，表示彈性供應群組選擇價格最低的執行個體規格建立執行個體的數量。

取值範圍：低於LaunchTemplateConfig.N中 N 的取值。

建立隨收隨付執行個體的策略。取值範圍：

• lowest-price：成本最佳化策略。選擇價格最低的執行個體規格。

• prioritized：優先順序策略。按照LaunchTemplateConfig.N.Priority設定的優先順序建立執行個體。

預設值：lowest-price。

彈性供應群組即時容量超過目標容量並觸發縮容時，是否釋放縮容的執行個體。取值範圍：

• termination：釋放縮容的執行個體。

• no-termination：只將縮容的執行個體移出彈性供應群組。

預設值：no-termination。

彈性供應群組的啟動時間，和ValidUntil共同確定有效時段。

按照ISO 8601標準表示，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。

預設值：該介面立即生效的時間戳記。

彈性供應群組的到期時間，和ValidFrom共同確定有效時段。

按照ISO 8601標準表示，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。

預設值：2099-12-31T23:59:59Z。

彈性供應群組到期時，是否釋放群組內執行個體。取值範圍：

• true：釋放群組內執行個體。

• false：只將群組內執行個體移出彈性供應群組。

預設值：false。

刪除彈性供應群組時，是否釋放群組內執行個體。取值範圍：

• true：釋放群組內執行個體。

• false：保留群組內執行個體。

預設值：false。

彈性供應群組內搶佔式執行個體的最高價格。

彈性供應群組的目標總容量。取值範圍：正整數。

總容量必須大於等於PayAsYouGoTargetCapacity（指定的隨收隨付執行個體目標容量）和SpotTargetCapacity（指定的搶佔式執行個體目標容量）取值之和。

彈性供應群組內，隨收隨付執行個體的目標容量。取值範圍：小於等於TotalTargetCapacity的參數取值。

彈性供應群組內，搶佔式執行個體的目標容量。取值範圍：小於等於TotalTargetCapacity的參數取值。

PayAsYouGoTargetCapacity和SpotTargetCapacity之和小於TotalTargetCapacity時，指定差額容量的計費方式。取值範圍：

• PayAsYouGo：隨收隨付執行個體。

• Spot：搶佔式執行個體。

預設值：Spot。

彈性供應群組關聯的執行個體啟動範本的 ID，您可以呼叫 DescribeLaunchTemplates 查詢可用的執行個體啟動範本。同時指定啟動範本與啟動設定資訊（LaunchConfiguration.*）時，優先使用啟動範本。

彈性供應群組關聯的執行個體啟動範本的版本，您可以呼叫 DescribeLaunchTemplateVersions 查詢可用的執行個體啟動範本版本。

預設值：啟動範本的預設版本。

彈性供應群組的描述資訊。

保證請求冪等性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元，且不能超過 64 個字元。更多資訊，請參見如何保證冪等性。

映像 ID。啟動執行個體時選擇的映像資源，您可以呼叫 DescribeImages 查詢可以使用的映像資源。同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

執行個體所屬的安全性群組 ID。同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

是否為 I/O 最佳化執行個體。取值範圍：

• none：非 I/O 最佳化。

• optimized：I/O 最佳化。

已停售的執行個體規格執行個體預設值是 none，其他執行個體規格預設值是 optimized。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

網路計費類型。取值範圍：

• PayByBandwidth：按固定頻寬計費。

• PayByTraffic：按使用流量計費。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

公網入頻寬最大值，單位為 Mbit/s。取值範圍：

• 當公網出頻寬小於等於 10 Mbit/s 時：1~10，預設為 10。

• 當公網出頻寬大於 10 Mbit/s 時：1~LaunchConfiguration.InternetMaxBandwidthOut的取值，預設為LaunchConfiguration.InternetMaxBandwidthOut的取值。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

公網出頻寬最大值，單位為 Mbit/s。取值範圍：0~100。

預設值：0。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

執行個體名稱。長度為 2~128 個字元，必須以大小寫字母或中文開頭，不能以http://和https://開頭。可以包含中文、英文、數字、半形冒號（:）、底線（_）、半形句號（.）或短橫線（-）。

預設值：執行個體的InstanceId。

建立多台 ECS 執行個體時，您可以批次設定有序的執行個體名稱。具體操作，請參見批次設定有序的執行個體名稱或主機名稱。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

執行個體主機名稱。限制說明如下：

• 半形句號（.）和短橫線（-）不能作為首尾字元，更不能連續使用。

• Windows 執行個體：字元長度為 2~15，不支援半形句號（.），不能全是數字。允許大小寫英文字母、數字和短橫線（-）。

• 其他類型執行個體（Linux 等）：字元長度為 2~64，支援多個半形句號（.），點之間為一段，每段允許大小寫英文字母、數字和短橫線（-）。

• 不支援同時設定LaunchConfiguration.HostName與LaunchConfiguration.HostNames.N，否則會傳回錯誤訊息。

• 同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

執行個體描述。長度為 2~256 個英文或中文字元，不能以http://和https://開頭。同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

金鑰對名稱。

• Windows 執行個體，忽略該參數。預設為空。

• Linux 執行個體的密碼登入方式會被初始化成禁止。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

執行個體 RAM 角色名稱。您可以使用 RAM API ListRoles 查詢您已建立的執行個體 RAM 角色。同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

是否開啟安全性加固。取值範圍：

• Active：啟用安全性加固，只對公用映像生效。

• Deactive：不啟用安全性加固，對所有映像類型生效。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

執行個體自訂資料。需要以 Base64 方式編碼，原始資料最多為 32 KB。同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

系統磁碟的雲端硬碟種類。取值範圍：

• cloud_efficiency：高效雲端硬碟。

• cloud_ssd：SSD 雲端硬碟。

• cloud_essd：ESSD 雲端硬碟。

• cloud：普通雲端硬碟。

已停售的執行個體規格且非 I/O 最佳化執行個體預設值為 cloud，否則預設值為 cloud_efficiency。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

系統磁碟大小。單位為 GiB，取值範圍：20~500。該參數的取值必須大於或者等於 max{20, LaunchConfiguration.ImageId 對應的映像大小}。

預設值：max{40, 參數 LaunchConfiguration.ImageId 對應的映像大小}。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

系統磁碟名稱。長度為 2~128 個英文或中文字元。必須以大小寫字母或中文開頭，不能以http://和https://開頭。可以包含數字、半形句號（.）、半形冒號（:）、底線（_）或短橫線（-）。

預設值：空。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

系統磁碟的描述。長度為 2~256 個英文或中文字元，不能以http://和https://開頭。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

建立 ESSD 雲端硬碟作為系統磁碟使用時，設定雲端硬碟的效能等級。取值範圍：

• PL0（預設）：單碟最高隨機讀寫 IOPS 1 萬。

• PL1：單碟最高隨機讀寫 IOPS 5 萬。

• PL2：單碟最高隨機讀寫 IOPS 10 萬。

• PL3：單碟最高隨機讀寫 IOPS 100 萬。

有關如何選擇 ESSD 效能等級，請參見 ESSD 雲端硬碟。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

是否使用映像預設的密碼。取值範圍：

• true：使用。

• false：不使用。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

執行個體所在的企業資源群組 ID。同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

設定突增效能執行個體的運作模式。取值範圍：

• Standard：標準模式，執行個體效能請參見什麼是突增效能執行個體下的效能約束模式章節。

• Unlimited：無效能約束模式，執行個體效能請參見什麼是突增效能執行個體下的無效能約束模式章節。

預設值：無。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

執行個體的密碼。長度為 8 至 30 個字元，必須同時包含大小寫英文字母、數字和特殊符號中的三類字元。特殊符號可以是：

()`~!@#$%^&*-_+=|{}`[]`:;'<>,.?/

其中，Windows 執行個體不能以正斜線（/）為密碼首字元。

同時指定啟動範本與啟動設定資訊時，優先使用啟動範本。

部署集 ID。

彈性供應群組的目標最小容量。取值範圍：正整數。

當您設定該參數後，需要注意：

• 僅建立一次性同步交付類型的彈性供應群組（AutoProvisioningGroupType=instant）時，該參數生效。

• 如果目前地域下的執行個體庫存小於該參數值，則會導致呼叫介面失敗，不會建立執行個體。

• 如果目前地域下的執行個體庫存大於該參數值，則按照已設定的其他參數值正常建立執行個體。

按量付費執行個體的自動釋放時間。按照ISO 8601標準表示，使用 UTC+0 時間。格式為：yyyy-MM-ddTHH:mm:ssZ。

• 如果秒（ss）取值不是00，則自動取為目前分鐘（mm）開始時。

• 最短釋放時間為目前時間半小時之後。

• 最長釋放時間不能超過目前時間三年。

映像族系名稱。長度為 2~128 個英文或中文字元。必須以大小寫字母或中文開頭，不能以aliyun和acs:開頭，不能包含http://或者https://。可以包含數字、半形冒號（:）、底線（_）或者短橫線（-）。