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

Esta operação é compatível apenas com segredos genéricos. É possível realizar as seguintes ações:
- Adicionar um estágio de versão a uma versão específica do segredo.
- Remover um estágio de versão de uma versão específica do segredo.
- Remover um estágio de versão de uma versão específica do segredo e associar esse estágio a outra versão.
Cada segredo genérico pode ter, no máximo, oito estágios de versão.

Este tópico apresenta um exemplo de atualização do estágio de versão do segredo chamado secret001. Neste exemplo, o estágio de versão ACSCurrent marca a versão 002.

Depuração

Chame esta operação diretamente no OpenAPI Explorer para evitar o cálculo manual de assinaturas. Após uma chamada bem-sucedida, o OpenAPI Explorer gera automaticamente códigos de exemplo para o SDK.

Parâmetros da solicitação

Nome	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UpdateSecretVersionStage	A operação a ser executada. Defina o valor como UpdateSecretVersionStage.
SecretName	String	Sim	secret001	O nome ou o Alibaba Cloud Resource Name (ARN) do segredo. Nota Para acessar um segredo em outra conta Alibaba Cloud, especifique o ARN do segredo. O ARN segue o formato `acs:kms:${region}:${account}:secret/${secret-name}`.
VersionStage	String	Sim	ACSCurrent	O estágio de versão do segredo. Cenário 1: Adicionar um estágio de versão a uma versão específica do segredo. Especifique este parâmetro e MoveToVersion. Não especifique RemoveFromVersion. Valores válidos: ACSCurrent, ACSPrevious ou um estágio personalizado. Cenário 2: Remover um estágio de versão de uma versão específica do segredo. Especifique este parâmetro e RemoveFromVersion. Não especifique MoveToVersion. Defina este parâmetro como um estágio personalizado. Nota ACSCurrent e ACSPrevious são estágios definidos pelo sistema e não podem ser excluídos, apenas movidos entre versões do segredo. Cenário 3: Remover um estágio de versão de uma versão específica do segredo e associá-lo a outra versão. Especifique este parâmetro, MoveToVersion e RemoveFromVersion. Valores válidos: ACSCurrent, ACSPrevious ou um estágio personalizado.
RemoveFromVersion	String	Não	001	O número da versão do segredo. Este parâmetro indica a remoção do estágio de versão especificado em VersionStage desta versão. Nota Especifique pelo menos um parâmetro: RemoveFromVersion ou MoveToVersion.
MoveToVersion	String	Não	002	O número da versão do segredo. Este parâmetro indica a associação do estágio de versão especificado em VersionStage a esta versão. Nota Especifique pelo menos um parâmetro: RemoveFromVersion ou MoveToVersion. Se VersionStage for definido como ACSCurrent ou ACSPrevious, será obrigatório especificar este parâmetro.

Parâmetros de resposta

Nome	Tipo	Exemplo	Descrição
SecretName	String	secret001	O nome do segredo.
RequestId	String	8cad259f-4d77-40ec-bbd7-b9c47a423bb9	O ID da solicitação. Identificador exclusivo gerado pela Alibaba Cloud para solucionar problemas.

Exemplos

Exemplo de solicitação

http(s)://[Endpoint]/?Action=UpdateSecretVersionStage
&SecretName=secret001
&VersionStage=ACSCurrent
&RemoveFromVersion=001
&MoveToVersion=002
&Common request parameters

Exemplo de resposta

Formato XML

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

<UpdateSecretVersionStageResponse>
    <SecretName>secret001</SecretName>
    <RequestId>8cad259f-4d77-40ec-bbd7-b9c47a423bb9</RequestId>
</UpdateSecretVersionStageResponse>

Formato JSON

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

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

Códigos de erro

Para obter uma lista de códigos de erro, consulte a Central de Erros de API.