Get VM Virtual Disk Items operation


The Get VM Virtual Disk Items operation enables you to retrieve the details of the virtual disks from the specified VM.

The following figure shows a sample <items> XML element for the Get VM Virtual Disk Items operation:

Sample <items> XML element for the Get VM Virtual Disk Items operation

<items>
 <item>
   <parameters>
     <vm-id></vm-id>
   </parameters>
 </item>
</items>

The following table describes the elements for this adapter request:

 

Adapter request elements for the Get VM Virtual Disk Items operation

Element

Definition

Required

<operation-name>

Defines the type of operation: Get_VM_Virtual_Disk_Items

Yes

<vcloud-organization>

Specifies the name of the vCloud organization

Conditional:

  • Required if not specified in the configuration
  • If used, requires <user-name> and <password>
<user-name>

Specifies the user name required for basic HTTP authentication on vCloud

Conditional:

  • Required if not specified in the configuration
  • If used, requires <vcloud-organization> and <password>
<password>

Contains the password corresponding to the specified user name

Conditional:

  • Required if not specified in the configuration
  • If used, requires <vcloud-organization> and <user-name>
<parameters>

Contains the <vm-id> element that executes the operation

Yes

<vm-id>

Specifies the ID of the VM whose virtual disk items details you want to retrieve

Valid value: Any string

Yes

The following figure shows the sample adapter request for the Get VM Virtual Disk Items operation:

Sample adapter request for the Get VM Virtual Disk Items operation

<vmware-vcloud-request>
 <operation-name>Get_VM_Virtual_Disk_Items</operation-name>
 <vcloud-organization>TestOrg</vcloud-organization>
 <user-name>TestUser</user-name>
 <password>Password</password>
 <parameters>
   <vm-id>vm-690224753</vm-id>
 </parameters>
</vmware-vcloud-request>

The following figure shows the response for the sample request:

Sample adapter response for the Get VM Virtual Disk Items operation

<vmware-vcloud-response>
   <metadata>
       <status>success</status>
   </metadata>
   <status-line>
       <code>200</code>
       <reason>OK</reason>
   </status-line>
   <message-body>
       <RasdItemsList type = "application/vnd.vmware.vcloud.rasdItemsList+xml" href = "https://10.128.248.112/api/v1.0/vApp/vm-867787057/virtualHardwareSection/disks">
           <Link
               rel = "edit"
               type = "application/vnd.vmware.vcloud.rasdItemsList+xml"
               href = "https://10.128.248.112/api/v1.0/vApp/vm-867787057/virtualHardwareSection/disks"/>
           <Item>
               <Address>2</Address>
               <Description>SCSI Controller</Description>
               <ElementName>SCSI Controller 2</ElementName>
               <InstanceID>4</InstanceID>
               <ResourceSubType>buslogic</ResourceSubType>
               <ResourceType>6</ResourceType>
           </Item>
           <Item>
               <AddressOnParent>0</AddressOnParent>
               <Description>Hard disk</Description>
               <ElementName>Hard disk 1</ElementName>
               <HostResource
                   capacity = "4096"
                   busType = "6"
                   busSubType = "buslogic"/>
               <InstanceID>2032</InstanceID>
               <Parent>4</Parent>
               <ResourceType>17</ResourceType>
           </Item>
           <Item>
               <Address>0</Address>
               <Description>IDE Controller</Description>
               <ElementName>IDE Controller 0</ElementName>
               <InstanceID>5</InstanceID>
               <ResourceType>5</ResourceType>
           </Item>
           <Item>
               <AddressOnParent>0</AddressOnParent>
               <Description>Hard disk</Description>
               <ElementName>Hard disk 2</ElementName>
               <HostResource
                   capacity = "1024"
                   busType = "5"
                   busSubType = ""/>
               <InstanceID>3000</InstanceID>
               <Parent>5</Parent>
               <ResourceType>17</ResourceType>
           </Item>
           <Item>
               <Address>3</Address>
               <Description>SCSI Controller</Description>
               <ElementName>SCSI Controller 3</ElementName>
               <InstanceID>6</InstanceID>
               <ResourceSubType>lsilogic</ResourceSubType>
               <ResourceType>6</ResourceType>
           </Item>
           <Item>
               <AddressOnParent>0</AddressOnParent>
               <Description>Hard disk</Description>
               <ElementName>Hard disk 3</ElementName>
               <HostResource
                   capacity = "8192"
                   busType = "6"
                   busSubType = "lsilogic"/>
               <InstanceID>2048</InstanceID>
               <Parent>6</Parent>
               <ResourceType>17</ResourceType>
           </Item>
           <Item>
               <Address>1</Address>
               <Description>IDE Controller</Description>
               <ElementName>IDE Controller 1</ElementName>
               <InstanceID>7</InstanceID>
               <ResourceType>5</ResourceType>
           </Item>
           <Item>
               <AddressOnParent>1</AddressOnParent>
               <Description>Hard disk</Description>
               <ElementName>Hard disk 4</ElementName>
               <HostResource
                   capacity = "2048"
                   busType = "5"
                   busSubType = ""/>
               <InstanceID>3003</InstanceID>
               <Parent>7</Parent>
               <ResourceType>17</ResourceType>
           </Item>
       </RasdItemsList>
   </message-body>
</vmware-vcloud-response>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*