- NAME
-
- gcloud alpha identity groups update - update a group
- SYNOPSIS
-
-
gcloud alpha identity groups update
EMAIL
[--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. - POSITIONAL ARGUMENTS
-
EMAIL
- The email address of the group to be updated.
- FLAGS
-
-
At most one of these may 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 may 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 may 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.
-
At most one of these may be specified:
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--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/ - EXAMPLES
-
To update a group:
gcloud alpha identity groups update eng-discuss@foo.com --display-name="New Engineer Discuss" --description="Group for engineering discussions"
- NOTES
-
This command is currently in ALPHA and may change without notice. If this
command fails with API permission errors despite specifying the right project,
you may 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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2020-12-15 UTC.