Dokumen ini menjelaskan cara melihat tugas dan tugas Batch.
Sebelum memulai
- Jika belum pernah menggunakan Batch, baca Mulai menggunakan Batch dan aktifkan Batch dengan menyelesaikan prasyarat untuk project dan pengguna.
-
Untuk mendapatkan izin yang Anda perlukan untuk melihat tugas dan tugas, minta administrator untuk memberi Anda peran IAM Batch Job Viewer (
roles/batch.jobsViewer
) atau Batch Job Editor (roles/batch.jobsEditor
) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Lihat lowongan Anda
Untuk melihat tugas, pilih salah satu metode berikut:
Untuk melihat semua tugas dalam project Anda, lihat daftar tugas.
Untuk melihat semua detail konfigurasi tugas tertentu, lihat detail tugas.
Melihat daftar lowongan Anda
Anda dapat melihat daftar tugas di project saat ini menggunakan Google Cloud Console, gcloud CLI, Batch API, Go, Java, Node.js, Python, atau C++.
Konsol
Untuk melihat daftar tugas dalam project saat ini menggunakan Konsol Google Cloud, buka halaman Daftar tugas.
Daftar pekerjaan mungkin terdiri dari beberapa halaman. Jika Anda perlu melanjutkan ke halaman berikutnya, klik
Next di bagian bawah layar.Opsional: Jika Anda ingin memfilter daftar tugas, klik
Filter. Lalu, ketik atau pilih properti dan nilai.Misalnya, untuk memfilter daftar agar hanya menyertakan lowongan di status tertentu, masukkan perintah berikut:
Status:JOB_STATE
Ganti
JOB_STATE
dengan status tugas—misalnya,FAILED
.
gcloud
Lihat semua tugas
Untuk melihat daftar tugas dalam project saat ini menggunakan gcloud CLI, gunakan perintah gcloud batch jobs list
.
gcloud batch jobs list
Melihat daftar lowongan yang difilter
Anda juga dapat menambahkan satu atau beberapa tanda untuk melihat daftar tugas yang difilter:
Untuk hanya melihat lowongan di lokasi tertentu, sertakan flag
--location
.Untuk melihat tugas hanya berdasarkan ekspresi filter, tentukan flag
--filter
.
Misalnya, gunakan perintah berikut:
gcloud batch jobs list \
--location=LOCATION \
--filter="FILTER_EXPRESSION"
Ganti kode berikut:
LOCATION
: lokasi tempat ada satu atau beberapa tugas.FILTER_EXPRESSION
: ekspresi filter yang menentukan tugas yang ingin Anda cantumkan. Ekspresi filter harus menentukan satu atau beberapa pasangan nilai properti yang dipisahkan oleh nol atau beberapa operator boolean (AND
,OR
, danNOT
).Misalnya, lihat ekspresi filter berikut:
Filter berdasarkan status tugas: Untuk hanya melihat tugas yang berada dalam status tertentu, gunakan ekspresi filter berikut:
status.state="JOB_STATE"
Ganti
JOB_STATE
dengan status tugas—misalnya,FAILED
.Filter berdasarkan label: Anggaplah project Anda telah menentukan label kustom berikut:
Untuk menunjukkan tugas dan resource-nya yang dibuat oleh tim riset saat Anda melihat laporan Penagihan Cloud, beberapa tugas Anda dan resource-nya memiliki label
team
yang disetel keresearch
.Untuk menunjukkan beban kerja yang sensitif waktu, beberapa tugas memiliki label
deadline
, yang ditetapkan ke berbagai nilai.Untuk menunjukkan runnable yang telah berhasil diuji oleh tim pengembangan, beberapa runnable memiliki label
tested
yang ditetapkan ketrue
.
Kemudian, Anda dapat menentukan ekspresi filter berikut:
(allocationPolicy.labels.team=research) AND ((labels.deadline:*) OR (runnables.labels.tested=true))
Ekspresi filter ini hanya mencantumkan tugas yang memenuhi semua kriteria berikut:
Tugas yang berasal dari tim riset, yang memiliki label
team
pada kebijakan alokasi tugas yang ditetapkan keresearch
.Pekerjaan yang memenuhi minimal salah satu kriteria berikut:
Tugas yang sensitif terhadap waktu, yang memiliki label
deadline
pada tugas yang ditetapkan ke nilai apa pun.Tugas yang memiliki setidaknya satu runnable yang telah berhasil diuji, yaitu tugas yang memiliki setidaknya satu runnable dengan label
tested
yang ditetapkan ketrue
.
API
Lihat semua tugas
Guna melihat daftar tugas dalam project saat ini untuk lokasi tertentu menggunakan
Batch API, buat permintaan GET
ke
metode jobs.list
.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs
Ganti kode berikut:
PROJECT_ID
: project ID project Anda saat ini.LOCATION
: lokasi tempat tugas ada.
Melihat daftar lowongan yang difilter
Atau, Anda dapat menentukan parameter kueri filter
untuk melihat daftar tugas
yang difilter berdasarkan ekspresi filter.
Misalnya, buat permintaan GET
berikut:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs?filter=FILTER_EXPRESSION
Ganti FILTER_EXPRESSION
dengan
ekspresi filter
yang menggunakan encoding URL.
Ekspresi filter harus menentukan satu atau beberapa pasangan nilai properti yang dipisahkan oleh nol atau beberapa operator boolean (AND
, OR
, dan NOT
).
Misalnya, lihat ekspresi filter berikut:
Filter berdasarkan status tugas: Untuk hanya melihat tugas yang berada dalam status tertentu, gunakan ekspresi filter berikut:
status.state="JOB_STATE"
Ganti
JOB_STATE
dengan status tugas—misalnya,FAILED
.Filter berdasarkan label: Anggaplah project Anda telah menentukan label kustom berikut:
Untuk menunjukkan tugas dan resource-nya yang dibuat oleh tim riset saat Anda melihat laporan Penagihan Cloud, beberapa tugas Anda dan resource-nya memiliki label
team
yang disetel keresearch
.Untuk menunjukkan beban kerja yang sensitif waktu, beberapa tugas memiliki label
deadline
, yang ditetapkan ke berbagai nilai.Untuk menunjukkan runnable yang telah berhasil diuji oleh tim pengembangan, beberapa runnable memiliki label
tested
yang ditetapkan ketrue
.
Kemudian, Anda dapat menentukan ekspresi filter berikut:
(allocationPolicy.labels.team%3Dresearch)%20AND%20((labels.deadline%3A*)%20OR%20(runnables.labels.tested%3Dtrue))
Ekspresi filter ini hanya mencantumkan tugas yang memenuhi semua kriteria berikut:
Tugas yang berasal dari tim riset, yang memiliki label
team
pada kebijakan alokasi tugas yang ditetapkan keresearch
.Pekerjaan yang memenuhi minimal salah satu kriteria berikut:
Tugas yang sensitif terhadap waktu, yang memiliki label
deadline
pada tugas yang ditetapkan ke nilai apa pun.Tugas yang memiliki setidaknya satu runnable yang telah berhasil diuji, yaitu tugas yang memiliki setidaknya satu runnable dengan label
tested
yang ditetapkan ketrue
.
Go
Go
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Go.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Java
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Java.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Node.js
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Node.js.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Python
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Python.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C++
C++
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch C++.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Melihat detail pekerjaan
Anda dapat melihat detail tugas dalam project saat ini menggunakan Google Cloud Console, gcloud CLI, Batch API, Go, Java, Node.js, Python, atau C++.
Konsol
Untuk melihat detail tugas dalam project saat ini menggunakan Konsol Google Cloud, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman Job list.
Di kolom Nama pekerjaan, klik nama pekerjaan.
Halaman Detail pekerjaan akan terbuka.
Tab Details terbuka secara default. Untuk informasi selengkapnya, klik tab lainnya.
gcloud
Untuk melihat detail tugas dalam project saat ini menggunakan gcloud CLI, gunakan perintah gcloud batch jobs describe
dengan flag --location
.
gcloud batch jobs describe JOB_NAME \
--location=LOCATION
Ganti kode berikut:
JOB_NAME
: nama pekerjaan yang ada.LOCATION
: lokasi tempat lowongan berada.
API
Untuk melihat detail tugas dalam project saat ini menggunakan
Batch API, buat permintaan GET
ke
metode jobs.get
.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME
Ganti kode berikut:
PROJECT_ID
: project ID project saat ini.LOCATION
: lokasi tempat lowongan berada.JOB_NAME
: nama pekerjaan yang ada.
Go
Go
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Go.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Java
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Java.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Node.js
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Node.js.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Python
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Python.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C++
C++
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch C++.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Lihat tugas
Untuk melihat tugas pada salah satu tugas Anda, pilih salah satu metode berikut:
Untuk melihat semua tugas dalam tugas atau grup tugas tugas, lihat daftar tugas tugas.
Untuk melihat semua detail konfigurasi tugas tertentu, lihat detail tugas.
Melihat daftar tugas untuk
Anda dapat melihat daftar tugas dalam tugas atau grup tugas tugas menggunakan Konsol Google Cloud, gcloud CLI, Batch API, Go, Java, Node.js, Python, atau C++.
Jika Anda ingin memfilter daftar tugas dalam tugas atau grup tugas tugas—misalnya, untuk hanya mencantumkan tugas yang berhasil diselesaikan, Anda harus menggunakan gcloud CLI atau Batch API.
Konsol
Untuk melihat ringkasan tugas tugas menggunakan konsol Google Cloud, lihat detail tugas untuk membuka halaman Detail tugas. Kemudian, lihat bagian Detail tugas.
gcloud
Untuk melihat daftar tugas dalam grup tugas tugas menggunakan gcloud CLI, gunakan perintah gcloud batch tasks list
dengan flag berikut:
gcloud batch tasks list \
--job=JOB_NAME \
--location=LOCATION
Ganti kode berikut:
JOB_NAME
: nama pekerjaan yang ada.LOCATION
: lokasi tempat pekerjaan berada.
Anda juga dapat menambahkan flag --filter
untuk melihat daftar tugas yang difilter
dalam grup tugas tugas berdasarkan ekspresi filter.
Misalnya, gunakan perintah berikut:
gcloud batch tasks list \
--job=example-job \
--location=us-central1 \
--filter="FILTER_EXPRESSION"
Ganti FILTER_EXPRESSION
dengan
ekspresi filter.
Misalnya, Anda dapat menentukan ekspresi filter berikut untuk hanya melihat tugas dalam grup tugas tugas yang sedang berjalan atau telah berhasil diselesaikan:
STATE=RUNNING OR STATE=SUCCEEDED
API
Untuk melihat daftar tugas dalam grup tugas tugas menggunakan
Batch API, buat permintaan GET
ke
metode tasks.list
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks
Ganti kode berikut:
PROJECT_ID
: project ID project saat ini.LOCATION
: lokasi tempat lowongan berada.JOB_NAME
: nama pekerjaan yang ada.TASK_GROUP_NAME
: nama grup tugas yang ingin Anda lihat detailnya. Nilai harus ditetapkan kegroup0
.
Atau, Anda dapat menentukan parameter kueri filter
untuk melihat daftar tugas
yang difilter dalam grup tugas tugas berdasarkan ekspresi filter.
Misalnya, buat permintaan GET
berikut:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs/example-job/taskGroups/group0/tasks?filter=FILTER_EXPRESSION
Ganti FILTER_EXPRESSION
dengan
ekspresi filter yang menggunakan
encoding URL.
Misalnya, Anda dapat menentukan ekspresi filter berikut untuk hanya melihat tugas dalam grup tugas tugas yang sedang berjalan atau telah berhasil diselesaikan:
STATE=RUNNING%20OR%20STATE=SUCCEEDED
Perhatikan bahwa ekspresi filter yang dienkode ke URL merepresentasikan ekspresi filter yang didekode berikut:
STATE=RUNNING OR STATE=SUCCEEDED
Go
Go
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Go.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Java
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Java.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Node.js
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Node.js.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Python
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Python.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C++
C++
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch C++.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Melihat detail tugas
Anda dapat melihat detail tugas menggunakan Google Cloud Console, gcloud CLI, Batch API, Go, Java, Node.js, Python, atau C++.
Konsol
Untuk melihat detail tugas menggunakan Konsol Google Cloud, lihat detail tugas untuk membuka halaman Detail tugas. Kemudian, lihat bagian Detail tugas.
gcloud
Untuk melihat detail tugas menggunakan gcloud CLI, gunakan perintah gcloud batch tasks describe
dengan flag berikut:
gcloud batch tasks describe TASK_INDEX \
--location=LOCATION \
--job=JOB_NAME \
--task_group=TASK_GROUP_NAME
Ganti kode berikut:
TASK_INDEX
: indeks tugas yang ingin Anda lihat detailnya. Dalam grup tugas, indeks tugas dimulai dari 0 untuk tugas pertama dan meningkat 1 dengan setiap tugas tambahan. Misalnya, grup tugas yang berisi empat tugas memiliki indeks0
,1
,2
, dan3
.TASK_GROUP_NAME
: nama grup tugas yang berisi tugas yang ingin Anda lihat detailnya. Nilai ini harus ditetapkan kegroup0
.JOB_NAME
: nama pekerjaan yang ada.LOCATION
: lokasi tempat pekerjaan berada.
API
Untuk melihat detail tugas menggunakan Batch API, buat
permintaan GET
ke
metode tasks.get
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX
Ganti kode berikut:
PROJECT_ID
: project ID project saat ini.LOCATION
: lokasi tempat lowongan berada.JOB_NAME
: nama pekerjaan yang ada.TASK_GROUP_NAME
: nama grup tugas yang berisi tugas yang ingin Anda lihat detailnya. Nilai ini harus ditetapkan kegroup0
.TASK_INDEX
: indeks tugas yang ingin Anda lihat detailnya. Dalam grup tugas, indeks tugas dimulai dari 0 untuk tugas pertama dan meningkat 1 dengan setiap tugas tambahan. Misalnya, grup tugas yang berisi empat tugas memiliki indeks0
,1
,2
, dan,3
.
Go
Go
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Go.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Java
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Java.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Node.js
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Node.js.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Python
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch Python.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C++
C++
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Batch C++.
Untuk mengautentikasi ke Batch, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Langkah selanjutnya
Pelajari cara memantau dan menganalisis pekerjaan:
Jika mengonfigurasi log untuk tugas, Anda dapat menganalisis tugas menggunakan log.
Jika telah mengonfigurasi notifikasi status, Anda dapat memantau tugas menggunakan notifikasi Pub/Sub dan menganalisis notifikasi menggunakan BigQuery.
Pelajari cara mengatur resource menggunakan label.
Pelajari cara menghapus dan mengekspor tugas.