Creazione e aggiornamento di un gruppo dinamico

Questa pagina spiega come creare e aggiornare un gruppo dinamico.

Prima di iniziare

Esegui le seguenti attività prima di procedere con le informazioni riportate in questa pagina:

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 dynamicGroupMetadata con la query utilizzata per popolare 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 dynamicGroupMetadata con la query utilizzata per popolare il gruppo. Il seguente esempio mostra come creare un gruppo dinamico contenente tutti gli utenti esistenti nel reparto di 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 contenere dynamicGroupMetadata con la nuova query utilizzata per popolare 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 dynamicGroupMetadata con la query utilizzata per popolare il gruppo. Il seguente esempio mostra come aggiornare un gruppo dinamico contenente tutti gli utenti del reparto di ingegneria a un gruppo contenente tutti gli utenti dei reparti di 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

Dopo aver creato il gruppo dinamico, puoi recuperarlo ed elencare le sue appartenenze. Per saperne di più, consulta Recuperare un gruppo dinamico ed elencare i membri.