gcloud alpha iam service-accounts update

NAME
gcloud alpha iam service-accounts update - update an IAM service account
SYNOPSIS
gcloud alpha iam service-accounts updateSERVICE_ACCOUNT[--description=DESCRIPTION][--display-name=DISPLAY_NAME][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA) Update an IAM service account.

If the service account does not exist, this command returns aPERMISSION_DENIED error.

EXAMPLES
To update the description and display name for a service account, run:
gcloudalphaiamservice-accountsupdatemy-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 beformatted either as a numeric service account ID or as an email, like this:123456789876543212345 or my-iam-account@somedomain.com. This represents a Cloudresource. (NOTE) Some attributes are not given arguments in this group but canbe set in other ways.

To set theproject attribute:

  • provide the argumentservice_account on the command line with afully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

SERVICE_ACCOUNT
ID of the serviceAccount or fully qualified identifier for the serviceAccount.

To set theservice_account attribute:

  • provide the argumentservice_account on the command line.
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 help for details.

API REFERENCE
This command uses theiam/v1 API. The full documentation for thisAPI can be found at:https://cloud.google.com/iam/
NOTES
This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudiamservice-accountsupdate
gcloudbetaiamservice-accountsupdate

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.