Nachdem Sie ein Abo erstellt haben, können Sie die Übermittlungsmethode in Push, Pull oder Export ändern.
Hinweis
- Erstellen Sie eines der unterstützten Abos.
Erforderliche Rollen und Berechtigungen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Pub/Sub-Editor (roles/pubsub.editor) für das Abo zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Ändern eines Abotyps benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigung pubsub.subscriptions.update, die zum Ändern eines Abotyps erforderlich ist.
Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Sie können die Zugriffssteuerung auf Projektebene und auf der Ebene einzelner Ressourcen konfigurieren. Sie können ein Abo in einem Projekt erstellen und es an ein Thema in einem anderen Projekt anhängen. Prüfen Sie, ob Sie die erforderlichen Berechtigungen für jedes Projekt haben.
Zustellungstyp eines Abos ändern
So ändern Sie den Bereitstellungstyp eines Abos:
Console
Rufen Sie in der Cloud de Confiance Console die Seite Abos auf.
Klicken Sie auf den Namen des Abos, das Sie aktualisieren möchten.
Klicken Sie auf der Seite mit den Abodetails auf Bearbeiten.
Wählen Sie unter Zustellungstyp den neuen Zustellungstyp aus.
Geben Sie die Attribute für den neuen Abotyp ein. Weitere Informationen finden Sie in den folgenden Themen:
Optional. Aktualisieren Sie bei Bedarf weitere Aboeigenschaften.
Klicken Sie auf Aktualisieren.
gcloud
Verwenden Sie den Befehl gcloud pubsub subscriptions update, um den Übermittlungstyp zu ändern. Löschen Sie die Konfiguration für den aktuellen Bereitstellungstyp und legen Sie die Konfiguration für den neuen Typ fest:
gcloud pubsub subscriptions update SUBSCRIPTION_ID \
CLEAR_CONFIG_FLAG \
NEW_CONFIG_FLAGS
Ersetzen Sie Folgendes:
SUBSCRIPTION_ID: Der Name des Abos, das aktualisiert werden soll.
CLEAR_CONFIG_FLAG: Ein Flag zum Löschen der vorhandenen Konfiguration für den Übermittlungstyp. Verwenden Sie je nach aktuellem Bereitstellungstyp eines der folgenden Flags:
Pull-Abo:
--no-enable-exactly-once-deliveryPush-Abo:
--push-endpoint=""BigQuery-Abo:
--clear-bigquery-configBigtable-Abo:
--clear-bigtable-configCloud Storage-Abo:
--clear-cloud-storage-config
NEW_CONFIG_FLAGS: Flags zum Konfigurieren des neuen Bereitstellungstyps. Weitere Informationen finden Sie in der Dokumentation zum Befehl
gcloud pubsub subscriptions update.
Beispiele
BigQuery-Abo in ein Pull-Abo ändern:
gcloud pubsub subscriptions update SUBSCRIPTION_ID \
--clear-bigquery-config
Push-Abo in ein BigQuery-Abo ändern:
gcloud pubsub subscriptions update SUBSCRIPTION_ID \
--push-endpoint="" \
--bigquery-table=BIGQUERY_TABLE
Push-Abo-Endpunkt aktualisieren
So aktualisieren Sie die Endpunkt-URL für ein Push-Abo:
Console
So ändern Sie die Endpunkt-URL:
- Rufen Sie in der Cloud de Confiance Console die Seite Abos auf.
- Klicken Sie neben dem Abo, das Sie aktualisieren möchten, auf more_vert.
- Wählen Sie unter Lieferart eine Lieferoption aus.
- Füllen Sie nach Bedarf weitere Abo-Properties aus.
- Klicken Sie auf Aktualisieren.
gcloud
-
Aktivieren Sie Cloud Shell in der Cloud de Confiance Console.
Unten in der Cloud de Confiance Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.
-
Führen Sie den Befehl
gcloud pubsub subscriptions modify-push-configaus, um die Endpunkt-URL zu ändern:gcloud pubsub subscriptions modify-push-config SUBSCRIPTION_ID \ --push-endpoint=PUSH_ENDPOINT
Wenn für das Abo bereits die Pull-Bereitstellung verwendet wird, wird durch Festlegen des Push-Endpunkts die Bereitstellungsmethode auf Push-Bereitstellung umgestellt.
Sie können von Push- zu Pull-Zustellung wechseln, indem Sie den Push-Endpunkt in einen leeren String ändern.
REST
Verwenden Sie die Methode projects.subscriptions.modifyPushConfig, um die Push-Konfigurationen eines Abos zu ändern:
Anfrage:
Die Anfrage muss mit einem Zugriffstoken im Header Authorization authentifiziert werden. So rufen Sie ein Zugriffstoken für die aktuellen Standardanmeldedaten für Anwendungen ab: gcloud auth application-default print-access-token.
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID:modifyPushConfig Authorization: Bearer ACCESS_TOKEN
Anfragetext:
{
"pushConfig": {
"pushEndpoint": "PUSH_ENDPOINT"
}
}Wobei:
https://myproject.appspot.com/myhandler.Response:
Wenn die Anfrage erfolgreich ist, ist die Antwort ein leeres JSON-Objekt.
C++
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für C++ in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Pub/Sub C++ API-Referenzdokumentation.
C#
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für C# in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub C# API.
Go
Im folgenden Beispiel wird die Hauptversion der Go Pub/Sub-Clientbibliothek (v2) verwendet. Wenn Sie noch die v1-Bibliothek verwenden, finden Sie hier die Migrationsanleitung zu v2. Eine Liste der v1-Codebeispiele finden Sie unter Verworfene Codebeispiele.
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Go-Einrichtungsanleitung in der Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Pub/Sub Go API-Referenzdokumentation.
Java
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Java in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Java API.
Node.js
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Node.js in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Pub/Sub Node.js API-Referenzdokumentation.
Node.ts
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Node.js in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Pub/Sub Node.js API-Referenzdokumentation.
Python
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Python in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Python API.
Ruby
Im folgenden Beispiel wird die Ruby Pub/Sub-Clientbibliothek v3 verwendet. Wenn Sie noch die v2-Bibliothek verwenden, lesen Sie die Migrationsanleitung zu v3. Eine Liste der Ruby v2-Codebeispiele finden Sie unter eingestellte Codebeispiele.
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Pub/Sub Ruby API-Referenzdokumentation.
Nächste Schritte
- Abo mit
gcloud-Befehlen erstellen oder ändern - Erstellen oder ändern Sie ein Abo mit REST APIs.