ExportDataKey - Key Management Service: Central de Documentação do Alibaba Cloud

Descrição da operação

Precauções

Para informações sobre a política de acesso necessária para que um usuário RAM ou função RAM use esta operação, consulte Resource Access Management.
Esta operação é acessível por meio de um gateway compartilhado ou um gateway dedicado. Para mais informações, consulte Alibaba Cloud SDK.
- Gateway compartilhado: Você pode acessar o KMS usando o endpoint público ou um endpoint VPC. Para usar o endpoint público, é necessário habilitá-lo primeiro. Para mais informações, consulte Acessar a chave em uma instância KMS pela Internet.
- Gateway dedicado: Você pode acessar o KMS usando o endpoint privado da instância KMS: <YOUR_KMS_INSTANCE_ID>.cryptoservice.kms.aliyuncs.com.

Descrição

Após chamar a operação GenerateDataKeyWithoutPlaintext para obter uma chave de dados criptografada por uma chave mestra (CMK), você pode usar a operação ExportDataKey para distribuir a chave de dados para outras regiões ou módulos criptográficos. A operação ExportDataKey retorna o texto cifrado da chave de dados, recriptografado com a chave pública especificada.

Você pode importar o texto cifrado exportado no módulo criptográfico que contém a chave privada correspondente. Esse processo permite distribuir com segurança a chave de dados do KMS para um módulo criptográfico. Após a chave de dados ser importada no módulo criptográfico, você pode usá-la para criptografar ou descriptografar dados.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CiphertextBlob	string	Sim	O texto cifrado da chave de dados que é criptografada usando uma chave mestra (CMK).	ODZhOWVmZDktM2QxNi00ODk0LWJkNGYtMWZjNDNmM2YyYWJmS7FmDBBQ0BkKsQrtRnidtPwirmDcS0ZuJCU41xxAAWk4Z8qsADfbV0b+i6kQmlvj79dJdGOvtX69Uycs901q********
EncryptionContext	object	Não	Uma string JSON que consiste em pares de chave-valor. EncryptionContext é o contexto de criptografia que é passado quando a chave de dados é criptografada usando uma CMK. Para mais informações, consulte EncryptionContext.	{"Example":"Example"}
PublicKeyBlob	string	Sim	A chave pública no formato Base64.	MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAndKfC2ReLL2+y8a0+ZBBeAft/uBYo86GZiYJuflqgUzKxpyuvlo3uQkBv6b+nx+0tz8g8v7GhpPWMSW5L9mNHYsvYFsa7jTxsYdt17yj6GlUHPuMIs8hr5qbwl38IHU1iIa7nYWwE2fb3ePOvLDACRJVgGpU0yxioW80d2QD+9aU4jF5dlAahcfgsNzo2CXzCUc1+xbmNuq7Rp+H9VJB9dyYOwqnW3RhOLBo21FzpORapf0UiRlrHRpk1V6ez+aE1dofaYh/9bh0m6ioxj7j5hpZbWccuEZTMBKd+cbuBkRhJzc6Tti6qwZbDiu4fUwbZS0Tqpuo1UadiyxMW********
WrappingKeySpec	string	Sim	O tipo da chave pública especificada por PublicKeyBlob. Para mais informações sobre tipos de chave, consulte Introdução a chaves assimétricas. Valores válidos: RSA_2048 EC_SM2	RSA_2048
WrappingAlgorithm	string	Sim	O algoritmo de criptografia usado para criptografar a chave de dados usando a chave pública especificada por PublicKeyBlob. Para mais informações sobre os algoritmos, consulte AsymmetricDecrypt. Valores válidos: RSAES_OAEP_SHA_256 RSAES_OAEP_SHA_1 SM2PKE	RSAES_OAEP_SHA_256
DryRun	string	Não	Especifica se o modo DryRun deve ser ativado. true false (padrão) O modo DryRun é usado para testar a chamada de API e verificar as permissões nos recursos especificados e a validade dos parâmetros da solicitação. Se você ativar o modo DryRun, o KMS retornará uma resposta de falha e um motivo de falha. Os motivos de falha incluem os seguintes: DryRunOperationError: A solicitação teria sido bem-sucedida se o parâmetro DryRun não tivesse sido especificado. ValidationError: Os parâmetros especificados na solicitação são inválidos. AccessDeniedError: Você não está autorizado a realizar a operação no recurso KMS.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
KeyVersionId	string	O ID da versão da chave usada para descriptografar o texto cifrado da chave de dados especificada.	2ab1a983-7072-4bbc-a582-584b5bd8****
KeyId	string	O ID da CMK usada para descriptografar o texto cifrado da chave de dados especificada. O identificador globalmente exclusivo da CMK.	202b9877-5a25-46e3-a763-e20791b5****
RequestId	string	O ID da solicitação, que é um identificador exclusivo gerado pelo Alibaba Cloud para a solicitação. Você pode usar o ID da solicitação para solucionar problemas.	4bd560a1-729e-45f1-a3d9-b2a33d61046b
ExportedDataKey	string	A chave de dados exportada que é protegida por criptografia de chave pública.	BQKP+1zK6+ZEMxTP5qaVzcsgXtWplYBKm0NXdSnB5FzliFxE1bSiu4dnEIlca2JpeH7yz1/S6fed630H+hIH6DoM25fTLNcKj+mFB0Xnh9m2+HN59Mn4qyTfcUeadnfCXSWcGBouhXFwcdd2rJ3n337bzTf4jm659gZu3L0i6PLuxM9p7mqdwO0cKJPfGVfhnfMz+f4alMg79WB/NNyE2lyX7/qxvV49ObNrrJbKSFiz8Djocaf0IESNLMbfYI5bXjWkJlX92DQbKhibtQW8ZOJ//ZC6t0AWcUoKL6QDm/dg5koQalcleRinpB+QadFm894sLbVZ9+N4GVs*******

Exemplos

Resposta de sucesso

JSON formato

{
  "KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
  "KeyId": "202b9877-5a25-46e3-a763-e20791b5****",
  "RequestId": "4bd560a1-729e-45f1-a3d9-b2a33d61046b",
  "ExportedDataKey": "BQKP+1zK6+ZEMxTP5qaVzcsgXtWplYBKm0NXdSnB5FzliFxE1bSiu4dnEIlca2JpeH7yz1/S6fed630H+hIH6DoM25fTLNcKj+mFB0Xnh9m2+HN59Mn4qyTfcUeadnfCXSWcGBouhXFwcdd2rJ3n337bzTf4jm659gZu3L0i6PLuxM9p7mqdwO0cKJPfGVfhnfMz+f4alMg79WB/NNyE2lyX7/qxvV49ObNrrJbKSFiz8Djocaf0IESNLMbfYI5bXjWkJlX92DQbKhibtQW8ZOJ//ZC6t0AWcUoKL6QDm/dg5koQalcleRinpB+QadFm894sLbVZ9+N4GVs*******"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The specified parameter is not valid.	An invalid value is specified for the parameter.
500	InternalFailure	Internal Failure.
404	InvalidAccessKeyId.NotFound	The Access Key ID provided does not exist in our records.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.