Auf dieser Seite wird beschrieben, wie Sie den Lebenszyklus eines lang laufenden Vorgangs (Long-Running Operation, LRO) der Live Stream API verwalten.
Lang laufende Vorgänge werden zurückgegeben, wenn die Aufrufe von Methoden sehr lange dauern. In der Live Stream API wird beispielsweise bei jedem Aufruf von projects.locations.inputs.create ein LRO erstellt.
Der LRO verfolgt den Status des Verarbeitungsjobs.
Sie können die projects.locations.operations-Methoden verwenden, die von der Live Stream API bereitgestellt werden, um den Status von LROs zu prüfen. Sie können LROs auch auflisten, abbrechen oder löschen.
LROs werden auf der Ebene des Google Cloud-Projekts und des Standorts verwaltet. Wenn Sie eine Anfrage an die API senden, fügen Sie das Google Cloud-Projekt und den Standort hinzu, 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 zeigt, dass die Live Stream API einen LRO mit dem Namen projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID erstellt hat.
Verwenden Sie die Methode projects.locations.operations.get, um zu prüfen, ob der Eingabeendpunkt erstellt wurde. Wenn die Antwort "done": false enthält, wiederholen Sie den Befehl, bis die Antwort "done": true enthält. Dieser Vorgang kann einige Minuten dauern.
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: Ihre Google Cloud-Projektnummer. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.LOCATION: Der Standort des Eingabeendpunkts. Verwenden Sie eine der unterstützten Regionen.Standorte anzeigenus-central1us-east1us-east4us-west1us-west2northamerica-northeast1southamerica-east1asia-east1asia-east2asia-south1asia-northeast1asia-southeast1australia-southeast1europe-north1europe-west1europe-west2europe-west3europe-west4
OPERATION_ID: die Kennzeichnung 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
Verwenden Sie die Methode projects.locations.operations.list, um alle Vorgänge an einem bestimmten Standort aufzulisten.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.LOCATION: Standort der Vorgänge. Verwenden Sie eine der unterstützten Regionen.Standorte anzeigenus-central1us-east1us-east4us-west1us-west2northamerica-northeast1southamerica-east1asia-east1asia-east2asia-south1asia-northeast1asia-southeast1australia-southeast1europe-north1europe-west1europe-west2europe-west3europe-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
Wenn Sie einen asynchronen Abbruch eines lang andauernden Vorgangs starten möchten, verwenden Sie die Methode projects.locations.operations.cancel. Der Server unternimmt alles, um den Vorgang abzubrechen, aber der Erfolg kann nicht garantiert werden.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.LOCATION: Standort des Vorgangs; verwenden Sie eine der unterstützten Regionen.Standorte anzeigenus-central1us-east1us-east4us-west1us-west2northamerica-northeast1southamerica-east1asia-east1asia-east2asia-south1asia-northeast1asia-southeast1australia-southeast1europe-north1europe-west1europe-west2europe-west3europe-west4
OPERATION_ID: die Kennzeichnung für den Vorgang
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten als Antwort ein leeres JSON-Objekt erhalten:
{}
Lange laufenden Vorgang löschen
Wenn Sie einen abgeschlossenen langwierigen Vorgang löschen möchten, verwenden Sie die Methode projects.locations.operations.delete. Diese Methode zeigt an, dass der Client kein Interesse mehr an dem Ergebnis eines Vorgangs hat. Der Vorgang wird nicht abgebrochen.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.LOCATION: Standort des Vorgangs; verwenden Sie eine der unterstützten Regionen.Standorte anzeigenus-central1us-east1us-east4us-west1us-west2northamerica-northeast1southamerica-east1asia-east1asia-east2asia-south1asia-northeast1asia-southeast1australia-southeast1europe-north1europe-west1europe-west2europe-west3europe-west4
OPERATION_ID: die Kennzeichnung für den Vorgang
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten als Antwort ein leeres JSON-Objekt erhalten:
{}