- NAME
-
- gcloud iam service-accounts update - update an IAM service account
- SYNOPSIS
-
-
gcloud iam service-accounts updateSERVICE_ACCOUNT[--description=DESCRIPTION] [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
- Update an IAM service account.
If the service account does not exist, this command returns a
PERMISSION_DENIEDerror. - EXAMPLES
- To update the description and display name for a service account, run:
gcloud iam service-accounts update my-iam-account@my-project.iam.gserviceaccount.com --description = "Updated description." --display-name = "Updated Name" - POSITIONAL ARGUMENTS
-
- ServiceAccount resource - The service account to update. The account should be
formatted either as a numeric service account ID or as an email, like this:
123456789876543212345 or my-iam-account@somedomain.com. This represents a Cloud
resource. (NOTE) Some attributes are not given arguments in this group but can
be set in other ways.
To set the
projectattribute:- provide the argument
service_accounton the command line with a fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
-
SERVICE_ACCOUNT - ID of the serviceAccount or fully qualified identifier for the serviceAccount.
To set the
service_accountattribute:- provide the argument
service_accounton the command line.
- provide the argument
- provide the argument
- ServiceAccount resource - The service account to update. The account should be
formatted either as a numeric service account ID or as an email, like this:
123456789876543212345 or my-iam-account@somedomain.com. This represents a Cloud
resource. (NOTE) Some attributes are not given arguments in this group but can
be set in other ways.
- FLAGS
-
-
--description=DESCRIPTION - The new textual description for the account.
-
--display-name=DISPLAY_NAME - The new textual name to display for the account.
-
- 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
iam/v1API. The full documentation for this API can be found at: https://cloud.google.com/iam/ - NOTES
- These variants are also available:
gcloud alpha iam service-accounts updategcloud beta iam service-accounts update
gcloud iam service-accounts 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 2026-05-27 UTC.
