シークレットを削除する

このページでは、シークレットとそのすべてのバージョンを削除する方法について説明します。

シークレット バージョンのみを削除するには、シークレット バージョンを破棄するをご覧ください。

必要なロール

シークレットを削除するために必要な権限を取得するには、シークレット、プロジェクト、フォルダ、または組織に対するSecret Manager 管理者 roles/secretmanager.admin)の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

シークレットを削除する

シークレットを削除するには、次のいずれかの方法を使用します。

コンソール

  1. コンソールで、[Secret Manager] ページに移動します。 Google Cloud

    Secret Manager に移動

  2. 削除するシークレットを選択します。

  3. [ アクション] をクリックしてから、[削除] をクリックします。

  4. 表示される確認ダイアログで、シークレットの名前を入力して、 [**シークレットを削除**] をクリックします。

gcloud

後述のコマンドデータを使用する前に、 次のように置き換えます。

  • SECRET_ID: シークレットの ID

次のコマンドを実行します。

Linux、macOS、Cloud Shell

gcloud secrets delete SECRET_ID

Windows(PowerShell)

gcloud secrets delete SECRET_ID

Windows(cmd.exe)

gcloud secrets delete SECRET_ID

レスポンスでシークレットが返されます。

REST

リクエストのデータを使用する前に、 次のように置き換えます。

  • PROJECT_ID: プロジェクト ID Google Cloud
  • SECRET_ID: シークレットの ID

HTTP メソッドと URL:

DELETE https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID

リクエストの本文(JSON):

{}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID"

PowerShell

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{}

C#

このコードを実行するには、まず C# 開発環境を設定し、 Secret Manager C# SDK をインストールします。 Compute Engine または GKE では、cloud-platform スコープを使用して認証する必要があります。


using Google.Cloud.SecretManager.V1;

public class DeleteSecretSample
{
    public void DeleteSecret(
      string projectId = "my-project",