接口约束
4.1.4 密钥授权管理
4.1.4.5 查询可退役授权列表 功能介绍功能介绍
● 功能介绍：查询用户可以退役的授权列表。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1.0/{project_id}/kms/list-retirable-grants
表4-345 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID
请求参数
表4-346 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。 通过调用IAM服务 获取用户Token接口获取（响应
sequence 否 String 请求消息序列号，36字节序列 号。 例如：
grants Array of
Grants
objectsgrant列表，详情请参见grants字段数据结构说 明。
参数 参数类型 描述
next_marker String 获取下一页所需要传递的marker值。 当
“truncated”为“false”时，“next_marker”
为空。
truncated String 是否还有下一页：
● “true”表示还有数据。
● “false”表示已经是最后一页。
表4-349 Grants
参数 参数类型 描述
key_id String 密钥ID。
grant_id String 授权ID，64字节。
grantee_princi
pal String 被授权用户ID，1~64字节，满足正则匹配“^[a-zA-Z0-9]{1，64}$”。 例如：
0d0466b00d0466b00d0466b00d0466b0 grantee_princi
pal_type String 授权类型。 有效值：“user”，“domain”。
operations Array of
strings 授权允许的操作列表。 有效的值：“create-
datakey”，“create-datakey-without- plaintext”，“encrypt-datakey”，“decrypt- datakey”，“describe-key”，“create-grant”，“retire-grant”，“encrypt-data”，
“decrypt-data”。 有效值不能仅为“create-grant”。
issuing_princi
pal String 创建授权用户ID，1~64字节，满足正则匹配
“^[a-zA-Z0-9]{1，64}$”。 例如：
0d0466b00d0466b00d0466b00d0466b0
creation_date String 创建时间，时间戳，即从1970年1月1日至该时间 的总秒数。 例如：1497341531000
name String 授权名字，取值1到255字符，满足正则匹配
“^[a-zA-Z0-9:/_-]{1,255}$”。
retiring_princi
pal String 可退役授权的用户ID，1~64字节，满足正则匹配
“^[a-zA-Z0-9]{1，64}$”。 例如：
0d0466b00d0466b00d0466b00d0466b0
状态码： 400
表4-350 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-351 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
状态码： 401
表4-352 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-353 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
状态码： 403
表4-354 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-355 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码
状态码： 404
表4-356 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-357 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
状态码： 500
表4-358 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-359 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
状态码： 502
表4-360 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-361 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码
参数 参数类型 描述
error_msg String 错误请求返回的错误信息
状态码： 504
表4-362 响应 Body 参数
参数 参数类型 描述
error Object 错误信息返回体。
表4-363 ErrorDetail
参数 参数类型 描述
error_code String 错误请求返回的错误码 error_msg String 错误请求返回的错误信息
请求示例
"operations" : [ "create-datakey", "describe-key" ],
"issuing_principal" : "8b961fb414344d59825ba0c8c008c815", "key_id" : "737fd52b-36c4-4c91-972e-f6e202de9f6e",
"grant_id" : "dd3f03e9229a5e47a41be6c27a630e60d5cbdbad2be89465d63109ad034db7d8", "grantee_principal" : "13gg44z4g2sglzk0egw0u726zoyzvrs8",
"name" : "13gg44z4g2sglzk0egw0u726zoyzvrs8", "creation_date" : "1597062260000",
"grantee_principal_type" : "user"
} ],
"next_marker" : "", "total" : 1,
"truncated" : "false"
}
状态码
状态码 描述
您可以在API Explorer中调试该接口。
URI
POST /v1.0/{project_id}/kms/encrypt-data
表4-364 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID