KDDIクラウドプラットフォームサービス ナレッジサイト

  • HOME
  • 提供API一覧
  • deployPremiumVirtualMachine

deployPremiumVirtualMachine

処理概要

Premium仮想サーバの作成

 

注意事項

・serviceofferingidはlistServiceOffringsの応答結果より指定ください。
・zoneidはlistZonesの結果より指定ください。

 

リクエスト

・リクエストパラメータ

Parameter Name Description Required
serviceofferingid the ID of the service offering for the virtual machine TRUE
templateid the ID of the template for the virtual machine TRUE
zoneid availability zone for the virtual machine TRUE
hostname HOST NAME to deploy the VM TRUE
hypervisor the hypervisor on which to deploy the virtual machine TRUE
name the virtual machine name TRUE
iptonetworklist ip to network mapping. Can’t be specified with networkIds parameter. Example: iptonetworklist[0].ip=10.10.10.11&iptonetworklist[0].ipv6=fc00:1234:5678::abcd&iptonetworklist[0].networkid=uuid – requests to use ip 10.10.10.11 in network id=uuid true ( only index [0] )
diskofferingid the ID of the disk offering for the virtual machine. If the template is of ISO format, the diskOfferingId is for the root disk volume. Otherwise this parameter is used to indicate the offering for the data disk volume. If the templateId parameter passed is from a Template object, the diskOfferingId refers to a DATA Disk Volume created. If the templateId parameter passed is from an ISO object, the diskOfferingId refers to a ROOT Disk Volume created. FALSE
size the arbitrary size for the DATADISK volume. Mutually exclusive with diskOfferingId FALSE
 

・リクエストサンプル

$ ./testapi-kenshou02-east.sh command=deployPremiumVirtualMachine name=testapi2 serviceofferingid=c9fae3d1-4e8c-4a5c-912d-64140af845ae zoneid=7d4b9647-356d-49a8-8e1a-28862b9c9082 hostname=jp2-east03-Losv-003271 hypervisor=VMware templateid=a42a3b6d-95db-417b-84a3-c1208dfcd509 iptonetworklist[0].networkid=dfab0cf8-c56f-437c-9816-14e47d127235 iptonetworklist[1].networkid=19a2e758-163f-40a8-b977-1932dcbe2bc3 iptonetworklist[1].ip=192.168.4.22
 

 

レスポンス

・レスポンスボディ

Response Name
Description
jobid the ID of the asychronous job

・レスポンスサンプル

【コマンド実行結果】
<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>
<deploypremiumvirtualmachineresponse cloud-stack-version=”4.3.0.2″>
<jobid>2226327a-c7f1-442e-8737-faa6005edee0</jobid>
</deploypremiumvirtualmachineresponse>

 

【queryAsyncJobResultでの確認結果】
<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>
<queryexasyncjobresultresponse cloud-stack-version=”4.3.0.2″>
<accountid>d344caf5-24dc-4194-ac5f-2d78d5e38039</accountid>
<cmd>org.apache.cloudstack.api.command.user.vm.DeployVMCmd</cmd>
<created>2016-09-25T18:56:14+0900</created>
<jobid>2226327a-c7f1-442e-8737-faa6005edee0</jobid>
<jobprocstatus>0</jobprocstatus>
<jobresultcode>0</jobresultcode>
<jobresulttype>object</jobresulttype>
<jobstatus>1</jobstatus>
<userid>0212ea46-0529-4250-9e3e-bcb03c114002</userid>
<jobresult>
<virtualmachine>
<account>xxxx</account>
<cpunumber>2</cpunumber>
<cpuspeed>2590</cpuspeed>
<created>2016-09-25T18:56:14+09:00</created>
<displayname>p-testapi2-MXXXXXXXX</displayname>
<domain>MXXXXXXXX</domain>
<domainid>57edb9da-0279-45f0-842a-d768c4ed0d47</domainid>
<guestosid>9e4fd456-c234-11e4-a399-2c600c06bb24</guestosid>
<haenable>true</haenable>
<hostname>jp2-east03-Losv-003271</hostname>
<hypervisor>VMware</hypervisor>
<id>85a02372-43da-4778-af44-bfb9e96ff532</id>
<isdynamicallyscalable>true</isdynamicallyscalable>
<jobid>2226327a-c7f1-442e-8737-faa6005edee0</jobid>
<jobstatus>0</jobstatus>
<memory>12288</memory>
<name>p-testapi2-MXXXXXXXX</name>
<networkkbsread>0</networkkbsread>
<networkkbswrite>0</networkkbswrite>
<nic>
<broadcasturi>vlan://2860</broadcasturi>
<gateway>10.1.1.1</gateway>
<id>a925d87d-626c-4c70-a8ea-f71f94f9696e</id>
<ipaddress>10.1.1.85</ipaddress>
<isdefault>true</isdefault>
<isolationuri>vlan://2860</isolationuri>
<macaddress>02:00:28:4a:01:63</macaddress>
<netmask>255.255.255.0</netmask>
<networkid>dfab0cf8-c56f-437c-9816-14e47d127235</networkid>
<networkname>PublicFrontSegment</networkname>
<traffictype>Guest</traffictype>
<type>Isolated</type>
</nic>
<nic>
<broadcasturi>vlan://3052</broadcasturi>
<gateway>198.18.52.33</gateway>
<id>947c67b9-4c5b-412b-9f39-410c3b551cc9</id>
<ipaddress>198.18.52.45</ipaddress>
<isdefault>false</isdefault>
<isolationuri>vlan://3052</isolationuri>
<macaddress>06:dc:ae:00:09:50</macaddress>
<netmask>255.255.255.224</netmask>
<networkid>36f4ce53-44f2-4fd9-bb7c-b382dd5a2959</networkid>
<networkname>MonitoringNetwork</networkname>
<traffictype>Guest</traffictype>
<type>Shared</type>
</nic>
<nic>
<broadcasturi>vlan://2452</broadcasturi>
<gateway>192.168.4.1</gateway>
<id>ce79ea87-c9b2-4942-ab9c-728ef5f11db4</id>
<ipaddress>192.168.4.22</ipaddress>
<isdefault>false</isdefault>
<isolationuri>vlan://2452</isolationuri>
<macaddress>06:77:58:00:0c:61</macaddress>
<netmask>255.255.255.0</netmask>
<networkid>19a2e758-163f-40a8-b977-1932dcbe2bc3</networkid>
<networkname>BackSegment</networkname>
<traffictype>Guest</traffictype>
<type>Shared</type>
</nic>
<password>mJ8vjzctz</password>
<passwordenabled>true</passwordenabled>
<rootdeviceid>0</rootdeviceid>
<rootdevicetype>ROOT</rootdevicetype>
<serviceofferingid>c9fae3d1-4e8c-4a5c-912d-64140af845ae</serviceofferingid>
<serviceofferingname>Premium_2vCPU_Mem12GB</serviceofferingname>
<state>Running</state>
<templatedisplaytext>CentOS 6.5 64bit ウイルス対策なし</templatedisplaytext>
<templateid>a42a3b6d-95db-417b-84a3-c1208dfcd509</templateid>
<templatename>CentOS6.5(64bit)100GB</templatename>
<zoneid>7d4b9647-356d-49a8-8e1a-28862b9c9082</zoneid>
<zonename>jp2-east03</zonename>
</virtualmachine>
</jobresult>
</queryexasyncjobresultresponse>

提供API一覧

2022/07/06 2022/07/06