System Administration > Configuration > Fabric > Nodes > Transport Nodes

Add or update deployment references of edge VM.

Populates placement references for edge node registered with identifier
at NSX Manager. NSX Manager will then report current state of the
VM and manage lifecycle operations like edit and delete of the specified
edge VM.
This internal API may be used to convert a manually deployed edge VM into
an NSX lifecycle-managed edge VM. The edge VM must be reachable from NSX
Manager.
NSX Manager fetches live configuration from the edge and vCenter Server
and reports the values in GET API for the following configuration.
NSX Manager fetches the following settings from the edge - hostname, NTP
servers, syslog servers, DNS servers, search domains and SSH.
NSX Manager fetches the following configuration from vCenter Server -
storage, networks, compute cluster, resource allocations and
reservation for CPU and memory.
NSX Manager saves fields that are not refreshed from sources external sources,
from the request payload itself. Fields include login credentials, resource pool,
static IP address, network interfaces with static port attachments and advanced
configuration section.
If these fields are configured on the edge and not specified in request
payload, then the converted edge would have gaps as compared to an NSX
Manager lifecycle-managed edge deployed with this configuration. Any gaps in
configuration would feature when consequent lifecycle operations are performed.

Request:

Method:
POST
URI Path(s):
/api/v1/transport-nodes/{node-id}?action=addOrUpdatePlacementReferences
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
TransportNodePlacementConfig+

Example Request:

POST https://<nsx-mgr>/api/v1/transport-nodes/8538f119-ba45-4fb1-9cf1-ee849e4cf168?action=addOrUpdatePlacementReferences { "vm_id":"vm-435", "vm_deployment_config": { "vc_id": "1307106d-6092-4417-b83d-4014cf618005", "compute_id": "domain-c7", "storage_id": "datastore-22", "management_network_id": "network-24", "data_network_ids": [ "network-24", "network-24" ], "reservation_info": { "memory_reservation": { "reservation_percentage": 100 }, "cpu_reservation": { "reservation_in_shares": "HIGH_PRIORITY" } }, "placement_type": "VsphereDeploymentConfig" }, "node_user_settings":{ "cli_username":"admin", "root_password":"Admin!23Admin", "cli_password":"Admin!23Admin" }, "node_settings": { "hostname": "statEdge", "enable_ssh": true, "allow_ssh_root_login": true, "advanced_configuration":[ { "key":"ovf-param:sddcMode", "value":"vmc" }, { "key":"ovf-param:nsx_vmc_nestdb_port_0", "value":"1235" } ] }, }

Successful Response:

Response Code:
200 OK
Response Headers:
n/a
Response Body:
n/a

Required Permissions:

crud

Feature:

nodes_edges

Additional Errors: