Consulta todas as versões de uma CMK especificada.
Descrição da operação
Para obter mais informações sobre a política de acesso necessária para que um usuário RAM ou uma 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 obter mais informações, consulte Usar aliases. |
key-hzz630494463ejqjx**** |
| PageNumber |
integer |
Não |
O número da página a ser retornada. As páginas começam na página 1. Valor padrão: 1. |
1 |
| PageSize |
integer |
Não |
O número de entradas a serem retornadas em cada página. Valores válidos: 0 a 101. Valor padrão: 10. |
10 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| PageSize |
integer |
O número de entradas retornadas por página. |
10 |
| RequestId |
string |
O ID da solicitação. |
f71204c4-53cd-4eea-b405-653ba2db7e86 |
| PageNumber |
integer |
O número da página retornada. |
1 |
| TotalCount |
integer |
O número total de versões de chave retornadas. |
3 |
| KeyVersions |
object |
||
| KeyVersion |
array<object> |
Um array que consiste em versões de chave. |
|
|
object |
|||
| KeyId |
string |
The globally unique ID of the CMK. Nota
If you set the KeyId parameter to the alias of the CMK, the ID of the CMK to which the alias is bound is returned. |
key-hzz630494463ejqjx**** |
| KeyVersionId |
string |
The globally unique ID of the CMK version. |
1e3304fd-68ac-4d5b-8886-ae5f01a1**** |
| CreationDate |
string |
The date and time when the CMK version was created. The time is displayed in UTC. |
2024-03-25T10:42:40Z |
Exemplos
Resposta de sucesso
JSON formato
{
"PageSize": 10,
"RequestId": "f71204c4-53cd-4eea-b405-653ba2db7e86",
"PageNumber": 1,
"TotalCount": 3,
"KeyVersions": {
"KeyVersion": [
{
"KeyId": "key-hzz630494463ejqjx****",
"KeyVersionId": "1e3304fd-68ac-4d5b-8886-ae5f01a1****",
"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. | |
| 404 | Forbidden.KeyNotFound | The specified Key is not found. | The error message returned because the specified CMK does not exist. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.