使用說明

runInstances主要是用於產生一個或多個雲伺服器

1. 製作雲用雲伺服器的方法有以下三種
   1. 採用公用範本申請雲伺服器 (create vm from public image)
   2. 採用雲伺服器複製雲伺服器 (clone vm from vm)
   3. 採用用戶範本複製雲伺服器 (create vm from template)
2. 採用公用範本或是用戶範本複製雲伺服器時，imageId, instanceType 參數為必填
3. 採用雲伺服器複製雲伺服器時，instanceId參數為必填，此時imageId, instanceType, monitoringEnabled 的參數將被忽略
4. 採用用戶範本複製雲伺服器時，此時 monitoringEnabled 的參數將被忽略
5. 若雲伺服器有關連的快照或備份，則無法執行雲伺服器複製雲伺服器
6. CaaS雲伺服器會有三張網卡，但部份網卡保留，不可被使用
7. CVPC雲伺服器會有五張網卡
8. 當雲伺服器做成用戶範本時，此用戶範本會記錄當下雲伺服器網卡狀態
9. 網卡狀態分成三種
   • 0: 不存在
   • 1: 停用
   • 2: 啟用
10. 雲伺服器複製雲伺服器時，需注意要與新申請雲伺服器的網卡狀態與所對應的子網段服務識別碼的關係， 若沒有輸入 vnic1AdapterStatus, vnic2AdapterStatus, vnic3AdapterStatus，則這三個值預設會和原本雲伺服器的三張網卡的狀態的值一致， 例如: 原本的雲伺服器三張網卡分別為 vnic 1 啟用，vnic 2 停用， vnic 3 不存在，則預設值 vnic1AdapterStatus=2 , vnic2AdapterStatus=1, vnic3AdapterStatus=0
11. 關於 CaaS 的雲伺服器
    1. 申請 CaaS 的雲伺服器時，不可指定 vpcBusinessServiceId
    2. CaaS 的雲伺服器最多有三張網卡，但只 vnic 1 和 vnic 3 可使用， vnic 2 保留；其中 vnic 1 是不可被移除的 (vnic1AdapterStatus 必需為 2)，不可指定 ip (vnic1UserAssignIp 需為 null)，也不可指定子網段 (vnic1SubnetBusinessServiceId 需為 null)； vnic 2 無作用，不可指定相關的參數 vnic2SubnetBusinessServiceId, vnic2AdapterStatus 和 vnic2UserAssignIp ；而 vnic 3 為子網段的網卡，不一定需存在
    3. 採用公用範本申請 CaaS 雲伺服器時，vnic1SubnetBusinessServiceId, vnic2SubnetBusinessServiceId, vnic3SubnetBusinessServiceId, vnic1UserAssignIp, vnic2UserAssignIp, vnic3UserAssignIp, vnic2AdapterStatus, vnic3AdapterStatus 值不可設定；vnic1AdapterStatus 預設值為 2 且不可被設定成 0 或 1
    4. 採用 CaaS 雲伺服器複製 CaaS 雲伺服器時， vnic1SubnetBusinessServiceId, vnic2SubnetBusinessServiceId, vnic1UserAssignIp, vnic2UserAssignIp, vnic2AdapterStatus 值不可設定；vnic1AdapterStatus 預設值為 2 且不可被設定成 0 或 1；如果要設定子網段網卡，則 vnic3AdapterStatus 需為 2 ， vnic3SubnetBusinessServiceId 用來設定網卡 3 子網段服務識別碼 ，也可透過參數 vnic3UserAssignIp 來指定 ip
    5. 採用用戶範本複製雲伺服器時，vnic1SubnetBusinessServiceId, vnic2SubnetBusinessServiceId, vnic1UserAssignIp, vnic2UserAssignIp, vnic2AdapterStatus 值不可設定；vnic1AdapterStatus 預設值為 2 且不可被設定成 0 或 1；如果要設定子網段網卡，則 vnic3AdapterStatus 需為 2 ， vnic3SubnetBusinessServiceId 用來設定網卡 3 子網段服務識別碼 ，也可透過參數 vnic3UserAssignIp 來指定 ip
12. 關於 CVPC 的雲伺服器
    1. 申請 CVPC 的雲伺服器時，必需指定 vpcBusinessServiceId及IpVersion
    2. CVPC 的雲伺服器最多有五張網卡
    3. 採用公用範本申請 CVPC 雲伺服器時， vnic2SubnetBusinessServiceId, vnic3SubnetBusinessServiceId, vnic4SubnetBusinessServiceId,vnic5SubnetBusinessServiceId, vnic2UserAssignIp, vnic3UserAssignIp,vnic4UserAssignIp,vnic5UserAssignIp, vnic2AdapterStatus, vnic3AdapterStatus, vnic4AdapterStatus, vnic5AdapterStatus 值不可設定；vnic1AdapterStatus 預設值為 2 且不可被設定成 0 或 1，vnic1IpVersion 為必填欄位 0表示IPv4,1表示IPv6 vnic1SubnetBusinessServiceId 為必填欄位，用來設定網卡 1 子網段服務識別碼， 也可透過參數 vnic1UserAssignIp 來指定 ip
    4. 採用 CVPC 雲伺服器複製 CVPC 雲伺服器時，需注意：原本雲伺服器的五張網卡的狀態要與新申請雲伺服器的網卡所對應的子網段服務識別碼的對應關係， 如：當原始的用戶範本的網卡狀態為vnic1AdapterStatus=2 (啟用), vnic2AdapterStatus=1(停用), vnic3AdapterStatus=0 (不存在)，vnic4AdapterStatus=0 (不存在)，vnic5AdapterStatus=0 (不存在) 則 vnic1SubnetBusinessServiceId 為必填， vnic2SubnetBusinessServiceId 不可填， vnic3SubnetBusinessServiceId 不可填， vnic4SubnetBusinessServiceId 不可填， vnic5SubnetBusinessServiceId 不可填
    5. 採用用戶範本複製雲伺服器時, 需注意範本有多少張網卡,就需提供相對應的網卡資訊。若範本有三張網卡,則需指定vnic1IpVersion、vnic1SubnetBusinessServiceId、vnic2IpVersion、vnic2SubnetBusinessServiceId、vnic3IpVersion、vnic3SubnetBusinessServiceId

Request參數

Response參數

Request範例

範例 1 (公用範本):		
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=runInstances
&imageId=hi-cuium8up
&instanceType=HC1.S.WIN
&monitoringEnabled=false
&instanceName=myInstance
&count=1
&regionId=${regionId}
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}

範例 2 (雲伺服器複製雲伺服器):
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=runInstances
&instanceId=BV550100010001
&monitoringEnabled=false
&instanceName=myInstance
&count=1
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}

範例 3 (用戶範本複製雲伺服器):
https://hws.hicloud.hinet.net/cloud_hws/api/hws/?action=runInstances
&imageId=BT550100010001
&instanceType=HC1.S.WIN
&instanceName=myInstance
&chtAuthType=hwspass
&version=${version}
&expires=${expires}
&accessKey=${accessKey}
&signature=${signature}

		

Response範例

{
	"requestId": "xxxEXAMPLE",
	"orderUuidList": ["b8b5a2c9-760a-4106-b1c7-c7963d5d7e84"]
}
		

相關連結

錯誤訊息