DescribeKey
更新时间：2025-08-21
DescribeKey
- 接口说明
获取指定的CMK的详细信息
- 请求URI
Plain Text
1POST /?action=DescribeKey请求体参数
- 请求体字段数据结构说明
| 参数 | 类型 | 是否必需 | 描述 | 示例值 |
|---|---|---|---|---|
| keyId | String | 是 | CMK的密钥ID | 5be45b47-38ba-f055-e892-25ff66c91adc |
响应体参数
- 响应体字段数据结构说明
| 参数 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| keyMetadata | KeyMetadata | 密钥元信息 |
- KeyMetadata字段数据结构说明
| 参数名称 | 参数类型 | 描述 | 示例值 |
|---|---|---|---|
| keyId | String | 密钥id | |
| creationDate | String | 密钥创建时间 | 2018-08-15T13:58:18Z |
| keyState | String | 密钥状态，有以下几种：pendingImport(待导入)、pendingDeletion(待删除)、enabled(启用)、disabled(禁用) | enabled |
| description | String | 密钥描述 | |
| deletionDate | String | 计划删除时间 | 2018-08-15T13:58:18Z |
| region | String | 区域 | bj |
| origin | String | 密钥来源 | BAIDU_KMS |
| keySpec | String | 密钥类型 | BAIDU_AES_256 |
| keyUsage | String | 密钥用途 | ENCRYPT_DECRYPT |
| protectedBy | String | 密钥保护级别 | SOFTWARE |
| rotateCycle | Integer | 轮转周期 | 200 |
| nextRotateTime | String | 下次轮转时间 | 2018-08-15T13:58:18Z |
请求示例
Plain Text
1POST /?action=DescribeKey
2<公共请求头>
3
4{
5 "keyId": "5be45b47-38ba-f055-e892-25ff66c91adc"
6}响应示例
Plain Text
1HTTP/1.1 200 OK
2<公共响应头>
3
4{
5 "keyMetadata": {
6 "keyId": "5be45b47-38ba-f055-e892-25ff66c91adc",
7 "creationDate": "2018-08-13T13:58:18Z",
8 "keyState": "enabled",
9 "description": "test",
10 "deletionDate": "2018-09-15T13:20:14Z",
11 "keyUsage": "ENCRYPT_DECRYPT",
12 "region": "bj",
13 "origin": "string",
14 "keySpec": "string",
15 "protectedBy": "string",
16 "rotateCycle":300,
17 "nextRotateTime":"2018-09-15T13:20:14Z"
18 }
19}