建立訂閱項目後,您可以將提交方式變更為推送、提取或匯出。
事前準備
- 建立支援的訂閱項目。
必要角色和權限
如要取得變更及管理訂閱類型所需的權限,請要求管理員為您授予主題或專案的 Pub/Sub 編輯者 (roles/pubsub.editor
) 身分與存取權管理角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
這個預先定義的角色包含變更和管理訂閱類型所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
如要變更及管理訂閱類型,您必須具備下列權限:
-
從訂閱項目提取:
pubsub.subscriptions.consume
-
建立訂閱項目:
pubsub.subscriptions.create
-
刪除訂閱項目:
pubsub.subscriptions.delete
-
取得訂閱項目:
pubsub.subscriptions.get
-
列出訂閱項目:
pubsub.subscriptions.list
-
更新訂閱:
pubsub.subscriptions.update
-
將訂閱項目附加至主題:
pubsub.topics.attachSubscription
-
取得訂閱項目的身分與存取權管理政策:
pubsub.subscriptions.getIamPolicy
-
設定訂閱項目的 IAM 政策:
pubsub.subscriptions.setIamPolicy
您可以在專案層級和個別資源層級設定存取權控管。您可以在一個專案中建立訂閱項目,然後將其附加至位於其他專案的主題。請確認您具備每個專案的必要權限。
修改提交方式
您可以切換不同的訂閱類型。
控制台
如要修改訂閱項目,請完成下列步驟。
- 在 Google Cloud 控制台中,前往「訂閱項目」頁面。
- 按一下要更新的訂閱項目旁邊的 more_vert。
- 在「運送類型」中,選擇運送選項。
- 視需要填入其他訂閱屬性。
- 按一下「更新」。
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 modify-push-config
指令:gcloud pubsub subscriptions modify-push-config SUBSCRIPTION_ID \ --push-endpoint=PUSH_ENDPOINT
如果訂閱項目已使用提取傳送,設定推送端點會將傳送方式切換為推送傳送。
您可以將推送端點變更為空字串,藉此切換至提取傳送。
REST
如要修改訂閱項目的推送設定,請使用 projects.subscriptions.modifyPushConfig
方法:
要求:
要求必須透過 Authorization
標頭中的存取權權杖進行驗證。如要取得目前應用程式預設憑證的存取權杖:gcloud auth application-default print-access-token
。
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID:modifyPushConfig Authorization: Bearer ACCESS_TOKEN
要求主體:
{ "pushConfig": { "pushEndpoint": "PUSH_ENDPOINT" } }
其中:
https://myproject.appspot.com/myhandler
。回應:
如果要求成功,回應會是空的 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
Python
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 Python。詳情請參閱 Pub/Sub Python API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Ruby
在嘗試這個範例之前,請先按照 Pub/Sub 快速入門:使用用戶端程式庫中的操作說明設定 Ruby。詳情請參閱 Pub/Sub Ruby API 參考說明文件。
如要向 Pub/Sub 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
後續步驟
- 使用
gcloud
指令建立或修改訂閱項目。 - 使用 REST API 建立或修改訂閱項目。