本頁說明如何停用密鑰版本。密鑰版本可處於下列三種狀態之一:
- 
    已啟用 
- 
    已停用 
- 
   已刪除 
停用密鑰版本後,您就無法存取該版本。如要還原存取權,請重新啟用該版本。
必要的角色
    
      如要取得停用密鑰版本所需的權限,請要求管理員為您授予密鑰的 Secret Manager 密鑰版本管理員  (roles/secretmanager.secretVersionManager) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
  
  
停用密鑰版本
如要停用密鑰版本,請使用下列其中一種方法:
控制台
- 
    前往 Google Cloud 控制台的「Secret Manager」頁面。 
- 
    
    在「Secret Manager」頁面中,按一下「Regional secrets」分頁標籤,然後點選密鑰來存取其版本。 
- 
    在密鑰詳細資料頁面的「版本」分頁中,選取要存取的密鑰版本。 
- 
    找出要停用的密鑰版本,然後按一下「動作」,再按一下「停用」。 
- 
    在隨即顯示的確認對話方塊中,按一下「停用所選版本」。 
gcloud
使用下列任何指令資料之前,請先替換以下項目:
- VERSION_ID:密鑰版本的 ID
- SECRET_ID:密鑰的 ID
- LOCATION:密鑰的 Google Cloud 位置
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud secrets versions disable VERSION_ID --secret=SECRET_ID --location=LOCATION
Windows (PowerShell)
gcloud secrets versions disable VERSION_ID --secret=SECRET_ID --location=LOCATION
Windows (cmd.exe)
gcloud secrets versions disable VERSION_ID --secret=SECRET_ID --location=LOCATION
REST
使用任何要求資料之前,請先替換以下項目:
- LOCATION:密鑰的 Google Cloud 位置
- PROJECT_ID:專案 ID Google Cloud
- SECRET_ID:密鑰的 ID
- VERSION_ID:密鑰版本的 ID
HTTP 方法和網址:
POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:disable
JSON 要求主體:
{}
如要傳送要求,請選擇以下其中一個選項:
curl
      將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:disable"
PowerShell
      將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:disable" | Select-Object -Expand Content
您應該會收到如下的 JSON 回應:
{
  "name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID",
  "createTime": "2024-09-02T07:16:34.566706Z",
  "state": "DISABLED",
  "etag": "\"16214546481514\""
}
Go
如要執行這段程式碼,請先設定 Go 開發環境,並安裝 Secret Manager Go SDK。在 Compute Engine 或 GKE 上,您必須使用 cloud-platform 範圍進行驗證。
Java
如要執行這段程式碼,請先設定 Java 開發環境,並安裝 Secret Manager Java SDK。在 Compute Engine 或 GKE 上,您必須使用 cloud-platform 範圍進行驗證。
Node.js
如要執行這段程式碼,請先設定 Node.js 開發環境,並安裝 Secret Manager Node.js SDK。在 Compute Engine 或 GKE 上,您必須使用 cloud-platform 範圍進行驗證。
Python
如要執行這段程式碼,請先設定 Python 開發環境,然後安裝 Secret Manager Python SDK。在 Compute Engine 或 GKE 上,您必須使用 cloud-platform 範圍進行驗證。