com.vmware.cis.tagging.tag_association

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

list_attached_tags

POST /com/vmware/cis/tagging/tag-association?~action=list-attached-tags

Fetches the array of tags attached to the given object. To invoke this operation, you need the read privilege on the input object. The array will only contain those tags for which you have read privileges.
Request:
Representations:
{
    "object_id": {
        "id": "obj-103",
        "type": "string"
    }
}
<?xml version="1.0" ?>
<ns0:ListAttachedTags-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>
</ns0:ListAttachedTags-Input>
POST /com/vmware/cis/tagging/tag-association?~action=list-attached-tags
&object_id.id=obj-103
&object_id.type=string

Parameters:
Name Type Required Description
object_id
 *
 dynamic_ID Yes The identifier of the input object.

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

Parameters:
Name Type Required Description
result List<ID> Yes The array of all tag identifiers that correspond to the tags attached to the given object. Id of type com.vmware.cis.tagging.Tag.

Errors:
Type Description HTTP Status Code
unauthorized if you do not have the privilege to read the object. 403

Copyright © 2014. All Rights Reserved.