To create a tenant with parameters inline, you first display all available tenants then request a new tenant with input parameters specified inline.

Before you begin

In addition to the Prerequisites for Creating a Tenant, verify that you have parameter values for the new tenant.

Procedure

  1. Use the identity service to display all the available tenants.
    curl --insecure -H "Accept:application/json" -H "Authorization: Bearer $token" https://$vRA/identity/api/tenants
    

    For details regarding input and output of this sample, see Syntax for Displaying Your Current Tenants.

  2. Examine the response to verify that the tenant you plan to create is not listed.

    See the output of the request to display all tenants Create a Tenant With Parameters Inline.

  3. Submit a request for a new tenant with parameters inline.
    curl -X PUT --insecure -H "Accept:application/json" -H "Content-Type: application/json" -H "Authorization: Bearer $token" https://$vRA/identity/api/tenants/rainpole --data '{"@type":"Tenant","id":"rainpole","urlName":"rainpole","name":"rainpoleTenant","description":"New Custom Tenant","contactEmail":"admin@vmware.com","defaultTenant":false}'

    For details regarding input and output of this sample, see Syntax for Requesting a New Tenant

  4. Use the identity service to display all the available tenants again.
    curl --insecure -H "Accept:application/json" -H "Authorization: Bearer $token" https://$vRA/identity/api/tenants
    
  5. Examine the response to verify that the tenant you requested is listed.

    See the output of the request to verify the new tenant is created Create a Tenant With Parameters Inline.

Create a Tenant With Parameters Inline

The following sample output for 1 lists three tenants.

curl --insecure -H "Accept:application/json" -H "Authorization: Bearer $token" https://$vRA/identity/api/tenants
{
   "links":[],
   "content"[
      {"@type":"Tenant",
       "id":"vsphere.local",
       "urlName":"vsphere.local",
       "name":"vsphere.local",
       "description":null,
       "contactEmail":null,
       "password":"",
       "defaultTenant":true},
      {"@type":"Tenant",
       "id":"qe",
       ...},
      {"@type":"Tenant",
       "id":"management",
       ...}
   ],
   "metadata":{"size":20,"totalElements":3,"totalPages":1,"number":1,"offset":0}
}

The following sample output for 3 shows that the tenant named rainpole has been created.

curl -X PUT --insecure -H "Accept:application/json" -H "Content-Type: application/json" -H "Authorization: Bearer $token" https://$vRA/identity/api/tenants/rainpole --data '{"@type":"Tenant","id":"rainpole","urlName":"rainpole","name":"rainpoleTenant","description":"New Custom Tenant","contactEmail":"admin@vmware.com","defaultTenant":false}'
{
   "id":"rainpole",
   "urlName":"rainpole",
   "name":"rainpoleTenant",
   "description":"New Custom Tenant",
   "contactEmail":"admin@vmware.com",
   "defaultTenant":false
}

The following sample output for 4 lists four tenants including rainpole.

curl --insecure -H "Accept:application/json" -H "Authorization: Bearer $token" https://$vRA/identity/api/tenants                                              
{
   "links":[],
   "content":[
      {"@type":"Tenant",
       "id":"vsphere.local",
       ...},
      {"@type":"Tenant",
       "id":"qe",
       ...},
      {"@type":"Tenant",
       "id":"management",
       ...},
      {"@type":"Tenant",
       "id":"rainpole",
       ...}
   ],
   "metadata":{"size":20,"totalElements":4,"totalPages":1,"number":1,"offset":0}
}