Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Mengelola antrean dan tugas

Anda dapat mengelola antrean dan tugas dengan cara berikut:

Di konsol Google Cloud
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. Tugas akan otomatis dihapus jika batas retensi tugas maksimum tercapai.

Konsol

Di konsol Google Cloud , 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: Google Cloud project ID Anda
LOCATION: region tempat antrean berada—misalnya, us-central1

Isi permintaan harus kosong.

Untuk mengirim permintaan Anda, luaskan 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 batch tugas dari antrean

Anda dapat menghapus batch tugas dari antrean menggunakan metode projects.locations.queues.tasks.batchDelete untuk menghapus daftar nama tugas.

Perhatikan hal berikut:

Semua tugas harus dihapus dari antrean yang sama.
Ada batasan jumlah tugas yang dapat dihapus dalam satu batch. Untuk mengetahui informasi selengkapnya, lihat Kuota dan batas.
Permintaan batch, yang menggabungkan operasi individual ke dalam satu permintaan, tidak bersifat atomik karena beberapa operasi yang ada dalam batch dapat gagal, sementara yang lain berhasil.
Anda hanya dapat menghapus tugas jika tugas tersebut dijadwalkan atau dikirim. Anda tidak dapat menghapus tugas jika telah berhasil diselesaikan atau jika telah kehabisan percobaan ulang setelah gagal secara konsisten. Tugas akan otomatis dihapus jika batas retensi tugas maksimum tercapai.
Anda juga dapat membuat batch tugas. Untuk mengetahui informasi selengkapnya, lihat Membuat batch tugas.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

TASK_NAME: nama tugas yang akan dihapus dengan format berikut: projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_ID
PROJECT_ID: Google Cloud project ID Anda
REGION: region tempat antrean berada—misalnya, us-central1
QUEUE_ID: nama antrean tempat tugas berada

Isi permintaan berisi daftar nama tugas.

Meminta isi JSON:

{
  "names": [
    "TASK_NAME"
  ]
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

cat > request.json << 'EOF'
{
  "names": [
    "TASK_NAME"
  ]
}
EOF

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

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

PowerShell (Windows)

Simpan isi permintaan dalam file bernama request.json. Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:

@'
{
  "names": [
    "TASK_NAME"
  ]
}
'@  | Out-File -FilePath request.json -Encoding utf8

Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudtasks.googleapis.com/v2beta3/projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks:batchDelete" | Select-Object -Expand Content

APIs Explorer (browser)

Salin isi permintaan dan buka halaman referensi metode. Panel APIs Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Tempelkan isi permintaan di alat ini, lengkapi kolom lainnya yang wajib diisi, lalu klik Jalankan.

Jika berhasil, isi respons akan berisi instance Operation.

{
  "name": "projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.tasks.v2beta3.BatchDeleteTasksMetadata"
  },
  "done": false
}

Menghapus semua tugas dari antrean secara permanen

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

Konsol

Di konsol Google Cloud , 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: Google Cloud project ID Anda
LOCATION: region tempat antrean di-deploy—misalnya, us-central1

Isi permintaan harus kosong.

Untuk mengirim permintaan Anda, luaskan 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, tugas yang tertunda akan diproses sesuai urutan penambahannya ke backlog antrean.

Konsol

Di konsol Google Cloud , 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: Google Cloud project ID Anda
- LOCATION: region tempat antrean di-deploy—misalnya, us-central1
Isi permintaan harus kosong.

Untuk mengirim permintaan Anda, luaskan 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: Google Cloud project ID Anda
- LOCATION: region tempat antrean di-deploy—misalnya, us-central1
Isi permintaan harus kosong.

Untuk mengirim permintaan Anda, luaskan 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 membuat daftar 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 konsol Google Cloud , buka halaman Cloud Tasks > Queues.

Buka Antrean

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

Detail parameter pembatasan kapasitas 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: Google Cloud Project ID Anda.
LOCATION: region tempat antrean dibuat—misalnya, us-central1.

Untuk mengirim permintaan Anda, luaskan 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 akan berisi instance Queue resource dan responsnya akan 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 sedang berjalan pada saat penghapusan atau menunggu untuk dijalankan. Hal ini juga menghindari kegagalan proses internal dalam siklus penghapusan atau pembuatan ulang.

Konsol

Di konsol Google Cloud , 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: Google Cloud project ID Anda
LOCATION: region tempat antrean di-deploy—misalnya, us-central1

Isi permintaan harus kosong.

Untuk mengirim permintaan Anda, luaskan 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 batch tugas dari antrean

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

APIs Explorer (browser)

Menghapus semua tugas dari antrean secara permanen

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)

Langkah berikutnya

Mengelola antrean dan tugas