查询配额
功能介绍
查询用户可以创建的资源配额总数及当前使用量,当前仅有告警规则一种资源类型。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /V1.0/{project_id}/quotas
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 租户ID。用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取方式请参见“获取项目ID”。 约束限制: 不涉及。 取值范围: 长度为[1,64]个字符。 默认取值: 不涉及。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
否 |
String |
参数解释: 发送的实体的MIME类型。 约束限制: 不涉及。 取值范围: 长度为[1,64]个字符。 默认取值: 默认使用application/json,如果API是对象、镜像上传等接口,媒体类型可按照流类型的不同进行确定。 |
X-Auth-Token |
否 |
String |
参数解释: 用户Token。调用获取用户Token接口,请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 约束限制: 不涉及。 取值范围: 长度为[1,16384]个字符。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
quotas |
QuotasResp object |
参数解释: 配额列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
type |
String |
参数解释: 配额类型。 取值范围: 枚举值说明:
|
used |
Long |
参数解释: 已使用配额数。 取值范围: 不涉及。 |
unit |
String |
参数解释: 单位。 取值范围: 长度为[0,32]个字符。 |
quota |
Long |
参数解释: 配额总数。 取值范围: 不涉及。 |
min |
Long |
参数解释: 最小值。 取值范围: 不涉及。 |
max |
Long |
参数解释: 最大值。 取值范围: 不涉及。 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
请求错误。 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
未提供认证信息,或认证信息错误。 |
状态码:403
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
请求页面被禁止访问。 |
状态码:408
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
请求超出了服务器的等待时间。 |
状态码:429
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
前请求过多。 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
请求未完成,服务异常。 |
状态码:503
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
系统暂时不可用,请求受限。 |
请求示例
/V1.0/{project_id}/quotas
响应示例
状态码:200
OK
{ "quotas" : { "resources" : [ { "unit" : "", "type" : "alarm", "quota" : 1000, "used" : 10 } ] } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
408 |
Request Timeout |
429 |
Too Many Requests |
500 |
Internal Server Error |
503 |
Service Unavailable |
错误码
请参见错误码。