- NAME
- 
- gcloud secrets delete - delete a secret
 
- SYNOPSIS
- 
- 
gcloud secrets deleteSECRET[--etag=ETAG] [--location=LOCATION] [GCLOUD_WIDE_FLAG …]
 
- 
- DESCRIPTION
- Delete a secret and destroy all secret versions. This action is irreversible. If the given secret does not exist, this command will succeed, but the operation will be a no-op.
- EXAMPLES
- 
Delete a secret my-secret:gcloud secrets delete my-secretDelete a secret my-secretusing an etag:gcloud secrets delete my-secret --etag=123
- POSITIONAL ARGUMENTS
- 
- 
Secret resource - The secret to delete. 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 SECRETon the command line with a fully specified name;
- 
provide the argument --projecton the command line;
- 
set the property core/project.
 This must be specified. - SECRET
- 
ID of the secret or fully qualified identifier for the secret.
To set the secretattribute:- 
provide the argument SECRETon the command line.
 
- 
provide the argument 
 
- 
provide the argument 
 
- 
Secret resource - The secret to delete. This represents a Cloud resource. (NOTE)
Some attributes are not given arguments in this group but can be set in other
ways.
- FLAGS
- 
- --etag=- ETAG
- Current entity tag (ETag) of the secret. If specified, the secret is deleted only if the ETag provided matches the current secret's ETag.
- 
Location resource - The location to delete secret. 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 --locationon the command line with a fully specified name;
- 
provide the argument --projecton the command line;
- 
set the property core/project.
 - --location=- LOCATION
- 
ID of the location or fully qualified identifier for the location.
To set the locationattribute:- 
provide the argument --locationon the command line.
 
- 
provide the argument 
 
- 
provide the argument 
 
- 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.
- NOTES
- 
This variant is also available:
gcloud beta secrets delete
      gcloud secrets delete
  
  
  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 2025-05-07 UTC.