Elastic Compute Service：CreateInstance - 建立執行個體

執行個體所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。

鏡像檔案 ID，啟動執行個體時選擇的鏡像資源。如需使用雲市場鏡像，您可以在雲市場鏡像商詳情頁查看ImageId。當您不通過指定ImageFamily選用鏡像族系最新可用鏡像時，此參數必選。

鏡像族系名稱，通過設定該參數來擷取當前鏡像族系內最新可用鏡像來建立執行個體。

• 設定了ImageId，則不能設定該參數。

• 未設定ImageId，則可以設定該參數。

執行個體的資源規格。

• 產品選型：參見執行個體規格類型系列或調用 DescribeInstanceTypes 查看目標執行個體規格的效能資料，或者參見選型配置瞭解如何選擇執行個體規格。

• 查詢庫存：調用 DescribeAvailableResource 查看指定地區或者可用性區域內的資源供給情況。

指定新建立執行個體所屬於的安全性群組 ID。

執行個體的名稱。長度為 2~128 個字元，支援 Unicode 中 letter 分類下的字元（其中包括英文、中文等）和數字。可以包含半形冒號（:）、底線（_）、半形句號（.）或者短劃線（-）。如果沒有指定該參數，預設值為執行個體 ID。

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

• PayByBandwidth：按固定頻寬計費。

• PayByTraffic（預設）：按使用流量計費。

是否要自動續約。當參數InstanceChargeType取值PrePaid時才生效。取值範圍：

• true：自動續約。

• false（預設）：不自動續約。

每次自動續約的時間長度，當參數 AutoRenew 取值 True 時，該參數為必填參數。

PeriodUnit 為 Month 時，AutoRenewPeriod 取值：1、2、3、6、12。

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

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

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

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

預設值為 0。

雲端服務器的主機名稱。

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

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

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

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

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

您需要注意：

• 如果傳入 Password 參數，建議您使用 HTTPS 協議發送請求，避免密碼泄露。

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

• 部分作業系統的執行個體不支援配置密碼，僅支援配置金鑰組。例如：Others Linux、Fedora CoreOS。

是否使用鏡像預設的密碼。使用該參數時，Password 參數必須為空白，同時您需要確保使用的鏡像已經設定了密碼。

部署集 ID。

如果您設定的部署集對應的策略為部署集組高可用策略（AvailabilityGroup）時，可以通過該參數指定執行個體在部署集中的分組號。取值範圍為 1~7。

執行個體所屬的可用性區域 ID。更多資訊，請參見 DescribeZones 擷取可用性區域列表。

預設值：空，系統自動選擇。

執行個體所在的叢集 ID。

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

虛擬區域網路 ID。

執行個體的內網 IP。

系統硬碟大小，單位為 GiB。取值範圍為：

• 普通雲端硬碟：20~500

• 其他類型雲端硬碟：20~2048

該參數的取值必須大於或者等於 max{20, ImageSize}。

預設值：max{40, ImageSize} 。

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

• cloud_efficiency：高效雲端硬碟。

• cloud_ssd：SSD 雲端硬碟。

• cloud_essd：ESSD 雲端硬碟。

• cloud：普通雲端硬碟。

• cloud_auto：ESSD AutoPL 雲端硬碟。

• cloud_essd_entry：ESSD Entry 雲端硬碟。

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

系統硬碟名稱。長度為 2~128 個字元，支援 Unicode 中 letter 分類下的字元（其中包括英文、中文和數字等）。可以包含半形冒號（:）、底線（_）、半形句號（.）或者短劃線（-）。

預設值為空白。

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

預設值為空白。

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

• PL0：單盤最高隨機讀寫 IOPS 1 萬。

• PL1（預設）：單盤最高隨機讀寫 IOPS 5 萬。

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

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

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

執行個體的描述。長度為 2~256 個英文或中文字元，不能以http://或https://開頭。

預設值為空白。

如果是建立 VPC 類型的執行個體，需要指定交換器 ID。您可以調用 DescribeVSwitches 查詢已建立的交換器的相關資訊。

執行個體私網 IP 位址。該 IP 位址必須為交換器（VSwitchId）網段的空閑地址。

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

• none：非 I/O 最佳化。

• optimized：I/O 最佳化。

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

其他執行個體規格預設值是 optimized。

是否使用阿里雲提供的虛擬機器系統配置（Windows：NTP、KMS；Linux：NTP、YUM）。

執行個體的付費方式。取值範圍：

• PrePaid：訂用帳戶。選擇該類付費方式時，您必須確認自己的帳號支援餘額支付/信用支付，否則將返回 InvalidPayMethod的錯誤提示。

• PostPaid（預設）：隨用隨付。

購買資源的時間長度，單位由PeriodUnit指定。當參數InstanceChargeType取值為PrePaid時才生效且為必選值。一旦指定了DedicatedHostId，則取值範圍不能超過Dedicated Host的訂閱時間長度。取值範圍：

PeriodUnit=Month 時，Period 取值：1、2、3、6、12。

購買資源的時間長度。取值範圍：

Month。

預設值為 Month。

執行個體自訂資料，需要以 Base64 方式編碼，未經處理資料最多為 32 KB。

執行個體的搶佔策略。當參數InstanceChargeType取值為PostPaid時生效。取值範圍：

• NoSpot（預設）：正常隨用隨付執行個體。

• SpotWithPriceLimit：設定上限價格的搶佔式執行個體。

• SpotAsPriceGo：系統自動出價，跟隨當前市場實際價格。

金鑰組名稱。

設定執行個體的每小時最高價格。支援最多 3 位小數，參數SpotStrategy取值為SpotWithPriceLimit時生效。

搶佔式執行個體的保留時間長度，單位為小時。預設值：1。取值範圍：

• 1：建立後阿里雲會保證執行個體運行 1 小時不會被自動釋放；超過 1 小時後，系統會自動比較出價與市場價格、檢查資產庫存，來決定執行個體的持有和回收。

• 0：建立後，阿里雲不保證執行個體運行 1 小時，系統會自動比較出價與市場價格、檢查資產庫存，來決定執行個體的持有和回收。

搶佔執行個體中斷模式。取值範圍：

• Terminate：直接釋放執行個體。

• Stop：執行個體進入節省停機模式。

  關於節省停機模式的更多說明，請參見隨用隨付執行個體節省停機模式。

預設值：Terminate。

執行個體 RAM 角色名稱。您可以使用 RAM API ListRoles 查詢您已建立的執行個體 RAM 角色。

是否開啟安全強化。取值範圍：

• Active：啟用安全強化，只對系統鏡像生效。

• Deactive：不啟用安全強化，對所有鏡像類型生效。

執行個體所在的企業資源組 ID。

執行個體所屬的 HPC 叢集 ID。

是否只預檢此次請求。取值範圍：

• true：發送檢查請求，不會建立執行個體。檢查項包括是否填寫了必需參數、請求格式、業務限制和 ECS 庫存。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼DryRunOperation。

• false（預設）：發送正常請求，通過檢查後直接建立執行個體。

Dedicated Host ID。

您可以通過 DescribeDedicatedHosts 查詢Dedicated Host ID 列表。

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

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

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

執行個體釋放保護屬性，指定是否支援通過控制台或 API（ DeleteInstance ）釋放執行個體。

• true：開啟執行個體釋放保護。

• false（預設）：關閉執行個體釋放保護。

Dedicated Host執行個體是否與Dedicated Host關聯。取值範圍：

• default：執行個體不與Dedicated Host關聯。已啟用節省停機模式的執行個體，停機後再次啟動時，若原Dedicated Host可用資源不足，則執行個體被放置在自動部署資源集區的其它Dedicated Host上。

• host：執行個體與Dedicated Host關聯。已啟用節省停機模式的執行個體，停機後再次啟動時，仍放置在原Dedicated Host上。若原Dedicated Host可用資源不足，則執行個體重啟失敗。

預設值為 default。

是否在Dedicated Host上建立執行個體。取值範圍：

• default：在非Dedicated Host上建立執行個體。

• host：在Dedicated Host上建立執行個體。若您不指定DedicatedHostId，則由阿里雲自動選擇Dedicated Host部署執行個體。

預設值為 default。

儲存集 ID。

儲存集中的最大分區數量。取值範圍：大於等於 2。

是否啟用執行個體中繼資料的訪問通道。取值範圍：

• enabled：啟用。

• disabled：禁用。

預設值為 enabled。

訪問執行個體中繼資料時是否強制使用加固模式（IMDSv2）。取值範圍：

• optional：不強制使用。

• required：強制使用。設定該取值後，普通模式無法訪問執行個體中繼資料。

預設值為 optional。

執行個體啟動的私人池容量選項。彈性保障服務或容量預定服務在生效後會產生私人池容量，供執行個體啟動時選擇。取值範圍：

• Open：開放模式。將自動匹配開放類型的私人池容量。如果沒有合格私人池容量，則使用公用池資源啟動。該模式下無需設定PrivatePoolOptions.Id參數。

• Target：指定模式。使用指定的私人池容量啟動執行個體，如果該私人池容量不可用，則執行個體會啟動失敗。該模式下必須指定私人池 ID，即PrivatePoolOptions.Id參數為必填項。

• None：不使用模式。執行個體啟動將不使用私人池容量。

預設值為 None。

以下任一情境，執行個體啟動的私人池容量選項只能取值None或不傳值。

• 建立搶佔式執行個體。

• 建立傳統網路類型的 ECS 執行個體。

• 在Dedicated Host DDH 上建立 ECS 執行個體。

私人池 ID。即彈性保障服務 ID 或容量預定服務 ID。