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

# 在现有 Amazon MSK 主题上启用和禁用分层存储
<a name="msk-enable-disable-topic-tiered-storage-cli"></a>

这些小节介绍如何在已创建的主题上启用和禁用分层存储。要创建启用了分层存储的新集群和主题，请参阅[使用 Amazon Web Services 管理控制台创建启用了分层存储的集群](https://docs.amazonaws.cn//msk/latest/developerguide/msk-create-cluster-tiered-storage-console)。

## 在现有 Amazon MSK 主题上启用分层存储
<a name="msk-enable-topic-tiered-storage-cli"></a>

要在现有主题上启用分层存储，请使用以下示例中的 `alter` 命令语法。在已经存在的主题上启用分层存储后，您不会受到某个 Apache Kafka 客户端版本的限制。

```
bin/kafka-configs.sh --bootstrap-server $bsrv --alter --entity-type topics --entity-name msk-ts-topic --add-config 'remote.storage.enable=true, local.retention.ms=604800000, retention.ms=15550000000'
```

## 在现有 Amazon MSK 主题上禁用分层存储
<a name="msk-disable-topic-tiered-storage-cli"></a>

要在现有主题上禁用分层存储，请按照启用分层存储时的顺序使用 `alter` 命令语法。

```
bin/kafka-configs.sh --bootstrap-server $bs --alter --entity-type topics --entity-name MSKTutorialTopic --add-config 'remote.log.msk.disable.policy=Delete, remote.storage.enable=false'
```

**注意**  
禁用分层存储后，就会完全删除分层存储中的主题数据。Apache Kafka 会保留主存储数据，但仍会应用基于 `local.retention.ms` 的主保留规则。禁用主题的分层存储后，便无法再次启用分层存储。要在现有主题上禁用分层存储，您不会受到某个 Apache Kafka 客户端版本的限制。