통합 안내서 › CA Access Control for Virtual Environments REST API › 관리되는 장치 태깅

관리되는 장치 태깅

컴퓨터를 보안 그룹에 추가하고 원격으로 관리하기 위해 관리되는 장치에 태그를 지정할 수 있습니다.

Follow these steps:

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 Managed Object Browser(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>