更新时间:2022-02-22 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(预留)、allocated(预留)、limit(最大)和in_use(已使用)。

    snapshots

    Object

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

    gigabytes

    Object

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

    volumes_SSD

    Object

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

    volumes_SAS

    Object

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

    snapshots_SSD

    Object

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

    snapshots_SAS

    Object

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

    gigabytes_SSD

    Object

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

    gigabytes_SAS

    Object

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

    id

    String

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

    backups

    Object

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

    backup_gigabytes

    Object

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

    per_volume_gigabytes

    Object

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

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

  • error参数说明

    参数

    参数类型

    描述

    message

    String

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

    code

    String

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

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

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

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

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

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

状态码

  • 正常

    200

错误码

请参考错误码说明