Create NS Group

Creates a new NSGroup that can group NSX resources - VIFs, Lports and LSwitches as well as the grouping objects - IPSet, MACSet and other NSGroups. For NSGroups containing VM criteria(both static and dynamic), system VMs will not be included as members. This filter applies at VM level only. Exceptions are as follows:

LogicalPorts and VNI of System VMs will be included in NSGroup if the criteria is based on LogicalPort, LogicalSwitch or VNI directly.

This API is deprecated. Please use below policy API /infra/domains//groups/ to create Group.

Request

URI

POST

https://nsxmanager.your.domain/api/v1/ns-groups

COPY

Request Body

NSGroup of type(s) application/json

Optional

{
    "_links": [
        {
            "action": "string",
            "href": "string",
            "rel": "string"
        }
    ],
    "_schema": "string",
    "_self": {},
    "_revision": 0,
    "_create_time": 0,
    "_create_user": "string",
    "_last_modified_time": 0,
    "_last_modified_user": "string",
    "_protection": "string",
    "_system_owned": false,
    "description": "string",
    "display_name": "string",
    "id": "string",
    "resource_type": "string",
    "tags": [
        {
            "scope": "string",
            "tag": "string"
        }
    ],
    "member_count": 0,
    "members": [
        {
            "resource_type": "string",
            "op": "string",
            "target_property": "string",
            "target_resource": {
                "is_valid": false,
                "target_display_name": "string",
                "target_id": "string",
                "target_type": "string"
            },
            "target_type": "string",
            "value": "string"
        }
    ],
    "membership_criteria": [
        {
            "resource_type": "string"
        }
    ]
}

Authentication

This operation uses the following authentication methods.

BasicAuth

Responses

201

Created

Returns NSGroup of type(s) application/json

This response body class contains all of the following: InlineNSGroup1

"NSGroup Object"

400

Returns BadRequest of type(s) application/json