Mit lang andauernden Vorgängen arbeiten

Auf dieser Seite wird beschrieben, wie Sie lang andauernde Vorgänge in AutoML Natural Language handhaben.

Einführung

Manche Vorgänge in AutoML Natural Language sind etwas zeitaufwendiger:

  • datasets.importData
  • datasets.exportData
  • datasets.delete
  • models.batchPredict
  • models.create
  • models.delete
  • models.deploy
  • models.undeploy

Wenn Sie die AutoML Natural Language UI verwenden, können Sie Ihr Browserfenster schließen, ohne den Vorgang zu beeinträchtigen. Das Steuerfeld wird aktualisiert, wenn der Vorgang abgeschlossen ist.

Wenn Sie einen lang andauernden API-Aufruf ausführen, wird der anfängliche Aufruf sofort zurückgegeben, obwohl der Vorgang noch läuft. Sie können den Status lang andauernder Vorgänge auf unterschiedliche Weise ermitteln.

Projektinhaber werden von AutoML Natural Language per E-Mail benachrichtigt, sobald ein Vorgang mit langer Ausführungszeit abgeschlossen ist.

Status eines Vorgangs abfragen

Sie können den Status eines lang andauernden Vorgangs abfragen. Das Programm läuft dabei weiter. Sie müssen die Abfrage jedoch bis zum Abschluss des Vorgangs fortsetzen.

Zum Ermitteln des Vorgangsstatus verwenden Sie die Vorgangs-ID der zu Beginn des Vorgangs erhaltenen Antwort.

Ersetzen Sie im folgenden Befehl operation-name durch den vollständigen Namen Ihres Vorgangs. Der vollständige Name hat folgendes Format: projects/{project-id}/locations/us-central1/operations/{operation-id}.

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type: application/json" \
  https://automl.googleapis.com/v1/operation-name

Für einen Importvorgang sollte eine Ausgabe wie die folgende angezeigt werden: In der Ausgabe gibt es das Objekt metadata, das Informationen enthält, die für den Anfragetyp spezifisch sind. Das Feld done gibt an, ob der Vorgang abgeschlossen ist oder nicht. Wenn der Vorgang abgeschlossen ist, enthält die Antwort Informationen über die Auswirkungen der Anfrage.

{
  "name": "projects/1234/locations/us-central1/operations/TBL2126599795587061786",
  "metadata": {
...
  },
  "done": true,
  "response": {
...
  }
}

Auf einen Vorgang warten

Wenn Sie die Ausführung des Vorgangs blockieren möchten, können Sie warten, bis der Vorgang abgeschlossen ist oder ein von Ihnen festgelegtes Zeitlimit überschritten wurde.

Ersetzen Sie unten im Befehl Folgendes:

  • operation-name durch den vollständigen Namen Ihres Vorgangs. Der vollständige Name hat folgendes Format: projects/{project-id}/locations/us-central1/operations/{operation-id}.

  • timeout durch die maximale Wartezeit in Sekundenbruchteilen, die durch "s" beendet wird. Beispiel: Durch Angabe des Werts "4.5s" wird der Wartebefehl nach viereinhalb Sekunden zurückgegeben, wenn der Vorgang noch läuft.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "Content-Type: application/json" \
   -d '{"timeout":"timeout"}' \
  https://automl.googleapis.com/v1/operation-name:wait

Vorgang abbrechen

Sie können eine Import- oder Trainingsaufgabe mit der Vorgangs-ID abbrechen. Es wird nicht garantiert, dass der Abbruch tatsächlich erfolgt. Vorgänge können nicht gelöscht werden.

Ersetzen Sie im folgenden Befehl operation-name durch den vollständigen Namen Ihres Vorgangs. Der vollständige Name hat folgendes Format: projects/{project-id}/locations/us-central1/operations/{operation-id}.

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  https://automl.googleapis.com/v1/operation-name:cancel