統合ガイド › 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 （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. 割り当てられたタグでデバイスを更新します。

   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>