Melihat tugas

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.

Buka 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.

Catatan: Beberapa opsi pemfilteran—misalnya, untuk hanya mencantumkan tugas dengan satu atau beberapa label tertentu—tidak didukung di Konsol Google Cloud. Untuk opsi pemfilteran lainnya, cantumkan tugas menggunakan gcloud CLI atau Batch API.

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

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, 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 ke research.
  - 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 ke true.
  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 ke research.
  - 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 ke true.

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.

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 ke research.
- 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 ke true.
Kemudian, Anda dapat menentukan ekspresi filter berikut:
```
(allocationPolicy.labels.team%3Dresearch)%20AND%20((labels.deadline%3A*)%20OR%20(runnables.labels.tested%3Dtrue))
```
Catatan: Ekspresi filter yang dienkode ke URL merepresentasikan ekspresi filter yang didekode 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 ke research.
- 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 ke true.

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.

import (
	"context"
	"fmt"
	"io"

	batch "cloud.google.com/go/batch/apiv1"
	"cloud.google.com/go/batch/apiv1/batchpb"
	"google.golang.org/api/iterator"
)

// Lists all jobs in the given project and region
func listJobs(w io.Writer, projectID, region string) error {
	// projectID := "your_project_id"
	// region := "us-central1"

	ctx := context.Background()
	batchClient, err := batch.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("NewClient: %w", err)
	}
	defer batchClient.Close()

	req := &batchpb.ListJobsRequest{
		Parent: fmt.Sprintf("projects/%s/locations/%s", projectID, region),
	}

	var jobs []*batchpb.Job
	it := batchClient.ListJobs(ctx, req)

	for {
		job, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			return fmt.Errorf("unable to list jobs: %w", err)
		}
		jobs = append(jobs, job)
	}

	fmt.Fprintf(w, "Jobs: %v\n", jobs)

	return nil
}

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.

import com.google.cloud.batch.v1.BatchServiceClient;
import com.google.cloud.batch.v1.Job;
import java.io.IOException;

public class ListJobs {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";

    // Name of the region hosting the jobs.
    String region = "europe-central2";

    listJobs(projectId, region);
  }

  // Get a list of all jobs defined in given region.
  public static void listJobs(String projectId, String region) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `batchServiceClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (BatchServiceClient batchServiceClient = BatchServiceClient.create()) {

      // Construct the parent path of the job.
      String parent = String.format("projects/%s/locations/%s", projectId, region);

      for (Job job : batchServiceClient.listJobs(parent).iterateAll()) {
        System.out.println(job.getName());
      }
      System.out.println("Listed all batch jobs.");
    }
  }
}

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.

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
/**
 * The region that hosts the job.
 */
// const region = 'us-central-1';

// Imports the Batch library
const batchLib = require('@google-cloud/batch');

// Instantiates a client
const batchClient = new batchLib.v1.BatchServiceClient();

async function callListJobs() {
  // Construct request
  const request = {
    parent: `projects/${projectId}/locations/${region}`,
  };

  // Run request
  const iterable = await batchClient.listJobsAsync(request);
  for await (const response of iterable) {
    console.log(response);
  }
}

callListJobs();

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.

from __future__ import annotations

from collections.abc import Iterable

from google.cloud import batch_v1

def list_jobs(project_id: str, region: str) -> Iterable[batch_v1.Job]:
    """
    Get a list of all jobs defined in given region.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        region: name of the region hosting the jobs.

    Returns:
        An iterable collection of Job object.
    """
    client = batch_v1.BatchServiceClient()

    return client.list_jobs(parent=f"projects/{project_id}/locations/{region}")

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.

#include "google/cloud/batch/v1/batch_client.h"

  [](std::string const& project_id, std::string const& location_id) {
    auto const parent = "projects/" + project_id + "/locations/" + location_id;
    // Initialize a client and issue the request.
    auto client = google::cloud::batch_v1::BatchServiceClient(
        google::cloud::batch_v1::MakeBatchServiceConnection());
    int i = 0;
    for (auto job : client.ListJobs(parent)) {
      if (!job) throw std::move(job).status();
      std::cout << "Job[" << i++ << "]  " << job->DebugString() << "\n";
    }
  }

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.

Buka Daftar tugas
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

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.

import (
	"context"
	"fmt"
	"io"

	batch "cloud.google.com/go/batch/apiv1"
	"cloud.google.com/go/batch/apiv1/batchpb"
)

// Retrieves the information about the specified job, most importantly its status
func getJob(w io.Writer, projectID, region, jobName string) (*batchpb.Job, error) {
	// projectID := "your_project_id"
	// region := "us-central1"
	// jobName := "some-job"

	ctx := context.Background()
	batchClient, err := batch.NewClient(ctx)
	if err != nil {
		return nil, fmt.Errorf("NewClient: %w", err)
	}
	defer batchClient.Close()

	req := &batchpb.GetJobRequest{
		Name: fmt.Sprintf("projects/%s/locations/%s/jobs/%s", projectID, region, jobName),
	}

	response, err := batchClient.GetJob(ctx, req)
	if err != nil {
		return nil, fmt.Errorf("unable to get job: %w", err)
	}

	fmt.Fprintf(w, "Job info: %v\n", response)

	return response, nil
}

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.

import com.google.cloud.batch.v1.BatchServiceClient;
import com.google.cloud.batch.v1.Job;
import com.google.cloud.batch.v1.JobName;
import java.io.IOException;

public class GetJob {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";

    // Name of the region hosts the job.
    String region = "europe-central2";

    // The name of the job you want to retrieve information about.
    String jobName = "JOB_NAME";

    getJob(projectId, region, jobName);
  }

  // Retrieve information about a Batch Job.
  public static void getJob(String projectId, String region, String jobName) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `batchServiceClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (BatchServiceClient batchServiceClient = BatchServiceClient.create()) {

      Job job =
          batchServiceClient.getJob(
              JobName.newBuilder()
                  .setProject(projectId)
                  .setLocation(region)
                  .setJob(jobName)
                  .build());

      System.out.printf("Retrieved the job: %s ", job.getName());
    }
  }
}

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.

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
/**
 * The region that hosts the job.
 */
// const region = 'us-central-1';
/**
 * The name of the job you want to retrieve information about.
 */
// const jobName = 'YOUR_JOB_NAME';

// Imports the Batch library
const batchLib = require('@google-cloud/batch');

// Instantiates a client
const batchClient = new batchLib.v1.BatchServiceClient();

async function callGetJob() {
  // Construct request
  const request = {
    name: `projects/${projectId}/locations/${region}/jobs/${jobName}`,
  };

  // Run request
  const response = await batchClient.getJob(request);
  console.log(response);
}

callGetJob();

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.


from google.cloud import batch_v1

def get_job(project_id: str, region: str, job_name: str) -> batch_v1.Job:
    """
    Retrieve information about a Batch Job.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        region: name of the region hosts the job.
        job_name: the name of the job you want to retrieve information about.

    Returns:
        A Job object representing the specified job.
    """
    client = batch_v1.BatchServiceClient()

    return client.get_job(
        name=f"projects/{project_id}/locations/{region}/jobs/{job_name}"
    )

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.

#include "google/cloud/batch/v1/batch_client.h"

  [](std::string const& project_id, std::string const& location_id,
     std::string const& job_id) {
    auto const name = "projects/" + project_id + "/locations/" + location_id +
                      "/jobs/" + job_id;
    // Initialize a client and issue the request.
    auto client = google::cloud::batch_v1::BatchServiceClient(
        google::cloud::batch_v1::MakeBatchServiceConnection());
    auto response = client.GetJob(name);
    if (!response) throw std::move(response).status();
    std::cout << "GetJob() succeeded with " << response->DebugString() << "\n";
  }

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 ke group0.

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

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.

import (
	"context"
	"fmt"
	"io"

	batch "cloud.google.com/go/batch/apiv1"
	"cloud.google.com/go/batch/apiv1/batchpb"
	"google.golang.org/api/iterator"
)

// Lists all tasks in the given project and region
func listTasks(w io.Writer, projectID, region, jobName, taskGroup string) error {
	// projectID := "your_project_id"
	// region := "us-central1"
	// jobName := "some-job"
	// taskGroup := "group0" // defaults to "group0" on job creation unless overridden

	ctx := context.Background()
	batchClient, err := batch.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("NewClient: %w", err)
	}
	defer batchClient.Close()

	req := &batchpb.ListTasksRequest{
		Parent: fmt.Sprintf("projects/%s/locations/%s/jobs/%s/taskGroups/%s", projectID, region, jobName, taskGroup),
	}

	var tasks []*batchpb.Task
	it := batchClient.ListTasks(ctx, req)

	for {
		task, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			return fmt.Errorf("unable to list tasks: %w", err)
		}
		tasks = append(tasks, task)
	}

	fmt.Fprintf(w, "Tasks: %v\n", tasks)

	return nil
}

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.

import com.google.cloud.batch.v1.BatchServiceClient;
import com.google.cloud.batch.v1.Task;
import java.io.IOException;

public class ListTasks {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";
    // Name of the region hosts the job.
    String region = "europe-central2";
    // Name of the job which tasks you want to list.
    String jobName = "JOB_NAME";
    // Name of the group of tasks. Usually it's `group0`.
    String groupName = "group0";

    listTasks(projectId, region, jobName, groupName);
  }

  // Get a list of all jobs defined in given region.
  public static void listTasks(String projectId, String region, String jobName, String groupName)
      throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `batchServiceClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (BatchServiceClient batchServiceClient = BatchServiceClient.create()) {

      String parent = String.format("projects/%s/locations/%s/jobs/%s/taskGroups/%s", projectId,
          region, jobName, groupName);
      for (Task task : batchServiceClient.listTasks(parent).iterateAll()) {
        System.out.println(task.getName());
      }
    }
  }
}

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.

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
/**
 * The region that hosts the job.
 */
// const region = 'us-central-1';
/**
 * The name of the job which tasks you want to list.
 */
// const jobName = 'YOUR_JOB_NAME';
/**
 * The name of the group of tasks. Usually it's `group0`.
 */
// const groupName = 'group0';

// Imports the Batch library
const batchLib = require('@google-cloud/batch');

// Instantiates a client
const batchClient = new batchLib.v1.BatchServiceClient();

async function callListTasks() {
  // Construct request
  const request = {
    parent: `projects/${projectId}/locations/${region}/jobs/${jobName}/taskGroups/${groupName}`,
  };

  // Run request
  const iterable = await batchClient.listTasksAsync(request);
  for await (const response of iterable) {
    console.log(response);
  }
}

callListTasks();

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.

from __future__ import annotations

from collections.abc import Iterable

from google.cloud import batch_v1

def list_tasks(
    project_id: str, region: str, job_name: str, group_name: str
) -> Iterable[batch_v1.Task]:
    """
    Get a list of all jobs defined in given region.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        region: name of the region hosting the jobs.
        job_name: name of the job which tasks you want to list.
        group_name: name of the group of tasks. Usually it's `group0`.

    Returns:
        An iterable collection of Task objects.
    """
    client = batch_v1.BatchServiceClient()

    return client.list_tasks(
        parent=f"projects/{project_id}/locations/{region}/jobs/{job_name}/taskGroups/{group_name}"
    )

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.

#include "google/cloud/batch/v1/batch_client.h"

  [](std::string const& project_id, std::string const& location_id,
     std::string const& job_id, std::string const& group_id) {
    auto const parent = "projects/" + project_id + "/locations/" + location_id +
                        "/jobs/" + job_id + "/taskGroups/" + group_id;
    // Initialize a client and issue the request.
    auto client = google::cloud::batch_v1::BatchServiceClient(
        google::cloud::batch_v1::MakeBatchServiceConnection());
    int i = 0;
    for (auto task : client.ListTasks(parent)) {
      if (!task) throw std::move(task).status();
      std::cout << "Task[" << i++ << "]  " << task->DebugString() << "\n";
    }
  }

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 indeks 0, 1, 2, dan 3.
TASK_GROUP_NAME: nama grup tugas yang berisi tugas yang ingin Anda lihat detailnya. Nilai ini harus ditetapkan ke group0.
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 ke group0.
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 indeks 0, 1, 2, dan, 3.

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.

import (
	"context"
	"fmt"
	"io"

	batch "cloud.google.com/go/batch/apiv1"
	"cloud.google.com/go/batch/apiv1/batchpb"
)

// Retrieves the information about the specified job, most importantly its status
func getTask(w io.Writer, projectID, region, jobName, taskGroup string, taskNumber int32) error {
	// projectID := "your_project_id"
	// region := "us-central1"
	// jobName := "some-job"
	// taskGroup := "group0" // defaults to "group0" on job creation unless overridden
	// taskNumber := 0

	ctx := context.Background()
	batchClient, err := batch.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("NewClient: %w", err)
	}
	defer batchClient.Close()

	req := &batchpb.GetTaskRequest{
		Name: fmt.Sprintf("projects/%s/locations/%s/jobs/%s/taskGroups/%s/tasks/%d",
			projectID, region, jobName, taskGroup, taskNumber),
	}

	response, err := batchClient.GetTask(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to get task: %w", err)
	}

	fmt.Fprintf(w, "Task info: %v\n", response)

	return nil
}

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.

import com.google.cloud.batch.v1.BatchServiceClient;
import com.google.cloud.batch.v1.Task;
import com.google.cloud.batch.v1.TaskName;
import java.io.IOException;

public class GetTask {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";
    // Name of the region hosts the job.
    String region = "europe-central2";
    // The name of the job you want to retrieve information about.
    String jobName = "JOB_NAME";
    // The name of the group that owns the task you want to check. Usually it's `group0`.
    String groupName = "group0";
    // Number of the task you want to look up.
    int taskNumber = 0;

    getTask(projectId, region, jobName, groupName, taskNumber);
  }

  // Retrieve information about a Task.
  public static void getTask(String projectId, String region, String jobName, String groupName,
      int taskNumber) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `batchServiceClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (BatchServiceClient batchServiceClient = BatchServiceClient.create()) {

      Task task = batchServiceClient.getTask(TaskName.newBuilder()
          .setProject(projectId)
          .setLocation(region)
          .setJob(jobName)
          .setTaskGroup(groupName)
          .setTask(String.valueOf(taskNumber))
          .build());
      System.out.printf("Retrieved task information: %s", task.getName());
    }
  }
}

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.

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
/**
 * The region that hosts the job.
 */
// const region = 'us-central-1';
/**
 * The name of the job you want to retrieve information about.
 */
// const jobName = 'YOUR_JOB_NAME';
/**
 * The name of the group that owns the task you want to check.
 * Usually it's `group0`.
 */
// const groupName = 'group0';
/**
 * The number of the task you want to look up.
 */
// const taskNumber = 0;

// Imports the Batch library
const batchLib = require('@google-cloud/batch');

// Instantiates a client
const batchClient = new batchLib.v1.BatchServiceClient();

async function callGetJob() {
  // Construct request
  const request = {
    name:
      `projects/${projectId}/locations/${region}/jobs/${jobName}` +
      `/taskGroups/${groupName}/tasks/${taskNumber}`,
  };

  // Run request
  const response = await batchClient.getTask(request);
  console.log(response);
}

callGetJob();

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.


from google.cloud import batch_v1

def get_task(
    project_id: str, region: str, job_name: str, group_name: str, task_number: int
) -> batch_v1.Task:
    """
    Retrieve information about a Task.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        region: name of the region hosts the job.
        job_name: the name of the job you want to retrieve information about.
        group_name: the name of the group that owns the task you want to check. Usually it's `group0`.
        task_number: number of the task you want to look up.

    Returns:
        A Task object representing the specified task.
    """
    client = batch_v1.BatchServiceClient()

    return client.get_task(
        name=f"projects/{project_id}/locations/{region}/jobs/{job_name}"
        f"/taskGroups/{group_name}/tasks/{task_number}"
    )

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.

#include "google/cloud/batch/v1/batch_client.h"

  [](std::string const& project_id, std::string const& location_id,
     std::string const& job_id, std::string const& group_id,
     std::string const& task_number) {
    auto const name = "projects/" + project_id + "/locations/" + location_id +
                      "/jobs/" + job_id + "/taskGroups/" + group_id +
                      "/tasks/" + task_number;
    // Initialize a client and issue the request.
    auto client = google::cloud::batch_v1::BatchServiceClient(
        google::cloud::batch_v1::MakeBatchServiceConnection());
    auto response = client.GetTask(name);
    if (!response) throw std::move(response).status();
    std::cout << "GetTask() succeeded with " << response->DebugString() << "\n";
  }

Langkah selanjutnya

Pelajari cara memantau dan menganalisis pekerjaan:
- Melihat histori tugas dari peristiwa status.
- 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.

Melihat tugas

Sebelum memulai

Lihat lowongan Anda

Melihat daftar lowongan Anda

Konsol

gcloud

Lihat semua tugas

Melihat daftar lowongan yang difilter

API

Lihat semua tugas

Melihat daftar lowongan yang difilter

Go

Go

Java

Java

Node.js

Node.js

Python

Python

C++

C++

Melihat detail pekerjaan

Konsol

gcloud

API

Go

Go

Java

Java

Node.js

Node.js

Python

Python

C++

C++

Lihat tugas

Melihat daftar tugas untuk

Konsol

gcloud

API

Go

Go

Java

Java

Node.js

Node.js

Python

Python

C++

C++

Melihat detail tugas

Konsol

gcloud

API

Go

Go

Java

Java

Node.js

Node.js

Python

Python

C++

C++

Langkah selanjutnya