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

# 停用或啟用直接 Apache ZooKeeper 用戶端存取
<a name="zookeeper-disable-access"></a>

您可以在 Amazon MSK 佈建叢集上停用直接 Apache ZooKeeper 用戶端存取，以確認您的應用程式不依賴直接 ZooKeeper 連線。停用 ZooKeeper 存取時，用戶端無法再連線到連接埠 2181 （純文字） 和 2182 (TLS) 上的 Apache ZooKeeper 節點。您可以隨時重新啟用 ZooKeeper 存取。

**注意**  
此功能僅適用於搭配標準代理程式使用 ZooKeeper 中繼資料模式的 Amazon MSK 佈建叢集。它不適用於下列叢集類型：  
在 KRaft 中繼資料模式中執行的叢集
使用 Express 代理程式的叢集。ZooKeeper 存取是在 Express 叢集中自動管理，無法手動設定。
Amazon MSK Serverless 叢集

**使用主控台停用 ZooKeeper 存取**

1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/msk/home 開啟 Amazon MSK 主控台？region=us-east-1\#/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/)。

1. 在叢集清單中，選擇您要停用 ZooKeeper 存取的叢集。

1. 選擇**屬性**索引標籤，然後尋找**網路設定**區段。

1. 選擇**停用 ZooKeeper 存取**。

**使用 停用 ZooKeeper 存取 AWS CLI**

1. 執行下列 AWS CLI 命令，將 {{ClusterArn}} 和 {{Current-Cluster-Version}} 取代為 ARN 和目前版本的叢集。若要尋找叢集的目前版本，請使用 [DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster) 操作或 [describe-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html) AWS CLI 命令。範例版本為`KTVPDKIKX0DER`。

   ```
   aws kafka update-connectivity --cluster-arn {{ClusterArn}} --current-version {{Current-Cluster-Version}} --zookeeper-access '{"Enabled": false}'
   ```

   此 `update-connectivity` 命令的輸出如以下 JSON 範例所示。

   ```
   {
       "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
       "ClusterOperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef"
   }
   ```
**注意**  
若要重新啟用 ZooKeeper 存取，請`--zookeeper-access`改用具有下列值的類似 AWS CLI 命令：  

   ```
   '{"Enabled": true}'
   ```

1. 如要取得 `update-connectivity` 操作的結果，請執行下列命令，使用您在 `update-connectivity` 命令輸出中取得的 ARN 取代 {{ClusterOperationArn}}。

   ```
   aws kafka describe-cluster-operation --cluster-operation-arn {{ClusterOperationArn}}
   ```

   此 `describe-cluster-operation` 命令的輸出如以下 JSON 範例所示。

   ```
   {
       "ClusterOperationInfo": {
           "ClientRequestId": "982168a3-939f-11e9-8a62-538df00285db",
           "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
           "CreationTime": "2026-01-15T21:08:57.735Z",
           "OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
           "OperationState": "UPDATE_COMPLETE",
           "OperationType": "UPDATE_CONNECTIVITY",
           "SourceClusterInfo": {
               "ZookeeperAccess": {
                   "Enabled": true
               }
           },
           "TargetClusterInfo": {
               "ZookeeperAccess": {
                   "Enabled": false
               }
           }
       }
   }
   ```

   如果 `OperationState` 具有值 `UPDATE_IN_PROGRESS`，請稍候一段時間，然後再次執行 `describe-cluster-operation` 命令。

**使用 Amazon MSK API 停用 ZooKeeper 存取**
+ 若要使用 API 在叢集上停用或啟用 ZooKeeper 存取，請參閱 [UpdateConnectivity](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-connectivity.html)。