Vorgänge mit langer Ausführungszeit abfragen

Auf dieser Seite wird beschrieben, wie Sie den Abschlussstatus asynchroner Methoden ermitteln. Diese Methoden geben einen Vorgang mit langer Ausführungszeit zurück, der Informationen zum Fortschritt des Vorgangs und zu seinem endgültigen Status enthält.

Die folgenden Methoden geben einen Vorgang mit langer Ausführungszeit zurück:

• CreateKey
• UpdateKey
• DeleteKey
• UndeleteKey

Wenn Sie eine Anfrage an eine dieser Methoden senden und diese erfolgreich ist, gibt die Methode eine Vorgangs-ID im Feld name zurück, die die laufende Arbeit auf dem Server darstellt, z. B.:

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

Mit der Methode operations.get können Sie den Status des Vorgangs prüfen. Verwenden Sie dazu den Wert aus dem Feld name:

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

Für die Abfrage eines Vorgangs empfehlen wir, die Methode operations.get wiederholt mit einem Backoff von 10 Sekunden aufzurufen, bis die Antwort "done": true enthält:

{
  "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=="
  }
}