cis tagging tag: list tags for category
Enumerates all tags for the given category. To invoke this operation, you need the read privilege on the given category and the individual tags in that category.
Request:
HTTP request
POST https://{server}/rest/com/vmware/cis/tagging/tag/id:{category_id}?~action=list-tags-for-category
Path Parameters
| Name | Type | Description |
|---|---|---|
| Required | ||
| category_id | string | The identifier of the input category. |
Response:
HTTP Status Code: 200
Representations:
{
"value": [
"obj-103",
"obj-103"
]
}
"value": [
"obj-103",
"obj-103"
]
}
<?xml version="1.0" ?>
<ns0:ListTagsForCategory-Result xmlns:ns0="http://vmware.com/cis/tagging/tag" 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:ListTagsForCategory-Result>
<ns0:ListTagsForCategory-Result xmlns:ns0="http://vmware.com/cis/tagging/tag" 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:ListTagsForCategory-Result>
Response Type:
| Name | Type | Description |
|---|---|---|
| bold = required | ||
| value | string[] | The array of resource identifiers for the tags in the given input category. |
Errors:
| HTTP Status Code | Type | Description |
|---|---|---|
| 404 | not_found | if the category for the given category_id does not exist in the system. |
| 403 | unauthorized | if you do not have the privilege to read the category. |