gcloud beta iam service-accounts disable

NAME
gcloud beta iam service-accounts disable - disable an IAM service account
SYNOPSIS
gcloud beta iam service-accounts disableSERVICE_ACCOUNT[GCLOUD_WIDE_FLAG …]
DESCRIPTION
(BETA) Disable an IAM service account. After the service account isdisabled, credential generation and API requests using this service account willfail. Usinggcloud iam service-accounts enable to re-enable it.

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

EXAMPLES
To disable a service account from your project, run:
gcloudbetaiamservice-accountsdisablemy-iam-account@my-project.iam.gserviceaccount.com
POSITIONAL ARGUMENTS
ServiceAccount resource - The IAM service account to disable. This represents aCloud resource. (NOTE) Some attributes are not given arguments in this group butcan be 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.
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 beta and might change without notice. Thesevariants are also available:
gcloudiamservice-accountsdisable
gcloudalphaiamservice-accountsdisable

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.