Create a Tenant With Parameters Inline

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

Prerequisites

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

Procedure

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.
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.

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":"[email protected]","defaultTenant":false}'

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

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

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.

Example: Create a Tenant With Parameters Inline

The following sample output for Step 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 Step 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":"[email protected]","defaultTenant":false}'
{
   "id":"rainpole",
   "urlName":"rainpole",
   "name":"rainpoleTenant",
   "description":"New Custom Tenant",
   "contactEmail":"[email protected]",
   "defaultTenant":false
}

The following sample output for Step 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}
}