gcloud beta identity groups update Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud beta identity groups update - update a group
- SYNOPSIS
gcloud beta identity groups updateEMAIL[--dynamic-user-query=DYNAMIC_USER_QUERY][--labels=LABELS][--clear-posix-groups|--remove-posix-groups=[POSIX_GROUP,…]][--clear-description|--description=DESCRIPTION][--clear-display-name|--display-name=DISPLAY_NAME][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(BETA)Update a group.- EXAMPLES
- To update a group:
gcloudbetaidentitygroupsupdateeng-discuss@foo.com--display-name="New Engineer Discuss"--description="Group for engineering discussions"To remove POSIX information from a Google Group:
gcloudbetaidentitygroupsupdateeng-discuss@foo.com--remove-posix-groups=eng - POSITIONAL ARGUMENTS
EMAIL- The email address of the group to be updated.
- FLAGS
--dynamic-user-query=DYNAMIC_USER_QUERY- Query that determines the memberships of the dynamic group.
Example of a query:
--dynamic-user-query="user.organizations.exists(org,org.title=='SWE')" --labels=LABELS- One or more label entries that apply to the group. Currently supported labelscontain a key with an empty value.
Google Groups are the default type of group and have a label with a key of'cloudidentity.googleapis.com/groups.discussion_forum' and an empty value.
Existing Google Groups can have an additional label with a key of'cloudidentity.googleapis.com/groups.security' and an empty value added to them.
This is an immutable change and the security label cannot be removed onceadded.Dynamic groups have a label with a key of'cloudidentity.googleapis.com/groups.dynamic'.
Identity-mapped groups for Cloud Search have a label with a key of'system/groups/external' and an empty value.
Examples: {"cloudidentity.googleapis.com/groups.discussion_forum": ""} or{"system/groups/external": ""}.
- At most one of these can be specified:
--clear-posix-groups- Clear all POSIX groups from the specified Cloud Identity group.
--remove-posix-groups=[POSIX_GROUP,…]- Remove POSIX groups from the specified Cloud Identity group. You can specifymultiple POSIX groups by either name or gid by using a comma-separated list.
For example, use '--remove-posix-groups=1005,1006' to remove POSIX groups withgroup ids '1005' and '1006', or use '--remove-posix-groups=eng,docs' to removePOSIX groups named 'eng' and 'docs'.
- At most one of these can be specified:
--clear-description- Clear existing description on group being updated.
--description=DESCRIPTION- Replace existing description on group being updated.
- At most one of these can be specified:
--clear-display-name- Clear existing display name on group being updated.
--display-name=DISPLAY_NAME- Replace existing display name on group being updated.
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$gcloud helpfor details. - API REFERENCE
- This command uses the
cloudidentity/v1beta1API. The fulldocumentation for this API can be found at:https://cloud.google.com/identity/ - NOTES
- This command is currently in beta and might change without notice. Thesevariants are also available:
gcloudidentitygroupsupdategcloudalphaidentitygroupsupdate
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-05-07 UTC.