Operazioni a lunga esecuzione (avanzate)

Alcuni metodi dell'API Cloud Translation restituiscono un'operazione a lunga esecuzione. Questi metodi sono asincroni e l'operazione potrebbe non essere completata quando il metodo restituisce una risposta. Puoi controllare lo stato di un'operazione o annullarla.

Stato operazione

Di seguito viene illustrato come eseguire il polling dello stato di un'operazione.

REST

Chiama il metodo get per operation risorsa.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo progetto Google Cloud
  • location-id: la posizione scelta per il bucket Cloud Storage
  • operation-id: l'ID operazione che hai ricevuto sopra

Metodo HTTP e URL:

GET https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/location-id/operations/operation-id

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-number/locations/location-id/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.translation.v3.SomeOperationMetadata",
    "state": "SUCCEEDED",
    "submitTime": "2019-11-27T22:59:40Z"
  }
}

Al termine dell'operazione, viene restituito un valore state di SUCCEEDED.

Annullamento dell'operazione

Di seguito viene mostrato come annullare un'operazione.

REST

Chiama il metodo cancel sulla risorsa operation.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo progetto Google Cloud.
  • LOCATION: la località scelta quando hai avviato l'operazione.
  • OPERATION_ID: l'ID dell'operazione da annullare.

Metodo HTTP e URL:

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION_ID/operations/OPERATION_ID:cancel

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

Risorse aggiuntive