cis tagging category: remove from used by

Removes the used_by_entity from the cis.tagging.category_model.used_by subscribers set. If the used_by_entity is not using this category, then this becomes a no-op. To invoke this operation, you need the modify cis.tagging.category_model.used_by privilege on the category.


HTTP request

POST https://{server}/rest/com/vmware/cis/tagging/category/id:{category_id}?~action=remove-from-used-by

Path Parameters

Name Type Description
category_id string The identifier of the input category.

Request Body Structure:

<?xml version="1.0" ?>
<ns0:RemoveFromUsedBy-Input xmlns:ns0="" xmlns:xsi="">

Request Body Parameters:

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


HTTP Status Code: 200



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 remove an entity from the cis.tagging.category_model.used_by field.