Add Node | NSX-T Data Center REST API

Add Node

Creates a host node (hypervisor) or edge node (router) in the transport network.

When you run this command for a host, NSX Manager attempts to install the NSX kernel modules, which are packaged as VIB, RPM, or DEB files. For the installation to succeed, you must provide the host login credentials and the host thumbprint.

To get the ESXi host thumbprint, SSH to the host and run the openssl x509 -in /etc/vmware/ssl/rui.crt -fingerprint -sha256 -noout command.

To generate host key thumbprint using SHA-256 algorithm please follow the steps below.

Log into the host, making sure that the connection is not vulnerable to a man in the middle attack. Check whether a public key already exists. Host public key is generally located at '/etc/ssh/ssh_host_rsa_key.pub'. If the key is not present then generate a new key by running the following command and follow the instructions.

ssh-keygen -t rsa

Now generate a SHA256 hash of the key using the following command. Please make sure to pass the appropriate file name if the public key is stored with a different file name other than the default 'id_rsa.pub'.

awk '{print $2}' id_rsa.pub | base64 -d | sha256sum -b | sed 's/ .*$//' | xxd -r -p | base64

Request

URI

POST

https://nsxmanager.your.domain/api/v1/fabric/nodes

COPY

Request Body

Node of type(s) application/json

Optional

This request body class requires all of the following: ManagedResource , InlineNode1

{
    "_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"
}

Authentication

This operation uses the following authentication methods.

BasicAuth

Responses

201

Created

Returns Node of type(s) application/json

This response body class contains all of the following: ManagedResource , InlineNode1

{
    "_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