NSX-T Data Center REST API

Get groups for which the given VM is a member

Get policy groups for which the given VM is a member.

Request:

Method:
GET
URI Path(s):
/policy/api/v1/orgs/{org-id}/projects/{project-id}/vpcs/{vpc-id}/virtual-machine-group-associations
Request Headers:
n/a
Query Parameters:
VMGroupAssociationRequestParams+
Request Body:
n/a

Example Request:

GET https://<policy-mgr>/policy/api/v1/orgs/default/projects/project-1/vpcs/vpc-1/virtual-machine-group-associations?vm_external_id=9165aa7d-af37-4ed1-b3fd-d81836a40620

Successful Response:

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

Example Response:

{ "results": [ { "target_id": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/vm-name-group-1", "target_display_name": "g1", "target_type": "VPC_GROUP", "is_valid": true, "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/vm-name-group-1" }, { "target_id": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/vm-name-group-2", "target_display_name": "vm-name-group-2", "target_type": "VPC_GROUP", "is_valid": true, "path": "/orgs/default/projects/project-1/vpcs/vpc-1/groups/vm-name-group-2" } ], "result_count": 5, "sort_by": "target_display_name", "sort_ascending": true, "cursor": "00012" }

Required Permissions:

read

Feature:

policy_grouping

Additional Errors: