文档首页/ 云硬盘 EVS/ API参考/ API/ 配额管理/ 查询租户的详细配额

更新时间：2025-07-21 GMT+08:00

在线调试

CLI示例

查看PDF

查询租户的详细配额

功能介绍

查询租户的详细配额。

调用方法

请参见如何调用API。

URI

GET /v2/{project_id}/os-quota-sets/{target_project_id}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释项目ID。获取方法请参见"获取项目ID"。约束限制不涉及。取值范围不涉及。默认取值不涉及。
target_project_id	是	String	参数解释目标的项目ID。获取方法请参见"获取项目ID"。约束限制与project_id保持一致即可。取值范围不涉及。默认取值不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
usage	是	String	参数解释是否查询配额详细信息。约束限制当前只支持传True。取值范围不涉及。默认取值不涉及。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制不涉及。取值范围不涉及。默认取值不涉及。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
quota_set	QuotaList object	参数解释查询请求返回的配额信息。取值范围不涉及。

表5 QuotaList
参数	参数类型	描述
backup_gigabytes	QuotaDetailBackupGigabytes object	参数解释备份容量，单位为GiB，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
backups	QuotaDetailBackups object	参数解释备份个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
gigabytes	QuotaDetailGigabytes object	参数解释总容量，单位为GiB，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
id	String	参数解释项目ID。取值范围不涉及
snapshots	QuotaDetailSnapshots object	参数解释快照个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
volumes	QuotaDetailVolumes object	参数解释云硬盘个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
gigabytes_SATA	QuotaDetailGigabytesSATA object	参数解释 SATA云硬盘类型预留的容量大小，单位为GiB，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
snapshots_SATA	QuotaDetailSnapshotsSATA object	参数解释 SATA云硬盘类型预留快照个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
volumes_SATA	QuotaDetailVolumesSATA object	参数解释 SATA云硬盘类型预留的云硬盘个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
gigabytes_SAS	QuotaDetailGigabytesSAS object	参数解释 SAS类型云硬盘预留的size大小，单位为GiB，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
snapshots_SAS	QuotaDetailSnapshotsSAS object	参数解释 SAS类型云硬盘预留快照个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
volumes_SAS	QuotaDetailVolumesSAS object	参数解释 SAS类型云硬盘预留的云硬盘个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
gigabytes_SSD	QuotaDetailGigabytesSSD object	参数解释 SSD类型云硬盘预留的size大小，单位为GiB，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
snapshots_SSD	QuotaDetailSnapshotsSSD object	参数解释 SSD类型云硬盘预留快照个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
volumes_SSD	QuotaDetailVolumesSSD object	参数解释 SSD类型云硬盘预留的云硬盘个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
gigabytes_ESSD	QuotaDetailGigabytesESSD object	参数解释 ESSD类型云硬盘预留的size大小，单位为GiB，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
snapshots_ESSD	QuotaDetailSnapshotsESSD object	参数解释 ESSD类型云硬盘预留快照个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
volumes_ESSD	QuotaDetailVolumesESSD object	参数解释 ESSD类型云硬盘预留的云硬盘个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
gigabytes_GPSSD	QuotaDetailGigabytesGPSSD object	参数解释 GPSSD类型云硬盘预留的size大小，单位为GiB，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
snapshots_GPSSD	QuotaDetailSnapshotsGPSSD object	参数解释 GPSSD类型云硬盘预留快照个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
volumes_GPSSD	QuotaDetailVolumesGPSSD object	参数解释 GPSSD类型云硬盘预留的云硬盘个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
gigabytes_GPSSD2	QuotaDetailGigabytesGPSSD2 object	参数解释 GPSSD2类型云硬盘预留的size大小，单位为GiB，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
snapshots_GPSSD2	QuotaDetailSnapshotsGPSSD2 object	参数解释 GPSSD2类型云硬盘预留快照个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
volumes_GPSSD2	QuotaDetailVolumesGPSSD2 object	参数解释 GPSSD2类型云硬盘预留的云硬盘个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
gigabytes_ESSD2	QuotaDetailGigabytesESSD2 object	参数解释 ESSD2类型云硬盘预留的size大小，单位为GiB，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
snapshots_ESSD2	QuotaDetailSnapshotsESSD2 object	参数解释 ESSD2类型云硬盘预留快照个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
volumes_ESSD2	QuotaDetailVolumesESSD2 object	参数解释 ESSD2类型云硬盘预留的云硬盘个数，键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及
per_volume_gigabytes	QuotaDetailPerVolumeGigabytes object	参数解释每个云硬盘的容量配额限制。键值对，包含：reserved（预留）、limit（最大）和in_use（已使用）。取值范围不涉及

表6 QuotaDetailBackupGigabytes
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

表7 QuotaDetailBackups
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

表8 QuotaDetailGigabytes
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

表9 QuotaDetailSnapshots
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表10** QuotaDetailVolumes
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表11** QuotaDetailGigabytesSATA
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表12** QuotaDetailSnapshotsSATA
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表13** QuotaDetailVolumesSATA
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表14** QuotaDetailGigabytesSAS
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表15** QuotaDetailSnapshotsSAS
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表16** QuotaDetailVolumesSAS
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表17** QuotaDetailGigabytesSSD
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表18** QuotaDetailSnapshotsSSD
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表19** QuotaDetailVolumesSSD
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表20** QuotaDetailGigabytesESSD
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表21** QuotaDetailSnapshotsESSD
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表22** QuotaDetailVolumesESSD
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表23** QuotaDetailGigabytesGPSSD
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表24** QuotaDetailSnapshotsGPSSD
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表25** QuotaDetailVolumesGPSSD
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表26** QuotaDetailGigabytesGPSSD2
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表27** QuotaDetailSnapshotsGPSSD2
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表28** QuotaDetailVolumesGPSSD2
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表29** QuotaDetailGigabytesESSD2
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表30** QuotaDetailSnapshotsESSD2
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表31** QuotaDetailVolumesESSD2
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

**表32** QuotaDetailPerVolumeGigabytes
参数	参数类型	描述
in_use	Integer	参数解释已使用的数量。取值范围不涉及。
limit	Integer	参数解释最大的数量。取值范围不涉及。
reserved	Integer	参数解释预留属性。取值范围不涉及。

状态码：400

**表33** 响应Body参数
参数	参数类型	描述
error	Error object	参数解释出现错误时，返回的错误码。错误码和其对应的含义请参考错误码说明。取值范围不涉及。

**表34** Error
参数	参数类型	描述
code	String	参数解释出现错误时，返回的错误码。取值范围错误码和其对应的含义请参考错误码说明。
message	String	参数解释出现错误时，返回的错误消息。取值范围不涉及。

请求示例

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

响应示例

状态码：200

{
  "quota_set" : {
    "gigabytes_SAS" : {
      "reserved" : 0,
      "limit" : -1,
      "in_use" : 21
    },
    "volumes_SATA" : {
      "reserved" : 0,
      "limit" : -1,
      "in_use" : 8
    },
    "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
    },
    "gigabytes_SATA" : {
      "reserved" : 0,
      "limit" : -1,
      "in_use" : 168
    },
    "backups" : {
      "reserved" : 0,
      "limit" : 100,
      "in_use" : 10
    },
    "gigabytes_SSD" : {
      "reserved" : 0,
      "limit" : -1,
      "in_use" : 1085
    },
    "snapshots_SATA" : {
      "reserved" : 0,
      "limit" : -1,
      "in_use" : 0
    }
  }
}

状态码：400

Bad Request

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

SDK代码示例

SDK代码示例如下。

      
       
         
         
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.evs.v2.region.EvsRegion;
import com.huaweicloud.sdk.evs.v2.*;
import com.huaweicloud.sdk.evs.v2.model.*;


public class CinderListQuotasSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        EvsClient client = EvsClient.newBuilder()
                .withCredential(auth)
                .withRegion(EvsRegion.valueOf("<YOUR REGION>"))
                .build();
        CinderListQuotasRequest request = new CinderListQuotasRequest();
        request.withTargetProjectId("{target_project_id}");
        try {
            CinderListQuotasResponse response = client.cinderListQuotas(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        

      
     

      
       
         
         
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkevs.v2.region.evs_region import EvsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkevs.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = EvsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(EvsRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = CinderListQuotasRequest()
        request.target_project_id = "{target_project_id}"
        response = client.cinder_list_quotas(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        

      
     

      
       
         
         
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    evs "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/evs/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/evs/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/evs/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := evs.NewEvsClient(
        evs.EvsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.CinderListQuotasRequest{}
	request.TargetProjectId = "{target_project_id}"
	response, err := client.CinderListQuotas(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        

      
     

更多编程语言的SDK代码示例，请参见API Explorer的代码示例页签，可生成自动对应的SDK代码示例。

状态码

状态码	描述
200	OK
400	Bad Request

错误码

请参见错误码。

父主题：配额管理

上一篇：配额管理

下一篇：云硬盘标签管理

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问