gcloud beta identity groups update

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 help for details.

API REFERENCE
This command uses thecloudidentity/v1beta1 API. 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:
gcloudidentitygroupsupdate
gcloudalphaidentitygroupsupdate

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.