Remover uma entrada de ACL de uma ACL do Kafka gerenciado

Este documento descreve como remover uma entrada de ACL de um recurso de ACL do Kafka gerenciado.

Remover uma entrada de ACL é análogo a excluir uma única vinculação de ACL do Apache Kafka. Ao contrário da operação de atualização, essa operação não exige uma ETag para controle de simultaneidade.

Papéis e permissões necessárias

Para receber a permissão necessária para remover uma entrada de ACL, peça ao administrador para conceder a você o papel do IAM de Editor de ACLs do Kafka gerenciado (roles/managedkafka.aclEditor) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão managedkafka.acls.updateEntries, necessária para remover uma entrada de ACL.

Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.

Remover uma entrada de ACL

Console

  1. No Google Cloud console, acesse a página Clusters.

    Acessar Clusters

  2. Clique no nome do cluster que contém a entrada de ACL.

  3. Clique na guia Controle de acesso.

  4. Na lista Entradas de ACL, selecione uma ou mais entradas para excluir.

  5. Clique em Excluir.

gcloud

Execute o comando gcloud managed-kafka acls remove-acl-entry:

gcloud managed-kafka acls remove-acl-entry ACL_ID \
  --cluster=CLUSTER_ID \
  --location=LOCATION \
  --principal=PRINCIPAL \
  --operation=OPERATION \
  --permission-type=PERMISSION-TYPE \
  --host=*

Substitua:

  • ACL_ID. O ID do recurso de ACL do Kafka gerenciado a ser atualizado. Para mais informações, consulte ID da ACL.

  • CLUSTER_ID O ID do seu cluster do Kafka.

  • LOCATION A região do seu cluster do Kafka.

  • PRINCIPAL: o principal da entrada de ACL a ser removida.

  • OPERATION: o tipo de operação, como READ ou CREATE, da entrada de ACL a ser removida.

  • PERMISSION_TYPE: o tipo de permissão (ALLOW ou DENY) da entrada de ACL a ser removida.

Juntas, as flags --principal, --operation e --permission-type especificam qual entrada de ACL será removida.

Comando de amostra

Execute o comando a seguir para remover uma entrada de ACL que permite que uma conta de serviço específica leia de um tópico chamado test-topic no cluster test-cluster na região us-central1. Se essa entrada for a única, a ACL será excluída e a resposta vai conter deleted: True. Caso contrário, a entrada de ACL atualizada será retornada.

gcloud managed-kafka acls remove-acl-entry topic/test-topic \
  --cluster=test-cluster \
  --location=us-central1 \
  --principal='User:service-account@test-project.iam.gserviceaccount.com' \
  --operation=READ \
  --permission-type=ALLOW \
  --host='*' \

A seguir

Apache Kafka® é uma marca registrada da The Apache Software Foundation ou afiliadas nos Estados Unidos e/ou em outros países.