Mit Cloud Run können Sie Jobs und ihre Details während ihres gesamten Lebenszyklus aufrufen und Jobs löschen. Informationen zum Erstellen eines Jobs finden Sie unter Jobs erstellen. Informationen zum Ausführen eines Jobs finden Sie unter Jobs ausführen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud Run Developer (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 mitGoogle 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.
Jobs im Projekt aufrufen
Sie können eine Liste der Jobs in Ihrem Projekt über die Google Cloud -Console, die gcloud CLI, Clientbibliotheken oder die REST API aufrufen:
Console
Wechseln Sie in der Google Cloud -Console zur Seite „Cloud Run-Jobs“:
Optional: Filtern Sie den Job nach einem der Kriterien im Menü, z. B. Jobname, Ausführungszeit oder Region.
gcloud
Führen Sie den folgenden Befehl aus, um alle Jobs in Ihrem Projekt aufzulisten:
gcloud run jobs list
Führen Sie den folgenden Befehl aus, um Jobs nach Region zu filtern:
gcloud run jobs list --region REGION
Ersetzen Sie REGION durch den Namen der Region, nach der Sie filtern möchten, z. B. europe-west1.
Weitere Möglichkeiten zum Verfeinern der zurückgegebenen Liste, einschließlich der Verwendung von Filtern, finden Sie unter Jobliste.
Clientbibliotheken
So rufen Sie Jobs in Ihrem Projekt aus Code auf:
REST API
Senden Sie eine GET-HTTP-Anfrage an den Endpunkt jobs der Cloud Run Admin API, um die Liste der Jobs in Ihrem Projekt 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
Ersetzen Sie Folgendes:
ACCESS_TOKEN: Ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Aufrufen von Jobs hat. Wenn Sie beispielsweise in gcloud angemeldet sind, können Sie ein Zugriffstoken mitgcloud auth print-access-tokenabrufen. Innerhalb einer Cloud Run-Containerinstanz können Sie ein Zugriffstoken über den Metadatenserver der Containerinstanz abrufen.PROJECT_ID: die Google Cloud Projekt-ID.REGION: die Google Cloud Region des Jobs.
Auftragsdetails aufrufen
Weitere Details zu einem Job können Sie über die Google Cloud -Console, die gcloud CLI, Clientbibliotheken oder die REST API aufrufen:
Console
Wechseln Sie in der Google Cloud -Console zur Seite „Cloud Run-Jobs“:
Suchen Sie den gewünschten Job.
Klicken Sie auf den gewünschten Job, um die Seite mit den Jobdetails aufzurufen.
Wechseln Sie zwischen den Tabs Verlauf, Logs, Messwerte und YAML:
- Unter Verlauf finden Sie Informationen zu den Aufgaben in der Jobausführung.
- Unter Logs werden die Loginformationen angezeigt.
- Unter Messwerte finden Sie Informationen zu den Jobausführungen.
- YAML zeigt die Konfiguration des Jobs im YAML-Format.
gcloud
Führen Sie den folgenden Befehl aus, um Details zu einem Job aufzurufen:
gcloud run jobs describe JOB
Ersetzen Sie JOB durch den Namen des Jobs.
Clientbibliotheken
So rufen Sie Details zu einem Job aus Code auf:
REST API
Wenn Sie Details zu einem Job aufrufen möchten, senden Sie 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
Ersetzen Sie Folgendes:
ACCESS_TOKEN: Ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Aufrufen von Jobdetails hat. Wenn Sie beispielsweise in gcloud angemeldet sind, können Sie ein Zugriffstoken mitgcloud auth print-access-tokenabrufen. Innerhalb einer Cloud Run-Containerinstanz können Sie ein Zugriffstoken über den Metadatenserver der Containerinstanz abrufen.PROJECT_ID: die Google Cloud Projekt-ID.REGION: die Google Cloud Region des Jobs.JOB: Der Name Ihres Cloud Run-Jobs.
Job löschen
Wenn Sie einen Job löschen, werden alle laufenden Jobausführungen und alle laufenden Containerinstanzen beendet.
Obwohl ein gelöschter Job nicht mehr in der Liste der Jobs angezeigt wird, sind seine Logs für den Rest der Logaufbewahrungsdauer und die Monitoring-Daten weiterhin in Cloud Logging verfügbar ist weiterhin in Cloud Monitoring verfügbar.
Console
Wechseln Sie in der Google Cloud -Console zur Seite „Cloud Run-Jobs“:
Wählen Sie den Job aus.
Klicken Sie auf Löschen.
Klicken Sie auf Bestätigen.
gcloud
Führen Sie den folgenden Befehl aus, um einen Job zu löschen:
gcloud run jobs delete JOB
Ersetzen Sie JOB durch den Namen des Jobs.
Wenn Sie zur Bestätigung aufgefordert werden, antworten Sie mit y. Nach Abschluss wird eine Erfolgsmeldung angezeigt.
Clientbibliotheken
So löschen Sie einen Job aus Code:
REST API
Um einen Job zu löschen, senden Sie 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
Ersetzen Sie Folgendes:
ACCESS_TOKEN: ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Löschen von Jobs hat. Wenn Sie beispielsweise in gcloud angemeldet sind, können Sie ein Zugriffstoken mitgcloud auth print-access-tokenabrufen. Innerhalb einer Cloud Run-Containerinstanz können Sie ein Zugriffstoken über den Metadatenserver der Containerinstanz abrufen.PROJECT_ID: die Google Cloud Projekt-ID.REGION: die Google Cloud Region des Jobs.JOB: Der Name Ihres Cloud Run-Jobs.