com.vmware.cis.tagging.tag_association

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

list_attached_objects

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

Fetches the array of attached objects for the given tag. To invoke this operation, you need the read privilege on the input tag. Only those objects for which you have read privileges will be returned.
Request:
Representations:
{
    "tag_id": "obj-103"
}
<?xml version="1.0" ?>
<ns0:ListAttachedObjects-Input xmlns:ns0="http://vmware.com/cis/tagging/tag_association" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <tag_id>obj-103</tag_id>
</ns0:ListAttachedObjects-Input>
POST /com/vmware/cis/tagging/tag-association?~action=list-attached-objects
&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.

Response:
Representations:
{
    "value": [
        {
            "id": "obj-103",
            "type": "string"
        },
        {
            "id": "obj-103",
            "type": "string"
        }
    ]
}
<?xml version="1.0" ?>
<ns0:ListAttachedObjects-Result xmlns:ns0="http://vmware.com/cis/tagging/tag_association" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <value-array>
    <array-item>
      <id>obj-103</id>
      <type>string</type>
    </array-item>
    <array-item>
      <id>obj-103</id>
      <type>string</type>
    </array-item>
  </value-array>
</ns0:ListAttachedObjects-Result>

Parameters:
Name Type Required Description
result List<dynamic_ID> Yes The array of attached object identifiers.

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 read the tag. 403

Copyright © 2014. All Rights Reserved.