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

Consulta todos os IDs de versão e rótulos de estágio de um segredo especificado.

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 função RAM chame esta OpenAPI, consulte Resource Access Management.
As informações de versão não incluem o valor do segredo. Por padrão, esta operação retorna apenas as versões do segredo que estão marcadas com um estágio de versão.

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 ou o Alibaba Cloud Resource Name (ARN) do segredo. Nota Ao acessar um segredo que pertence a outra conta da Alibaba Cloud, você deve especificar o ARN do segredo. O ARN de um segredo está no formato `acs:kms:${region}:${account}:secret/${secret-name}`.	secret001
IncludeDeprecated	string	Não	Especifica se devem ser incluídas na resposta as versões do segredo que não possuem estágios de versão. Valores válidos: false (padrão): Não true: Sim	false
PageNumber	integer	Não	O número da página a ser retornada para uma consulta paginada. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas a serem retornadas em cada página para 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, que é um identificador exclusivo gerado pela Alibaba Cloud. Você pode usar este ID para solucionar problemas.	5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47
PageSize	integer	O número de entradas retornadas em cada página.	10
PageNumber	integer	O número da página retornada.	1
TotalCount	integer	O número total de entradas.	1
VersionIds	object
VersionId	array<object>	Uma lista de informações de versão do segredo.
	array<object>	Uma lista de informações de versão do segredo.
VersionId	string	The version number.	v1
CreateTime	string	The time when the version was created.	2024-02-21T15:39:26Z
VersionStages	object
VersionStage	array	The stage labels of the version.
	string	The stage labels of the version.	{"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.