HEX
Server: Apache/2.4.65 (Ubuntu)
System: Linux ielts-store-v2 6.8.0-1036-gcp #38~22.04.1-Ubuntu SMP Thu Aug 14 01:19:18 UTC 2025 x86_64
User: root (0)
PHP: 7.2.34-54+ubuntu20.04.1+deb.sury.org+1
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,
Upload Files
File: //snap/google-cloud-cli/current/help/man/man1/gcloud_iam_service-accounts_update.1
.TH "GCLOUD_IAM_SERVICE\-ACCOUNTS_UPDATE" 1



.SH "NAME"
.HP
gcloud iam service\-accounts update \- update an IAM service account



.SH "SYNOPSIS"
.HP
\f5gcloud iam service\-accounts update\fR \fISERVICE_ACCOUNT\fR [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Update an IAM service account.

If the service account does not exist, this command returns a
\f5PERMISSION_DENIED\fR error.



.SH "EXAMPLES"

To update the description and display name for a service account, run:

.RS 2m
$ gcloud iam service\-accounts update \e
    my\-iam\-account@my\-project.iam.gserviceaccount.com \e
    \-\-description="Updated description." \e
    \-\-display\-name="Updated Name"
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5service_account\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fISERVICE_ACCOUNT\fR

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

To set the \f5service_account\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5service_account\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

The new textual description for the account.

.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

The new textual name to display for the account.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "API REFERENCE"

This command uses the \fBiam/v1\fR API. The full documentation for this API can
be found at: https://cloud.google.com/iam/



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha iam service\-accounts update
.RE

.RS 2m
$ gcloud beta iam service\-accounts update
.RE