更新时间:2022-12-06 GMT+08:00

查询配额

功能介绍

查询配额,查询用户可以创建的用户主密钥配额总数及当前使用量信息。

用户可以创建的用户主密钥配额不包括服务自动创建的默认主密钥数量。

URI

  • URI格式

    GET /v1.0/{project_id}/kms/user-quotas

  • 参数说明
    表1 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

    项目ID。

请求消息

响应消息

表2 响应参数

参数

是否必选

参数类型

描述

quotas

Object

配额列表,详情请参见表3

表3 quotas字段数据结构说明

参数

是否必选

参数类型

描述

resources

Array of objects

资源配额列表,详情请参见表4

表4 resources字段数据结构说明

参数

是否必选

参数类型

描述

type

String

配额类型。

枚举值说明:

  • CMK,用户主密钥
  • grant_per_CMK,单个用户主密钥可创建授权数

used

Integer

已使用配额数。

quota

Integer

配额总数。

示例

  • 请求样例

  • 响应样例
    {
        "quotas": {
            "resources": [
                {
                    "type": "CMK",
                    "used": 15,
                    "quota": 20
                },
                {
                    "type": "grant_per_CMK",
                    "used": 15,
                    "quota": 100
                }
    
            ]
        }
    }

    {
        "error": {
            "error_code": "KMS.XXXX",
            "error_msg": "XXX"
        }
    }

状态码

表5描述的是API返回的正常状态码。
表5 状态码

状态码

编码

状态说明

200

OK

请求已成功。

异常状态码,请参见状态码