GetParametersForImport - 密钥管理服务

返回的参数可用于执行ImportKeyMaterial。

使用说明：

主密钥材料来源必须是外部，即Origin为EXTERNAL。
本次调用返回的公钥和令牌必须搭配使用，且只能用于本次调用中指定的CMK。
每次调用返回的公钥与令牌都不相同。

您需要指定用于加密密钥材料的公钥类型和加密算法，对应关系如下表所示。


公钥类型	加密算法	说明
RSA_2048	RSAES_PKCS1_V1_5 RSAES_OAEP_SHA_1 RSAES_OAEP_SHA_256	支持所有地域、任意保护级别的密钥。
EC_SM2	SM2PKE	仅支持导入保护级别为HSM的密钥，且密码机处于国密局商用密码检测认证的地域。更多信息，请参见托管密码机简介。

本文将提供一个示例，获取密钥ID为1234abcd-12ab-34cd-56ef-12345678****、加密算法为RSAES_PKCS1_V1_5、公钥类型为RSA_2048的主密钥材料参数，返回的主密钥材料参数包含密钥ID、用于加密密钥材料的公钥（PublicKey）、导入密钥材料的令牌（ImportToken）以及令牌的过期时间。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	GetParametersForImport	要执行的操作，取值：GetParametersForImport。
KeyId	String	是	1234abcd-12ab-34cd-56ef-12345678****	主密钥的全局唯一标识符。说明密钥材料来源必须是外部，即Origin为EXTERNAL。
WrappingAlgorithm	String	是	RSAES_PKCS1_V1_5	用于加密密钥材料的算法。
WrappingKeySpec	String	是	RSA_2048	用于加密密钥材料的公钥类型。

关于公共请求参数的详情，请参见公共参数。

返回数据


名称	类型	示例值	描述
ImportToken	String	Base64String	导入令牌。令牌的有效期为24小时。后续调用ImportKeyMaterial时需要指定该参数。
KeyId	String	1234abcd-12ab-34cd-56ef-12345678****	主密钥全局唯一标识符。后续调用ImportKeyMaterial时需要指定该参数。
PublicKey	String	MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAlls4uIBxD0GG84C+lGBO6Dhpf1J3XimC6cPmPNaKKJMOzoX4tD+C+r7aZv8lZ3vnPfxuxvy/YwG+whUxTEEFUdqJTOIzhPfYucupqKM92crVHIuG+xtMVeHKjyTr+UrtKCsQikqHT+19yDRN/RMoo2HUx0gmEnRyXd8t3JyUXun9FdoxKA08GrsV7nodb9ZsoBLhnev7tTLcXvLyKW6XG1ZQCQm6dPnbnwLeDXR7uK0Lqn9PM28mBIdaiQUQxj2XbM1CoJA+JiyVX3Ptdb+4rqukb4Rb05B80Bs9xV/cf7FIku08l7xGhrGiQFq+DFXwQWtwihXHZxz3LhldU+4ZPwID****	用于加密密钥材料的公钥。采用Base64编码。
RequestId	String	8cdf51fd-bcd6-d79a-0ef4-e52c9b5466dc	请求ID。
TokenExpireTime	String	2018-01-25T00:01:02Z	导入令牌的过期时间。

示例

请求示例

https://[Endpoint]/?Action=GetParametersForImport
&KeyId=1234abcd-12ab-34cd-56ef-12345678****
&WrappingAlgorithm=RSAES_PKCS1_V1_5
&WrappingKeySpec=RSA_2048
&<公共请求参数>

正常返回示例

XML格式

<KMS>
    <ImportToken>Base64String</ImportToken>
    <PublicKey>MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAlls4uIBxD0GG84C+lGBO6Dhpf1J3XimC6cPmPNaKKJMOzoX4tD+C+r7aZv8lZ3vnPfxuxvy/YwG+whUxTEEFUdqJTOIzhPfYucupqKM92crVHIuG+xtMVeHKjyTr+UrtKCsQikqHT+19yDRN/RMoo2HUx0gmEnRyXd8t3JyUXun9FdoxKA08GrsV7nodb9ZsoBLhnev7tTLcXvLyKW6XG1ZQCQm6dPnbnwLeDXR7uK0Lqn9PM28mBIdaiQUQxj2XbM1CoJA+JiyVX3Ptdb+4rqukb4Rb05B80Bs9xV/cf7FIku08l7xGhrGiQFq+DFXwQWtwihXHZxz3LhldU+4ZPwID****</PublicKey>
    <KeyId>1234abcd-12ab-34cd-56ef-12345678****</KeyId>
    <TokenExpireTime>2018-01-25T00:01:02Z</TokenExpireTime>
    <RequestId>8cdf51fd-bcd6-d79a-0ef4-e52c9b5466dc</RequestId>
</KMS>

JSON格式

{
        "ImportToken":"Base64String",
        "PublicKey":"MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAlls4uIBxD0GG84C+lGBO6Dhpf1J3XimC6cPmPNaKKJMOzoX4tD+C+r7aZv8lZ3vnPfxuxvy/YwG+whUxTEEFUdqJTOIzhPfYucupqKM92crVHIuG+xtMVeHKjyTr+UrtKCsQikqHT+19yDRN/RMoo2HUx0gmEnRyXd8t3JyUXun9FdoxKA08GrsV7nodb9ZsoBLhnev7tTLcXvLyKW6XG1ZQCQm6dPnbnwLeDXR7uK0Lqn9PM28mBIdaiQUQxj2XbM1CoJA+JiyVX3Ptdb+4rqukb4Rb05B80Bs9xV/cf7FIku08l7xGhrGiQFq+DFXwQWtwihXHZxz3LhldU+4ZPwID****",
        "KeyId":"1234abcd-12ab-34cd-56ef-12345678****",
        "TokenExpireTime":"2018-01-25T00:01:02Z",
        "RequestId":"8cdf51fd-bcd6-d79a-0ef4-e52c9b5466dc"
}

错误码

访问错误中心查看更多错误码。