Auf dieser Seite wird beschrieben, wie du den Lebenszyklus einer Live Stream API verwaltest. Lang andauernder Vorgang.
Lang andauernde Vorgänge werden bei folgenden Methoden zurückgegeben:
lange dauern. Beispiel: Die Live Stream API
erstellt bei jedem Anruf einen LRO
projects.locations.inputs.create
Der LRO verfolgt den Status des Verarbeitungsjobs.
Sie können dazu die projects.locations.operations
-Methoden verwenden.
die die Live Stream API bereitstellt, um den Status
LROs. Sie können auch auflisten, abbrechen,
oder löschen Sie LROs.
LROs werden auf Google Cloud-Projekt- und Standortebene verwaltet. Geben Sie bei einer Anfrage an die API das Google Cloud-Projekt an und den Standort, an dem der LRO ausgeführt wird.
Der Datensatz eines LRO wird für etwa 30 Tage gespeichert, nachdem der LRO abgeschlossen wurde. Dies bedeutet, dass Sie nach diesem Zeitpunkt den LRO nicht mehr aufrufen oder auflisten können.
Details zu einem lang andauernden Vorgang abrufen
Angenommen, Sie haben einen Eingabeendpunkt erstellt.
Der Wert name
in der Antwort gibt an, dass die Live Stream API
hat einen LRO mit dem Namen projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID
erstellt.
Mit dem Befehl
projects.locations.operations.get
. Wenn die Antwort "done": false
enthält, wiederholen Sie den Befehl, bis der
Antwort enthält "done": true
. Dieser Vorgang kann einige Minuten dauern,
abgeschlossen ist.
Sie können den Namen des LRO auch abrufen, indem Sie lang laufende Vorgänge auflisten.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER
: Ihr Google Cloud-Projekt Zahl; Sie finden sie im Feld Projektnummer auf der Seite IAM-EinstellungenLOCATION
: der Ort, an dem sich der Eingabeendpunkt befindet gefunden; eine der unterstützten Regionen verwendenStandorte anzeigenus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
OPERATION_ID
: die Kennung für den Vorgang
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.video.livestream.v1.OperationMetadata", "createTime": CREATE_TIME, "endTime": END_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.video.livestream.v1.Input", "name": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "type": "RTMP_PUSH", "uri": INPUT_STREAM_URI, # For example, "rtmp://1.2.3.4/live/b8ebdd94-c8d9-4d88-a16e-b963c43a953b", "tier": "HD" } }
Lange laufende Vorgänge auflisten
Um alle Vorgänge an einem bestimmten Standort aufzulisten, verwenden Sie die Methode
projects.locations.operations.list
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER
: Ihr Google Cloud-Projekt Zahl; Sie finden sie im Feld Projektnummer auf der Seite IAM-EinstellungenLOCATION
: Standort der Vorgänge; eine der unterstützten Regionen verwendenStandorte anzeigenus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "operations": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.livestream.v1.OperationMetadata", "createTime": CREATE_TIME, "endTime": END_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/INPUT_ID, "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/my-other-operation", "metadata": { "@type": "type.googleapis.com/google.cloud.livestream.v1.OperationMetadata", "createTime": CREATE_TIME, "endTime": END_TIME, "target": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/my-other-input", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.livestream.v1.Input", "name": "projects/PROJECT_NUMBER/locations/LOCATION/inputs/my-other-input", "createTime": CREATE_TIME, "updateTime": UPDATE_TIME, "type": "RTMP_PUSH", "uri": INPUT_STREAM_URI, "tier": "HD" } } ] }
Lange laufenden Vorgang abbrechen
Um den asynchronen Abbruch eines lang andauernden Vorgangs zu starten, verwenden Sie die Methode
projects.locations.operations.cancel
. Der Server unternimmt alles, um den Vorgang abzubrechen, aber Erfolg ist
nicht garantiert werden.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER
: Ihr Google Cloud-Projekt Zahl; Sie finden sie im Feld Projektnummer auf der Seite IAM-EinstellungenLOCATION
: Standort des Vorgangs; eine der unterstützten Regionen verwendenStandorte anzeigenus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
OPERATION_ID
: die Kennung für den Vorgang
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten ein leeres JSON-Objekt als Antwort erhalten: <ph type="x-smartling-placeholder">{}
Lange laufenden Vorgang löschen
Löschen Sie einen abgeschlossenen Vorgang mit langer Ausführungszeit mithilfe der Methode
projects.locations.operations.delete
. Diese Methode zeigt an, dass der Kunde kein Interesse mehr an der
Ergebnis des Vorgangs. Der Vorgang wird nicht abgebrochen.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER
: Ihr Google Cloud-Projekt Zahl; Sie finden sie im Feld Projektnummer auf der Seite IAM-EinstellungenLOCATION
: Standort des Vorgangs; eine der unterstützten Regionen verwendenStandorte anzeigenus-central1
us-east1
us-east4
us-west1
us-west2
northamerica-northeast1
southamerica-east1
asia-east1
asia-east2
asia-northeast1
asia-southeast1
australia-southeast1
europe-west1
europe-west2
europe-west3
europe-west4
OPERATION_ID
: die Kennung für den Vorgang
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten ein leeres JSON-Objekt als Antwort erhalten: <ph type="x-smartling-placeholder">{}