• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Cinder V2 Interfaces
  5. Quota sets extension
  6. Show Quotas

Show Quotas

Function Description

This interface is used to query quotas of a tenant.

Interface Format

Method

URI

Description

GET

/v2/{tenant_id}/os-quota-sets/{tenant_id}

Queries the quota of a tenant.

Restrictions

N/A

Expanded Interface

N/A

Request Parameter

request filter parameters

Parameter

Type

Mandatory

Remarks

usage

Boolean

No

Specifies whether to query the used quota of a tenant. Value True indicates that the used quota is queried. Otherwise, the used quota is not queried.

Response Parameters

Parameter

Type

Mandatory

Remarks

volumes

Int

Yes

Number of volumes

snapshots

Int

Yes

Number of snapshots

gigabytes

Int

Yes

Total size of the snapshots and volumes

volumes_TYPE

Int

Yes

Number of volumes reserved for a volume type

snapshots_TYPE

Int

Yes

Number of snapshots reserved for a volume type

gigabytes_TYPE

Int

Yes

Volume size reserved for a volume type

id

String

Yes

Specifies the tenant ID.

backups

Int

Yes

Number of backups

backup_gigabytes

Int

Yes

Backup capacity of a tenant

per_volume_gigabytes

Int

Yes

Maximum size of a volume

Request Example

GET v2/5dd743c7ac1448948fe1ed331007229b/os-quota-sets/5dd743c7ac1448948fe1ed331007229b

Response Example

{
    "quota_set": {
        "snapshots_name_xx4type": -1,
        "volumes_name_xx4type1": -1,
        "gigabytes_name_xx4type1": -1,
        "gigabytes": 1000,
        "backup_gigabytes": 1000,
        "per_volume_gigabytes": -1,
        "snapshots": 10,
        "volumes_name_xx4type": -1,
        "gigabytes_name_xx4type": -1,
        "volumes": 2000,
        "snapshots_name_xx4type1": -1,
        "backups": 10,
        "id":"5dd743c7ac1448948fe1ed331007229b"
    }
}

Error Code

See section Processing Return Code.