You can register an NSX-T Manager instance with your cloud so that you can create Provider VDCs backed by this NSX-T Manager instance and import logical switches as organization networks.

If you want to use a logical switch from an NSX-T Manager instance as an organization network in your cloud, you must first register an NSX-T Manager instance, then create provider and organization VDCs backed by this NSX-T Manager instance.

This operation is restricted to system administrators.

Verify that you know the IP address and administrator credentials for the NSX-T Manager instance.

1

Retrieve the XML representation of the cloud extension objects and operations.

Use a request similar to:

GET https://vcloud.example.com/api/admin/extension

The response contains a Link element for retrieving NSX-T Manager instances and operations similar to:

<Link
   type="application/vnd.vmware.admin.networkManagers+xml"
   rel="down"
   href="https://vcloud.example.com/api/admin/extension/nsxtManagers"/>
2

Retrieve the XML representation of the NSX-T Manager instances and operations by using the URL from the response in Step 1.

Use a request similar to:

GET https://vcloud.example.com/api/admin/extension/nsxtManagers
Content-Type: application/vnd.vmware.admin.networkManagers+xml
...

The response contains a Link element for adding NSX-T Manager instances similar to:

<Link
   type="application/vnd.vmware.admin.nsxTmanager+xml"
   rel="add"
   href="https://vcloud.example.com/api/admin/extension/nsxtManagers"/>
3

Create an NsxTManager element that includes the information required to register the NSX-T Manager instance.

4

POST the NsxTManager element that you created in Step 3 to the URL from the response in Step 2.

See the request portion of Example: Register an NSX-T Manager Instance.

You must supply the user name and password of the NSX-T Manager administrator in the request. The response includes NSX-T Data Center URLs for the newly registered NSX-T Manager instance, and omits the password.

Request:

POST https://vcloud.example.com/api/admin/extension/nsxtManagers
Content-Type: application/vnd.vmware.admin.nsxTmanager+xml
...
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:NsxTManager
   xmlns="http://www.vmware.com/vcloud/v1.5"
   xmlns:ns2="http://www.vmware.com/vcloud/extension/v1.5"
   name="nsxManager1">
   <Description>NSX-T Manager</Description>
   <ns2:Username>admin</ns2:Username>
   <ns2:Password>Welcome@123</ns2:Password>
   <ns2:Url>https://10.100.121.67</ns2:Url>
</ns2:NsxTManager>

Response:

200 OK
Content-Type: application/vnd.vmware.admin.networkmanagers+xml;version=31.0
...
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<vmext:NsxTManager
   xmlns="http://www.vmware.com/vcloud/v1.5"
   xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
   name="nsxManager1"
   id="urn:vcloud:nsxtmanager:24"
   type="application/vnd.vmware.admin.nsxTmanager+xml"
   <Link
      rel="edit"
      href="http://www.vmware.com/api/admin/extension/nsxtManagers/24
      type="application/vnd.vmware.admin.nsxTmanager+xml"/>
   <Link
      rel="remove"
      href="http://www.vmware.com/api/admin/extension/nsxtManagers/24
      type="application/vnd.vmware.admin.nsxTmanager+xml"/>
   <Link
      rel="up"
      href="https://wdc-vcd-sp-static-34-90.eng.vmware.com/api/admin/extension/nsxtManagers"
      type="application/vnd.vmware.admin.networkManagers+xml"/>
   <Description>NSX-T Manager</Description>
   <vmext:Username>admin</vmext:Username>
   <vmext:Url>https://10.100.121.67</vmext:Url>
</vmext:NsxTManager>

Create a provider VDC backed by the registered NSX-T Data Center instance.