NSX-T Data Center REST API

Get groups for which the given bare metal server (BMS) is a member

Get policy groups for which the given bare metal server (BMS) is a member.
This API is only available when using VMware NSX.

Request:

Method:
GET
URI Path(s):
/policy/api/v1/infra/bms-group-associations
/policy/api/v1/global-infra/bms-group-associations
/policy/api/v1/orgs/{org-id}/projects/{project-id}/infra/bms-group-associations
Request Headers:
n/a
Query Parameters:
BareMetalServerGroupAssociationRequestParams+
Request Body:
n/a

Example Request:

GET https://<policy-mgr>/policy/api/v1/infra/bms-group-associations?bms_external_id=564de333-15ac-de52-da90-974fe099a17b&enforcement_point_path=/infra/sites/default/enforcement-points/ep1

Successful Response:

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

Example Response:

{ "result_count": 2, "results": [ { { "path" : "/infra/domains/domain1/groups/g1", "target_id" : "g1", "target_display_name" : "group-1", "target_type" : "DOMAIN_GROUP", "is_valid" : "true", "owner_id": "4c5c5516-087a-47cd-9fba-a7669775d308", "origin_site_id": "4c5c5516-087a-47cd-9fba-a7669775d308" }, { "path" : "/infra/domains/domain1/groups/g2", "target_id" : "g2", "target_display_name" : "group-2", "target_type" : "DOMAIN_GROUP", "is_valid" : "true", "owner_id": "4c5c5516-087a-47cd-9fba-a7669775d308", "origin_site_id": "4c5c5516-087a-47cd-9fba-a7669775d308" } } ] }

Required Permissions:

read

Feature:

policy_grouping

Additional Errors: