Todos os produtos
Search
Central de documentação

:ListSecretVersionIds

Última atualização: Jul 08, 2026

Consulta todas as versões de um segredo.

As informações de versão retornadas não incluem o valor do segredo. Por padrão, a resposta retorna apenas as versões do segredo com rótulos de estágio.

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 o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action String Sim ListSecretVersionIds

A operação a ser executada. Defina o valor como ListSecretVersionIds.

SecretName String Sim secret001

O Alibaba Cloud Resource Name (ARN) do segredo ou recurso de segredo.

Nota Ao acessar um segredo em outra conta Alibaba Cloud, insira o ARN do segredo. O ARN segue o formato acs:kms:${region}:${account}:secret/${secret-name}.
IncludeDeprecated String Não false

Define se a resposta inclui versões do segredo sem rótulos de estágio.

Valores válidos:

  • false (padrão)
  • true
PageNumber Integer Não 1

Número da página. Valor padrão: 1.

PageSize Integer Não 10

Número de entradas por página. Valor padrão: 20.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

SecretName

String

secret001

Nome do segredo.

RequestId

String

5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47

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

PageSize

Integer

10

Número de entradas por página.

PageNumber

Integer

1

Número da página.

TotalCount

Integer

1

Número total de entradas retornadas.

VersionIds

Array of VersionId

Lista de versões do segredo.

VersionId

VersionId

String

v1

ID da versão.

CreateTime

String

2024-02-21T15:39:26Z

Momento de criação da versão do segredo.

VersionStages

Array of String

{"VersionStage": ["ACSCurrent","uStage1"]}

Rótulos de estágio que marcam a versão do segredo.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=ListSecretVersionIds
&SecretName=secret001
&IncludeDeprecated=false
&PageNumber=1
&PageSize=10
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<ListSecretVersionIdsResponse>
    <SecretName>secret001</SecretName>
    <RequestId>5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <VersionIds>
        <VersionId>v1</VersionId>
        <CreateTime>2024-02-21T15:39:26Z</CreateTime>
        <VersionStages>{"VersionStage": ["ACSCurrent","uStage1"]}</VersionStages>
    </VersionIds>
</ListSecretVersionIdsResponse>

Formato JSON

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

{
  "SecretName" : "secret001",
  "RequestId" : "5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47",
  "PageSize" : 10,
  "PageNumber" : 1,
  "TotalCount" : 1,
  "VersionIds" : [ {
    "VersionId" : "v1",
    "CreateTime" : "2024-02-21T15:39:26Z",
    "VersionStages" : [ "{\"VersionStage\": [\"ACSCurrent\",\"uStage1\"]}" ]
  } ]
}

Códigos de erro

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