Create a Post
Showing results for 
Search instead for 
Did you mean: 

How does the API work in a multi domain environment?

In a multi-domain environment there is one API server.

Turning this server on/off is done on the MDS level.

When you login using mgmt_cli always provide the IP address of the MDS server and provide the domain name.

For example:

  • mgmt_cli login user <my name> password <my password> domain <my domain name> -m <IP address or DNS name of the MDS>
  • mgmt_cli add-host name <host name> ip-address <ip-address of the new host> -u <username> -p <password> -d <domain name> -m <IP address or DNS name of the MDS>

When using the login API without providing the domain name, you will be logged in to the MDS.

Similarly when making a web-service requests:

* The URL of the request should point to the MDS

* In the login API, provide the domain name as an argument.

For example:




     Content-Type: application/json



  "user" : "myuser",

  "password" : "mypassword",

  "domain" : "my domain name"


2 Replies

Glad I found this post. I was trying to figure out why I wasn't seeing objects I would create VIA the API wouldn't show up in the GUI. Specifying the domain fixed that.

Where was I creating objects when I wasn't specifying the domain?


Thanks for posting this. This is not explained even in the official documentation . 

Saved a lot of time . 

0 Kudos


Epsum factorial non deposit quid pro quo hic escorol.

Upcoming Events

    CheckMates Events