このページは Cloud Translation API によって翻訳されました。

キューとタスクの管理

キューとタスクは次の方法で管理できます。

Google Cloud コンソールで
ターミナルまたは Cloud Shell で Google Cloud CLI を使用する
Cloud Tasks API にリクエストを送信する

キューからタスクを削除する

タスクがスケジュール設定されている場合やディスパッチされている場合は、タスクを削除できます。たとえば、何回再試行しても正常に完了できないタスクの削除が必要になることがあります。タスクが正常に完了した場合や、失敗が繰り返されて再試行回数がなくなった場合は、タスクを削除できません。

コンソール

Google Cloud コンソールで、[Cloud Tasks] > [キュー] ページに移動します。

[キュー] に移動
削除するタスクのキューの名前をクリックします。
削除するタスクのチェックボックスをオンにします。
[タスクを削除] をクリックします。
[削除] をクリックして確定します。

gcloud

gcloud tasks delete コマンドを使用してタスクを削除します。

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

次のように置き換えます。

TASK_NAME: 削除するタスクの名前
QUEUE_ID: タスクが属するキューの名前
LOCATION: キューがデプロイされているリージョン（例: us-central1）

REST

タスクを削除するには、projects.locations.queues.tasks.delete メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

QUEUE_ID: タスクが属するキューの名前
TASK_NAME: 削除するタスクの名前
PROJECT_ID: 実際の Google Cloudプロジェクト ID
LOCATION: キューが存在するリージョン（例: us-central1）

リクエストの本文は空にする必要があります。

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

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）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

$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

API Explorer（ブラウザ）

メソッドのリファレンスページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。

成功すると、レスポンスの本文は空になります。

キューからすべてのタスクを削除する

キューからすべてのタスクを削除するには、タスクをパージします。パージ呼び出しの前に作成されたすべてのタスクが完全に削除されます。ただし、パージオペレーションが有効になるまでに最大 1 分かかることがあり、パージが有効になる前にタスクがディスパッチされることがあります。

コンソール

Google Cloud コンソールで、[Cloud Tasks] > [キュー] ページに移動します。

[キュー] に移動
削除するタスクのキューの名前をクリックします。
[キューを消去] をクリックします。
プロンプトが表示されたら、[削除] をクリックします。

gcloud

gcloud tasks queues purge コマンドを使用してキューを削除します。

gcloud tasks queues purge QUEUE_ID \
    --location=LOCATION

次のように置き換えます。

QUEUE_ID: パージするキューの名前
LOCATION: キューがデプロイされているリージョン（例: us-central1）

REST

キューを削除するには、projects.locations.queues.purge メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

QUEUE_ID: パージするキューの名前
PROJECT_ID: 実際の Google Cloudプロジェクト ID
LOCATION: キューがデプロイされているリージョン（例: us-central1）

リクエストの本文は空にする必要があります。

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

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）

次のコマンドを実行します。

$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

API Explorer（ブラウザ）

成功した場合、レスポンスの本文には 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"
}

キューを一時停止または再開する

キューを一時停止または再開できます。キューを一時停止すると、タスクの実行と配信が停止します。タスクを作成してキューに push または追加することはできますが、タスクは処理されません。キューが再開されると、バックログされたタスクはキューのバックログに追加された順に処理されます。

コンソール

Google Cloud コンソールで、[Cloud Tasks] > [キュー] ページに移動します。

[キュー] に移動
一時停止するキューのチェックボックスをオンにします。
[キューを一時停止] をクリックします。
プロンプトが表示されたら、[一時停止] をクリックします。
キューを再開するには、[キューの再開] をクリックします。

gcloud

gcloud tasks queues pause コマンドを使用してキューを一時停止します。
```
gcloud tasks queues pause QUEUE_ID \
    --location=LOCATION
```
次のように置き換えます。
- QUEUE_ID: 一時停止するキューの名前
- LOCATION: キューがデプロイされているリージョン（例: us-central1）
gcloud tasks queues resume コマンドを使用してキューを再開します。
```
gcloud tasks queues resume QUEUE_ID \
    --location=LOCATION
```

REST

キューを一時停止するには、projects.locations.queues.pause メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。
- QUEUE_ID: 一時停止するキューの名前
- PROJECT_ID: 実際の Google Cloudプロジェクト ID
- LOCATION: キューがデプロイされているリージョン（例: us-central1）
リクエストの本文は空にする必要があります。

リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。
```
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）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。
```
$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
```
API Explorer（ブラウザ）

メソッドのリファレンスページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。

成功した場合、レスポンスの本文には 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"
}
```
キューを再開するには、projects.locations.queues.resume メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。
- QUEUE_ID: 再開するキューの名前
- PROJECT_ID: 実際の Google Cloudプロジェクト ID
- LOCATION: キューがデプロイされているリージョン（例: us-central1）
リクエストの本文は空にする必要があります。

リクエストを送信するには、次のいずれかのオプションを展開します。
curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。
```
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）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。
```
$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
```
API Explorer（ブラウザ）

メソッドのリファレンスページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。

成功した場合、レスポンスの本文には 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"
}
```

キューの一覧表示

キューを一覧表示できます。キューを一覧表示すると、レート制限と再試行パラメータの詳細が返されます。次のフィールドは同等です。

最大レート（コンソール）、MAX_RATE（gcloud）、maxDispatchesPerSecond（REST）
最大同時実行数（コンソール）、MAX_NUM_OF_TASKS（gcloud）、maxConcurrentDispatches（REST）

コンソール

Google Cloud コンソールで、[Cloud Tasks] > [キュー] ページに移動します。

[キュー] に移動

Google Cloud プロジェクト内のすべてのキューが一覧表示されます。
詳細を表示するには、キューの名前をクリックし、[構成] タブをクリックします。

レート制限と再試行パラメータの詳細が表示されます。

gcloud

gcloud tasks queues list コマンドを使用してキューを一覧表示します。

gcloud tasks queues list \
    --location=LOCATION

LOCATION は、キューがデプロイされているリージョン（us-central1 など）に置き換えます。ロケーションが指定されていない場合、 Google Cloud プロジェクトの App Engine アプリのロケーションが存在すれば使用されます。存在しない場合は、ロケーションを指定する必要があります。

出力例を以下に示します。

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

REST

キューを一覧表示するには、projects.locations.queues.list メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際の Google Cloudプロジェクト ID。
LOCATION: キューが作成されるリージョン（例: us-central1）。

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

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

PowerShell（Windows）

次のコマンドを実行します。

$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

API Explorer（ブラウザ）

成功した場合、レスポンスの本文には Queue リソースのインスタンスが含まれ、レスポンスは次のようになります。

{
  "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"
}

キューを削除する

キューを削除できます。キュー内のタスクも削除されます。キューを削除した場合は、同じ名前で再作成するまでに 3 日間待つ必要があります。この待機期間により、削除時に実行中または実行待ちのタスクで予期しない動作が発生することを防ぐことができます。また、削除または再作成サイクルの内部プロセス障害も回避できます。

コンソール

Google Cloud コンソールで、[Cloud Tasks] > [キュー] ページに移動します。

[キュー] に移動
削除するキューのチェックボックスをオンにします。
[キューを削除] をクリックします。
プロンプトでキュー名を入力し、[確認] をクリックします。

gcloud

gcloud tasks queues delete コマンドを使用してキューを削除します。

gcloud tasks queues delete QUEUE_ID \
    --location=LOCATION

次のように置き換えます。

QUEUE_ID: 削除するキューの名前
LOCATION: キューがデプロイされているリージョン（例: us-central1）

REST

キューを削除するには、projects.locations.queues.delete メソッドを使用します。

リクエストのデータを使用する前に、次のように置き換えます。

QUEUE_ID: 削除するキューの名前
PROJECT_ID: 実際の Google Cloudプロジェクト ID
LOCATION: キューがデプロイされているリージョン（例: us-central1）

リクエストの本文は空にする必要があります。

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

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）

次のコマンドを実行します。

$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

API Explorer（ブラウザ）

成功すると、レスポンスの本文は空になります。

キューとタスクの管理 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

キューからタスクを削除する

コンソール

gcloud

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

API Explorer（ブラウザ）

キューからすべてのタスクを削除する

コンソール

gcloud

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

API Explorer（ブラウザ）

キューを一時停止または再開する

コンソール

gcloud

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

API Explorer（ブラウザ）

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

API Explorer（ブラウザ）

キューの一覧表示

コンソール

gcloud

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

API Explorer（ブラウザ）

キューを削除する

コンソール

gcloud

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

API Explorer（ブラウザ）

キューとタスクの管理