REST API - create

create_spec

The create_spec structure is used to create a category.

Use the create operation to create a category defined by the create specification.

Representations:

JSON
XML

{
    "associable_types": [
        "string",
        "string"
    ],
    "cardinality": "SINGLE",
    "description": "string",
    "name": "string"
}

<?xml version="1.0" ?>
<ns0:CreateSpec xmlns:ns0="http://vmware.com/cis/tagging/category" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <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>
</ns0:CreateSpec>

Attributes:

Name	Type	Required	Description
name *	string	Yes	The display name of the category.
description *	string	Yes	The description of the category.
cardinality *	com.vmware.cis.tagging.category_model.cardinality	Yes	The associated cardinality (`SINGLE`, `MULTIPLE`) of the category. The `cardinality` enumerated type defines the number of tags in a category that can be assigned to an object. Values one of SINGLE: An object can only be assigned one of the tags in this category. For example, if a category is "Operating System", then different tags of this category would be "Windows", "Linux", and so on. In this case a VM object can be assigned only one of these tags and hence the cardinality of the associated category here is single. MULTIPLE: An object can be assigned several of the tags in this category. For example, if a category is "Server", then different tags of this category would be "AppServer", "DatabaseServer" and so on. In this case a VM object can be assigned more than one of the above tags and hence the cardinality of the associated category here is multiple.
associable_types *	Set<string>	Yes	Object types to which this category's tags can be attached.

com.vmware.cis.tagging.category

create_spec