com.vmware.cis.tagging.tag_association

The tag_association service provides operations to attach, detach, and query tags.

detach

POST /com/vmware/cis/tagging/tag-association/id:{tag_id}?~action=detach
POST /com/vmware/cis/tagging/tag-association?~action=detach

Detaches the tag from the given object. To invoke this operation, you need the attach tag privilege on the tag and the read privilege on the object.
Request:
Representations:
{
    "object_id": {
        "id": "obj-103",
        "type": "string"
    },
    "tag_id": "obj-103"
}
<?xml version="1.0" ?>
<ns0:Detach-Input xmlns:ns0="http://vmware.com/cis/tagging/tag_association" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <object_id>
    <id>obj-103</id>
    <type>string</type>
  </object_id>
  <tag_id>obj-103</tag_id>
</ns0:Detach-Input>
POST /com/vmware/cis/tagging/tag-association?~action=detach
&object_id.id=obj-103
&object_id.type=string
&tag_id=obj-103

Parameters:
Name Type Required Description
tag_id
 *
 ID Yes The identifier of the input tag. Id of type com.vmware.cis.tagging.Tag.
object_id
 *
 dynamic_ID Yes The identifier of the input object.

Response:
Representations:

Parameters:
Name Type Required Description
result VOID Yes

Errors:
Type Description HTTP Status Code
not_found if the tag for the given tag_id does not exist in the system. 404
unauthorized if you do not have the privilege to detach the tag or do not have the privilege to read the concerned object. 403

Copyright © 2014. All Rights Reserved.