cis tagging tag association: 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 the read privilege will be returned.
Request:
HTTP request
POST https://{server}/rest/com/vmware/cis/tagging/tag-association/id:{tag_id}?~action=list-attached-objects
Path Parameters
Name | Type | Description |
---|---|---|
Required | ||
tag_id | string | The identifier of the input tag. |
Response:
HTTP Status Code: 200
Representation:
{
"value": [
{
"id": "obj-103",
"type": "string"
},
{
"id": "obj-103",
"type": "string"
}
]
}
"value": [
{
"id": "obj-103",
"type": "string"
},
{
"id": "obj-103",
"type": "string"
}
]
}
Response Type:
Name | Type | Description |
---|---|---|
bold = required | ||
value | dynamic_ID[] | The array of attached object identifiers. |
value[].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. |
value[].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. |
Errors:
HTTP Status Code | Type | Description |
---|---|---|
404 | not_found | if the tag for the given tag_id does not exist in the system. |
403 | unauthorized | if you do not have the privilege to read the tag. |