gcloud secrets delete

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. Ifthe given secret does not exist, this command will succeed, but the operationwill be a no-op.
EXAMPLES
Delete a secretmy-secret:
gcloudsecretsdeletemy-secret

Delete a secretmy-secret using an etag:

gcloudsecretsdeletemy-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 otherways.

To set theproject attribute:

  • provide the argumentSECRET on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

SECRET
ID of the secret or fully qualified identifier for the secret.

To set thesecret attribute:

  • provide the argumentSECRET on the command line.
FLAGS
--etag=ETAG
Current entity tag (ETag) of the secret. If specified, the secret is deletedonly if the ETag provided matches the current secret's ETag.
Location resource - The location to delete secret. 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 argument--location on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.
--location=LOCATION
ID of the location or fully qualified identifier for the location.

To set thelocation attribute:

  • provide the argument--location 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.

NOTES
This variant is also available:
gcloudbetasecretsdelete

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.