您可以使用 Google Cloud 控制台、Google Cloud CLI、用戶端程式庫或 Pub/Sub API 刪除 Pub/Sub 訂閱項目。
本文將說明如何在 Pub/Sub 中刪除訂閱項目。
- 如要管理 Google Cloud 帳戶,請參閱「管理 Cloud Billing 帳戶」。
- 如要管理 Google 帳戶,請參閱「付款與訂閱」一文。
事前準備
必要角色和權限
如要取得刪除訂閱所需的權限,請要求管理員為您授予訂閱或包含訂閱的專案的 Pub/Sub 編輯者 (roles/pubsub.editor
) IAM 角色。
這個預先定義的角色具備刪除訂閱項目所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
-
pubsub.subscriptions.delete
pubsub.subscriptions.list
- 只有在使用 Google Cloud 控制台刪除訂閱項目時,才需要這項權限。
您或許還可透過其他自訂角色或預先定義的 Pub/Sub 角色取得這些權限。
刪除訂閱項目
控制台
- 在 Google Cloud 控制台中,前往「訂閱項目」頁面。
- 選取要刪除的訂閱項目。
- 點選「刪除」。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
如要刪除訂閱項目,請執行
gcloud pubsub subscriptions delete
指令:gcloud pubsub subscriptions delete SUBSCRIPTION_ID
REST
如要刪除訂閱項目,請使用 projects.subscriptions.delete
方法:
要求:
要求必須透過 Authorization
標頭中的存取權權杖進行驗證。如要取得目前應用程式預設憑證的存取權杖:gcloud auth application-default print-access-token
。
DELETE https://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID Authorization: Bearer ACCESS_TOKEN
其中:
回應:
如果要求成功,回應會是空的 JSON 物件。
刪除是最終一致性的作業,因此其他程序可能需要一段時間才能看到其效果。
C++
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 C++。詳情請參閱 Pub/Sub C++ API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
C#
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 C#。詳情請參閱 Pub/Sub C# API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Go
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 Go。詳情請參閱 Pub/Sub Go API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 Java。詳情請參閱 Pub/Sub Java API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Node.js
Node.js
PHP
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 PHP。詳情請參閱 Pub/Sub PHP API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Python
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 Python。詳情請參閱 Pub/Sub Python API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Ruby
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 Ruby。詳情請參閱 Pub/Sub Ruby API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
您可以建立與剛剛刪除的訂閱項目相同名稱的訂閱項目。不過,新建立的訂閱項目與先前刪除的訂閱項目完全無關。舊訂閱項目的郵件不會傳送至新訂閱項目。
後續步驟
- 使用
gcloud
指令建立或修改訂閱項目。 - 使用 REST API 建立或修改訂閱項目。