586      阿裏雲

創建實例__實例相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

創建實例需要通過實名認證。沒有通過實名認證的可以前往 阿裏雲官網 中的用戶中心—>會員信息中進行實名認證。

根據傳入參數創建彈性計算實例。

• 在創建實例時，必須要選擇鏡像，用來確定新創建實例的係統盤配置。鏡像包含操作係統以及應用軟件配置，基於鏡像創建實例後，實例的係統盤即為此鏡像的完全克隆。

• 一個實例創建時必須指定加入一個安全組。安全組需要預先創建，可通過創建安全組接口創建，可以在新創建實例時指定，也可通過 修改實例屬性 的接口來完成實例所屬安全組變更。在同一個安全組內的實例內網可以相互訪問，但不同安全組之間默認有防火牆隔離，不可相互訪問，但可通過安全組授權（通過授權安全組權限接口實現）來設置此安全組的防火牆權限。同一個安全組內的實例數量不能超過1000個，若組內實例數量超出限製，創建實例時若指定該安全組，會提示失敗。

• 在創建實例時，如果參數InternetChargeType的值設置為PayByBandwidth（按固定帶寬付費），則InternetMaxBandwidthOut的設置值即為所選的固定帶寬值；如果參數InternetChargeType的值設置為PayByTraffic（按流量付費），則InternetMaxBandwidthOut隻是一個帶寬的上限設置，計費以發生的網絡流量為依據。設置InternetChargeType和InternetMaxBandwidthOut時，應仔細核算可能發生的帶寬費用。

• InternetMaxBandwidthIn的值在任何情況下都與計費無關，實例的入數據流量是免費的。

• 創建實例時，可以選擇是否為IO優化實例（IoOptimized）。

• 實例創建時，係統會根據用戶所指定鏡像為實例分配一個相應大小的係統盤,係統盤容量=Max{40,ImageSize}；也可以指定係統盤的容量SystemDisk.size參數，該參數必須大於等於max{40,ImageSize};同時，可以指定係統盤的種類：普通雲盤（cloud）、高效雲盤（cloud_efficiency）、SSD雲盤（cloud_ssd）、本地 SSD 盤（ephemeral_ssd）。

• 當實例選擇為IO優化實例時，係統盤隻能選擇高效雲盤（cloud_efficiency）及SSD雲盤（cloud_ssd）

• ECS不支持單獨創建或者添加本地SSD盤，因此本地SSD盤必須在創建實例時指定，實例創建完成後不能再添加。各個實例規格對不同磁盤種類大小的限製見 實例資源規格對照表。

• 單塊普通雲盤（cloud）容量最大不能超過2000GB，單塊高效雲盤（cloud_efficiency）容量最大不超過32TB（32768GB），單塊SSD雲盤（cloud_ssd）容量最大不能超過32TB（32768GB），單塊本地 SSD 盤（ephemeral_ssd）容量最大不能超過 800GB。

• 隨實例創建的係統盤，其Portable屬性為false，即不支持卸載和掛載操作。係統盤隨實例的釋放而釋放，所以係統盤的DeleteWithInstance的屬性為True。

• 隨實例創建的類型為普通雲盤（cloud）、高效雲盤（cloud_efficiency）或SSD雲盤（cloud_ssd）的數據盤，其Portable屬性為true，即支持卸載和掛載操作。如果數據盤隨實例的釋放而釋放，則DeleteWithInstance的屬性的默認值為True；反之，如果數據盤不隨實例的釋放而釋放，則DeleteWithInstance的屬性的默認值為False

• 隨實例創建的本地 SSD 盤（ephemeral_ssd），其 Portable 屬性為 false，即不支持卸載和掛載操作。本地 SSD 盤隨實例的釋放而釋放，所以其 DeleteWithInstance 的屬性為 True。

• 一個實例最多添加4塊數據盤；數據盤選擇本地 SSD 盤時，係統盤必須為本地 SSD 盤，同時一個實例的本地 SSD 盤總容量不超過 1TB（1024GB，不包括係統盤）。

• 選擇了本地SSD盤的實例，一旦創建後，不能修改實例規格。

• 實例內存為512M時不能使用 Windows 操作係統；內存為 4G以上時不能使用 32位操作係統。

• 當係統盤是普通雲盤（cloud）、高效雲盤（cloud_efficiency）或SSD雲盤（cloud_ssd）時，數據盤不能是ephemeral_ssd。

• 專有網絡類型實例隻能在創建時指定，這類實例必須且隻能屬於一個虛擬交換機。

• 指定VSwitchId創建實例時，SecurityGroupId和VSwitchId要屬於同一個專有網絡。

• VSwitchId和PrivateIpAddress同時指定時，PrivateIpAddress要包含在虛擬交換機的CidrBlock之內。

• PrivateIpAddress依賴於VSwitchId，不能單獨指定PrivateIpAddress。

• 若實例付費類型為預付費的包年包月實例（PrePaid）,則在執行付款時默認會使用該賬號下可用的優惠券（0折賬號除外）

• 創建完成後，實例為 Stopped 狀態

• 在阿裏雲CLI及SDK中使用該API時，部分帶”.”號的入參需要去掉”.”號使用，包括：SystemDisk.Category、SystemDisk.Size、SystemDisk.Description、DataDisk.n.Size、DataDisk.n.Category、DataDisk.n.SnapshotId、DataDisk.n.DiskName、DataDisk.n.Description、DataDisk.n.Device、DataDisk.n.DeleteWithInstance。如：在阿裏雲CLI及SDK中使用SystemDiskCategory來表示SystemDisk.Category入參

請求參數

返回參數

錯誤碼

示例

請求示例

https://ecs.aliyuncs.com/?Action=CreateInstance
&RegionId=cn-hangzhou
&ImageId=_32_23c472_20120822172155_aliguest.vhd
&SecurityGroupId=sg-c0003e8b9
&HostName=Bctest01
&InstanceType=ecs.t1.small
&<公共請求參數>

返回示例

XML格式

<CreateInstanceResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <InstanceId>i-instance1</InstanceId>
</CreateInstanceResponse>

JSON格式

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "InstanceId": "i-instance1"
}

最後更新：2016-11-23 16:03:50

  上一篇： ECS API 發生子賬號訪問主賬號資源時的鑒權規則__借助 RAM 實現子賬號對主賬號的 ECS 資源訪問_API 參考_雲服務器 ECS-阿裏雲

  下一篇： 啟動實例__實例相關接口_API 參考_雲服務器 ECS-阿裏雲