Viewing Tenants

The Tenant is the entity that uses Oracle Compute Cloud Service resources. Tenants must be registered by the Oracle Cloud Administrator before they can start using the service. For more information on how to obtain your tenant user information, see Using Oracle Compute Cloud Service.

Topics:

Discover Tenants

This API enables you to discover existing tenants in a specific container.

Note:

The discover API calls display the names of the objects in the specified container, not the details about the objects. To list the names of the objects, you must set the Accept header to application/oracle-compute-v3+directory+json. For all other purposes, you must set the Accept header to application/oracle-compute-v3+json.

Method

GET

REST Resource

/tenant/container/

URI

https://api_endpoint/tenant/container/

URI Parameter

Parameter	Description
container	Hierarchical namespace for the tenant. For example, `/` .

Example URI

https://api.oc.example.com/tenant/

Example Response Body

{"result": ["/mytenant", "/oracle"]}

Get Tenant

This API enables you to retrieve information for a specific tenant.

Method

GET

REST Resource

/tenant/name

URI

https://api_endpoint/tenant/name

URI Parameter

Parameter	Description
name	A unique hierarchical name for a tenant. For example, `/mytenant`.

Example URI

https://api.oc.example.com/tenant/mytenant

Example Response Body

{
        "description": "my tenant", 
        "dnszone": "mytenant.public.host1.us.oracle.com.", 
        "public_pkey": "0x1413", 
        "uri": "https://api/tenant/mytenant", 
        "private_pkey": "0x1412", 
        "type": "14.1.15-20150709.213443-dev", 
        "email": "abd@oracle.com", 
        "name": "mytenant"
}

List Tenants

This API enables you to list details about tenants in a specific container.

Method

GET

REST Resource

/tenant/container

URI

https://api_endpoint/tenant/container

URI Parameter

Parameter	Description
container	Hierarchical namespace for the tenant. For example, `/`.

Example URI

https://api.oc.example.com/tenant/

Example Response Body

{
 list:[
        {
        description": "Cloud administration tenant", 
        "public_pkey": null, 
        "uri": "https://api/tenant/cloud", 
        "private_pkey": null, 
        "type": null, "email": null, 
        "name": "cloud"
        }, 
        {
        "description": "ics-c2 tenant admin", 
        "public_pkey": "0x140f", 
        "uri": "https://api/tenant/ics-c2", 
        "private_pkey": "0x140e", 
        "type": "14.1.15-20150709.213443-dev", 
        "email": "ics-c2@ics.com", 
        "name": "ics-c2"
        }, 
        {
        "description": "my tenant", 
        "public_pkey": "0x1413", 
        "uri": "https://api/tenant/mytenant", 
        "private_pkey": "0x1412", 
        "type": "14.1.15-20150709.213443-dev", 
        "email": "abd@example.com", 
        "name": "mytenant"
        }]
}