Get Tenant Info

Returns detailed tenant info.

Endpoint

https://<Director_IP_address>:4443/c/router

Request Example

Request Fields

Field
Type
Value(s)
Description
action string
 MultitenancyManagement
The action that is invoked
method string
 getTenants
The method that is invoked
data array
Filter parameters. See the filter table below
type string rpc Type of communication protocol
tid int
1
Transaction ID. Used to identify the request by both the client and the server

filter

Field
Type
Description

start

int A start ID of the tenant to be returned

count

int Number of tenants to be returned

sort

string

Tenant parameter to be sorted with

sortAsc

boolean

true if the order is ascending

criteria

Json Filter criteria. See the table below

criteria

Field

Type

Description

name

string Name of criterion. ID means the tenant ID

type

string Type of the criterion. Possible values: AND, OR, EQ (equal), NEQ (not equal), LIKE (case sensitive), IN, BETWEEN, NOT_NULL, ILIKE, GT, GTE, LT, LTE

value

string Value of a criterion. 1 : tenant ID=1
values list <string> Attribute values. Used for the IN, BETWEEN values of the type field

Response Sample

Response Fields

Field
Value
Description
message string Message if the request failed
where string Reference to the method where the problem occurred
cause string Cause of failure
data
array Tenant items. See the children table below

children

Field
Value
Description

id

long ID of the tenant

name

string Name of the tenant

uuid

string UUid of the corresponding session

allocated

int Sockets allocated for the tenant

allocatedDesired

int Number of sockets to be allocated to the tenant at some point. It is saved in the database but not yet applied to the physical tenant

allocatedEc2Instances

int Number of EC2 instances allocated for the tenant

allocatedEc2InstancesDesired

int Number of EC2 instances to be allocated to the tenant at some point. It is saved in the database but not yet applied to the physical tenant

allocatedPhysicalServers

int

Number of allocated physical servers

allocatedPhysicalServersDesired

int

Number of physical machines to be allocated to the tenant at some point. It is saved in the database but not yet applied to the physical tenant

labels

array Tenant's labels

email

string

Contact Email of the tenant

phone

string

Contact phone number of the tenant

website

string

URL of the tenant website

address

string

Contact address of the tenant

logo

string

A path to the tenant logo image

showName

boolean

If true, it will display the name of the tenant

enabled

boolean

If true, the tenant will be enabled

state

string

A state of the tenant.  Possible values: OK, WARNING, INACCESSIBLE, ERROR

status

string

Status of the tenant. Possible values: NONE, UPDATING

changeStatus

string

Defines the pending change in the tenant’s state.  Possible values: NONE, CREATE_PENDING, CHANGE_PENDING

alarmState

string

State of the tenant’s alarms. Possible values: OK, WARNING, ERROR

lockedShared

boolean

true if a shared lock is set for the tenant. false otherwise

lockedExclusive

boolean

true if an exclusive lock is set for the tenant. false otherwise

wasEdited

boolean

Indicates whether the tenant was edited

wasDiscoveredOnce

boolean

Indicates whether the tenant’s state was discovered once

progress

int

A value from 0 to 100. For a newly created tenant, the value is set to 0

alarmCounters

array

Number of alarms in the tenant

usedVms

int

Number of VMs used by the tenant

usedSockets

int

Number of sockets used by the tenant

usedEc2Instances

int

Number of EC2 instances used by the tenant

usedPhysicalServers

int

Number of physical machines used by the tenant

alertErrorCode

string

An error code of the alert

alertTitle

string

A title of the alert

alertDescription

string

A description of the alert

total

int

Number of tenant items