cis tagging tag: list used tags

Enumerates all tags for which the used_by_entity is part of the cis.tagging.tag_model.used_by subscribers set. To invoke this operation, you need the read privilege on the individual tags.

Request:

HTTP request

POST https://{server}/rest/com/vmware/cis/tagging/tag?~action=list-used-tags

Request Body Structure:

{
    "used_by_entity""string"
}
<?xml version="1.0" ?>
<ns0:ListUsedTags-Input xmlns:ns0="http://vmware.com/cis/tagging/tag" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <used_by_entity>string</used_by_entity>
</ns0:ListUsedTags-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"
    ]
}
<?xml version="1.0" ?>
<ns0:ListUsedTags-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:ListUsedTags-Result>

Response Type:

Name Type Description
bold = required
value string[] The array of resource identifiers for the tags in the system that are used by used_by_entity.

Errors:

None