View a markdown version of this page

Desative ou habilite o acesso direto ao ZooKeeper cliente Apache - Amazon Managed Streaming for Apache Kafka

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Desative ou habilite o acesso direto ao ZooKeeper cliente Apache

Você pode desativar o acesso direto ao ZooKeeper cliente Apache em seu cluster provisionado pelo Amazon MSK para verificar se seus aplicativos não dependem de conexões diretas. ZooKeeper Quando o ZooKeeper acesso é desativado, os clientes não podem mais se conectar aos ZooKeeper nós do Apache nas portas 2181 (texto sem formatação) e 2182 (TLS). Você pode reativar o ZooKeeper acesso a qualquer momento.

nota

Esse recurso está disponível somente para clusters provisionados pelo Amazon MSK que usam o modo de ZooKeeper metadados com corretores padrão. Ele não está disponível para os seguintes tipos de cluster:

  • Clusters em execução no modo de metadados Kraft

  • Clusters usando corretores Express. ZooKeeper o acesso é gerenciado automaticamente em clusters Express e não pode ser configurado manualmente.

  • Clusters sem servidor Amazon MSK

Desativando ZooKeeper o acesso usando o console

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon MSK em https://console.aws.amazon.com/msk/home? region=us-east-1#/home/.

  2. Na lista de clusters, escolha o cluster no qual você deseja desativar o ZooKeeper acesso.

  3. Escolha a guia Propriedades e, em seguida, encontre a seção Configurações de rede.

  4. Escolha Desativar ZooKeeper acesso.

Desativando o ZooKeeper acesso usando o AWS CLI

  1. Execute o AWS CLI comando a seguir, substituindo ClusterArn e Current-Cluster-Version pelo ARN e pela versão atual do cluster. Para encontrar a versão atual do cluster, use a DescribeCluster operação ou o comando https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html AWS CLI describe-cluster. Uma versão de exemplo é KTVPDKIKX0DER.

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

    A saída desse comando update-connectivity é semelhante ao seguinte JSON de exemplo.

    {
    "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 reativar o ZooKeeper acesso, use um AWS CLI comando semelhante com o seguinte valor para--zookeeper-access:

    '{"Enabled": true}'

  2. Para obter o resultado da update-connectivity operação, execute o comando a seguir, ClusterOperationArn substituindo-o pelo ARN obtido na saída do update-connectivity comando.

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

    A saída desse comando describe-cluster-operation é semelhante ao seguinte JSON de exemplo.

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

    Se OperationState tiver o valor UPDATE_IN_PROGRESS, aguarde um pouco e execute o comando describe-cluster-operation novamente.

Desabilitar o ZooKeeper acesso usando a API Amazon MSK

  • Para usar a API para desativar ou ativar o ZooKeeper acesso em um cluster, consulte UpdateConnectivity.