Creazione e aggiornamento di un gruppo dinamico

Questa pagina spiega come creare e aggiornare un gruppo dinamico.

Prima di iniziare

Prima di procedere con le informazioni riportate in questa pagina, svolgi le seguenti attività:

Creazione di un gruppo dinamico

Di seguito è riportato un esempio di creazione di un gruppo dinamico:

REST

Per creare un gruppo dinamico, chiama groups.create() con un'istanza del gruppo. L'istanza del gruppo deve contenere il dynamicGroupMetadata con la query utilizzata per compilare il gruppo.

Python

Per creare un gruppo dinamico, chiama il metodo service.groups().create con un'istanza del gruppo. L'istanza del gruppo deve contenere il dynamicGroupMetadata con la query utilizzata per compilare il gruppo. L'esempio riportato di seguito mostra come creare un gruppo dinamico contenente tutti gli utenti esistenti nel reparto Ingegneria:

def create_dynamic_group(customer_id, email, query):
  service = build_service()
  groupDef = {
      "parent": "customerId/{}".format(customer_id),
      "groupKey": {"id": email},
      "labels": {"cloudidentity.googleapis.com/groups.discussion_forum": ""},
      "dynamicGroupMetadata": {
          "queries": [
              {
                  "resourceType": "USER",
                  "query": "user.organizations.exists(org, org.department=='engineering')"
              }
          ]
      }
  }
  request = service.groups().create(body=groupDef)
  request.uri += "&initialGroupConfig=EMPTY"
  response = request.execute()
  return response

Aggiornamento di un gruppo dinamico

Di seguito è riportato un esempio di aggiornamento di un gruppo dinamico:

REST

Per aggiornare un gruppo dinamico, chiama groups.patch() con un'istanza del gruppo. L'istanza del gruppo deve conteneredynamicGroupMetadata con la nuova query utilizzata per compilare il gruppo.

Python

Per aggiornare un gruppo dinamico, chiama il metodo service.groups().patch con il nome del gruppo da aggiornare e un'istanza del gruppo. L'istanza del gruppo deve contenere il dynamicGroupMetadata con la query utilizzata per compilare il gruppo. Il seguente esempio mostra come aggiornare un gruppo dinamico contenente tutti gli utenti del reparto Ingegneria in un gruppo contenente tutti gli utenti dei reparti Ingegneria o Finanza:

# name (i.e. groups/01234abcdeef) uniquely identifies the group
def update_dynamic_group(name, query):
  service = build_service()
  groupDef = {
    "dynamicGroupMetadata": {
    "queries": [
        {
          "resourceType": "USER",
          "query": "user.organizations.exists(org, org.department=='engineering' || org.department=='finance')"
        }
      ]
    }
  }
  request = service.groups().patch(name=name, body=groupDef)
  request.uri += "&updateMask=dynamicGroupMetadata"
  response = request.execute()

  return response

Passaggi successivi

Una volta creato il gruppo dinamico, puoi recuperarlo ed elencarne i membri. Per ulteriori informazioni, consulta Recupero di un gruppo dinamico e creazione di un elenco di membri.