REST API - list_used_categories

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

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

Representation:

{
    "value"[
        "obj-103",
        "obj-103"
    ]
}

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.

Errors:

None