Polling su operazioni a lunga esecuzione

Questa pagina descrive come determinare lo stato di completamento dei metodi asincroni. Questi metodi restituiscono un'operazione a lunga esecuzione che fornisce informazioni sullo stato di avanzamento dell'operazione e sul suo stato finale.

I seguenti metodi restituiscono un'operazione a lunga esecuzione:

  • CreateKey
  • UpdateKey
  • DeleteKey
  • UndeleteKey

Quando invii una richiesta a uno di questi metodi, in caso di esito positivo, il metodo restituisce un identificatore dell'operazione nel campo name, che rappresenta il lavoro in corso sul server, ad esempio:

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

Per controllare lo stato dell'operazione, utilizza il metodo operations.get con il valore del campo name:

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

Per eseguire il polling di un'operazione, ti consigliamo di richiamare ripetutamente il metodo operations.get con un backoff di 10 secondi finché la risposta non include "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=="
  }
}