NSX-T Data Center REST API

Move host from one sub-cluster to another sub-cluster. When a node is moved from one sub-cluster to another sub-cluster, based on the TransportNodeCollection configuration appropriate sub-configuration will be applied to the node. If TransportNodeCollection does not have sub-configurations for the sub-cluster, then global configuration will be applied.

Request:

Method:

POST

URI Path(s):

/policy/api/v1/infra/sites/{site-id}/enforcement-points/{enforcementpoint-id}/sub-clusters?action=move

Request Headers:

n/a

Query Parameters:

n/a

Request Body:

HostMovementSpec+

HostMovementSpec (schema)

Name	Description	Type	Notes
destination	Destination sub-cluster of hosts This is the policy path of destination sub-cluster to which hosts will be moved to. If this value is null, then we assume the host is moved into the cluster.	string
discovered_node_ids	Discovered node IDs Discovered node IDs to be moved.	array of string	Required
source	Source sub-cluster of hosts This is the policy path of source sub-cluster from which hosts are moved out	string	Required

Example Request:

POST https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/sub-clusters?action=move "source": "/infra/sites/default/enforcement-points/default/sub-clusters/subcluster-1" "destination": "/infra/sites/default/enforcement-points/default/sub-clusters/subcluster-2" "discovered_node_ids": [ "57e6560e-acd3-4783-baa0-59143307524b:host-1043", "47e6560e-acd3-4783-baa0-59143307524b:host-1044", "37e6560e-acd3-4783-baa0-59143307524b:host-1045" ]

Successful Response:

Response Code:

201 Created

Response Headers:

n/a

Response Body:

n/a

Required Permissions:

crud

Feature:

nodes_transport_nodes

Additional Errors:

• 301 Moved Permanently
• 307 Temporary Redirect
• 400 Bad Request
• 403 Forbidden
• 409 Conflict
• 412 Precondition Failed
• 500 Internal Server Error
• 503 Service Unavailable