Ce document explique comment créer une entrée LCA et l'ajouter à une ressource LCA Managed Kafka. Si la ressource LCA Managed Kafka n'existe pas, cette opération la crée également.
Cette opération est analogue à la création d'une liaison unique de LCA Apache Kafka. Contrairement à l'opération d'update, elle ne nécessite pas d'ETag pour le contrôle de la simultanéité.
Rôles et autorisations nécessaires
Pour obtenir l'autorisation nécessaire pour ajouter une entrée LCA, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de LCA Kafka géré (roles/managedkafka.aclEditor) sur votre projet.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ce rôle prédéfini contient l'autorisation managedkafka.acls.updateEntries, qui est requise pour ajouter une entrée ACL.
Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.
Ajouter une entrée LCA
Console
Dans la console Google Cloud , accédez à la page Clusters.
Cliquez sur le nom du cluster auquel vous souhaitez ajouter une entrée de LCA.
Cliquez sur l'onglet Contrôle des accès.
Cliquez sur Créer une entrée LCA.
Dans le panneau Créer une entrée LCA, saisissez les détails de l'entrée LCA :
Dans la liste Type de ressource, sélectionnez le type de ressource de cluster auquel s'applique cette ACL. Pour en savoir plus, consultez ID de la LCA.
Si le type de ressource est
Topic,Consumer groupouTransactional ID, sélectionnez ou saisissez l'ID de la ressource.Si le type de ressource est
Topic prefix,Consumer group prefixouTransactional ID prefix, saisissez le préfixe auquel la LCA doit correspondre.Dans le champ Principal, saisissez le principal pour l'entrée ACL.
Dans la liste Type d'autorisation, sélectionnez
ALLOWouDENY.Dans la liste Opération, sélectionnez le type d'opération pour l'entrée ACL.
Cliquez sur Créer.
gcloud
Exécutez la commande gcloud managed-kafka acls add-acl-entry :
gcloud managed-kafka acls add-acl-entry ACL_ID \
--cluster=CLUSTER_ID \
--location=LOCATION \
--principal=PRINCIPAL \
--operation=OPERATION \
--permission-type=PERMISSION_TYPE \
--host=*
Remplacez les éléments suivants :
ACL_ID: ID de la ressource LCA Managed Kafka à mettre à jour. Pour en savoir plus, consultez ID de la LCA. Si un LCA Managed Kafka avec cet ID n'existe pas, il est créé automatiquement.CLUSTER_ID: ID de votre cluster Kafka.LOCATION: région de votre cluster Kafka.PRINCIPAL: principal de la nouvelle entrée LCA.OPERATION: type d'opération, tel queREADouCREATE.PERMISSION_TYPE: autorisation dont dispose le compte principal pour l'opération. IndiquezALLOWouDENY.
Exemple de commande
Exécutez la commande suivante pour autoriser un compte de service spécifique à lire un sujet nommé test-topic dans le cluster test-cluster de la région us-central1.
gcloud managed-kafka acls add-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='*'
Voici un exemple de résultat :
acl:
aclEntries:
- host: '*'
operation: READ
permissionType: ALLOW
principal: 'User:service-account@test-project.iam.gserviceaccount.com'
etag: W/another-new-etag
name: projects/test-project/locations/us-central1/clusters/test-cluster/acls/topic/test-topic
patternType: LITERAL
resourceName: test-topic
resourceType: TOPIC
aclCreated: false
Le résultat de la commande add-acl-entry fournit des informations sur l'état de la LCA :
acl: cette section décrit la ressource LCA mise à jour après l'ajout de la nouvelle entrée.aclEntries: liste contenant toutes les entrées de contrôle des accès pour cette LCA. Dans cet exemple, il inclurait désormais l'entrée qui vient d'être ajoutée. Chaque entrée comporte les champs suivants :host: hôte de l'entrée LCA.operation: opération Kafka à laquelle s'applique cette entrée.permissionType: indique si l'accès estALLOWouDENY.principal: compte d'utilisateur ou de service auquel cette entrée est associée.
etag: il s'agit de l'étiquette d'entité pour la LCA mise à jour. Il est utilisé pour le contrôle de simultanéité optimiste lors des mises à jour ultérieures. La valeur change après l'ajout d'une entrée.name: identifiant unique de la ressource LCA. Il suit le formatprojects/{project}/locations/{location}/clusters/{cluster}/acls/{acl_id}.patternType: type de modèle de ressource pour cette LCA.resourceName: nom de la ressource Kafka à laquelle s'applique cette ACL.resourceType: type de ressource Kafka.
aclCreated: valeur booléenne indiquant si la ressource LCA a été créée suite à l'ajout de cette entrée.