In questa pagina viene descritto come gestire il ciclo di vita di un'API Live Stream un'operazione a lunga esecuzione (LRO).
Le operazioni a lunga esecuzione vengono restituite quando il metodo
il completamento delle chiamate potrebbe richiedere molto tempo. Ad esempio, l'API Live Stream
crea un LRO ogni volta che chiami
projects.locations.inputs.create
L'LRO monitora lo stato del job di elaborazione.
Puoi utilizzare i metodi projects.locations.operations
offerti dall'API Live Stream per controllare lo stato
LRO Puoi anche elencare, annullare o
o elimina gli LRO.
Gli LRO vengono gestiti a livello di progetto e località Google Cloud. Quando effettui una richiesta all'API, includi il progetto Google Cloud e della località in cui viene eseguito l'LRO.
Il registro di un LRO viene conservato per circa 30 giorni dopo l'LRO non sarà possibile visualizzare o elencare un LRO dopo questo punto.
Visualizza i dettagli di un'operazione a lunga esecuzione
Supponi di aver creato un endpoint di input.
Il valore name
nella risposta indica che l'API Live Stream
ha creato un LRO denominato projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID
.
Per verificare se l'endpoint di input è stato creato, utilizza il metodo
projects.locations.operations.get
. Se la risposta contiene "done": false
, ripeti il comando fino a quando
la risposta contiene "done": true
. Questa operazione può richiedere alcuni minuti
completato.
Puoi anche recuperare il nome LRO elenca le operazioni a lunga esecuzione.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il tuo progetto Google Cloud numero; che si trova nel campo Numero progetto nella Pagina Impostazioni IAMLOCATION
: la posizione in cui si trova l'endpoint di input localizzato; utilizza una delle regioni supportateMostra localitàus-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
: identificatore dell'operazione
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "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" } }
Elenca operazioni a lunga esecuzione
Per elencare tutte le operazioni in una determinata località, utilizza
projects.locations.operations.list
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il tuo progetto Google Cloud numero; che si trova nel campo Numero progetto nella Pagina Impostazioni IAMLOCATION
: la sede delle operazioni; utilizza una delle regioni supportateMostra localitàus-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
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "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" } } ] }
Annullare un'operazione a lunga esecuzione
Per avviare l'annullamento asincrono su un'operazione a lunga esecuzione, utilizza la classe
projects.locations.operations.cancel
. Il server fa il possibile per annullare l'operazione, ma l'operazione riesce
non è garantito.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il tuo progetto Google Cloud numero; che si trova nel campo Numero progetto nella Pagina Impostazioni IAMLOCATION
: la località dell'operazione; utilizza una delle regioni supportateMostra localitàus-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
: identificatore dell'operazione
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere un oggetto JSON vuoto come risposta:{}
Elimina un'operazione a lunga esecuzione
Per eliminare un'operazione a lunga esecuzione completata, utilizza
projects.locations.operations.delete
. Questo metodo indica che il cliente non è più interessato alla
risultato dell'operazione. L'operazione non viene annullata.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: il tuo progetto Google Cloud numero; che si trova nel campo Numero progetto nella Pagina Impostazioni IAMLOCATION
: la località dell'operazione; utilizza una delle regioni supportateMostra localitàus-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
: identificatore dell'operazione
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere un oggetto JSON vuoto come risposta:{}