Auf dieser Seite wird beschrieben, wie Sie Jobausführungen anzeigen und löschen. Informationen zum Ausführen, Abbrechen oder Überschreiben einer Jobkonfiguration finden Sie unter Jobs ausführen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen den IAM-Rolle Cloud Run-Entwickler (roles/run.developer
) für Ihren Cloud Run-Job zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Cloud Run-Jobs benötigen.
Eine Liste der IAM-Rollen und -Berechtigungen im Zusammenhang mit Cloud Run finden Sie unter IAM-Rollen für Cloud Run und IAM-Berechtigungen für Cloud Run. Wenn Ihr Cloud Run-Job mit Google Cloud APIs wie Cloud-Clientbibliotheken verknüpft ist, lesen Sie die Konfigurationsanleitung für Dienstidentitäten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Bereitstellungsberechtigungen und Zugriff verwalten.
Jobausführungen in Ihrem Projekt ansehen
Sie können eine Liste der Jobausführungen in Ihrem Projekt mit der Google Cloud Console oder der Google Cloud CLI aufrufen:
Console
So zeigen Sie die Liste der Ausführungen für einen Job an:
Suchen Sie den Job in der Liste, dessen Ausführungen Sie verwalten möchten.
Klicken Sie auf den Job, um die Liste der Ausführungen aufzurufen.
Suchen Sie auf der Seite mit den Ausführungsdetails in der Liste nach der Ausführung, die Sie interessiert. Optional können Sie den Filter auf ein gewünschtes Kriterium einstellen, z. B. Status mit dem Wert completed:
gcloud
So listen Sie alle Jobausführungen für alle Jobs in Ihrem Projekt auf:
gcloud run jobs executions list
So listen Sie nur die Ausführungen für einen bestimmten Job auf:
gcloud run jobs executions list --job JOB_NAME
Ersetzen Sie JOB_NAME
durch den Namen des Jobs, nach dem Sie filtern.
Weitere Möglichkeiten zum Verfeinern der zurückgegebenen Liste, einschließlich der Verwendung von Filtern, finden Sie unter Liste der Jobausführungen.
Mit dem Flag --format
können Sie den Namen der letzten Ausführung für einen bestimmten Job abrufen:
gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"
Ersetzen Sie JOB_NAME
durch den Namen des Jobs, nach dem Sie filtern.
Clientbibliotheken
So listen Sie alle Jobausführungen aus Code auf:
REST API
Senden Sie zum Auflisten von Jobausführungen eine GET
-HTTP-Anfrage an den Endpunkt jobs
der Cloud Run Admin API.
Verwenden Sie zum Beispiel curl
:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X GET \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions
Ersetzen Sie:
- ACCESS_TOKEN durch ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Aufrufen von Jobausführungen hat.
Wenn Sie beispielsweise in gcloud angemeldet sind, können Sie ein Zugriffstoken mit
gcloud auth print-access-token
abrufen. Innerhalb einer Cloud Run-Containerinstanz können Sie ein Zugriffstoken über den Metadatenserver der Containerinstanz abrufen. - JOB-NAME durch den Namen des Jobs.
- REGION durch die Google Cloud-Region des Jobs.
- PROJECT-ID durch die Google Cloud-Projekt-ID.
Details zur Jobausführung aufrufen
Mit dem Bereich "Ausführungsdetails" können Sie Details zur Jobausführung für die letzten 10000 Ausführungen eines Jobs aufrufen sowie alle Ausführungen, die in den letzten sieben Tagen aufgetreten sind. Ältere Ausführungsdetails werden entfernt und sind nicht mehr im Bereich der Ausführungsdetails sichtbar. Die Logs- und Monitoring-Daten für ältere Ausführungen sind jedoch weiterhin in Cloud Logging und Cloud Monitoring verfügbar, unterliegen den Aufbewahrungsrichtlinien für diese Produkte.
Mit der Google Cloud Console oder der Google Cloud-CLI können Sie weitere Details zu einer Jobausführung aufrufen.
Console
So rufen Sie Details zu einer bestimmten Jobausführung auf:
Klicken Sie auf die Jobausführung, um die Seite mit den Ausführungsdetails aufzurufen.
Beachten Sie die Tabs Aufgaben, Logs, Konfiguration und YAML.
- Aufgaben zeigt Informationen zu den Aufgaben der Jobausführung an.
- Logs zeigt die Logs an, die sich auf die Ausführung beziehen.
- Unter Konfiguration werden Informationen zum Job, zum Container, zur Sicherheit, zur Konnektivität usw. angezeigt, die bei der Ausführung verwendet wurden.
- YAML zeigt die Konfiguration des Jobs im YAML-Format an.
gcloud
So rufen Sie Details zu einer Jobausführung auf:
Führen Sie den Befehl aus:
gcloud run jobs executions describe EXECUTION_NAME
Ersetzen Sie EXECUTION_NAME
durch den Namen der Ausführung.
Mit dem Flag --format
können Sie die Ausgabe formatieren und zusätzliche Informationen abrufen. Zum Beispiel als YAML:
gcloud run jobs executions describe EXECUTION_NAME --format yaml
Clientbibliotheken
So rufen Sie Details zur Jobausführung aus Code auf:
REST API
Senden Sie eine GET
-HTTP-Anfrage an den Endpunkt jobs
der Cloud Run Admin API, um Details zur Jobausführung aufzurufen.
Verwenden Sie zum Beispiel curl
:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X GET \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME
Ersetzen Sie:
- ACCESS_TOKEN durch ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Aufrufen von Jobauusführungen hat.
Wenn Sie beispielsweise in gcloud angemeldet sind, können Sie ein Zugriffstoken mit
gcloud auth print-access-token
abrufen. Innerhalb einer Cloud Run-Containerinstanz können Sie ein Zugriffstoken über den Metadatenserver der Containerinstanz abrufen. - JOB-NAME durch den Namen des Jobs.
- EXECUTION-NAME durch den Namen der Jobausführung.
- REGION durch die Google Cloud-Region des Jobs.
- PROJECT-ID durch die Google Cloud-Projekt-ID.
Jobausführung löschen
Sie können eine Jobausführung auch während einer Ausführung löschen. Wenn Sie eine Ausführung löschen, wird die Ausführung beendet.
Obwohl eine gelöschte Ausführung nicht in der Liste der Ausführungen angezeigt wird, sind ihre Logs für den Rest der Logaufbewahrungsdauer und die Monitoring-Daten weiterhin in Cloud Logging und in Cloud Monitoring verfügbar.
Console
So löschen Sie eine Jobausführung:
Klicken Sie auf Löschen.
Wenn Sie aufgefordert werden, das Löschen zu bestätigen, klicken Sie auf Bestätigen.
gcloud
So löschen Sie eine Jobausführung:
Führen Sie den Befehl aus:
gcloud run jobs executions delete EXECUTION_NAME
Ersetzen Sie
EXECUTION_NAME
durch den Namen der Ausführung.Wenn Sie zur Bestätigung aufgefordert werden, antworten Sie mit
y
. Bei Erfolg wird eine Erfolgsmeldung angezeigt.
Clientbibliotheken
So löschen Sie eine Jobausführung aus Code:
REST API
Senden Sie zum Löschen einer Jobausführung eine DELETE
-HTTP-Anfrage an den Endpunkt jobs
der Cloud Run Admin API.
Verwenden Sie zum Beispiel curl
:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X DELETE \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME
Ersetzen Sie:
- ACCESS_TOKEN durch ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Löschen von Jobausführungen hat.
Wenn Sie beispielsweise in gcloud angemeldet sind, können Sie ein Zugriffstoken mit
gcloud auth print-access-token
abrufen. Innerhalb einer Cloud Run-Containerinstanz können Sie ein Zugriffstoken über den Metadatenserver der Containerinstanz abrufen. - JOB_NAME durch den Namen des Jobs.
- EXECUTION-NAME durch den Namen der Jobausführung.
- REGION durch die Google Cloud-Region des Jobs.
- PROJECT-ID durch die Google Cloud-Projekt-ID.