NSX-T Data Center REST API

Associated URIs:

API Description API Path

NSX-V setup details


Get setup details of NSX-V to be migrated.
GET /api/v1/migration/setup

Perform V2T migration steps on newly added Host Transport Node.


This API is to support the add Host workflow once the V2T migration process has started. The high level add host
workflow will be as follows.
1. Verify that overall migration status is in PAUSED state in migration co-ordinator.
2. Follow steps mentioned in product documentation to add a new host to cluster.
3. Invoke the migration co-ordinator sync HOST groups API. This will result in migration co-ordinator updating
its inventory and accouting for the newly added host transport node. At this point, the list host upgrade units
API call to MC will also show the newly added host transport node. But do NOT resume the migration. Since this
host transport node is added after the V2T migration has started, we need to perform migration steps on this host
through a special API (Accept Host Transport Node)
4. Invoke this API (Accept Host Transport Node) to perform the V2T migration steps on newly added host transport
node. Once the API is successful, we should be seeing that migration status has been marked as SUCCESS for the
newly added host transport node. Very Importnant Note : Make sure that migration status is PAUSED in migration
co-ordinator when performing steps 2 through 4. Also ensure that all the steps 2 through 4 pass without failures.

This API should be invoked only when
- The overall migration status is in PAUSED status.
- The migration mode selected has HOST component in it.
- All the migration stages before HOST stage are completed.
- The new host has been added to a cluster by following all the steps mentioned in product documentation.
POST /api/v1/migration/setup?action=migrate_newly_added_host_transport_node

Add NSX-V to NSX-T site mapping


Add NSX-V to NSX-T site mapping.
PUT /api/v1/migration/setup?action=addV2tSiteMapping

Add ALB endpoint details for non cross VC migration modes.


Add ALB endpoint details for non cross VC migration modes.
PUT /api/v1/migration/setup?action=addAlbInfo

Set the NSX-V ESG to NSX-T Router mapping option.


Set the NSX-V ESG to NSX-T Router mapping option.
PUT /api/v1/migration/setup?action=setEsgToRouterMappingOption

NSX-V setup details


Provide setup details of NSX-V to be migrated.
PUT /api/v1/migration/setup