1. Operations
2. cis
3. tagging
4. tag association

## cis tagging tag association: 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 the read privileges.

### Request:

#### HTTP request

POST https://{server}/rest/com/vmware/cis/tagging/tag-association?~action=list-attached-tags

#### Request Body Structure:

- JSON
- XML

{
"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>

#### Request Body Parameters:

Name | Type | Description
--- | --- | ---
bold = required
object_id | dynamic_ID | The identifier of the input object.
object_id.type | string | The type of resource being identified (for example `com.acme.Person`). Services that contain operations for creating and deleting resources typically contain a constant specifying the resource type for the resources being created and deleted. The API metamodel metadata services include a service that allows retrieving all the known resource types.
object_id.id | string | The identifier for a resource whose type is specified by vapi.std.dynamic_ID.type. When clients pass a value of this structure as a parameter, the field `type` must contain the actual resource type. When operations return a value of this structure as a result, the field `type` will contain the actual resource type.

### Response:

#### HTTP Status Code: 200

#### Representations:

- JSON
- XML

{
"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>

#### Response Type:

Name | Type | Description
--- | --- | ---
bold = required
value | string[] | The array of all tag identifiers that correspond to the tags attached to the given object.

#### Errors:

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