Integration Guide › CA Access Control for Virtual Environments REST API › Examples: HTTP Schema

Examples: HTTP Schema

The following are schema examples for the supported REST-based API commands:

• HTTP POST:

  POST /iam/api/1.0/restapi/environments/ac/tags HTTP/1.1
  Content-type: application/xml; charset=UTF-8
  Authorization: Basic YWRtaW46ZGVmYXVsdA==
  Cache-Control: no-cache
  Pragma: no-cache
  Host: 10.112.196.244
  Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
  Connection: keep-alive
  Content-Length: 79
  
  <Tag><Name>testtag</Name><Description>testtag2 description</Description></Tag>
  

• HTTP GET:

  GET /iam/api/1.0/restapi/environments/ac/devices/vm-19 HTTP/1.1
  Authorization: Basic YWRtaW46ZGVmYXVsdA==
  Host: 10.112.196.169:9998
  

• HTTP  PUT:

  PUT /iam/api/1.0/restapi/environments/ac/devices/vm-19 HTTP/1.1
  Content-type: application/xml; charset=UTF-8
  Authorization: Basic YWRtaW46ZGVmYXVsdA==
  Cache-Control: no-cache
  Pragma: no-cache
  Host: 10.112.196.244
  Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
  Connection: keep-alive
  Content-Length: 959
  
  <Devices><Device><ID>vm-19</ID><ParentID>esx-3</ParentID><Name>ESXi in a box</Name><Type>VirtualMachine</Type><VirtualMachineProperties><ManagedObjectID>vm-394</ManagedObjectID><ManagedObjectVCenterUUID>54E79C3A-49D5-4958-A983-8B919F470CEC</ManagedObjectVCenterUUID><GuestOSVersion>LINUX_REDHAT_5</GuestOSVersion><GuestOSArchitecture>X86</GuestOSArchitecture><GuestOSDescription>Red Hat Enterprise Linux 5 (64-bit)</GuestOSDescription></VirtualMachineProperties><Tags><Tag><Name>testtag</Name><Description>testtag2 description</Description></Tag></Tags><SecurityGroups><SecurityGroup><ID>sg-13</ID><Name>weiig01esxi01.ca.com</Name><Description/><Owner>superadmin</Owner></SecurityGroup><SecurityGroup><ID>sg-15</ID><Name>Discovered virtual machine</Name><Description/><Owner>superadmin</Owner></SecurityGroup><SecurityGroup><ID>sg-22</ID><Name>vSphere in a box</Name><Description/><Owner>superadmin</Owner></SecurityGroup></SecurityGroups></Device></Devices>
  

• HTTP DELETE:

  DELETE /iam/api/1.0/restapi/environments/ac/tags/testtag HTTP/1.1
  Content-type: application/xml; charset=UTF-8
  Authorization: Basic YWRtaW46ZGVmYXVsdA==
  Cache-Control: no-cache
  Pragma: no-cache
  Host: 10.112.196.244
  Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
  Connection: keep-alive