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.
Request:
HTTP request
POST https://{server}/rest/com/vmware/cis/tagging/category/id:{category_id}?~action=remove-from-used-by
Path Parameters
| Name | Type | Description |
|---|---|---|
| Required | ||
| category_id | string | The identifier of the input category. |
Request Body Structure:
{
"used_by_entity": "string"
}
"used_by_entity": "string"
}
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. |
Response:
HTTP Status Code: 200
NoneErrors:
| 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. |