查询租户的详细配额

功能介绍

查询租户的详细配额。

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

错误码

请参考错误码说明。