統合ガイド › CA Access Control for Virtual Environments REST API › 管理対象デバイスからのタグの削除

管理対象デバイスからのタグの削除

管理対象デバイス上のタグを削除して、そのデバイスをセキュリティ グループから削除できます。

次の手順に従ってください：

1. CA Access Control for Virtual Environments が管理対象デバイスに使用する ID を取得します。

   CA Access Control for Virtual Environments が管理対象デバイスに使用する ID を取得するには、フィルタを使用します。 例：

   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 （Managed Object Browser）に定義されるように、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. 以下のとおり、デバイスを更新してタグを削除します。
   1. 手順 1 の XML 応答ファイルを編集し、<Tags> から </Tags> タグまでにあるコンテンツをすべて削除します。
   2. HTTP PUT コマンドを使用して、更新された XML ファイルを以下の URL に送信します。

      https://<host>:18443/iam/api/1.0/restapi/environments/ac/devices/vm-19