Creazione e aggiornamento di un gruppo dinamico
Questa pagina spiega come creare e aggiornare un gruppo dinamico.
Prima di iniziare
Prima di continuare con le informazioni in questa pagina, esegui le operazioni seguenti:
Leggi la panoramica dell'API Groups.
Leggi la panoramica dei gruppi dinamici.
(Facoltativo) Formula e testa una query di appartenenza.
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 parametro
dynamicGroupMetadata
con la query utilizzata per completare il gruppo.
Python
Per creare un gruppo dinamico, chiama il metodo service.groups().create
con
di un'istanza del gruppo. L'istanza del gruppo deve contenere il
dynamicGroupMetadata
con la query utilizzata per compilare il gruppo. La
l'esempio seguente illustra come creare un gruppo dinamico contenente tutti gli utenti
nel dipartimento 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
dynamicGroupMetadata
con la query utilizzata per compilare il gruppo. La
il seguente esempio mostra come aggiornare un gruppo dinamico contenente tutti gli utenti in
Engineering in un gruppo contenente tutti gli utenti dei gruppi Ingegneria o Finanza
reparti:
# 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 Recupero di un gruppo dinamico e creazione di un elenco di membri.