Policy > Infra > Tags

List all unique tags.

Returns paginated list of all unique tags. Supports filtering by scope, tag and
source from which tags are synched. Supports starts with, equals and
contains operators on scope and tag values.
To filter tags by starts with on scope or tag, use '*' as prefix before the value.
To filter tags by ends with on scope or tag, use '*' as suffix after the value.
To filter tags by contain on scope or tag, use '*' as prefix and suffix on the value.
Below special characters in the filter value needs to be escaped with hex values.
- Character '&' needs to be escaped as '%26'
- Character '[' needs to be escaped as '%5B'
- Character ']' needs to be escaped as '%5D'
- Character '+' needs to be escaped as '%2B'
- Character '#' needs to be escaped as '%23'

Request:

Method:
GET
URI Path(s):
/policy/api/v1/infra/tags
/policy/api/v1/global-infra/tags
Request Headers:
n/a
Query Parameters:
TagInfoListRequestParameters+
Request Body:
n/a

Example Request:

GET https://<policy-mgr>/policy/api/v1/infra/tags

Successful Response:

Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
TagInfoListResult+

Example Response:

{ "results": [ { "scope": "os", "tag": "windows", "tagged_objects": 250 }, { "scope": "os", "tag": "ubantu", "tagged_objects": 100 } ], "result_count": 2 } { "results": [ { "scope": "os", "tag": "windows", "tagged_objects": 250 } ], "result_count": 1 } { "results": [ { "scope": "os", "tag": "ubantu", "tagged_objects": 100 } ], "result_count": 1 }

Required Permissions:

read

Feature:

policy_vm_vm_tags

Additional Errors: