创建主密钥
<p><strong><span style="font-size:18px">创建密钥:CreateCmk</span></strong></p>
<p><strong>描述</strong></p>
<p>创建用户主密钥(Customer Master Key, CMK)。主密钥可以直接用来对小包数据进行加密(一般小于4KB),同时也用来产生数据密钥(DataKey,DK),该数据密钥可用来对本地大量磁盘数据进行加解密操作。</p>
<p><strong>请求参数</strong></p>
<table border="1">
<thead>
<tr>
<th style="width:87px">
<p>名称</p>
</th>
<th style="width:66px">
<p>类型</p>
</th>
<th style="width: 74px;">
<p>是否必需</p>
</th>
<th style="width: 478px;">
<p>描述</p>
</th>
</tr>
</thead>
<tbody>
<tr>
<td style="width:87px">
<p>description</p>
</td>
<td style="width:66px">
<p>String</p>
</td>
<td style="width:74px">
<p>否</p>
</td>
<td style="width:478px">
<p>密钥的描述</p>
</td>
</tr>
<tr>
<td style="width:87px">
<p>keyUsage</p>
</td>
<td style="width:66px">
<p>Integer</p>
</td>
<td style="width:74px">
<p>是</p>
</td>
<td style="width:478px">
<p>密钥用途。</p>
<p>目前该版本仅支持值为0,默认传0。</p>
<p>注:(0:"ENCRYPT/DECRYPT")</p>
</td>
</tr>
<tr>
<td style="width:87px">
<p>alias</p>
</td>
<td style="width:66px">
<p>String</p>
</td>
<td style="width:74px">
<p>是</p>
</td>
<td style="width:478px">
<p>密钥名称。唯一,不能重复</p>
</td>
</tr>
<tr>
<td style="width:87px">
<p>algorithm</p>
</td>
<td style="width:66px">
<p>String</p>
</td>
<td style="width:74px">
<p>是</p>
</td>
<td style="width:478px">
<p>加密算法。</p>
<p>默认RSA(国际标准支持:RSA,国密标准支持SM2)</p>
</td>
</tr>
<tr>
<td style="width:87px">
<p>origin</p>
</td>
<td style="width:66px">
<p>Integer</p>
</td>
<td style="width:74px">
<p>是</p>
</td>
<td style="width:478px">
<p>密钥材料来源。支持平安云KMS平台产生、外部导入两种来源。注:(0: "平台产生"),(1:"外部导入")</p>
</td>
</tr>
</tbody>
</table>
<p><strong>返回参数</strong></p>
<table border="1">
<thead>
<tr>
<th>
<p>名称</p>
</th>
<th>
<p>类型</p>
</th>
<th>
<p>描述</p>
</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<p>code</p>
</td>
<td>
<p>String</p>
</td>
<td>
<p>返回码,成功返回"SUCCESS"</p>
</td>
</tr>
<tr>
<td>
<p>keyMetadata</p>
</td>
<td>
<p>KeyMetadata</p>
</td>
<td>
<p>返回密钥信息</p>
</td>
</tr>
<tr>
<td>
<p>requestId</p>
</td>
<td>
<p>String</p>
</td>
<td>
<p>当前请求ID</p>
</td>
</tr>
</tbody>
</table>
<p><strong>KeyMetadata</strong></p>
<table border="1">
<thead>
<tr>
<th style="width:113px">
<p>名称</p>
</th>
<th style="width:72px">
<p>类型</p>
</th>
<th style="width:526px">
<p>描述</p>
</th>
</tr>
</thead>
<tbody>
<tr>
<td style="width:113px">
<p>keyId</p>
</td>
<td style="width:72px">
<p>String</p>
</td>
<td style="width:526px">
<p>密钥的全局唯一标识符</p>
</td>
</tr>
<tr>
<td style="width:113px">
<p>alias</p>
</td>
<td style="width:72px">
<p>String</p>
</td>
<td style="width:526px">
<p>密钥名称</p>
</td>
</tr>
<tr>
<td style="width:113px">
<p>keyUsage</p>
</td>
<td style="width:72px">
<p>String</p>
</td>
<td style="width:526px">
<p>密钥用途,加密/解密</p>
</td>
</tr>
<tr>
<td style="width:113px">
<p>description</p>
</td>
<td style="width:72px">
<p>String</p>
</td>
<td style="width:526px">
<p>密钥描述</p>
</td>
</tr>
<tr>
<td style="width:113px">
<p>creationDate</p>
</td>
<td style="width:72px">
<p>String</p>
</td>
<td style="width:526px">
<p>密钥创建时间(yyyy-MM-dd HH:mm:ss)</p>
</td>
</tr>
<tr>
<td style="width:113px">
<p>deleteDate</p>
</td>
<td style="width:72px">
<p>String</p>
</td>
<td style="width:526px">
<p>密钥预计被删除时间(yyyy-MM-dd HH:mm:ss)当该值为空时,表示密钥不会被删除。只有当密钥状态keyState是待删除PendingDeletion时,会返回这个参数</p>
</td>
</tr>
<tr>
<td style="width:113px">
<p>ownerId</p>
</td>
<td style="width:72px">
<p>String</p>
</td>
<td style="width:526px">
<p>密钥拥有者</p>
</td>
</tr>
<tr>
<td style="width:113px">
<p>keyState</p>
</td>
<td style="width:72px">
<p>String</p>
</td>
<td style="width:526px">
<p>密钥状态。0启用;1禁用;2待删除。</p>
</td>
</tr>
<tr>
<td style="width:113px">
<p>origin</p>
</td>
<td style="width:72px">
<p>String</p>
</td>
<td style="width:526px">
<p>密钥材料来源。</p>
</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre>
<code>https:// kms-cn-shanghai.yun.pingan.com/?action=CreateCmk
&keyUsage=0
&origin=<origin>
&alias=<your key alias>
&algorithm=<algorithm>
&description=<your key description>
&<公共请求参数></code></pre>
<p><img src="data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==" /><img src="data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==" /><strong>返回示例</strong></p>
<pre>
<code>{
"code":"SUCCESS",
"keyMetadata":{
"keyUsage":"ENCRYPT_DECRYPT",
"origin":"平安云产生",
"keyState":"ENABLE|已启用",
"keyId":"your key id",
"description":"key description example",
"alias":"your key alias",
"ownerId":"123456",
"creationDate":"2018-12-04 15:07:54"
}
"requestId":"53912b71-3435-409e-ad05-1882ced04f1f"
}</code></pre>
<p><img src="data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==" /></p>
提交成功!非常感谢您的反馈,我们会继续努力做到更好!