Interroger les opérations de longue durée

Cette page explique comment déterminer l'état d'achèvement des méthodes asynchrones. Ces méthodes renvoient une opération de longue durée qui fournit des informations sur la progression de l'opération et son état final.

Les méthodes suivantes renvoient une opération de longue durée :

• CreateKey
• UpdateKey
• DeleteKey
• UndeleteKey

Lorsque vous envoyez une requête à l'une de ces méthodes, elle renvoie un identifiant d'opération dans le champ name en cas de succès. Cet identifiant représente le travail en cours sur le serveur. Par exemple :

{
  "name": "operations/akmf.6573437d-47c1-42c4-b817-0562f514f6ff"
}

Pour vérifier l'état de l'opération, utilisez la méthode operations.get avec la valeur du champ name :

  gcurl https://apikeys.googleapis.com/v2/operations/akmf.6573437d-47c1-42c4-b817-0562f514f6ff

Pour interroger une opération, nous vous recommandons d'appeler plusieurs fois la méthode operations.get en respectant un intervalle de 10 secondes entre chaque tentative, jusqu'à ce que la réponse inclue "done": true :

{
  "name": "operations/akmf.6573437d-47c1-42c4-b817-0562f514f6ff",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.apikeys.v2.Key",
    "name": "projects/103621867718/locations/global/keys/b7ff1f9f-8275-410a-94dd-3855ee9b5dd2",
    "keyString": "----REDACTED----",
    "createTime": "2019-02-04T23:56:28.531Z",
    "uid": "b7ff1f9f-8275-410a-94dd-3855ee9b5dd2",
    "updateTime": "2019-02-04T23:56:28.531Z",
    "restrictions": {
      "browserKeyRestrictions": {
      }
    },
    "etag": "k0bsYGkIvSxDVwNxyw49NQ=="
  }
}