查询配额 - 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	参数解释：发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。约束限制：不涉及。取值范围： application/json 默认取值： application/json
X-Auth-Token	是	String	参数解释：从IAM服务获取的用户Token。用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为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：实例的数量配额
min	Integer	参数解释：配额最小取值，表示该资源配额的下限。约束限制：不涉及。取值范围：不涉及。
max	Integer	参数解释：配额最大取值，表示该资源配额的上限。约束限制：不涉及。取值范围：不涉及。
quota	Integer	参数解释：用户配额的实际值，即系统为该用户分配的配额数量。约束限制：不涉及。取值范围：不涉及。
used	Integer	参数解释：已使用的配额值，表示当前已占用的资源数量。约束限制：不涉及。取值范围：不涉及。

请求示例

查询配额示例

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

响应示例

状态码：200

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