기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 직접 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 Management Console하고 [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` 작업 결과를 가져오려면 다음 명령을 실행하여 {{ClusterOperationArn}}을 `update-connectivity` 명령의 출력에서 가져온 ARN으로 바꿉니다.

   ```
   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)를 참조하세요.