Dynamische Gruppe erstellen und aktualisieren

Auf dieser Seite erfahren Sie, wie Sie eine dynamische Gruppe erstellen und aktualisieren.

Hinweise

Führen Sie folgende Aufgaben aus, bevor Sie die Informationen auf dieser Seite umsetzen:

Dynamische Gruppe erstellen

Das folgende Beispiel zeigt die Erstellung einer dynamischen Gruppe:

REST

Rufen Sie zum Erstellen einer dynamischen Gruppe groups.create() mit einer Instanz der Gruppe auf. Die Instanz der Gruppe muss die dynamicGroupMetadata mit der Abfrage enthalten, die zum Befüllen der Gruppe verwendet wird.

Python

Rufen Sie zum Erstellen einer dynamischen Gruppe die Methode service.groups().create mit einer Instanz der Gruppe auf. Die Instanz der Gruppe muss die dynamicGroupMetadata mit der Abfrage enthalten, die zum Befüllen der Gruppe verwendet wird. Im folgenden Beispiel wird gezeigt, wie Sie eine dynamische Gruppe mit allen Nutzern in der Engineeringabteilung erstellen:

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

Dynamische Gruppe aktualisieren

Das folgende Beispiel zeigt die Aktualisierung einer dynamischen Gruppe:

REST

Rufen Sie zum Aktualisieren einer dynamischen Gruppe groups.patch() mit einer Instanz der Gruppe auf. Die Instanz der Gruppe muss den dynamicGroupMetadata mit der neuen Abfrage enthalten, die zum Füllen einer neuen Gruppe verwendet wird.

Python

Rufen Sie zum Aktualisieren einer dynamischen Gruppe die Methode service.groups().patch mit dem Namen der zu aktualisierenden Gruppe und einer Instanz der Gruppe auf. Die Instanz der Gruppe muss die dynamicGroupMetadata mit der Abfrage enthalten, die zum Befüllen der Gruppe verwendet wird. Im folgenden Beispiel wird gezeigt, wie Sie eine dynamische Gruppe mit allen Nutzern im Engineering auf eine Gruppe aktualisieren, die alle Nutzer in den Abteilungen Engineering oder Finanzen enthält:

# 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

Nächste Schritte

Sobald die dynamische Gruppe vorhanden ist, können Sie sie abrufen und die Mitgliedschaften auflisten. Weitere Informationen finden Sie unter Dynamische Gruppe abrufen und Mitglieder auflisten.