# 查询OS的配额 - ShowOsQuota #### 功能介绍 查询OS配额接口用于获取ModelArts OS服务中部分资源的配额信息，如资源池配额、网络配额等。该接口适用于以下场景：当需要了解资源池或网络资源的使用限制、规划资源分配或监控资源使用情况时，用户可通过此接口获取相关配额信息。使用该接口的前提条件是ModelArts OS服务已部署且用户具有相应的权限（如管理员权限或资源管理权限）。调用接口成功后，系统将返回资源池配额、网络配额等详细信息，帮助用户更好地进行资源规划和管理。若用户无权限访问该接口、服务不可用或配额信息未配置，接口将返回相应的错误信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=ShowOsQuota)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /v1/{project_id}/quotas 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释** ：用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | quotas | [Quota] object | **参数解释**： 资源配额。 | 表3Quota | 参数 | 参数类型 | 描述 | |:---|:---|:---| | resources | Array of [ResourceQuota] objects | **参数解释**： 资源的配额信息。 | 表4ResourceQuota | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释**：资源类型 **取值范围**：可选值如下： - VPC：虚拟私有云。 - SUBNET：子网。 - SECURITY_GROUP：安全组。 - SECURITY_GROUP_RULE：安全组规则。 - PUBLIC_IP：公网IP。 - VPC_PEER：VPC对端链接个数。 - FIREWALL：防火墙。 - SHARE_BANDWIDTH：共享带宽。 - SHARE_BANDWIDTH_IP：共享带宽IP。 - LOADBALANCER：负载均衡。 - LISTENER：监听器。 - PHYSICAL_CONNECT：物理连接。 - VIRTUAL_INTERFACE：虚拟接口。 - VPC_CONTAIN_ROUTETABLE：VPC包含的路由表。 - ROUTETABLE_CONTAIN_ROUTES：路由表包含的路由。 | | quota | String | **参数解释**： 资源配额上限。 **取值范围**： 不涉及。 | | used | String | **参数解释**： 已使用配额。 **取值范围**： 不涉及。 | **状态码：404** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**：ModelArts错误码。 **取值范围**：不涉及。 | | error_msg | String | **参数解释**：具体错误信息。 **取值范围**：不涉及。 | #### 请求示例 无 #### 响应示例 **状态码：200** ``` { "quotas" : { "resources" : [ { "type" : "VPC", "quota" : "15", "used" : "10" }, { "type" : "SUBNET", "quota" : "15", "used" : "10" } ] } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK。 | | 404 | Not Found。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。