cis tagging category: add to used by
Adds the
used_by_entity
to the cis.tagging.category_model.used_by subscribers set for the specified category. If the used_by_entity
is already in the set, then this becomes an idempotent 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=add-to-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"
}
<?xml version="1.0" ?>
<ns0:AddToUsedBy-Input xmlns:ns0="http://vmware.com/cis/tagging/category" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<used_by_entity>string</used_by_entity>
</ns0:AddToUsedBy-Input>
<ns0:AddToUsedBy-Input xmlns:ns0="http://vmware.com/cis/tagging/category" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<used_by_entity>string</used_by_entity>
</ns0:AddToUsedBy-Input>
Request Body Parameters:
Name | Type | Description |
---|---|---|
bold = required | ||
used_by_entity | string | The name of the user to be added to 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 add an entity to the cis.tagging.category_model.used_by field. |