Creazione e aggiornamento di un gruppo dinamico

In questa pagina viene spiegato come creare e aggiornare un gruppo dinamico.

Prima di iniziare

Prima di procedere con le informazioni in questa pagina, esegui le seguenti operazioni:

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 completare 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 completare 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 contenere dynamicGroupMetadata 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 dynamicGroupMetadata con la query utilizzata per completare il gruppo. L'esempio seguente mostra come aggiornare un gruppo dinamico che contiene tutti gli utenti del settore Ingegneria a un gruppo contenente tutti gli utenti del reparto 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 e elencarne le appartenenze. Per ulteriori informazioni, consulta la sezione Recuperare un gruppo dinamico e elencare i membri.