Get VM Removable Media Drive Items operation


The Get VM Removable Drive Items operation enables you to retrieve the details of the removable media drive items from the specified VM.

The following figure shows a sample <items> XML element for the Get VM Removable Media Drive Items operation:

Sample <items> XML element for the Get VM Removable Media Drive 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 Removable Media Drive Items operation

Element

Definition

Required

<operation-name>

Defines the type of operation: Get_VM_Removable_Media_Drive_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 removable media drive items details you want to retrieve

Valid value: Any string

Yes

The following figure shows the sample adapter request for the Get VM Removable Media Drive Items operation:

Sample adapter request for the Get VM Removable Media Drive Items operation

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

The following figure shows the response for the sample request:

Sample adapter response for the Get VM Removable Media_Drive 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-1923816390/virtualHardwareSection/media">
     <Item>
       <Address>1</Address>
       <Description>IDE Controller</Description>
       <ElementName>IDE Controller 1</ElementName>
       <InstanceID>2</InstanceID>
       <ResourceType>5</ResourceType>
     </Item>
     <Item>
       <AddressOnParent>0</AddressOnParent>
       <AutomaticAllocation>false</AutomaticAllocation>
       <Description>Floppy Drive</Description>
       <ElementName>Floppy Drive 1</ElementName>
       <HostResource />
       <InstanceID>8000</InstanceID>
       <ResourceType>14</ResourceType>
     </Item>
   </RasdItemsList>
 </message-body>
</vmware-vcloud-response>

 

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

TrueSight Orchestration Content 20.19.01