Viewing Tenant Quotas

Quota defines the resource usage limit set for a tenant. The Oracle Cloud Administrator determines the quota limits for the tenant.

Topics:

Discover Quota

This API enables you retrieve tenant quotas in the specified container and sub containers.

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

/quota/container

URI

https://api_endpoint/quota/container

URI Parameter

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

Example URI

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

Example Response Body

{
 "list": 
 [
  "/default",
  "/mytenant",
 ]
}

Get Quota

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

Method

GET

REST Resource

/quota/name

URI

https://api_endpoint/quota/name

URI Parameter

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

Example URI

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

Example Response Body

 "list": [
  {
   "usage": {
    "machineimage": {
     "number": 2, 
     "megabytes": 4247
    }, 
    "vnet": {
     "vnetreservations": 3
    }, 
    "compute": {
     "instances": 6, 
     "ram": 46080, 
     "instance_restrictions": {}, 
     "cpus": 12.0
    }, 
    "nds": {
     "megabytes": 181468
    }
   }, 
   "uri": "http://api.oc.example.com./quota/mytenant", 
   "description": "Default quota for \"mytenant\"", 
   "name": "/mytenant", 
   "allowance": {
    "machineimage": {
     "number": 5, 
     "megabytes": 100000
    }, 
    "vnet": {
     "vnetreservations": null
    }, 
    "compute": {
     "instances": 10, 
     "ram": 50000, 
     "instance_restrictions": {}, 
     "cpus": 20.0
    }, 
    "nds": {
     "megabytes": 200000
    }
   }
  }
 ]
}

List Quota

This API enables you to list details about the tenant quotas for a specific container.

Method

GET

REST Resource

/quota/container

URI

https://api_endpoint/quota/container

URI Parameters

Parameter	Description
container	(Optional) Hierarchical namespace for tenant. For example, `/mytenant/`

Example URI

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

Example Response Body

{
 "list": [
  {
   "usage": 
    {
     "machineimage": {"number": 0, "megabytes": 0},  
     "vnet": {"vnetreservations": 0},
     "compute": { "instances": 0,"ram": 0, "instance_restrictions": {}, "cpus": 0.0 },
     "nds": {"megabytes": 0 }
    },
   "uri": "https://api/quota/ics2",
   "description": "Default quota for \"ics2\"",
   "name": "/ics2",
   "allowance": 
   {
    "machineimage": {"number": null,"megabytes": null},
    "vnet": {"vnetreservations": null},
    "compute": {"instances": null,"ram": null, "instance_restrictions": {}, "cpus": null},
    "nds": {"megabytes": null}
   }
  },
  {
   "usage": 
    {
    "machineimage": {"number": 1,"megabytes": 1380 },
    "vnet": {"vnetreservations": 0},
    "compute": {"instances": 1,"ram": 8192,"instance_restrictions": {},"cpus": 2.0},
    "nds": {"megabytes": 17180}
    },
   "uri": "https://api/quota/e2fmigration-s29",
   "description": "\"Account Quota\"",
   "name": "/e2fmigration-s29",
   "allowance": 
    {
     "machineimage": {"number": null,"megabytes": null},
     "vnet": {"vnetreservations": null },
     "compute": {"instances": null, "ram": 24576, "instance_restrictions": {},"cpus": 10.0},
     "nds": {"megabytes": null}
    }
  },
  {
    "usage": 
    {
     "machineimage": {"number": 0, "megabytes": 0},
     "vnet": { "vnetreservations": 0},
     "compute": {"instances": 0,"ram": 0,"instance_restrictions": {}, "cpus": 0.0 },
     "nds": {"megabytes": 0}
    },
    "uri": "https://api/quota/ics1",
    "description": "Default quota for \"ics1\"",
    "name": "/ics1",
    "allowance": 
    {
     "machineimage": {"number": null, "megabytes": null },
     "vnet": {"vnetreservations": null },
     "compute": {"instances": null, "ram": null, "instance_restrictions": {},  "cpus": null },
     "nds": { "megabytes": null }
    }
  }
 } 
]}