As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Atualizar o valor de um AWS Secrets Manager segredo
<a name="manage_update-secret-value"></a>



Para atualizar o valor da sua chave secreta, você pode usar o console, a CLI ou um SDK. Quando você atualiza o valor do segredo, o Secrets Manager cria uma nova versão do segredo com uma rótulo de preparação `AWSCURRENT`. Você ainda pode acessar a versão antiga, que tem o rótulo da `AWSPREVIOUS`. Você também pode adicionar seus próprios rótulos. Para obter mais informações, consulte [Secrets Manager versioning](whats-in-a-secret.md#term_version) (Versionamento do Secrets Manager).

**Para atualizar o valor do segredo (console)**

1. Abra o console do Secrets Manager em [https://console.aws.amazon.com/secretsmanager/](https://console.aws.amazon.com/secretsmanager/).

1. Na lista de segredos, escolha o segredo.

1. Na página de detalhes do segredo, na guia **Visão geral**, na seção **Valor do segredo**, escolha **Recuperar o valor do segredo** e, em seguida, **Editar**. 

## AWS CLI
<a name="manage_update-secret-value_CLI"></a>

**Para atualizar o valor do segredo (AWS CLI)**
+ Quando você insere comandos em um shell de comando, existe o risco de o histórico de comandos ser acessado ou de utilitários terem acesso aos seus parâmetros de comando. Consulte [Mitigue os riscos de usar o AWS CLI para armazenar seus segredos AWS Secrets Manager](security_cli-exposure-risks.md).

  O seguinte [https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/put-secret-value.html](https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/put-secret-value.html) cria uma nova versão de um segredo com dois pares de chave/valor.

  ```
  aws secretsmanager put-secret-value \
        --secret-id MyTestSecret \
        --secret-string "{\"user\":\"diegor\",\"password\":\"EXAMPLE-PASSWORD\"}"
  ```

  O seguinte [https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/put-secret-value.html](https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/put-secret-value.html) cria uma nova versão com um rótulo de teste personalizado. A nova versão terá os rótulos `MyLabel` e `AWSCURRENT`.

  ```
  aws secretsmanager put-secret-value \
        --secret-id MyTestSecret \
        --secret-string "{\"user\":\"diegor\",\"password\":\"EXAMPLE-PASSWORD\"}"
        --version-stages "MyLabel"
  ```

## AWS SDK
<a name="manage_update-secret-value_SDK"></a>

Recomendamos que você evite chamar `PutSecretValue` ou `UpdateSecret` em uma frequência sustentada de mais de uma vez a cada dez minutos. Quando você chama `PutSecretValue` ou `UpdateSecret` para atualizar o valor do segredo, o Secrets Manager cria uma nova versão do segredo. O Secrets Manager remove versões sem rótulo quando há mais de 100, mas não remove versões criadas há menos de 24 horas. Se você atualizar o valor do segredo mais de uma vez a cada dez minutos, criará mais versões do que o Secrets Manager remove e atingirá a cota de versões de segredos.

Para atualizar o valor de um segredo, utilize as seguintes ações: [https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_UpdateSecret.html](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_UpdateSecret.html) ou [https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html). Para obter mais informações, consulte [AWS SDKs](asm_access.md#asm-sdks).