查询租户的详细配额

功能介绍

查询租户的详细配额。

URI

• URI格式

  GET /v3/{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}/v3/{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

错误码

请参考错误码。