集成指南 › CA Access Control for Virtual Environments REST API › 标记受管设备

标记受管设备

您可以标记受管设备以将计算机添加到安全组并远程对它进行管理。

遵循这些步骤:

1. 获得 CA Access Control for Virtual Environments 用于受管设备的 ID。

   要得到 CA Access Control for Virtual Environments 用于受管设备的 ID，请使用筛选，并使用 REST 请求来检索设备详细信息。 例如：

   https://hostname:18443/iam/api/1.0/restapi/environments/ac/devices?managed-object-vcenter-uuid=54E79C3A-49D5-4958-A983-8B919F470CEC&managed-object-id=vm-394
   

   注意：在前一示例中，使用在 VMware 管理对象浏览器 (MOB) 中定义的筛选参数 vCenter UUID 和 VM UUID 传递。

   您得到响应 XML 文档，类似于以下内容：

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

   设备的 ID 是在响应 XML 文件中所指定的 vm-19。

2. 使用分配的标记更新设备。

   将 HTTP PUT 命令发送到下列 URL：

   https://<host>:18443/iam/api/1.0/restapi/environments/ac/devices/<managed_device_ID>
   

   注意：HTTP 内容必须包含新分配的标记信息，除此以外，还包含设备的所有现有属性。 要获得现有属性，请在筛选设备的 CA Access Control for Virtual Environments ID 时从响应 XML 文件复制 <Device>…</Device> 标记之间的数据。

   带有新标记关系的 HTTP 内容示例：

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