Integration Guide › CA Access Control for Virtual Environments REST API › Modify a Tag

Modify a Tag

You modify a tag to modify in order to assign or remove the tags from the managed devices.

Follow these steps:

1. Retrieve the tag state using a GET command:

   https://hostname:18443/iam/api/1.0/restapi/environments/ac/<tag_name>
   

   You get a response XML document back, similar to the following:

   <Tag>
     <Name>testtag</Name>
     <Description />
     <Devices>
       <Device>
         <ID>vm-11</ID>
       </Device>
     </Devices>
   </Tag>
   

2. Update the device with the modified tag.

   Send an HTTP PUT command to the following URL:

   https://hostname:18443/iam/api/1.0/restapi/environments/ac/<tag_name>