REST API - add_to_used_by

cis tagging tag: add to used by

Adds the used_by_entity to the cis.tagging.tag_model.used_by subscribers set. If the used_by_entity is already in the set, then this becomes a no-op. To invoke this operation, you need the modify cis.tagging.tag_model.used_by privilege on the tag.

Request:

HTTP request

POST https://{server}/rest/com/vmware/cis/tagging/tag/id:{tag_id}?~action=add-to-used-by

Path Parameters

Name Type Description
Required
tag_id string The identifier of the input tag.

Request Body Structure:

{
    "used_by_entity""string"
}

Request Body Parameters:

Name Type Description
bold = required
used_by_entity string The name of the user to be added to the cis.tagging.tag_model.used_by set.

Response:

HTTP Status Code: 200

None

Errors:

HTTP Status Code Type Description
404 not_found if the tag for the given tag_id does not exist in the system.
403 unauthorized if you do not have the privilege to add an entity to the cis.tagging.tag_model.used_by field.