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

Descrição da operação

Para obter informações sobre a política de acesso que deve ser concedida a um usuário RAM ou função RAM para chamar esta operação, consulte Controle de acesso.

Esta operação pode ser chamada por meio de um gateway compartilhado. Para mais informações, consulte Alibaba Cloud SDK.

Gateway compartilhado: Acesse o KMS por meio de endpoints públicos ou de VPC.

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.

Sintaxe da solicitação

GET  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DataKeyName	string	Não	O nome da chave de dados gerenciada (DK). Este parâmetro é obrigatório.	example-data-key.
DataKeyVersionId	string	Não	O número da versão da chave de dados gerenciada (DK). Este parâmetro é opcional. Se você definir este parâmetro como um número de versão específico, o texto simples da versão especificada da chave de dados gerenciada (DK) será retornado.	xH6OPUmz.
UseLatest	boolean	Não	Especifica se deve ser usada a versão mais recente da chave de dados gerenciada (DK) quando nenhum número de versão for fornecido. Valores válidos: true: Retorna a versão mais recente da chave de dados gerenciada (DK). false: Retorna a primeira versão da chave de dados gerenciada (DK). Valor padrão: false.	true.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação. O Alibaba Cloud gera um identificador exclusivo para cada solicitação. Você pode usar o ID da solicitação para solucionar problemas.	4bd560a1-729e-45f1-a3d9-b2a33d61046b
DataKeyName	string	O nome da chave de dados gerenciada (DK).	example-data-key.
DataKeyVersionName	string	O nome da credencial que armazena o material da chave da versão da chave de dados gerenciada (DK) retornada.	kms-datakeyversion!example-data-key!xH6OPUmz.
DataKeyVersionId	string	O número da versão da chave de dados gerenciada (DK) retornada.	xH6OPUmz.
Plaintext	string	O valor de texto simples codificado em Base64 da chave de dados (DK).	CYueyVmZJ2MfA1VSZV2jCbFT8bO7StAvBnHacplr9aI=

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4bd560a1-729e-45f1-a3d9-b2a33d61046b",
  "DataKeyName": "example-data-key",
  "DataKeyVersionName": "kms-datakeyversion!example-data-key!xH6OPUmz",
  "DataKeyVersionId": "xH6OPUmz\n",
  "Plaintext": "CYueyVmZJ2MfA1VSZV2jCbFT8bO7StAvBnHacplr9aI="
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.