Consulta os metadados de uma versão específica de CMK.
Descrição da operação
Este tópico fornece um exemplo de como consultar as informações sobre uma versão da CMK 1234abcd-12ab-34cd-56ef-12345678****. O ID da versão da CMK é 2ab1a983-7072-4bbc-a582-584b5bd8****. A resposta mostra que a hora de criação da versão da CMK é 2016-03-25T10:42:40Z.
Para mais informações sobre a política de acesso necessária para que um usuário RAM ou função RAM chame esta API, consulte Resource Access Management.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| KeyId |
string |
Sim |
O ID globalmente exclusivo da CMK. Você também pode definir este parâmetro como um alias vinculado à CMK. Para mais informações, consulte Visão geral de alias. |
key-hzz630494463ejqjx**** |
| KeyVersionId |
string |
Sim |
O ID globalmente exclusivo da versão da CMK. Você pode chamar a operação ListKeyVersions para consultar as versões da CMK. |
2ab1a983-7072-4bbc-a582-584b5bd8**** |
Para mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| RequestId |
string |
O ID da solicitação. |
7021b6ec-4be7-4d3c-8a68-1e85d4d515a0 |
| KeyVersion |
object |
Os metadados da versão da CMK. |
|
| KeyId |
string |
O ID globalmente exclusivo da CMK. Nota
Se você definir o parâmetro KeyId na solicitação como um alias da CMK, o ID da CMK à qual o alias está vinculado será retornado. |
key-hzz630494463ejqjx**** |
| KeyVersionId |
string |
O ID globalmente exclusivo da versão da CMK. |
2ab1a983-7072-4bbc-a582-584b5bd8**** |
| CreationDate |
string |
A data e hora em que a versão da CMK foi criada. A hora é exibida em UTC. |
2024-03-25T10:42:40Z |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "7021b6ec-4be7-4d3c-8a68-1e85d4d515a0",
"KeyVersion": {
"KeyId": "key-hzz630494463ejqjx****",
"KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
"CreationDate": "2024-03-25T10:42:40Z"
}
}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. |
| 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.