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
Request
URI
POST
https://nsxmanager.your.domain/api/v1/ns-groups
COPY
Request Body
NSGroup of type(s) application/json
Optional
{
"_self": {
"action": "string",
"href": "string",
"rel": "string"
},
"_links": [
{
"action": "string",
"href": "string",
"rel": "string"
}
],
"_schema": "string",
"_revision": 0,
"_system_owned": false,
"display_name": "string",
"description": "string",
"tags": [
{
"scope": "string",
"tag": "string"
}
],
"_create_user": "string",
"_protection": "string",
"_create_time": 0,
"_last_modified_time": 0,
"_last_modified_user": "string",
"id": "string",
"resource_type": "string",
"member_count": 0,
"members": [
{
"resource_type": "string",
"target_resource": {
"target_display_name": "string",
"is_valid": false,
"target_id": "string",
"target_type": "string"
},
"target_property": "string",
"target_type": "string",
"value": "string",
"op": "string"
}
],
"membership_criteria": [
{
"resource_type": "string"
}
]
}
Responses
201
Created
Returns NSGroup of type(s) application/json
This response body class contains all of the following: ManagedResource , InlineNSGroup1
{
"_self": {
"action": "string",
"href": "string",
"rel": "string"
},
"_links": [
{
"action": "string",
"href": "string",
"rel": "string"
}
],
"_schema": "string",
"_revision": 0,
"_system_owned": false,
"display_name": "string",
"description": "string",
"tags": [
{
"scope": "string",
"tag": "string"
}
],
"_create_user": "string",
"_protection": "string",
"_create_time": 0,
"_last_modified_time": 0,
"_last_modified_user": "string",
"id": "string",
"resource_type": "string",
"member_count": 0,
"members": [
{
"resource_type": "string",
"target_resource": {
"target_display_name": "string",
"is_valid": false,
"target_id": "string",
"target_type": "string"
},
"target_property": "string",
"target_type": "string",
"value": "string",
"op": "string"
}
],
"membership_criteria": [
{
"resource_type": "string"
}
]
}
400
Returns BadRequest of type(s) application/json
{
"details": "string",
"related_errors": [
"ApiError Object"
],
"module_name": "string",
"error_message": "string",
"error_code": 0
}object
error_data
Optional
Additional data about the error
string
details
Optional
Further details about the error
string
module_name
Optional
The module name where the error occurred
string
error_message
Optional
A description of the error
integer As int64 As int64
error_code
Optional
A numeric error code
403
Returns Forbidden of type(s) application/json
{
"details": "string",
"related_errors": [
"ApiError Object"
],
"module_name": "string",
"error_message": "string",
"error_code": 0
}object
error_data
Optional
Additional data about the error
string
details
Optional
Further details about the error
string
module_name
Optional
The module name where the error occurred
string
error_message
Optional
A description of the error
integer As int64 As int64
error_code
Optional
A numeric error code
404
Returns NotFound of type(s) application/json
{
"details": "string",
"related_errors": [
"ApiError Object"
],
"module_name": "string",
"error_message": "string",
"error_code": 0
}object
error_data
Optional
Additional data about the error
string
details
Optional
Further details about the error
string
module_name
Optional
The module name where the error occurred
string
error_message
Optional
A description of the error
integer As int64 As int64
error_code
Optional
A numeric error code
412
Returns PreconditionFailed of type(s) application/json
{
"details": "string",
"related_errors": [
"ApiError Object"
],
"module_name": "string",
"error_message": "string",
"error_code": 0
}object
error_data
Optional
Additional data about the error
string
details
Optional
Further details about the error
string
module_name
Optional
The module name where the error occurred
string
error_message
Optional
A description of the error
integer As int64 As int64
error_code
Optional
A numeric error code
500
Returns InternalServerError of type(s) application/json
{
"details": "string",
"related_errors": [
"ApiError Object"
],
"module_name": "string",
"error_message": "string",
"error_code": 0
}object
error_data
Optional
Additional data about the error
string
details
Optional
Further details about the error
string
module_name
Optional
The module name where the error occurred
string
error_message
Optional
A description of the error
integer As int64 As int64
error_code
Optional
A numeric error code
503
Returns ServiceUnavailable of type(s) application/json
{
"details": "string",
"related_errors": [
"ApiError Object"
],
"module_name": "string",
"error_message": "string",
"error_code": 0
}object
error_data
Optional
Additional data about the error
string
details
Optional
Further details about the error
string
module_name
Optional
The module name where the error occurred
string
error_message
Optional
A description of the error
integer As int64 As int64
error_code
Optional
A numeric error code
Grouping Objects Operations
POST
Add MAC Address
POST
Add Or Remove NS Group Expression
POST
Create IP Set
POST
Create MAC Set
POST
Create NS Group
POST
Create NS Service
POST
Create NS Service Group
DELETE
Delete IP Set
DELETE
Delete MAC Set
DELETE
Delete NS Group
DELETE
Delete NS Service
DELETE
Delete NS Service Group
GET
Get Effective IP Address Members
GET
Get Effective Logical Port Members
GET
Get Effective Logical Switch Members
GET
Get Effective Virtual Machine Members
GET
Get MAC Addresses
GET
Get Member Types
GET
Get Service Associations
GET
Get Unassociated Virtual Machines
GET
List IP Sets
GET
List MAC Sets
GET
List NS Groups
GET
List NS Service Groups
GET
List NS Services
GET
Read IP Set
GET
Read MAC Set
GET
Read NS Group
GET
Read NS Service
GET
Read NS Service Group
DELETE
Remove MAC Address
PUT
Update IP Set
PUT
Update MAC Set
PUT
Update NS Group
PUT
Update NS Service
PUT
Update NS Service Group