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

Consulta todas as informações de versão de um segredo.

Descrição da operação

Para obter detalhes sobre a política de acesso necessária para que um usuário do Resource Access Management (RAM) ou uma função do RAM invoque esta operação, consulte Controle de acesso.
As informações de versão não incluem valores de segredo. Por padrão, apenas as versões de segredo que possuem estágios de versão são retornadas.

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.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
SecretName	string	Sim	O nome do segredo ou o Amazon Resource Name (ARN) do segredo. Nota Ao acessar um segredo em outra conta da Alibaba Cloud, você deve especificar o ARN do segredo. O formato do ARN do segredo é `acs:kms:${region}:${account}:secret/${secret-name}`.	secret001
IncludeDeprecated	string	Não	Especifica se as versões de segredo que não possuem estágios de versão devem ser incluídas na resposta. Valores válidos: false (padrão): não inclui true: inclui	false
PageNumber	integer	Não	O número da página atual em uma consulta paginada. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página em uma consulta paginada. Valor padrão: 20.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
SecretName	string	O nome do segredo.	secret001
RequestId	string	O ID da solicitação. O ID é um identificador exclusivo gerado pela Alibaba Cloud para a solicitação e pode ser usado para solucionar problemas.	5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47
PageSize	integer	O tamanho da página atual.	10
PageNumber	integer	O número da página atual.	1
TotalCount	integer	O número total de entradas.	1
VersionIds	object
VersionId	array<object>	A lista de informações de versão do segredo.
	array<object>	A lista de informações de versão do segredo.
VersionId	string	O ID da versão.	v1
CreateTime	string	A hora em que a versão foi criada.	2024-02-21T15:39:26Z
VersionStages	object
VersionStage	array	Os rótulos de estágio da versão.
	string	Os rótulos de estágio da versão.	{"VersionStage": ["ACSCurrent","uStage1"]}

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	InvalidParameter	some of the specified parameters "\" is not valid
500	InternalFailure	Internal Failure
403	Forbidden.NoPermission	This operation is forbidden by permission system
404	Forbidden.ResourceNotFound	Resource not found

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.