You can use the REST API identity service to list of all the vRealize Automation tenants in your system.
Input
Use the supported input parameters to control the command output.
Parameter |
Description |
---|---|
URL |
https://$host/identity/api/tenants |
$host |
Specifies the host name and fully qualified domain name or IP address of the vRealize Automation identity server. |
$token |
Specifies a valid HTTP bearer token with necessary credentials. |
Output
The command output contains property names and values based on the command input parameters.
Parameter |
Description |
---|---|
Links |
Specifies an array of link objects, each of which contains the following parts:
|
Content |
Specifies an array of data rows, each of which represents one of the tenant objects returned in a pageable list. Each tenant object can contain the following information:
|
Metadata |
Specifies the following paging-related data:
|
curl Command
The following example command displays all available tenants.
curl --insecure -H "Accept:text/xml" -H "Authorization: Bearer $token" https://$host/identity/api/tenants
Format the XML output to improve its readability. For information about formatting output, see Filtering and Formatting REST API Information.
JSON Output
The following JSON output is returned based on the command input.
{ "links" : [ ], "content" : [ { "@type" : "Tenant", "id" : "vsphere.local", "urlName" : "vsphere.local", "name" : "vsphere.local", "description" : null, "contactEmail" : null, "password" : null, "defaultTenant" : true }, { "@type" : "Tenant", "id" : "MYCOMPANY", "urlName" : "MYCOMPANY", "name" : "QETenant", "description" : "Test tenant", "contactEmail" : null, "password" : "defaultPwd#1", "defaultTenant" : false } ], "metadata" : { "size" : 19, "totalElements" : 2, "totalPages" : 1, "number" : 1, "offset" : 0 } }