Get Unassociated Virtual Machines

Get Unassociated Virtual Machines

Get the list of all the virtual machines that are not a part of any existing NSGroup.

Request
URI
GET
https://nsxmanager.your.domain/api/v1/ns-groups/unassociated-virtual-machines
COPY
Query Parameters
string
cursor
Optional

Opaque cursor to be used for getting next page of records (supplied by current result page)

string
display_name
Optional

Display Name of the virtual machine

string
external_id
Optional

External id of the virtual machine

string
host_id
Optional

Id of the host where this vif is located

string
included_fields
Optional

Comma separated list of fields that should be included in query result

integer
page_size
Optional

Maximum number of results to return in this page (server may return fewer)

boolean
sort_ascending
Optional

sort_ascending

string
sort_by
Optional

Field by which records are sorted

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns UnassociatedVMListResult of type(s) application/json
This response body class contains all of the following: ListResult , InlineUnassociatedVMListResult1 
{
    "_self": {
        "action": "string",
        "href": "string",
        "rel": "string"
    },
    "_links": [
        {
            "action": "string",
            "href": "string",
            "rel": "string"
        }
    ],
    "_schema": "string",
    "cursor": "string",
    "sort_ascending": false,
    "sort_by": "string",
    "result_count": 0,
    "last_update_timestamp": 0,
    "results": [
        {
            "_self": {
                "action": "string",
                "href": "string",
                "rel": "string"
            },
            "_links": [
                {
                    "action": "string",
                    "href": "string",
                    "rel": "string"
                }
            ],
            "_schema": "string",
            "_last_sync_time": 0,
            "display_name": "string",
            "description": "string",
            "resource_type": "string",
            "tags": [
                {
                    "scope": "string",
                    "tag": "string"
                }
            ],
            "source": {
                "target_display_name": "string",
                "is_valid": false,
                "target_id": "string",
                "target_type": "string"
            },
            "local_id_on_host": "string",
            "type": "string",
            "power_state": "string",
            "compute_ids": [
                "string"
            ],
            "host_id": "string",
            "external_id": "string"
        }
    ]
}

400
Returns BadRequest of type(s) application/json
This response body class contains all of the following: RelatedApiError , InlineApiError1 
{
    "module_name": "string",
    "error_message": "string",
    "error_code": 0,
    "details": "string",
    "related_errors": [
        {
            "module_name": "string",
            "error_message": "string",
            "error_code": 0,
            "details": "string"
        }
    ]
}

403
Returns Forbidden of type(s) application/json
This response body class contains all of the following: RelatedApiError , InlineApiError1 
{
    "module_name": "string",
    "error_message": "string",
    "error_code": 0,
    "details": "string",
    "related_errors": [
        {
            "module_name": "string",
            "error_message": "string",
            "error_code": 0,
            "details": "string"
        }
    ]
}

404

Not Found

Operation doesn't return any data structure

412
Returns PreconditionFailed of type(s) application/json
This response body class contains all of the following: RelatedApiError , InlineApiError1 
{
    "module_name": "string",
    "error_message": "string",
    "error_code": 0,
    "details": "string",
    "related_errors": [
        {
            "module_name": "string",
            "error_message": "string",
            "error_code": 0,
            "details": "string"
        }
    ]
}

500
Returns InternalServerError of type(s) application/json
This response body class contains all of the following: RelatedApiError , InlineApiError1 
{
    "module_name": "string",
    "error_message": "string",
    "error_code": 0,
    "details": "string",
    "related_errors": [
        {
            "module_name": "string",
            "error_message": "string",
            "error_code": 0,
            "details": "string"
        }
    ]
}

503
Returns ServiceUnavailable of type(s) application/json
This response body class contains all of the following: RelatedApiError , InlineApiError1 
{
    "module_name": "string",
    "error_message": "string",
    "error_code": 0,
    "details": "string",
    "related_errors": [
        {
            "module_name": "string",
            "error_message": "string",
            "error_code": 0,
            "details": "string"
        }
    ]
}

On This Page
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