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

# 在現有的 Amazon MSK 主題上啟用和停用分層儲存
<a name="msk-enable-disable-topic-tiered-storage-cli"></a>

這些章節說明如何為已建立的主題啟用和停用分層儲存。若要建立已啟用分層儲存的新叢集和主題，請參閱[使用 AWS 管理主控台建立具有分層儲存的叢集](https://docs.aws.amazon.com//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 用戶端版本。