List Tags by Users Filtered by Tag Name

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

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 https://{orchestrator_fqdn}/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 https://{orchestrator_fqdn}/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.