查询租户配额 - ShowServerLimits
功能介绍
查询该租户下,所有资源的配额信息,包括已使用配额。
调试
您可以在API Explorer中调试该接口。
授权信息
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
ecs:cloudServerQuotas:get | read | - | - | - | - |
URI
GET /v1/{project_id}/cloudservers/limits
请求消息
无
响应消息
参数 | 参数类型 | 描述 |
|---|---|---|
maxTotalInstances | Integer | 参数解释: 云服务器最大申请数量。 取值范围: 不涉及 |
maxTotalCores | Integer | 参数解释: 当前租户所有的CPU核数最大申请数量。 取值范围: 不涉及 |
maxTotalRAMSize | Integer | 参数解释: 内存最大申请容量(单位:MiB)。 取值范围: 不涉及 |
maxTotalSpotInstances | Integer | 参数解释: 竞价实例的最大申请数量。 竞价实例即采用竞价计费模式的实例,详细内容,请参见竞价计费(竞价模式)。 取值范围: 不涉及 |
maxTotalSpotCores | Integer | 参数解释: 竞价实例的CPU核数最大申请数量。 取值范围: 不涉及 |
maxTotalSpotRAMSize | Integer | 参数解释: 竞价实例的内存最大申请容量(单位:MiB)。 取值范围: 不涉及 |
maxTotalKeypairs | Integer | 参数解释: 可以申请的SSH密钥对最大数量。 取值范围: 不涉及 |
maxServerMeta | Integer | 参数解释: 可输入元数据的最大长度。 取值范围: 不涉及 |
maxPersonality | Integer | 参数解释: 可注入文件的最大个数。 取值范围: 不涉及 |
maxPersonalitySize | Integer | 参数解释: 注入文件内容的最大长度(单位:Byte)。 取值范围: 不涉及 |
maxServerGroups | Integer | 参数解释: 服务器组的最大个数。 取值范围: 不涉及 |
maxServerGroupMembers | Integer | 参数解释: 服务器组中的最大弹性云服务器数。 取值范围: 不涉及 |
totalServerGroupsUsed | Integer | 参数解释: 已使用的服务器组个数。 取值范围: 不涉及 |
maxSecurityGroups | Integer | 参数解释: 安全组最大使用个数。 说明: 具体配额限制请以VPC配额限制为准。 取值范围: 不涉及 |
maxSecurityGroupRules | Integer | 参数解释: 安全组中安全组规则最大的配置个数。 说明: 具体配额限制请以VPC配额限制为准。 取值范围: 不涉及 |
maxTotalFloatingIps | Integer | 参数解释: 最大的浮动IP使用个数。 取值范围: 不涉及 |
maxImageMeta | Integer | 参数解释: 镜像元数据最大的长度。 取值范围: 不涉及 |
totalInstancesUsed | Integer | 参数解释: 当前云服务器使用个数。 取值范围: 不涉及 |
totalCoresUsed | Integer | 参数解释: 当前已使用CPU核数。 取值范围: 不涉及 |
totalRAMUsed | Integer | 参数解释: 当前内存使用容量(单位:MiB)。 取值范围: 不涉及 |
totalSpotInstancesUsed | Integer | 参数解释: 当前竞价实例的使用个数。 取值范围: 不涉及 |
totalSpotCoresUsed | Integer | 参数解释: 当前竞价实例已使用的CPU核数。 取值范围: 不涉及 |
totalSpotRAMUsed | Integer | 参数解释: 当前竞价实例的内存使用容量(单位:MiB)。 取值范围: 不涉及 |
totalSecurityGroupsUsed | Integer | 参数解释: 当前安全组使用个数。 取值范围: 不涉及 |
totalFloatingIpsUsed | Integer | 参数解释: 当前浮动IP使用个数。 取值范围: 不涉及 |
limit_by_flavor | Array of objects | 参数解释: 该属性当前未使用,返回值为[]。 取值范围: 不涉及 |
请求示例
查询该租户下所有资源的配额信息。
GET https://{endpoint}/v1/{project_id}/cloudservers/limits 响应示例
{
"absolute":{
"maxServerMeta":128,
"maxPersonality":5,
"maxImageMeta":128,
"maxPersonalitySize":10240,
"maxSecurityGroupRules":20,
"maxTotalKeypairs":-1,
"totalRAMUsed":75776,
"totalInstancesUsed":21,
"maxSecurityGroups":10,
"totalFloatingIpsUsed":0,
"maxTotalCores":20480,
"totalSecurityGroupsUsed":1,
"maxTotalFloatingIps":10,
"maxTotalInstances":2048,
"totalCoresUsed":40,
"maxTotalRAMSize":25165824,
"maxTotalSpotInstances":20,
"maxTotalSpotCores":320,
"maxTotalSpotRAMSize":655360,
"totalSpotInstancesUsed":0,
"totalSpotCoresUsed":0,
"totalSpotRAMUsed":0,
"limit_by_flavor":[],
"maxServerGroups":10,
"maxServerGroupMembers":16,
"totalServerGroupsUsed":2
}
} 返回值
请参考通用请求返回值。
错误码
请参考错误码。

