You can use the Orchestrator REST API to retrieve a list of tag instances created by a specific user and filter the tags by tag name.

About this task

You can also retrieve global tag instances. Global tags are listed under the system user name __GLOBAL__.

Procedure

Make a GET request at the URL of the user.
  • To retrieve a filtered list of the tag instances created by a specific user, make a GET request by using the following syntax:

    GET http://{vcoHost}:{port}/vco/api/tags/{user_name}/{tag_name}
  • To retrieve a filtered list of global tag instances, make a GET request by using the following syntax:

    GET http://{vcoHost}:{port}/vco/api/tags/__GLOBAL__/{tag_name}

Results

If the GET request is successful, you receive the status code 200. The information that you retrieve contains a reference to the tagged object, tag name, tag value, and an indication whether the tag instance is global or private.