Todos os produtos
Search
Central de documentação

:ListKeyVersions

Última atualização: Jul 08, 2026

Consulta todas as versões de uma chave.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action String Sim ListKeyVersions

Operação a ser executada. Defina o valor como ListKeyVersions.

KeyId String Sim key-hzz630494463ejqjx****

ID, alias ou Alibaba Cloud Resource Name (ARN) da chave. Para mais informações, consulte Gerenciar um alias de chave.

Nota Ao acessar uma chave em outra conta Alibaba Cloud, insira o ARN da chave. O ARN da chave segue o formato acs:kms:${region}:${account}:key/${keyid}.
PageNumber Integer Sim 1

Número da página.

A numeração começa em 1.

Valor padrão: 1.

PageSize Integer Não 10

Número de entradas por página.

Valores válidos: 0 a 101.

Valor padrão: 10.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

PageSize

Integer

10

Número de entradas por página.

RequestId

String

f71204c4-53cd-4eea-b405-653ba2db7e86

ID da solicitação, usado para localizar e solucionar problemas.

PageNumber

Integer

1

Número da página.

TotalCount

Integer

3

Total de versões de chave retornadas.

KeyVersions

Array of KeyVersion

Lista de versões de chave.

KeyVersion

KeyId

String

key-hzz630494463ejqjx****

ID da chave. Se KeyId for definido como alias ou ARN da chave, o sistema retorna o ID da chave.

KeyVersionId

String

1e3304fd-68ac-4d5b-8886-ae5f01a1****

ID da versão da chave. Deve ser globalmente único.

CreationDate

String

2024-03-25T10:42:40Z

Data e hora de criação da versão da chave, exibidas em UTC.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=ListKeyVersions
&KeyId=key-hzz630494463ejqjx****
&PageNumber=1
&PageSize=10
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ListKeyVersionsResponse>
    <PageSize>10</PageSize>
    <RequestId>f71204c4-53cd-4eea-b405-653ba2db7e86</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>3</TotalCount>
    <KeyVersions>
        <KeyId>key-hzz630494463ejqjx****</KeyId>
        <KeyVersionId>1e3304fd-68ac-4d5b-8886-ae5f01a1****</KeyVersionId>
        <CreationDate>2024-03-25T10:42:40Z</CreationDate>
    </KeyVersions>
</ListKeyVersionsResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageSize" : 10,
  "RequestId" : "f71204c4-53cd-4eea-b405-653ba2db7e86",
  "PageNumber" : 1,
  "TotalCount" : 3,
  "KeyVersions" : [ {
    "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.

O parâmetro especificado é inválido.

404

Forbidden.KeyNotFound

The specified Key is not found.

A chave especificada não existe.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.