TaggingCategoryUpdateSpec

The Category.UpdateSpec structure describes the updates to be made to an existing category. Use the Category.update operation to modify a category. When you call the operation, specify the category identifier. You obtain the category identifier when you call the Category.create operation. You can also retrieve an identifier by using the Category.list operation.


Properties

array of string
associable_types Optional

Object types to which this category’s tags can be attached. The set of associable types cannot be updated incrementally. For example, if Category.UpdateSpec.associable-types originally contains {A,B,C} and you want to add D, then you need to pass {A,B,C,D} in your update specification. You also cannot remove any item from this set. For example, if you have {A,B,C}, then you cannot remove say {A} from it. Similarly, if you start with an empty set, then that implies that you can tag any object and hence you cannot later pass say {A}, because that would be restricting the type of objects you want to tag. Thus, associable types can only grow and not shrink.

If unset the associable types will not be modified.


cardinality Optional

The CategoryModel.Cardinality enumerated type defines the number of tags in a category that can be assigned to an object.
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.

Possible values are: SINGLEMULTIPLE


string
description Optional

The description of the category. If unset the description will not be modified.


string
name Optional

The display name of the category. If unset the name will not be modified.

JSON Example

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

Feedback

Was this page helpful?