List Nodes

List Nodes

Returns information about all fabric nodes (hosts and edges).

Request
URI
GET
https://nsxmanager.your.domain/api/v1/fabric/nodes
COPY
Query Parameters
string
cursor
Optional

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

string
discovered_node_id
Optional

Id of the discovered node which was converted to create this node

string
display_name
Optional

HostNode display name

string
external_id
Optional

HostNode external id

string
hardware_id
Optional

Hardware Id of the host

string
hypervisor_os_type
Optional

HostNode's Hypervisor type, for example ESXi, RHEL KVM or UBUNTU KVM.

Possible values are : ESXI, RHELKVM, UBUNTUKVM, HYPERV,
string
included_fields
Optional

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

string
ip_address
Optional

Management IP address of the node

integer
page_size
Optional

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

string
resource_type
Optional

Node type from 'HostNode', 'EdgeNode', 'PublicCloudGatewayNode'

Possible values are : HostNode, EdgeNode, PublicCloudGatewayNode,
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 NodeListResult of type(s) application/json
This response body class contains all of the following: ListResult , InlineNodeListResult1 
{
    "_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,
    "results": [
        {
            "_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",
            "discovered_ip_addresses": [
                "string"
            ],
            "ip_addresses": [
                "string"
            ],
            "external_id": "string",
            "fqdn": "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

array of ApiError
related_errors
Optional

Other errors related to this 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

array of ApiError
related_errors
Optional

Other errors related to this 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

array of ApiError
related_errors
Optional

Other errors related to this 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

array of ApiError
related_errors
Optional

Other errors related to this 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

array of ApiError
related_errors
Optional

Other errors related to this 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

array of ApiError
related_errors
Optional

Other errors related to this 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


On This Page
Fabric Operations
POST
Add Compute Manager
POST
Add Node
POST
Create Compute Collection Fabric Template
DELETE
Delete Compute Collection Fabric Template
DELETE
Delete Compute Manager
DELETE
Delete Node
GET
Get Compute Collection Fabric Template
GET
Get Compute Manager State
GET
Get Fabric Node Modules
GET
Get Fabric Node State
POST
Host Prep Discovered Node Hostprep
GET
List Compute Collection Fabric Templates
GET
List Compute Collections
GET
List Compute Managers
GET
List Discovered Nodes
GET
List Fabric Node Interfaces
GET
List Node Capabilities
GET
List Nodes
GET
List Vifs
GET
List Virtual Machines
POST
Perform Host Node Upgrade Action Upgrade Infra
POST
Perform Node Action
GET
Read Compute Collection
GET
Read Compute Manager
GET
Read Compute Manager Status
GET
Read Discovered Node
GET
Read Fabric Node Interface
GET
Read Fabric Node Interface Statistics
GET
Read Node
GET
Read Nodes Status
GET
Read Node Status
POST
Restart Inventory Sync Restart Inventory Sync
PUT
Update Compute Collection Fabric Template
PUT
Update Compute Manager
PUT
Update Node
POST
Update Virtual Machine Tags Update Tags