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á.

# Gerenciar a retenção de mensagens para o sistema de mensagens do SDK do Amazon Chime
<a name="manage-retention"></a>

Os proprietários da conta podem usar o Amazon Chime SDK APIs para ativar a retenção de mensagens. As mensagens são excluídas automaticamente com base no período definido pelo administrador. Os períodos de retenção podem durar de um dia a 15 anos. Você também pode usar o APIs para atualizar os períodos de retenção de mensagens ou desativar a retenção de mensagens a qualquer momento.

**Topics**
+ [Exemplos de comandos de retenção da CLI](#retention-examples)
+ [Habilitar a retenção de mensagens](#enable-retention)
+ [Restaurar e excluir mensagens](#restore-and-delete)

## Exemplos de comandos de retenção da CLI
<a name="retention-examples"></a>

Os exemplos a seguir mostram comandos da CLI típicos para retenção:

**Habilitando**

`aws chime-sdk-identity put-app-instance-retention-settings --app-instance-arn {appInstanceArn} --app-instance-retention-settings ChannelRetentionSettings={RetentionDays=60}`

**Atualizando**

`aws chime-sdk-identity put-app-instance-retention-settings --app-instance-arn {appInstanceArn} --app-instance-retention-settings ChannelRetentionSettings={RetentionDays=30}`

**Desabilitando**

`aws chime-sdk-identity put-app-instance-retention-settings --app-instance-arn {appInstanceArn} --app-instance-retention-settings ChannelRetentionSettings={}`

## Habilitar a retenção de mensagens
<a name="enable-retention"></a>

Você usa o Amazon Chime SDK APIs para ativar a retenção de mensagens. Você também pode usar o APIs para atualizar os períodos de retenção de mensagens ou desativar a retenção de mensagens a qualquer momento. Para obter mais informações sobre como configurar a retenção de mensagens, consulte a [Referência da API do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/Welcome.html).

## Restaurar e excluir mensagens
<a name="restore-and-delete"></a>

Você pode restaurar mensagens para os usuários dentro de 30 dias após definir ou atualizar um período de retenção de mensagens. No entanto, após o período de tolerância de 30 dias, todas as mensagens do chat que se enquadrem no período de retenção serão excluídas permanentemente, e as novas mensagens do chat serão excluídas permanentemente assim que passar o período de retenção.

**nota**  
Durante o período de tolerância de 30 dias, se você estender uma política de retenção, ou desativá-la, as mensagens do chat que não passarem no novo período de retenção ficarão visíveis novamente para os usuários da conta.

As mensagens também são excluídas permanentemente quando um `AppInstanceUser` exclui um canal ou uma mensagem.