cis tagging category: list used categories
Enumerates all categories for which the
used_by_entity
is part of the cis.tagging.category_model.used_by subscribers set. To invoke this operation, you need the read privilege on the individual categories.
Request:
HTTP request
POST https://{server}/rest/com/vmware/cis/tagging/category?~action=list-used-categories
Request Body Structure:
{
"used_by_entity": "string"
}
"used_by_entity": "string"
}
<?xml version="1.0" ?>
<ns0:ListUsedCategories-Input xmlns:ns0="http://vmware.com/cis/tagging/category" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<used_by_entity>string</used_by_entity>
</ns0:ListUsedCategories-Input>
<ns0:ListUsedCategories-Input xmlns:ns0="http://vmware.com/cis/tagging/category" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<used_by_entity>string</used_by_entity>
</ns0:ListUsedCategories-Input>
Request Body Parameters:
Name | Type | Description |
---|---|---|
bold = required | ||
used_by_entity | string | The field on which the results will be filtered. |
Response:
HTTP Status Code: 200
Representations:
{
"value": [
"obj-103",
"obj-103"
]
}
"value": [
"obj-103",
"obj-103"
]
}
<?xml version="1.0" ?>
<ns0:ListUsedCategories-Result xmlns:ns0="http://vmware.com/cis/tagging/category" 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:ListUsedCategories-Result>
<ns0:ListUsedCategories-Result xmlns:ns0="http://vmware.com/cis/tagging/category" 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:ListUsedCategories-Result>
Response Type:
Name | Type | Description |
---|---|---|
bold = required | ||
value | string[] | The array of resource identifiers for the categories in the system that are used by used_by_entity . |