Operazioni a lunga esecuzione

L'API Submission è asincrona e restituisce un'operazione a lunga esecuzione. L'operazione potrebbe non essere completata quando il metodo restituisce una risposta.

Recupero dello stato di un'operazione

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

Chiama il metodo GET per il tipo Operations.

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

• project-number: il numero del tuo progetto Google Cloud
• operation-id: il tuo ID operazione

Metodo HTTP e URL:

GET https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id"

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/project-number/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.webrisk.v1.SubmitUriMetadata",
    "state": "RUNNING"
  }
  "done": false,
  ...
}

Al termine dell'operazione, viene restituito uno dei seguenti valori per state:

• SUCCEEDED: indica che l'URL inviato è stato aggiunto alla lista bloccata di Navigazione sicura.

• CLOSED: indica che non è stato rilevato che l'URL inviato viola le norme di Navigazione sicura e che non è stato aggiunto alla lista bloccata di Navigazione sicura nelle ultime 24 ore.