Halaman ini diterjemahkan oleh Cloud Translation API.

Mengelola antrean dan tugas

Anda dapat mengelola antrean dan tugas dengan cara berikut:

Di Google Cloud console
Dengan menggunakan Google Cloud CLI di terminal atau Cloud Shell
Dengan mengirim permintaan ke Cloud Tasks API

Menghapus tugas dari antrean

Anda dapat menghapus tugas jika tugas tersebut dijadwalkan atau dikirim. Misalnya, Anda mungkin perlu menghapus tugas yang tidak dapat diselesaikan dengan sukses, berapa kali pun tugas tersebut dicoba ulang. Anda tidak dapat menghapus tugas jika tugas tersebut telah berhasil diselesaikan atau jika tugas tersebut telah kehabisan percobaan ulang setelah terus gagal.

Konsol

Di Google Cloud konsol, buka halaman Cloud Tasks > Queues.

Buka Antrean
Klik nama antrean untuk tugas yang ingin Anda hapus.
Pilih kotak centang untuk tugas yang ingin Anda hapus.
Klik Hapus tugas.
Saat diminta, klik Hapus.

gcloud

Hapus tugas menggunakan perintah gcloud tasks delete:

gcloud tasks delete TASK_NAME \
    --queue=QUEUE_ID \
    --location=LOCATION

Ganti kode berikut:

TASK_NAME: nama tugas yang ingin Anda hapus
QUEUE_ID: nama antrean tempat tugas berada
LOCATION: region tempat antrean di-deploy—misalnya, us-central1

REST

Untuk menghapus tugas, gunakan metode projects.locations.queues.tasks.delete.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

QUEUE_ID: nama antrean tempat tugas berada
TASK_NAME: nama tugas yang ingin Anda hapus
PROJECT_ID: project ID Google Cloud Anda
LOCATION: region tempat antrean berada—misalnya, us-central1

Isi permintaan harus kosong.

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID/tasks/TASK_NAME"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID/tasks/TASK_NAME" | Select-Object -Expand Content

APIs Explorer (browser)

Buka halaman referensi metode. Panel APIs Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.

Jika berhasil, isi respons akan kosong.

Menghapus permanen semua tugas dari antrean

Anda dapat menghapus semua tugas dari antrean dengan menghapusnya secara permanen. Semua tugas yang dibuat sebelum panggilan penghapusan akan dihapus permanen. Namun, operasi penghapusan permanen dapat memerlukan waktu hingga satu menit untuk diterapkan dan tugas mungkin dikirim sebelum penghapusan permanen diterapkan.

Konsol

Di Google Cloud konsol, buka halaman Cloud Tasks > Queues.

Buka Antrean
Klik nama antrean untuk tugas yang ingin Anda hapus.
Klik Hapus permanen antrean.
Saat diminta, klik Hapus.

gcloud

Kosongkan antrean menggunakan perintah gcloud tasks queues purge:

gcloud tasks queues purge QUEUE_ID \
    --location=LOCATION

Ganti kode berikut:

QUEUE_ID: nama antrean yang ingin Anda hapus
LOCATION: region tempat antrean di-deploy—misalnya, us-central1

REST

Untuk menghapus antrean, gunakan metode projects.locations.queues.purge.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

QUEUE_ID: nama antrean yang ingin Anda hapus
PROJECT_ID: project ID Google Cloud Anda
LOCATION: region tempat antrean di-deploy—misalnya, us-central1

Isi permintaan harus kosong.

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:purge"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:purge" | Select-Object -Expand Content

APIs Explorer (browser)

Jika berhasil, isi respons berisi instance Queue:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING",
  "purgeTime": "2025-03-28T13:06:30.110255Z"
}

Menjeda atau melanjutkan antrean

Anda dapat menjeda atau melanjutkan antrean. Menjeda antrean berarti eksekusi dan penayangan tugas dihentikan. Anda tetap dapat membuat tugas dan mengirim atau menambahkan tugas tersebut ke antrean, tetapi tugas tidak akan diproses. Setelah antrean dilanjutkan, semua tugas yang tertunda akan diproses sesuai urutan penambahannya ke backlog antrean.

Konsol

Di Google Cloud konsol, buka halaman Cloud Tasks > Queues.

Buka Antrean
Centang kotak untuk antrean yang ingin Anda jeda.
Klik Jeda antrean.
Saat diminta, klik Jeda.
Untuk melanjutkan antrean, klik Lanjutkan antrean.

gcloud

Jeda antrean menggunakan perintah gcloud tasks queues pause:
```
gcloud tasks queues pause QUEUE_ID \
    --location=LOCATION
```
Ganti kode berikut:
- QUEUE_ID: nama antrean yang ingin Anda jeda
- LOCATION: region tempat antrean di-deploy—misalnya, us-central1

Lanjutkan antrean menggunakan perintah gcloud tasks queues resume:

gcloud tasks queues resume QUEUE_ID \
    --location=LOCATION

REST

Untuk menjeda antrean, gunakan metode projects.locations.queues.pause.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- QUEUE_ID: nama antrean yang ingin Anda jeda
- PROJECT_ID: project ID Google Cloud Anda
- LOCATION: region tempat antrean di-deploy—misalnya, us-central1
Isi permintaan harus kosong.

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:pause"
```
PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:pause" | Select-Object -Expand Content
```
APIs Explorer (browser)

Buka halaman referensi metode. Panel APIs Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.

Jika berhasil, isi respons berisi instance Queue:
```
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "PAUSED"
}
```
Untuk melanjutkan antrean, gunakan metode projects.locations.queues.resume.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- QUEUE_ID: nama antrean yang ingin Anda lanjutkan
- PROJECT_ID: project ID Google Cloud Anda
- LOCATION: region tempat antrean di-deploy—misalnya, us-central1
Isi permintaan harus kosong.

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:resume"
```
PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:resume" | Select-Object -Expand Content
```
APIs Explorer (browser)

Buka halaman referensi metode. Panel APIs Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.

Jika berhasil, isi respons berisi instance Queue:
```
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING"
}
```

Membuat daftar antrean

Anda dapat mencantumkan antrean. Saat mencantumkan antrean, beberapa detail batas kecepatan dan parameter percobaan ulang ditampilkan. Perhatikan bahwa kolom berikut setara:

Kecepatan maks (Konsol), MAX_RATE (gcloud), maxDispatchesPerSecond (REST)
Max concurrent (Konsol), MAX_NUM_OF_TASKS (gcloud), maxConcurrentDispatches (REST)

Konsol

Di Google Cloud konsol, buka halaman Cloud Tasks > Queues.

Buka Antrean

Semua antrean di Google Cloud project Anda akan dicantumkan.
Untuk mengetahui detail selengkapnya, klik nama antrean, lalu klik tab Konfigurasi.

Detail parameter batas frekuensi dan percobaan ulang ditampilkan.

gcloud

Mencantumkan antrean menggunakan perintah gcloud tasks queues list:

gcloud tasks queues list \
    --location=LOCATION

Ganti LOCATION dengan region tempat antrean di-deploy—misalnya, us-central1. Jika lokasi tidak ditentukan, lokasi aplikasi App Engine project Google Cloud Anda akan digunakan jika ada; jika tidak, Anda harus menentukan lokasi.

Outputnya akan mirip dengan berikut ini:

QUEUE_NAME: my-queue
STATE: PAUSED
MAX_NUM_OF_TASKS: 1000
MAX_RATE (/sec): 500.0
MAX_ATTEMPTS: 100
...

REST

Untuk mencantumkan antrean, gunakan metode projects.locations.queues.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID Google Cloud Anda.
LOCATION: region tempat antrean dibuat—misalnya, us-central1.

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues" | Select-Object -Expand Content

APIs Explorer (browser)

Jika berhasil, isi respons berisi instance Queue resource dan responsnya akan terlihat mirip dengan berikut ini:

{
  "queues": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
      "rateLimits": {
        "maxDispatchesPerSecond": 500,
        "maxBurstSize": 100,
        "maxConcurrentDispatches": 1000
      },
      "retryConfig": {
        "maxAttempts": 100,
        "minBackoff": "0.100s",
        "maxBackoff": "3600s",
        "maxDoublings": 16
      },
      "state": "PAUSED",
      "purgeTime": "2025-03-28T13:37:32.292552Z"
    },
    ...
  ],
  "nextPageToken": "CjQKCHppcHBlcjIAEgwI9-GExAYQ_oDc1AMaGioLeWlrZXMtYWdhaW4yC3VzLWNlbnRyYWwx"
}

Menghapus antrean

Anda dapat menghapus antrean. Semua tugas dalam antrean juga akan dihapus. Jika Anda menghapus antrean, Anda harus menunggu 3 hari sebelum membuatnya ulang dengan nama yang sama. Periode tunggu ini mencegah perilaku yang tidak terduga dalam tugas yang berjalan pada saat penghapusan atau menunggu untuk dijalankan. Tindakan ini juga menghindari kegagalan proses internal dalam siklus penghapusan atau pembuatan ulang.

Konsol

Di Google Cloud konsol, buka halaman Cloud Tasks > Queues.

Buka Antrean
Pilih kotak centang untuk antrean yang ingin Anda hapus.
Klik Hapus antrean.
Pada perintah, ketik nama antrean, lalu klik Konfirmasi.

gcloud

Hapus antrean menggunakan perintah gcloud tasks queues delete:

gcloud tasks queues delete QUEUE_ID \
    --location=LOCATION

Ganti kode berikut:

QUEUE_ID: nama antrean yang ingin Anda hapus
LOCATION: region tempat antrean di-deploy—misalnya, us-central1

REST

Untuk menghapus antrean, gunakan metode projects.locations.queues.delete.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

QUEUE_ID: nama antrean yang ingin Anda hapus
PROJECT_ID: project ID Google Cloud Anda
LOCATION: region tempat antrean di-deploy—misalnya, us-central1

Isi permintaan harus kosong.

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" | Select-Object -Expand Content

APIs Explorer (browser)

Jika berhasil, isi respons akan kosong.

Mengelola antrean dan tugas Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Menghapus tugas dari antrean

Konsol

gcloud

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

APIs Explorer (browser)

Menghapus permanen semua tugas dari antrean

Konsol

gcloud

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

APIs Explorer (browser)

Menjeda atau melanjutkan antrean

Konsol

gcloud

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

APIs Explorer (browser)

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

APIs Explorer (browser)

Membuat daftar antrean

Konsol

gcloud

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

APIs Explorer (browser)

Menghapus antrean

Konsol

gcloud

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

APIs Explorer (browser)

Mengelola antrean dan tugas