5.5.1

2 Add another request header with the following values.
n
Name: accept
n
Value: */*
3 Make a POST request at the URL of the server configuration:
POST http://{vcoHost}:{port}/vco/api/server-configuration/
If the POST request is successful, you receive the status code 200.
Performing Tagging Operations
The Orchestrator REST API provides Web services that you can use to perform various operations to make
objects more searchable by using tags in Orchestrator.
You can make objects more searchable by attaching tags to them. Tags are strings with length between 3 and
64 characters and must contain no whitespace characters.
You can add global and private tags. Global tags are visible to all Orchestrator users and private tags are
visible only to the user who created them. Global tags can be created and removed only by users with
administrative privileges.
Tag an Object
You can assign tags to an object by using the Orchestrator REST API.
You can create both private and global tags. You specify whether the tag is private or global in the body of
the request.
NOTE To create global tags, you must be logged in as a user with administrative privileges.
You can also assign a value to the tag that you create. The value is an optional parameter that you can use to
filter tags.
Procedure
1 Define the request body by using the following syntax.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tag-instance xmlns="http://www.vmware.com/vco" global="false">
<name>tag_name</name>
<value>tag_value</value>
</tag-instance>
NOTE You can create a global tag by setting the global variable to "true".
2 Make a POST request at the URL of the object:
POST http://{vcoHost}:{port}/vco/api/catalog/{namespace}/{objectType}/{objectId}/tags
If the POST request is successful, you receive the status code 200.
Untag an Object
You can remove tags assigned to an object by using the Orchestrator REST API.
You can remove both private and global tags.
NOTE To remove global tags, you must be logged in as a user with administrative privileges.
Developing a Web Services Client for VMware vCenter Orchestrator
48 VMware, Inc.