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

  • HOME
  • 提供API一覧
  • deployFlexibleVirtualMachine

deployFlexibleVirtualMachine

処理概要

Flexible仮想サーバの作成

 

注意事項

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

 

リクエスト

・リクエストパラメータ

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
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

 

・リクエストサンプル

$ ./kick_api.sh command=deployFlexibleVirtualMachine serviceofferingid=de7f3f02-5c1e-476e-b4e2-9a90ee716bc2 zoneid=4459e79a-ac3d-4a54-ac73-57832c26b5f1 templateid=a9dc377a-7093-496f-ad4a-bec3db4e4c84 iptonetworklist[0].networkid=cf90774c-1dea-41fe-85f5-f2cc03cccb20 hypervisor=VMware name=FlexibleVM

 

レスポンス

・レスポンスボディ

Response Name
Description
jobid the ID of the asychronous job

 

・レスポンスサンプル

【コマンド実行結果】
<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>
<deployflexiblevirtualmachineresponse cloud-stack-version=”4.11.3″>
  <jobid>2a53f406-3f3c-4816-84d6-fec137065458</jobid>
</deployflexiblevirtualmachineresponse>

 

【queryAsyncJobResultでの確認結果】
<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>
<queryexasyncjobresultresponse cloud-stack-version=”4.11.3″>
  <accountid>8e0c9ea9-3979-4db6-8503-8e4cc560191d</accountid>
  <cmd>org.apache.cloudstack.api.command.admin.vm.DeployVMCmdByAdmin</cmd>
  <created>2023-04-06T11:28:22+0900</created>
  <jobid>2a53f406-3f3c-4816-84d6-fec137065458</jobid>
  <jobinstanceid>1d0378da-3627-4cb7-acd3-877e261e9c32</jobinstanceid>
  <jobinstancetype>VirtualMachine</jobinstancetype>
  <jobprocstatus>0</jobprocstatus>
  <jobresultcode>0</jobresultcode>
  <jobresulttype>object</jobresulttype>
  <jobstatus>1</jobstatus>
  <userid>061ed9e3-f792-4853-bd20-8dfb6c43ab01</userid>
  <jobresult>
    <virtualmachine>
      <account>kenshou01</account>
      <cpunumber>1</cpunumber>
      <cpuspeed>2590</cpuspeed>
      <created>2023-04-06T11:28:22+09:00</created>
      <displayname>x-FlexibleVM-M00000001</displayname>
      <domain>M00000001</domain>
      <domainid>3c87a491-35b3-4b68-ac32-2b6445e44c60</domainid>
      <guestosid>d9229258-1fd3-11ea-97bb-005056a0339a</guestosid>
      <haenable>true</haenable>
      <hypervisor>VMware</hypervisor>
      <id>1d0378da-3627-4cb7-acd3-877e261e9c32</id>
      <isdynamicallyscalable>true</isdynamicallyscalable>
      <jobid>2a53f406-3f3c-4816-84d6-fec137065458</jobid>
      <jobstatus>0</jobstatus>
      <memory>1024</memory>
      <name>x-FlexibleVM-M00000001</name>
      <networkkbsread>0</networkkbsread>
      <networkkbswrite>0</networkkbswrite>
      <nic>
        <broadcasturi>vlan://991</broadcasturi>
        <gateway>198.18.139.129</gateway>
        <id>fa99b6aa-c399-470c-804e-1709e3108cb0</id>
        <ipaddress>198.18.139.138</ipaddress>
        <isdefault>false</isdefault>
        <isolationuri>vlan://991</isolationuri>
        <macaddress>1e:00:7f:00:03:63</macaddress>
        <netmask>255.255.255.224</netmask>
        <networkid>18655d79-23ea-404c-b02b-16a4618ccbfa</networkid>
        <networkname>MonitoringNetwork</networkname>
        <traffictype>Guest</traffictype>
        <type>Shared</type>
      </nic>
      <nic>
        <broadcasturi>vlan://2709</broadcasturi>
        <gateway>10.1.1.1</gateway>
        <id>5b74272c-b6e7-4600-af38-3f3f0f3fd64b</id>
        <ipaddress>10.1.1.103</ipaddress>
        <isdefault>true</isdefault>
        <isolationuri>vlan://2709</isolationuri>
        <macaddress>02:00:28:59:07:12</macaddress>
        <netmask>255.255.255.0</netmask>
        <networkid>cf90774c-1dea-41fe-85f5-f2cc03cccb20</networkid>
        <networkname>PublicFrontSegment</networkname>
        <traffictype>Guest</traffictype>
        <type>Isolated</type>
      </nic>
      <password>V98rkZ</password>
      <passwordenabled>true</passwordenabled>
      <rootdeviceid>0</rootdeviceid>
      <rootdevicetype>ROOT</rootdevicetype>
      <serviceofferingid>de7f3f02-5c1e-476e-b4e2-9a90ee716bc2</serviceofferingid>
      <serviceofferingname>Flexible_RG1_1vCPU_Mem1GB</serviceofferingname>
      <state>Running</state>
      <templatedisplaytext>RedHat 8.4 64bit ウイルス対策なし</templatedisplaytext>
      <templateid>a9dc377a-7093-496f-ad4a-bec3db4e4c84</templateid>
      <templatename>RedHat8.4(64bit)100GB</templatename>
      <zoneid>4459e79a-ac3d-4a54-ac73-57832c26b5f1</zoneid>
      <zonename>jp2-east04</zonename>
    </virtualmachine>
  </jobresult>
</queryexasyncjobresultresponse>

提供API一覧

2024/04/23 2024/04/23