创建主密钥

<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:&quot;ENCRYPT/DECRYPT&quot;)</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: &quot;平台产生&quot;),(1:&quot;外部导入&quot;)</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>返回码,成功返回&quot;SUCCESS&quot;</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 &amp;keyUsage=0 &amp;origin=&lt;origin&gt; &amp;alias=&lt;your key alias&gt; &amp;algorithm=&lt;algorithm&gt; &amp;description=&lt;your key description&gt; &amp;&lt;公共请求参数&gt;</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>
以上内容是否解决了您的问题?
请补全提交信息!
联系我们

电话咨询

400-151-8800

邮件咨询

fincloud@ocft.com

在线客服

工单支持

解决云产品相关技术问题