Adding an LDAP domain to NSX Manager via REST call

If you’re using NSX Manager 6.1.x (mine is 6.1.4) and you try to add an LDAP domain you might encounter the following error:

A quick Google search and you realise this is a known bug affecting 6.1.x

https://www.vmware.com/support/nsx/doc/releasenotes_nsx_vsphere_620.html

Really VMware? #facepalm Pretty annoying to be honest, this seems a pretty basic functionality that should have been tested by the QA team – cough – QA what ? cough.

Anyway, as I’m preparing for my VCIX-NV I haven’t got much time to “waste” and decided to do it via REST call.

So using the official API documentation I found there is this updateDomain API call

Well, I’m going to keep this post short and straightfoward: the following xml code provided in the documentation is wrong!

<?xml version="1.0" encoding="UTF-8"?>
 <?xml version="1.0" encoding="UTF-8"?>
 <DirectoryDomain>
 <name>corp.local</name>
 <type>ActiveDirectory</type>
 <netbiosName>CORP</netbiosName>
 <username>Administrator</username>
 <password>VMWare1!</password>
 </DirectoryDomain>

if you try to execute a POST (using your favouring REST client, Postman for me) you’ll get a nice 404 error

After some playing and guessing the code that worked for me was the following

<DirectoryDomain>
<name>corp.local</name>
<type>ACTIVE_DIRECTORY</type>
<netbiosName>CORP</netbiosName>
<username>Administrator</username>
<password>VMWare1!</password>
</DirectoryDomain>