NSX-T Data Center REST API

List all objects assigned with matching scope and tag values

Paginated list of all objects assigned with matching scope and tag values. Objects
are represented in form of resource reference. Sort option is available only on
target_type and target_display_name properties.

Request:

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

Example Request:

GET https://<policy-mgr>/policy/api/v1/infra/tags/effective-resources?scope=type&tag=app

Successful Response:

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

Example Response:

{ "results": [ { "target_type": "VirtualMachine", "target_display_name": "App-VM-1", "target_id": "564d8b81-983d-b8ef-686b-161205939c58" }, { "target_type": "Group", "target_display_name": "app-vms", "path": "/infra/domains/default/groups/app-vms" } ], "result_count": 2 }

Required Permissions:

read

Feature:

policy_vm_vm_tags

Additional Errors: