Gruppi di client

I gruppi client consentono di raggruppare un set di client in base alle comunità. Lo scopo principale dei gruppi client è quello di semplificare la configurazione dell'autorizzazione. È possibile autorizzare un gruppo client a pubblicare o sottoscrivere uno spazio di argomenti. Tutti i client nel gruppo client sono autorizzati a eseguire l'azione di pubblicazione o sottoscrizione nello spazio degli argomenti.

In uno spazio dei nomi viene fornito un gruppo client predefinito denominato "$all". Il gruppo client include tutti i client nello spazio dei nomi. Per semplificare i test, è possibile usare $all per configurare le autorizzazioni.

Nota

• Il nome del gruppo client può essere lungo 3-50 caratteri
• Il nome del gruppo client può includere caratteri alfanumerici, trattini (-) e, senza spazi
• Il nome del gruppo client deve essere univoco per ogni spazio dei nomi
• $all è il gruppo client predefinito che include tutti i client nello spazio dei nomi. Questo gruppo non può essere modificato o eliminato

Considerazioni sul gruppo client

È consigliabile mantenere la quantità di gruppi client di piccole dimensioni per rendere gestibili le autorizzazioni.

Attualmente, è supportato un massimo di 10 gruppi client per spazio dei nomi.

Durante il raggruppamento dei client, assicurarsi che sia più semplice riutilizzare il gruppo per pubblicare e sottoscrivere più spazi di argomento. A questo scopo, è importante considerare gli scenari end-to-end per identificare gli argomenti a cui ogni client pubblica o sottoscrive.

È consigliabile identificare le comunità negli scenari, per evitare la frammentazione dei gruppi client e degli spazi degli argomenti. Impostare gli attributi client abbastanza generici per ottenere un raggruppamento semplice ed evitare query di gruppo estremamente complesse.

Come creare query di gruppo client?

Per configurare un gruppo client, è necessario compilare una query che filtra un set di client in base ai valori degli attributi.

Di seguito vengono fornite alcune query di esempio:

• (attributes.sensors = "motion" o attributes.sensors = "humidity") o attributes.type = "home-sensors"
• attributes.sensors IN ["motion", "humidity", "temperature"] e attributes.floor <= 5
• authenticationName IN ['client1', 'client2']

Nelle query di gruppo sono consentiti gli operandi seguenti:

• Operatore di uguaglianza "="
• Parentesi "()" per raggruppare le espressioni per controllare l'ordine delle operazioni
• Gli operatori logici "and" , "or" , "and" hanno una precedenza superiore a "or"
• Operatore diverso da uguale in due forme "<>" e "!="
• Minore di "<", maggiore di ">", minore di uguale a "<=", maggiore di uguale a ">=" per i valori long integer
• "IN" da confrontare con un set di valori

Schema del gruppo client di esempio

{
  "properties": {
    "description": "Description of client group",
    "query": "attributes.b IN ['a', 'b', 'c']"
  }
}

Configurazione del portale di Azure

Usare la procedura seguente per creare un gruppo client:

1. Passare allo spazio dei nomi nel portale di Azure

2. In Gruppi client selezionare + Gruppo client.

   

3. Aggiungere una query del gruppo client.

   

4. Selezionare Crea.

Configurazione dell'interfaccia della riga di comando di Azure

Usare i comandi seguenti per creare/visualizzare/eliminare un gruppo client

Creare un gruppo client

az eventgrid namespace client-group create -g myRG --namespace-name myNS -n myCG 

Ottenere un gruppo client

az eventgrid namespace client-group show -g myRG --namespace-name myNS -n myCG

Eliminare un gruppo client

az eventgrid namespace client-group delete -g myRG --namespace-name myNS -n myCG

Passaggi successivi

• Informazioni sugli spazi degli argomenti