Management Plane API >
Security
>
Services
>
Service Insertion
Get NSgroups for a given ServiceInstance.
Returns list of NSGroups used in Service Insertion North-South rules for a given
Service Instance.
Request:
Method:
GET
URI Path(s):
/api/v1/serviceinsertion/services/<service-id>/service-instances/<service-instance-id>/group-associations
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
n/a
Example Request:
GET https://<nsx-mgr>/api/v1/serviceinsertion/services/03a31751-beaa-4a75-a3c9-04043479f0ec/service-instances/e766bc2c-87d0-4ba6-874d-30953bf40741/group-associations
Successful Response:
Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
ServiceInstanceNSGroups
+
ServiceInstanceNSGroups
(
schema
)
Name
Description
Type
Notes
nsroups
NSGroup List
List of NSGroups Used in ServiceInsertion Rules.
array of
NSGroupInfo
Readonly
Example Response:
{ "nsgroups":[ { "nsgroup":{ "target_display_name":"Grp1", "is_valid":true, "target_type":"NSGroup", "target_id":"d4ecb8de-57e7-4809-b93a-f2f6991ad5ad" }, "nsgroup_policy_path":"/infra/domains/cgw/groups/multiple-expr-1" } ] }
Required Permissions:
read
Feature:
service_insertion
Additional Errors:
404 Not Found
301 Moved Permanently
307 Temporary Redirect
400 Bad Request
403 Forbidden
409 Conflict
500 Internal Server Error
503 Service Unavailable