更新时间:2023-07-24 GMT+08:00

查询租户的详细配额

URI

  • URI格式

    GET /v2/{project_id}/os-quota-sets/{target_project_id}?usage=True

  • 参数说明

    参数

    是否必选

    描述

    project_id

    项目ID。

    获取方法请参见获取项目ID

    target_project_id

    目标的项目ID。与project_id保持一致即可。

    usage

    是否查询配额详细信息。当前只支持传true。

请求消息

  • 请求样例:
    GET https://{endpoint}/v2/{project_id}/os-quota-sets/{project_id}?usage=True

响应消息

  • 响应参数

    参数

    参数类型

    描述

    quota_set

    Object

    查询请求返回的配额信息,请参见•quota_set参数说明

    error

    Object

    出现错误时,返回的错误信息,具体请参见•error参数说明

  • quota_set参数说明

    参数

    参数类型

    描述

    volumes

    Object

    云硬盘数量,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。请参见•QuotaDetailVolumes

    snapshots

    Object

    快照数量,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。请参见•QuotaDetailSnapshots

    gigabytes

    Object

    总大小(快照+云硬盘),单位为GB,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailGigabytes

    volumes_SSD

    Object

    SSD类型云硬盘预留的云硬盘个数,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailVolumesSSD

    volumes_SAS

    Object

    SAS类型云硬盘预留的云硬盘个数,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailVolumesSAS

    volumes_SATA

    Object

    SATA类型云硬盘预留的云硬盘个数,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailVolumesSATA

    volumes_ESSD

    Object

    ESSD类型云硬盘预留的云硬盘个数,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailVolumesESSD

    snapshots_SSD

    Object

    SSD类型云硬盘预留快照个数,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailSnapshotsSSD

    snapshots_SAS

    Object

    SAS类型云硬盘预留快照个数,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailSnapshotsSAS

    snapshots_SATA

    Object

    SATA类型云硬盘预留快照个数,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailSnapshotsSAT

    snapshots_ESSD

    Object

    ESSD类型云硬盘预留快照个数,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailSnapshotsESSD

    gigabytes_SSD

    Object

    SSD类型云硬盘预留的size大小,单位为GB,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailGigabytesSSD

    gigabytes_SAS

    Object

    SAS类型云硬盘预留的size大小,单位为GB,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailGigabytesSAS

    gigabytes_SATA

    Object

    SATA类型云硬盘预留的size大小,单位为GB,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailGigabytesSAT

    gigabytes_ESSD

    Object

    ESSD类型云硬盘预留的size大小,单位为GB,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailGigabytesESS...

    id

    String

    租户ID。租户ID就是项目ID。

    backups

    Object

    备份个数,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。请参见•QuotaDetailBackups

    backup_gigabytes

    Object

    备份大小,单位为GB,键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailBackupGigaby...

    per_volume_gigabytes

    Object

    每个云硬盘的容量配额限制。键值对,包含:reserved(预留)、limit(最大)和in_use(已使用)。

    请参见•QuotaDetailPerVolumeGig...

    如果返回值中limit为-1,表示没有限制配额。

  • QuotaDetailBackupGigabytes参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailBackups参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailGigabytes参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailSnapshots参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailVolumes参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailGigabytesSATA参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailGigabytesESSD参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailSnapshotsSATA参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailSnapshotsESSD参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailVolumesSATA参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailVolumesESSD参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailGigabytesSAS参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailSnapshotsSAS参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailVolumesSAS参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailGigabytesSSD参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailSnapshotsSSD参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailVolumesSSD参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • QuotaDetailPerVolumeGigabytes参数说明

    参数

    参数类型

    描述

    in_use

    Integer

    已使用的数量。

    limit

    Integer

    最大的数量。

    reserved

    Integer

    预留属性。

  • error参数说明

    参数

    参数类型

    描述

    message

    String

    出现错误时,返回的错误消息。

    code

    String

    出现错误时,返回的错误码。

    错误码和其对应的含义请参考错误码

  • 响应样例
    {
        "quota_set": {
            "gigabytes_SAS": {
                "reserved": 0, 
                "limit": -1, 
                "in_use": 21
            }, 
            "gigabytes": {
                "reserved": 0, 
                "limit": 42790, 
                "in_use": 2792
            }, 
            "backup_gigabytes": {
                "reserved": 0, 
                "limit": 5120, 
                "in_use": 51
            }, 
            "snapshots_SAS": {
                "reserved": 0, 
                "limit": -1, 
                "in_use": 0
            }, 
            "volumes_SSD": {
                "reserved": 0, 
                "limit": -1, 
                "in_use": 28
            }, 
            "snapshots": {
                "reserved": 0, 
                "limit": 10, 
                "in_use": 6
            }, 
            "id": "cd631140887d4b6e9c786b67a6dd4c02", 
            "volumes_SAS": {
                "reserved": 0, 
                "limit": -1, 
                "in_use": 2
            }, 
            "snapshots_SSD": {
                "reserved": 0, 
                "limit": -1, 
                "in_use": 0
            }, 
            "volumes": {
                "reserved": 0, 
                "limit": -1, 
                "in_use": 108
            }, 
            "backups": {
                "reserved": 0, 
                "limit": 100, 
                "in_use": 10
            }, 
            "gigabytes_SSD": {
                "reserved": 0, 
                "limit": -1, 
                "in_use": 1085
            }
    
        }
    }

    {
        "error": {
            "message": "XXXX", 
            "code": "XXX"
        }
    }

    其中error是泛指的错误,有badrequest、itemNotFound等,如报错为:

    {
        "badrequest": {
            "message": "XXXX", 
            "code": "XXX"
        }
    }

状态码

  • 正常

    200

错误码

请参考错误码