Opérations de longue durée

L'API Submission est asynchrone et renvoie une opération de longue durée. L'opération risque de ne pas être terminée lorsque la méthode renvoie une réponse.

Obtenir l'état d'une opération

Pour interroger l'état d'une opération, procédez comme suit :

Appelez la méthode GET pour le type "Opérations".

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • project-number : numéro de votre projet Google Cloud.
  • operation-id : ID d'opération

Méthode HTTP et URL :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

PowerShell

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Une fois l'opération terminée, l'une des valeurs suivantes est renvoyée pour state:

  • SUCCEEDED: indique que l'URL envoyée a été ajoutée à la liste de blocage du navigateur sécurisé.

  • CLOSED: indique que l'URL envoyée n'a pas été détectée comme ne respectant pas les règles de navigation sécurisée et qu'elle n'a pas été ajoutée à la liste de blocage de la navigation sécurisée au cours des dernières 24 heures.