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 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 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. Il seguente esempio mostra come creare un gruppo dinamico contenente tutti gli utenti esistenti nel reparto Engineering:
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
Aggiornare 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 completare 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 riportato di seguito mostra come aggiornare un gruppo dinamico contenente tutti gli utenti del reparto 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 ed elencarne le appartenenze. Per ulteriori informazioni, consulta la sezione Recuperare un gruppo dinamico e inserire un elenco di membri.