本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 管理 Amazon Chime SDK 訊息的訊息保留
<a name="manage-retention"></a>

帳戶擁有者可以使用 Amazon Chime SDK APIs 來開啟訊息的保留。系統會根據管理員設定的期限自動刪除訊息。保留期可以持續一天到 15 年。您也可以使用 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 SDK 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`刪除訊息。