cis tagging tag association: list attached objects on tags
Fetches the array of cis.tagging.tag_association.tag_to_objects describing the input tag identifiers and the objects they are attached to. To invoke this operation, you need the read privilege on each input tag. The cis.tagging.tag_association.tag_to_objects.object_ids will only contain those objects for which you have the read privilege. This operation was added in vSphere API 6.5
Request:
HTTP request
POST https://{server}/rest/com/vmware/cis/tagging/tag-association?~action=list-attached-objects-on-tags
Request Body Structure:
{
"tag_ids": [
"obj-103",
"obj-103"
]
}
"tag_ids": [
"obj-103",
"obj-103"
]
}
Request Body Parameters:
Name | Type | Description |
---|---|---|
bold = required | ||
tag_ids | string[] | The identifiers of the input tags. |
Response:
HTTP Status Code: 200
Representation:
{
"value": [
{
"object_ids": [
{
"id": "obj-103",
"type": "string"
},
{
"id": "obj-103",
"type": "string"
}
],
"tag_id": "obj-103"
},
{
"object_ids": [
{
"id": "obj-103",
"type": "string"
},
{
"id": "obj-103",
"type": "string"
}
],
"tag_id": "obj-103"
}
]
}
"value": [
{
"object_ids": [
{
"id": "obj-103",
"type": "string"
},
{
"id": "obj-103",
"type": "string"
}
],
"tag_id": "obj-103"
},
{
"object_ids": [
{
"id": "obj-103",
"type": "string"
},
{
"id": "obj-103",
"type": "string"
}
],
"tag_id": "obj-103"
}
]
}
Response Type:
Name | Type | Description |
---|---|---|
bold = required | ||
value | tag_to_objects[] | The array of the tag identifiers to all object identifiers that each tag is attached to. |
value[].tag_id | string | The identifier of the tag. This attribute was added in vSphere API 6.5 When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.cis.tagging.Tag . When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.cis.tagging.Tag . |
value[].object_ids | dynamic_ID[] | The identifiers of the related objects. This attribute was added in vSphere API 6.5 |
value[].object_ids[].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[].object_ids[].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. |