gcloud: Tue Mar 1 04:29:52 UTC 2022

gcloud/alpha/identity/groups/update

@@ -0,0 +1,105 @@
+NAME
+    gcloud alpha identity groups update - update a group
+
+SYNOPSIS
+    gcloud alpha identity groups update EMAIL
+        [--dynamic-user-query=DYNAMIC_USER_QUERY]
+        [--add-posix-group=POSIX_GROUP | --clear-posix-groups
+          | --remove-posix-groups=[POSIX_GROUP,...]]
+        [--clear-description | --description=DESCRIPTION]
+        [--clear-display-name | --display-name=DISPLAY_NAME]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) Update a group.
+
+EXAMPLES
+    To update a group:
+
+        $ gcloud alpha identity groups update eng-discuss@foo.com  \
+            --display-name="New Engineer Discuss"  \
+            --description="Group for engineering discussions"
+
+    To create a POSIX group from an existing Google Group:
+
+        $ gcloud alpha identity groups update eng-discuss@foo.com \
+            --add-posix-group=name=eng,gid=1005
+
+    To remove POSIX information from a Google Group:
+
+        $ gcloud alpha identity groups update eng-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')"
+
+     At most one of these can be specified:
+
+       --add-posix-group=POSIX_GROUP
+          Group id (gid) and a name for a POSIX group that you want to add to
+          the specified Cloud Identity group. You can specify multiple POSIX
+          groups to add with multiple instances of this flag.
+
+          For example, use '--add-posix-group=gid=1005,name=eng' to add a
+          single group, or '--add-posix-group=gid=1005,name=eng
+          --add-posix-group=gid=1006,name=docs' to add multiple groups.
+
+       --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
+          specify multiple 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 with group ids '1005' and '1006', or use
+          '--remove-posix-groups=eng,docs' to remove POSIX 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 the cloudidentity/v1alpha1 API. The full documentation
+    for this API can be found at: https://cloud.google.com/identity/
+
+NOTES
+    This command is currently in alpha and might change without notice. If this
+    command fails with API permission errors despite specifying the correct
+    project, you might be trying to access an API with an invitation-only early
+    access allowlist. These variants are also available:
+
+        $ gcloud identity groups update
+
+        $ gcloud beta identity groups update
+