com.vmware.cis.tagging.category

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

create

POST /com/vmware/cis/tagging/category
POST /com/vmware/cis/tagging/category?~action=create

Creates a category. To invoke this operation, you need the create category privilege.
Request:
Representations:
{
    "create_spec": {
        "associable_types": [
            "string",
            "string"
        ],
        "cardinality": "SINGLE",
        "description": "string",
        "name": "string"
    }
}
<?xml version="1.0" ?>
<ns0:Create-Input xmlns:ns0="http://vmware.com/cis/tagging/category" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <create_spec>
    <associable_types-array>
      <array-item>string</array-item>
      <array-item>string</array-item>
    </associable_types-array>
    <description>string</description>
    <name>string</name>
    <cardinality>SINGLE</cardinality>
  </create_spec>
</ns0:Create-Input>
POST /com/vmware/cis/tagging/category
?create_spec.associable_types.1=string
&create_spec.associable_types.2=string
&create_spec.description=string
&create_spec.name=string
&create_spec.cardinality=SINGLE

Parameters:
Name Type Required Description
create_spec
 *
 create_spec Yes Specification for the new category to be created.

Response:
Representations:
{
    "value": "obj-103"
}
<?xml version="1.0" ?>
<ns0:Create-Result xmlns:ns0="http://vmware.com/cis/tagging/category" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <value>obj-103</value>
</ns0:Create-Result>

Parameters:
Name Type Required Description
result ID Yes The identifier of the created category. Id of type com.vmware.cis.tagging.Category.

Errors:
Type Description HTTP Status Code
already_exists if the com.vmware.cis.tagging.category.create_spec.name provided in the create_spec is the name of an already existing category. 400
invalid_argument if any of the information in the create_spec is invalid. 400
unauthorized if you do not have the privilege to create a category. 403

Copyright © 2014. All Rights Reserved.