com.vmware.cis.tagging.category

The category service provides operations to create, read, update, delete, and enumerate categories.

add_to_used_by

POST /com/vmware/cis/tagging/category/id:{category_id}?~action=add-to-used-by
POST /com/vmware/cis/tagging/category?~action=add-to-used-by

Adds the used_by_entity to the com.vmware.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 com.vmware.cis.tagging.category_model.used_by privilege on the category.
Request:
Representations:
{
    "category_id": "obj-103",
    "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>
  <category_id>obj-103</category_id>
</ns0:AddToUsedBy-Input>
POST /com/vmware/cis/tagging/category?~action=add-to-used-by
&used_by_entity=string
&category_id=obj-103

Parameters:
Name Type Required Description
category_id
 *
 ID Yes The identifier of the input category. Id of type com.vmware.cis.tagging.Category.
used_by_entity
 *
 string Yes The name of the user to be added to the com.vmware.cis.tagging.category_model.used_by set.

Response:
Representations:

Parameters:
Name Type Required Description
result VOID Yes

Errors:
Type Description HTTP Status Code
not_found if the category for the given category_id does not exist in the system. 404
unauthorized if you do not have the privilege to add an entity to the com.vmware.cis.tagging.category_model.used_by field. 403

Copyright © 2014. All Rights Reserved.