Habilite o deshabilite el acceso directo ZooKeeper al cliente Apache

Puede deshabilitar el acceso directo de los ZooKeeper clientes Apache en su clúster aprovisionado de Amazon MSK para comprobar que sus aplicaciones no dependen de conexiones directas ZooKeeper . Cuando el ZooKeeper acceso está deshabilitado, los clientes ya no pueden conectarse a ZooKeeper los nodos de Apache en los puertos 2181 (texto sin formato) y 2182 (TLS). Puede volver a habilitar ZooKeeper el acceso en cualquier momento.

nota

Esta función solo está disponible para los clústeres aprovisionados de Amazon MSK que utilizan el modo de ZooKeeper metadatos con agentes estándar. No está disponible para los siguientes tipos de clústeres:

• Clústeres que se ejecutan en modo de KRaft metadatos

• Clústeres que utilizan corredores Express. ZooKeeper El acceso se administra automáticamente en los clústeres de Express y no se puede configurar manualmente.

• Clústeres Amazon MSK Serverless

Inhabilitar el ZooKeeper acceso mediante la consola

1. ¿Iniciar sesión en la Consola de administración de AWS consola Amazon MSK y abrirla desde https://console.aws.amazon.com/msk/casa? region=us-east-1#/home/.

2. En la lista de clústeres, elija el clúster en el que desee deshabilitar el acceso. ZooKeeper

3. Seleccione la pestaña Propiedades y, a continuación, busque la sección Configuración de redes.

4. Seleccione Desactivar el ZooKeeper acceso.

Inhabilitar el ZooKeeper acceso mediante el AWS CLI

1. Ejecute el siguiente AWS CLI comando, sustituyendo ClusterArn y Current-Cluster-Version por el ARN y la versión actual del clúster. Para buscar la versión actual del clúster, utilice la DescribeClusteroperación o el comando AWS CLI describe-cluster. Un ejemplo de ID de versión es KTVPDKIKX0DER.

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

   El resultado de este comando update-connectivity tendrá un aspecto similar al siguiente.

   {
       "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"
   }

   nota

   Para volver a habilitar el ZooKeeper acceso, utilice un AWS CLI comando similar con el siguiente valor for en su lugar: --zookeeper-access

   '{"Enabled": true}'

2. Para obtener el resultado de la update-connectivity operación, ejecute el siguiente comando y ClusterOperationArn reemplácelo por el ARN que obtuvo en el resultado del update-connectivity comando.

   aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn

   El resultado de este comando describe-cluster-operation tendrá un aspecto similar al siguiente.

   {
       "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
               }
           }
       }
   }

   Si OperationState tiene el valor UPDATE_IN_PROGRESS, espere un rato y vuelva a ejecutar el comando describe-cluster-operation.

Inhabilitar el ZooKeeper acceso mediante la API de Amazon MSK

• Para usar la API para deshabilitar o habilitar el ZooKeeper acceso a un clúster, consulte. UpdateConnectivity