In diesem Dokument wird erläutert, wie Sie Batchjobs und -aufgaben aufrufen.
Hinweise
- Wenn Sie Batch noch nicht verwendet haben, lesen Sie Erste Schritte mit Batch. Aktivieren Sie Batch, indem Sie die Voraussetzungen für Projekte und Nutzer erfüllen.
-
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Batch Job Viewer“ (
roles/batch.jobsViewer
) oder „Batch Job Editor“ (roles/batch.jobsEditor
) für das Projekt zu gewähren, damit Sie die erforderlichen Berechtigungen zum Ansehen von Jobs und Aufgaben erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Jobs ansehen
Wählen Sie eine der folgenden Methoden aus, um Ihre Jobs anzusehen:
Rufen Sie eine Liste Ihrer Jobs auf, um alle Jobs in Ihrem Projekt zu sehen.
Wenn Sie alle Konfigurationsdetails eines bestimmten Jobs sehen möchten, rufen Sie die Details eines Jobs auf.
Liste meiner Jobs aufrufen
Sie können eine Liste der Jobs im aktuellen Projekt mit der Google Cloud Console, der gcloud CLI, der Batch API, Go, Java, Node.js, Python oder C++ aufrufen.
Console
Wenn Sie über die Google Cloud Console eine Liste der Jobs im aktuellen Projekt aufrufen möchten, rufen Sie die Seite Jobliste auf.
Die Liste der Jobs kann mehrere Seiten umfassen. Wenn Sie mit der nächsten Seite fortfahren möchten, klicken Sie unten auf dem Bildschirm auf
Weiter.Optional: Wenn Sie die Liste der Jobs filtern möchten, klicken Sie auf
Filter. Geben Sie dann eine Eigenschaft und einen Wert ein oder wählen Sie sie aus.Wenn Sie die Liste beispielsweise so filtern möchten, dass nur Jobs mit einem bestimmten Status angezeigt werden, geben Sie Folgendes ein:
Status:JOB_STATE
Ersetzen Sie
JOB_STATE
durch einen Jobstatus, z. B.FAILED
.
gcloud
Alle Jobs ansehen
Verwenden Sie den Befehl gcloud batch jobs list
, um über die gcloud CLI eine Liste der Jobs im aktuellen Projekt aufzurufen.
gcloud batch jobs list
Gefilterte Liste von Jobs ansehen
Optional können Sie ein oder mehrere Flags hinzufügen, um eine gefilterte Liste von Jobs anzusehen:
Wenn Sie nur Jobs an einem bestimmten Standort ansehen möchten, fügen Sie das Flag
--location
hinzu.Wenn Sie nur Jobs aufrufen möchten, die auf einem Filterausdruck basieren, geben Sie das Flag
--filter
an.
Verwenden Sie zum Beispiel den folgenden Befehl:
gcloud batch jobs list \
--location=LOCATION \
--filter="FILTER_EXPRESSION"
Ersetzen Sie Folgendes:
LOCATION
: Der Standort, an dem ein oder mehrere Jobs vorhanden sind.FILTER_EXPRESSION
: ein Filterausdruck, der die Jobs definiert, die Sie auflisten möchten. Der Filterausdruck muss ein oder mehrere Attribut/Wert-Paare definieren, die durch null oder mehr boolesche Operatoren (AND
,OR
undNOT
) getrennt sind.Sehen Sie sich beispielsweise die folgenden Filterausdrücke an:
Anhand des Jobstatus filtern:Wenn Sie nur Jobs mit einem bestimmten Status aufrufen möchten, verwenden Sie den folgenden Filterausdruck:
status.state="JOB_STATE"
Ersetzen Sie
JOB_STATE
durch einen Jobstatus, z. B.FAILED
.Anhand von Labels filtern: Angenommen, in Ihrem Projekt wurden die folgenden benutzerdefinierten Labels definiert:
Um Jobs und die zugehörigen Ressourcen anzugeben, die von Ihrem Forschungsteam in Cloud Billing-Berichten erstellt wurden, haben einige Ihrer Jobs und deren Ressourcen das Label
team
, das aufresearch
gesetzt ist.Einige Jobs haben ein
deadline
-Label, das auf verschiedene Werte festgelegt ist, um zeitkritische Arbeitslasten anzugeben.Um Runnables anzuzeigen, die Ihr Entwicklungsteam erfolgreich getestet hat, haben einige Runnables das Label
tested
, das auftrue
gesetzt ist.
Anschließend können Sie den folgenden Filterausdruck angeben:
(allocationPolicy.labels.team=research) AND ((labels.deadline:*) OR (runnables.labels.tested=true))
Dieser Filterausdruck listet nur Jobs auf, die alle der folgenden Kriterien erfüllen:
Jobs, die zum Rechercheteam gehören und in der Zuweisungsrichtlinie des Jobs das Label
team
haben, für dieresearch
festgelegt ist.Jobs, die mindestens eines der folgenden Kriterien erfüllen:
Zeitkritische Jobs, die ein
deadline
-Label für den Job haben, das auf einen beliebigen Wert gesetzt ist.Jobs mit mindestens einem Runnable, das erfolgreich getestet wurde. Dies sind Jobs, die mindestens ein Runnable haben, bei dem das Label
tested
auftrue
gesetzt ist.
API
Alle Jobs ansehen
Wenn Sie mit der Batch API eine Liste der Jobs im aktuellen Projekt für einen bestimmten Standort aufrufen möchten, senden Sie eine GET
-Anfrage an die Methode jobs.list
.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs
Ersetzen Sie Folgendes:
PROJECT_ID
: die Projekt-ID Ihres aktuellen Projekts.LOCATION
: der Standort, an dem sich die Jobs befinden.
Gefilterte Liste von Jobs ansehen
Optional können Sie den Abfrageparameter filter
angeben, um eine gefilterte Liste von Jobs basierend auf einem Filterausdruck aufzurufen.
Stellen Sie beispielsweise die folgende GET
-Anfrage:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs?filter=FILTER_EXPRESSION
Ersetzen Sie FILTER_EXPRESSION
durch einen Filterausdruck, der URL-Codierung verwendet.
Der Filterausdruck muss ein oder mehrere Attribut/Wert-Paare definieren, die durch null oder mehr boolesche Operatoren (AND
, OR
und NOT
) getrennt sind.
Sehen Sie sich beispielsweise die folgenden Filterausdrücke an:
Anhand des Jobstatus filtern:Wenn Sie nur Jobs mit einem bestimmten Status aufrufen möchten, verwenden Sie den folgenden Filterausdruck:
status.state="JOB_STATE"
Ersetzen Sie
JOB_STATE
durch einen Jobstatus, z. B.FAILED
.Anhand von Labels filtern: Angenommen, in Ihrem Projekt wurden die folgenden benutzerdefinierten Labels definiert:
Um Jobs und die zugehörigen Ressourcen anzugeben, die von Ihrem Forschungsteam in Cloud Billing-Berichten erstellt wurden, haben einige Ihrer Jobs und deren Ressourcen das Label
team
, das aufresearch
gesetzt ist.Einige Jobs haben ein
deadline
-Label, das auf verschiedene Werte festgelegt ist, um zeitkritische Arbeitslasten anzugeben.Um Runnables anzuzeigen, die Ihr Entwicklungsteam erfolgreich getestet hat, haben einige Runnables das Label
tested
, das auftrue
gesetzt ist.
Anschließend können Sie den folgenden Filterausdruck angeben:
(allocationPolicy.labels.team%3Dresearch)%20AND%20((labels.deadline%3A*)%20OR%20(runnables.labels.tested%3Dtrue))
Dieser Filterausdruck listet nur Jobs auf, die alle der folgenden Kriterien erfüllen:
Jobs, die zum Rechercheteam gehören und in der Zuweisungsrichtlinie des Jobs das Label
team
haben, für dieresearch
festgelegt ist.Jobs, die mindestens eines der folgenden Kriterien erfüllen:
Zeitkritische Jobs, die ein
deadline
-Label für den Job haben, das auf einen beliebigen Wert gesetzt ist.Jobs mit mindestens einem Runnable, das erfolgreich getestet wurde. Dies sind Jobs, die mindestens ein Runnable haben, bei dem das Label
tested
auftrue
gesetzt ist.
Einfach loslegen (Go)
Go
Weitere Informationen findest du in der Referenzdokumentation zur Batch Go API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Weitere Informationen findest du in der Referenzdokumentation zur Batch Java API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Weitere Informationen findest du in der Referenzdokumentation zur Batch Node.js API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Weitere Informationen findest du in der Referenzdokumentation zur Batch Python API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
C++
C++
Weitere Informationen findest du in der Referenzdokumentation zur Batch C++ API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Details eines Auftrags ansehen
Sie können die Details eines Jobs im aktuellen Projekt mit der Google Cloud Console, der gcloud CLI, der Batch API, Go, Java, Node.js, Python oder C++ aufrufen.
Console
So rufen Sie die Details eines Jobs im aktuellen Projekt über die Google Cloud Console auf:
Rufen Sie in der Google Cloud Console die Seite Jobliste auf.
Klicken Sie in der Spalte Jobname auf den Namen eines Jobs.
Die Seite Jobdetails wird aufgerufen.
Der Tab Details ist standardmäßig geöffnet. Für weitere Informationen klicken Sie auf andere Tabs.
gcloud
Verwenden Sie den Befehl gcloud batch jobs describe
mit dem Flag --location
, um die Details eines Jobs im aktuellen Projekt über die gcloud CLI aufzurufen.
gcloud batch jobs describe JOB_NAME \
--location=LOCATION
Ersetzen Sie Folgendes:
JOB_NAME
: der Name eines vorhandenen Jobs.LOCATION
: der Standort, an dem sich der Job befindet.
API
Wenn Sie die Details eines Jobs im aktuellen Projekt mit der Batch API aufrufen möchten, stellen Sie eine GET
-Anfrage an die Methode jobs.get
.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME
Ersetzen Sie Folgendes:
PROJECT_ID
: die Projekt-ID des aktuellen Projekts.LOCATION
: der Standort, an dem sich der Job befindet.JOB_NAME
: der Name eines vorhandenen Jobs.
Einfach loslegen (Go)
Go
Weitere Informationen findest du in der Referenzdokumentation zur Batch Go API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Weitere Informationen findest du in der Referenzdokumentation zur Batch Java API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Weitere Informationen findest du in der Referenzdokumentation zur Batch Node.js API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Weitere Informationen findest du in der Referenzdokumentation zur Batch Python API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
C++
C++
Weitere Informationen findest du in der Referenzdokumentation zur Batch C++ API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Aufgaben ansehen
Wählen Sie eine der folgenden Methoden aus, um die Aufgaben für einen Ihrer Jobs aufzurufen:
Rufen Sie eine Liste der Aufgaben eines Jobs auf, um alle Aufgaben in einem Job oder der Aufgabengruppe eines Jobs zu sehen.
Wenn Sie alle Konfigurationsdetails einer bestimmten Aufgabe sehen möchten, rufen Sie die Details einer Aufgabe auf.
Liste der Aufgaben eines Jobs aufrufen
Sie können eine Liste der Aufgaben in einem Job oder der Aufgabengruppe eines Jobs mit der Google Cloud Console, der gcloud CLI, der Batch API, Go, Java, Node.js, Python oder C++ aufrufen.
Wenn Sie eine Liste von Aufgaben in einem Job oder in der Aufgabengruppe eines Jobs filtern möchten, um z. B. nur die Aufgaben aufzulisten, die erfolgreich ausgeführt wurden, müssen Sie die gcloud CLI oder die Batch API verwenden.
Console
Wenn Sie in der Google Cloud Console eine Zusammenfassung der Aufgaben eines Jobs ansehen möchten, rufen Sie die Details eines Jobs auf, um die Seite Jobdetails zu öffnen. Sehen Sie sich dann den Abschnitt Aufgabendetails an.
gcloud
Zum Aufrufen einer Liste der Aufgaben in der Aufgabengruppe eines Jobs über die gcloud CLI verwenden Sie den Befehl gcloud batch tasks list
mit den folgenden Flags:
gcloud batch tasks list \
--job=JOB_NAME \
--location=LOCATION
Ersetzen Sie Folgendes:
JOB_NAME
: der Name eines vorhandenen Jobs.LOCATION
: der Standort, an dem sich der Job befindet.
Optional können Sie das Flag --filter
hinzufügen, um eine gefilterte Liste von Aufgaben in der Aufgabengruppe eines Jobs basierend auf einem Filterausdruck anzusehen.
Verwenden Sie zum Beispiel den folgenden Befehl:
gcloud batch tasks list \
--job=example-job \
--location=us-central1 \
--filter="FILTER_EXPRESSION"
Ersetzen Sie FILTER_EXPRESSION
durch einen Filterausdruck.
Sie können beispielsweise den folgenden Filterausdruck angeben, damit nur die Aufgaben in der Aufgabengruppe eines Jobs angezeigt werden, die gerade ausgeführt werden oder erfolgreich abgeschlossen wurden:
STATE=RUNNING OR STATE=SUCCEEDED
API
Wenn Sie mithilfe der Batch API eine Liste der Aufgaben in der Aufgabengruppe eines Jobs aufrufen möchten, senden Sie eine GET
-Anfrage an die Methode tasks.list
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks
Ersetzen Sie Folgendes:
PROJECT_ID
: die Projekt-ID des aktuellen Projekts.LOCATION
: der Standort, an dem sich der Job befindet.JOB_NAME
: der Name eines vorhandenen Jobs.TASK_GROUP_NAME
: der Name der Aufgabengruppe, deren Details Sie aufrufen möchten. Der Wert muss aufgroup0
festgelegt werden.
Optional können Sie den Abfrageparameter filter
angeben, um eine gefilterte Liste von Aufgaben in der Aufgabengruppe eines Jobs basierend auf einem Filterausdruck anzusehen.
Stellen Sie beispielsweise die folgende GET
-Anfrage:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs/example-job/taskGroups/group0/tasks?filter=FILTER_EXPRESSION
Ersetzen Sie FILTER_EXPRESSION
durch einen Filterausdruck, der URL-Codierung verwendet.
Sie können beispielsweise den folgenden Filterausdruck angeben, damit nur die Aufgaben in der Aufgabengruppe eines Jobs angezeigt werden, die gerade ausgeführt werden oder erfolgreich abgeschlossen wurden:
STATE=RUNNING%20OR%20STATE=SUCCEEDED
Beachten Sie, dass der URL-codierte Filterausdruck den folgenden decodierten Filterausdruck darstellt:
STATE=RUNNING OR STATE=SUCCEEDED
Einfach loslegen (Go)
Go
Weitere Informationen findest du in der Referenzdokumentation zur Batch Go API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Weitere Informationen findest du in der Referenzdokumentation zur Batch Java API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Weitere Informationen findest du in der Referenzdokumentation zur Batch Node.js API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Weitere Informationen findest du in der Referenzdokumentation zur Batch Python API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
C++
C++
Weitere Informationen findest du in der Referenzdokumentation zur Batch C++ API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Aufgabendetails ansehen
Sie können die Details einer Aufgabe mit der Google Cloud Console, der gcloud CLI, der Batch API, Go, Java, Node.js, Python oder C++ ansehen.
Console
Wenn Sie die Details einer Aufgabe über die Google Cloud Console ansehen möchten, rufen Sie die Details eines Jobs auf und öffnen Sie die Seite Jobdetails. Sehen Sie sich dann den Abschnitt Aufgabendetails an.
gcloud
Zum Aufrufen der Details zu einer Aufgabe über die gcloud CLI verwenden Sie den Befehl gcloud batch tasks describe
mit den folgenden Flags:
gcloud batch tasks describe TASK_INDEX \
--location=LOCATION \
--job=JOB_NAME \
--task_group=TASK_GROUP_NAME
Ersetzen Sie Folgendes:
TASK_INDEX
: Der Index der Aufgabe, deren Details Sie sich ansehen möchten. In einer Aufgabengruppe beginnt der Aufgabenindex für die erste Aufgabe bei 0 und erhöht sich mit jeder weiteren Aufgabe um 1. Eine Aufgabengruppe, die vier Aufgaben enthält, hat beispielsweise die Indexe0
,1
,2
und3
.TASK_GROUP_NAME
: der Name der Aufgabengruppe mit der Aufgabe, deren Details Sie sich ansehen möchten. Der Wert muss aufgroup0
festgelegt sein.JOB_NAME
: der Name eines vorhandenen Jobs.LOCATION
: der Standort, an dem sich der Job befindet.
API
Wenn Sie die Details einer Aufgabe mit der Batch API ansehen möchten, senden Sie eine GET
-Anfrage an die Methode tasks.get
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX
Ersetzen Sie Folgendes:
PROJECT_ID
: die Projekt-ID des aktuellen Projekts.LOCATION
: der Standort, an dem sich der Job befindet.JOB_NAME
: der Name eines vorhandenen Jobs.TASK_GROUP_NAME
: der Name der Aufgabengruppe mit der Aufgabe, deren Details Sie sich ansehen möchten. Der Wert muss aufgroup0
festgelegt sein.TASK_INDEX
: Der Index der Aufgabe, deren Details Sie sich ansehen möchten. In einer Aufgabengruppe beginnt der Aufgabenindex für die erste Aufgabe bei 0 und erhöht sich mit jeder weiteren Aufgabe um 1. Eine Aufgabengruppe, die vier Aufgaben enthält, hat beispielsweise die Indexe0
,1
,2
,3
.
Einfach loslegen (Go)
Go
Weitere Informationen findest du in der Referenzdokumentation zur Batch Go API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Weitere Informationen findest du in der Referenzdokumentation zur Batch Java API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Weitere Informationen findest du in der Referenzdokumentation zur Batch Node.js API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Weitere Informationen findest du in der Referenzdokumentation zur Batch Python API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
C++
C++
Weitere Informationen findest du in der Referenzdokumentation zur Batch C++ API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Nächste Schritte
Weitere Informationen zum Überwachen und Analysieren von Jobs:
Wenn Sie Logs für einen Job konfiguriert haben, können Sie einen Job mithilfe von Logs analysieren.
Wenn Sie Statusbenachrichtigungen konfiguriert haben, können Sie einen Job mit Pub/Sub-Benachrichtigungen überwachen und Benachrichtigungen mit BigQuery analysieren.