查询配额 - 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

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