数据加密服务 DEW数据加密服务 DEW

更新时间:2021/09/02 GMT+08:00
分享

查询配额

功能介绍

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

调试

您可以在API Explorer中调试该接口。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

quotas

Quotas object

配额详情。

表4 Quotas

参数

参数类型

描述

resources

Array of Resources objects

资源配额列表。

表5 Resources

参数

参数类型

描述

type

String

配额类型。枚举值说明:

  • CMK,用户主密钥

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

used

Integer

已使用配额数。

quota

Integer

配额总数。

状态码: 403

表6 响应Body参数

参数

参数类型

描述

error

Object

错误信息返回体。

表7 ErrorDetail

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

error_msg

String

错误请求返回的错误信息。

请求示例

响应示例

状态码: 200

请求已成功。

{
  "quotas" : {
    "resources" : [ {
      "quota" : 20,
      "used" : 20,
      "type" : "CMK"
    }, {
      "quota" : 100,
      "used" : 0,
      "type" : "grant_per_CMK"
    } ]
  }
}

状态码: 403

认证失败。

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

状态码

状态码

描述

200

请求已成功。

403

认证失败。

错误码

请参见错误码

分享:

    相关文档

    相关产品