本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon Chime SDK 消息传递中管理消息保留日期
<a name="manage-retention"></a>

账户所有者可以使用 Amazon Chime SDK APIs 开启消息保留功能。根据管理员设置的时间段自动删除消息。保留期可以持续一天到十五年。您也可以随时使用 APIs 来更新留言保留期或关闭留言保留期。

**Topics**
+ [CLI 保留命令示例](#retention-examples)
+ [启用消息保留日期](#enable-retention)
+ [恢复和删除消息](#restore-and-delete)

## CLI 保留命令示例
<a name="retention-examples"></a>

以下示例介绍了用于保留的典型 CLI 命令：

**正在启用**

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

**正在更新**

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

**正在禁用**

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

## 启用消息保留日期
<a name="enable-retention"></a>

您可以使用 Amazon Chime 软件开发工具包 APIs 开启消息保留功能。您也可以随时使用 APIs 来更新留言保留期或关闭留言保留期。如需了解有关配置消息保留的更多信息，请参阅 [Amazon Chime SDK API 参考](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/Welcome.html)。

## 恢复和删除消息
<a name="restore-and-delete"></a>

您可以在设置或更新消息保留期后 30 天内将消息还原给用户。但是，在该 30 天宽限期之后，保留期内的所有消息都将永久删除，新消息在保留期过后也会永久删除。

**注意**  
在 30 天宽限期内，如果您延长保留策略期限或将其关闭，那么尚未超过新保留期的消息将再次对账户中的用户可见。

`AppInstanceUser` 删除频道或消息时，消息也会被永久删除。