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

Descrição da operação

Para obter mais informações sobre a política de acesso necessária para chamar esta operação como um usuário ou uma função do Resource Access Management (RAM), consulte Resource Access Management.
Esta operação suporta apenas segredos genéricos. Você pode realizar as seguintes operações:
- Adicionar um estágio de versão a uma versão de segredo especificada.
- Remover um estágio de versão de uma versão de segredo especificada.
- Remover um estágio de versão de uma versão de segredo especificada e anexá-lo a outra versão de segredo.
O número total de estágios de versão para cada segredo genérico não pode exceder 8.

Este tópico fornece um exemplo de como atualizar o estágio de versão do segredo chamado secret001. Neste exemplo, o estágio ACSCurrent é usado para marcar a versão 002.

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 Para acessar um segredo em uma conta diferente da Alibaba Cloud, você deve especificar o ARN do segredo. O ARN está no formato `acs:kms:${region}:${account}:secret/${secret-name}`.	secret001
VersionStage	string	Sim	O estágio de versão do segredo. Cenário 1: Adicionar um estágio de versão a uma versão de segredo especificada. Especifique este parâmetro e MoveToVersion. Não especifique RemoveFromVersion. Este parâmetro pode ser definido como ACSCurrent, ACSPrevious ou um estágio personalizado. Cenário 2: Remover um estágio de versão de uma versão de segredo especificada. Especifique este parâmetro e RemoveFromVersion. Não especifique MoveToVersion. Este parâmetro deve ser definido como um estágio personalizado. Nota ACSCurrent e ACSPrevious são estágios reservados pelo sistema. Você não pode removê-los diretamente. Você só pode removê-los de uma versão de segredo e anexá-los a outra. Cenário 3: Remover um estágio de versão de uma versão de segredo especificada e anexá-lo a outra versão de segredo. Especifique este parâmetro, MoveToVersion e RemoveFromVersion. Este parâmetro pode ser definido como ACSCurrent, ACSPrevious ou um estágio personalizado.	ACSCurrent
RemoveFromVersion	string	Não	O número da versão do segredo. Este parâmetro especifica que o estágio de versão definido por VersionStage é removido desta versão. Nota Você deve especificar pelo menos um entre RemoveFromVersion e MoveToVersion.	001
MoveToVersion	string	Não	O número da versão do segredo. Este parâmetro especifica que o estágio de versão definido por VersionStage é anexado a esta versão. Nota Você deve especificar pelo menos um entre RemoveFromVersion e MoveToVersion. Se você definir VersionStage como ACSCurrent ou ACSPrevious, deverá especificar este parâmetro.	002

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
SecretName	string	O nome do segredo.	secret001
RequestId	string	O ID da solicitação. A Alibaba Cloud gera um ID exclusivo para cada solicitação. Você pode usar o ID para solucionar problemas.	8cad259f-4d77-40ec-bbd7-b9c47a423bb9

Exemplos

Resposta de sucesso

JSON formato

{
  "SecretName": "secret001",
  "RequestId": "8cad259f-4d77-40ec-bbd7-b9c47a423bb9"
}

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
400	Rejected.LimitExceeded	exceed secret limits error
400	Rejected.InvalidRequest	param mismatch
400	Rejected.UnsupportedOperation	secret stages in unnormal status
500	InternalFailure	Internal Failure
403	Forbidden.NoPermission	This operation is forbidden by permission system
404	Forbidden.ResourceNotFound	Resource not found
409	Rejected.ResourceInDeleteWindow	secret in delete peroid

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.