com.vmware.cis.tagging.tag

The tag service provides operations to create, read, update, delete, and enumerate tags.

update

PATCH /com/vmware/cis/tagging/tag/id:{tag_id}
POST /com/vmware/cis/tagging/tag/id:{tag_id}?~action=update
POST /com/vmware/cis/tagging/tag?~action=update

Updates an existing tag. To invoke this operation, you need the edit privilege on the tag.
Request:
Representations:
{
    "tag_id": "obj-103",
    "update_spec": {
        "description": "string",
        "name": "string"
    }
}
<?xml version="1.0" ?>
<ns0:Update-Input xmlns:ns0="http://vmware.com/cis/tagging/tag" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <update_spec>
    <description>string</description>
    <name>string</name>
  </update_spec>
  <tag_id>obj-103</tag_id>
</ns0:Update-Input>
POST /com/vmware/cis/tagging/tag?~action=update
&update_spec.description=string
&update_spec.name=string
&tag_id=obj-103

Parameters:
Name Type Required Description
tag_id
 *
 ID Yes The identifier of the input tag. Id of type com.vmware.cis.tagging.Tag.
update_spec
 *
 update_spec Yes Specification to update the tag.

Response:
Representations:

Parameters:
Name Type Required Description
result VOID Yes

Errors:
Type Description HTTP Status Code
already_exists if the com.vmware.cis.tagging.tag.update_spec.name provided in the update_spec is the name of an already existing tag in the same category. 400
invalid_argument if any of the input information in the update_spec is invalid. 400
not_found if the tag for the given tag_id does not exist in the system. 404
unauthorized if you do not have the privilege to update the tag. 403

Copyright © 2014. All Rights Reserved.