# 查询账号配额 - ListCoreGatewayQuotas #### 功能介绍 获取当前认证账号的有效配额信息，包括配额类型、最小值、最大值、配额值和已使用数量。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 当前API调用无需身份策略权限。 #### URI GET /v1/core/gateway-quotas 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | gateway_id | 否 | String | **参数解释：** 网关的唯一标识符。 网关ID获取方式： 1. 进入AgentArts平台，在左侧导航栏选择"开发中心 \> 组件库 "，选择"网关"页签。 2. 在网关列表中"网关名称/ID"处复制网关ID即可。 **约束限制：** 不涉及。 **取值范围：** 匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件\^\[0-9a-f\]{8}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{12}$。 **默认取值：** 不涉及。 | | limit | 否 | Integer | **参数解释：** 返回的最大结果数。 **约束限制：** 不涉及。 **取值范围：** int32，取值范围为1-2条。 **默认取值：** 2 | | offset | 否 | Integer | **参数解释：** 返回结果偏移量。 **约束限制：** 不涉及。 **取值范围：** int32，取值范围为0-100000条。 **默认取值：** 0 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | quotas | Array of [CoreGatewayQuota] objects | **参数解释：** 配额列表。 **取值范围：** 数组长度为 1-2。 | | size | Integer | **参数解释：** 当前页返回的配额数量。 **取值范围：** 取值为 0-2个。 | | total | Integer | **参数解释：** 配额总数。 **取值范围：** 取值为 0-2个。 | 表3CoreGatewayQuota | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释：** 配额类型。 **取值范围：** - *gateway_count*: 网关数量配额，当指定gateway id时，不返回该类型的配额详情。 - *target_count_per_gateway*: 每个网关的目标服务数量配额，仅当指定了gateway id时，才会返回该类型的配额详情。 | | min | Integer | **参数解释：** 最小允许值。 **取值范围：** 取值为 1-10000个。 | | max | Integer | **参数解释：** 最大允许值。 **取值范围：** 取值为 1-10000个。 | | quota | Integer | **参数解释：** 当前配置的配额值。 **取值范围：** 取值为 1-10000个。 | | used | Integer | **参数解释：** 已使用数量（实时计算）。 **取值范围：** 取值为 0-10000个。 | **状态码：500** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码。 **取值范围：** 取值为1-32个字符。 | | error_msg | String | **参数解释：** 错误消息。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | | error_reason | String | **参数解释：** 错误原因。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | | error_suggestion | String | **参数解释：** 错误处理建议。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码。 **取值范围：** 取值为1-32个字符。 | | error_msg | String | **参数解释：** 错误消息。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | | error_reason | String | **参数解释：** 错误原因。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | | error_suggestion | String | **参数解释：** 错误处理建议。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | **状态码：401** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码。 **取值范围：** 取值为1-32个字符。 | | error_msg | String | **参数解释：** 错误消息。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | | error_reason | String | **参数解释：** 错误原因。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | | error_suggestion | String | **参数解释：** 错误处理建议。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | **状态码：404** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码。 **取值范围：** 取值为1-32个字符。 | | error_msg | String | **参数解释：** 错误消息。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | | error_reason | String | **参数解释：** 错误原因。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | | error_suggestion | String | **参数解释：** 错误处理建议。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | **状态码：429** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 错误码。 **取值范围：** 取值为1-32个字符。 | | error_msg | String | **参数解释：** 错误消息。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | | error_reason | String | **参数解释：** 错误原因。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | | error_suggestion | String | **参数解释：** 错误处理建议。 **取值范围：** 取值为 1-256 个字符，匹配由字母、数字、空格、中文汉字以及常见中英文标点符号组成的非空字符串，符合正则条件\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()''"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 | #### 请求示例 无 #### 响应示例 **状态码：200** 成功检索账号配额列表 ``` { "quotas" : [ { "type" : "gateway_count", "min" : 1, "max" : 100, "quota" : 20, "used" : 5 } ], "size" : 1, "total" : 1 } ``` **状态码：500** 内部服务器错误 ``` { "error_code" : "AgentArts.02000500", "error_msg" : "服务连接超时", "error_reason" : "服务连接超时", "error_suggestion" : "请稍后重试" } ``` **状态码：400** 请求参数错误 ``` { "error_code" : "AgentArts.02000001", "error_msg" : "请求参数错误", "error_reason" : "请求参数错误", "error_suggestion" : "根据接口返回的具体原因修改请求参数" } ``` **状态码：401** 认证信息无法识别 ``` { "error_code" : "AgentArts.02000300", "error_msg" : "认证信息无法识别", "error_reason" : "认证信息无法识别", "error_suggestion" : "使用正确的认证信息访问" } ``` **状态码：404** 资源未找到 ``` { "error_code" : "AgentArts.02000100", "error_msg" : "资源未找到", "error_reason" : "资源未找到", "error_suggestion" : "请检查对应资源是否存在" } ``` **状态码：429** 请求频率超限。 ``` { "error_code" : "AgentArts.02000400", "error_msg" : "请求过于频繁，请稍后重试", "error_reason" : "请求过于频繁，请稍后重试", "error_suggestion" : "稍后重试" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 成功检索账号配额列表 | | 500 | 内部服务器错误 | | 400 | 请求参数错误 | | 401 | 认证信息无法识别 | | 404 | 资源未找到 | | 429 | 请求频率超限。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。