文档首页/ 数据复制服务 DRS/ API参考/ API v3（推荐）/ 配额/ 查询配额 - ShowQuotas
更新时间：2026-02-04 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询配额 - ShowQuotas

功能介绍

查询单租户在DRS服务下的配额信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v3/{project_id}/quotas

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的Project ID。

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

指定类型为application/json。

缺省值：application/json

X-Auth-Token

是

String

从IAM服务获取的用户Token。

X-Language

否

String

请求语言类型。

取值范围：

  • en-us：英语
  • zh-cn：中文

缺省值：en-us

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

quotas

Object

配额信息。

详情请参见表4。
表4 quotas字段数据结构说明

参数

参数类型

描述

resource

Object

配额信息。

详情请参见表5。
表5 resource字段数据结构说明

参数

参数类型

描述

type

String

配额类型信息。

取值范围：

  • instances：实例的数量配额
  • cpu：CPU的配额
  • cores：CPU核心数的配额
  • server_groups：服务器组的配额
  • mem：内存配额
  • ram：主存配额

min

Integer

配额最小取值。

max

Integer

配额最大取值。

quota

Integer

用户配额的实际值。

used

Integer

已使用的配额值。

请求示例

查询配额示例

https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/quotas

响应示例

状态码：200

OK

{
  "quotas" : {
    "resource" : {
      "type" : "instances",
      "min" : 0,
      "max" : 9999,
      "quota" : 9999,
      "used" : 41
    }
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 配额

相关文档