Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

タスクの再試行パラメータを設定する

タスクの作成時に、projects.locations.queues.tasks.create メソッドを使用して、失敗したタスクを再試行する最大回数を指定したり、再試行の制限時間を設定したり、試行間隔を制御したりできます。タスクが正常に実行されると、キューから削除されます。いずれの場合も、最大タスク保持の上限も適用されます。

このタスクレベルの再試行構成は、タスクのキューレベルの再試行構成をオーバーライドします。

タスクの作成時に再試行を構成する

次の例は、Cloud Tasks API に直接リクエストを送信して HTTP ターゲットタスクを作成するときに、再試行パラメータを設定する方法を示しています。App Engine タスクを作成するときに、同じ再試行パラメータを使用できます。パラメータの詳細については、Task リソースの RetryConfig 設定をご覧ください。

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

PROJECT_ID: 必須。タスクが作成される Google Cloud プロジェクトのプロジェクト ID。
REGION: 必須。キューがデプロイされているリージョン（例: us-central1）。
QUEUE_ID: 必須。タスクが追加されるキューの ID。
URL: 必須。リクエストの送信先となる完全修飾された URL。この文字列は http:// または https:// のいずれかで始まる必要があります（例: https://www.example.com）。
注: Cloud Run サービスまたは関数をターゲットにするには、そのデフォルトの run.app URL を使用します。
SERVICE_ACCOUNT_EMAIL: 省略可。タスクの実行時にターゲットに送信されるリクエストに含まれる認証トークンの生成に使用されるサービスアカウントのメールアドレス。サービスアカウントは、キューと同じプロジェクトに存在する必要があります。呼び出し元には、サービスアカウントに対する iam.serviceAccounts.actAs 権限が必要です。
OpenID Connect トークンの代わりに OAuth2 アクセストークンを生成するには、oidcToken フィールドを oauthToken に置き換えて、サービスアカウントのメールアドレスを指定します。
MAX_ATTEMPTS: 省略可。タスクの試行の最大回数（初回を含む）。再試行を無制限に許可するには、これを -1 に設定します。MAX_ATTEMPTS に達した場合や -1 に設定されている場合でも、MAX_RETRY_DURATION は適用されます。
MAX_RETRY_DURATION: 省略可。失敗したタスクを再試行する最大時間。タスクが最初に試行された時点から測定されます。値は「s」で終わる文字列でなければなりません（5s など）。無制限の期間を指定するには、これを 0s に設定します。MAX_RETRY_DURATION に達した場合や 0s に設定されている場合でも、MAX_ATTEMPTS は適用されます。
注: 無制限の試行回数（MAX_ATTEMPTS が -1）と無制限の期間（MAX_RETRY_DURATION が 0s）を指定すると、タスクは最大タスク保持数の上限に達するまで再試行されます。それ以外の場合、Cloud Tasks は、両方の条件が満たされるか、タスクが成功するまで再試行を停止しません。
MIN_INTERVAL: 省略可。再試行の間に待機する最小時間。値は「s」で終わる文字列でなければなりません（5s など）。
MAX_INTERVAL: 省略可。再試行の間に待機する最大時間。値は「s」で終わる文字列でなければなりません（5s など）。
MAX_DOUBLINGS: 省略可。失敗したタスクの再試行間隔が一定になるまでの、間隔が倍増する最大回数。タスクの再試行間隔は MIN_INTERVAL から始まり、MAX_DOUBLINGS 回 2 倍ずつ間隔を長くします。その後は直線的に間隔が広げられます。最終的には、MAX_INTERVAL の間隔で MAX_ATTEMPTS 回まで再試行します。
たとえば、MIN_INTERVAL が 10s、MAX_INTERVAL が 300s、MAX_DOUBLINGS が 3 の場合、再試行間隔は 3 回 2 倍になり、2^3 * 10 秒ずつ線形に増加し、タスクが MAX_ATTEMPTS 回試行されるまで MAX_INTERVAL の間隔で再試行されます（10 秒、20 秒、40 秒、80 秒、160 秒、240 秒、300 秒、300 秒など）。
SCHEDULE_TIME: 省略可。タスクが試行される予定の時刻（RFC 3339 形式）。例: 2026-10-02T15:01:23Z。時間が設定されていない場合や過去の時間が設定されている場合、Cloud Tasks は現在の時刻に設定します。

リクエストの本文（JSON）:

{
  "task": {
    "httpRequest": {
      "url": "URL",
      "httpMethod": "POST",
      "oidcToken": {
        "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
      }
    },
    "retryConfig": {
      "maxAttempts": MAX_ATTEMPTS,
      "maxRetryDuration": "MAX_RETRY_DURATION",
      "minBackoff": "MIN_INTERVAL",
      "maxBackoff": "MAX_INTERVAL",
      "maxDoublings": MAX_DOUBLINGS
    },
    "scheduleTime": "SCHEDULE_TIME"
  }
}

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

curl（Linux、macOS、Cloud Shell）

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

リクエスト本文を request.json という名前のファイルに保存します。ターミナルで次のコマンドを実行して、このファイルを現在のディレクトリに作成または上書きします。

cat > request.json << 'EOF'
{
  "task": {
    "httpRequest": {
      "url": "URL",
      "httpMethod": "POST",
      "oidcToken": {
        "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
      }
    },
    "retryConfig": {
      "maxAttempts": MAX_ATTEMPTS,
      "maxRetryDuration": "MAX_RETRY_DURATION",
      "minBackoff": "MIN_INTERVAL",
      "maxBackoff": "MAX_INTERVAL",
      "maxDoublings": MAX_DOUBLINGS
    },
    "scheduleTime": "SCHEDULE_TIME"
  }
}
EOF

その後、次のコマンドを実行して REST リクエストを送信します。

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/v2/projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks"

PowerShell（Windows）

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

@'
{
  "task": {
    "httpRequest": {
      "url": "URL",
      "httpMethod": "POST",
      "oidcToken": {
        "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
      }
    },
    "retryConfig": {
      "maxAttempts": MAX_ATTEMPTS,
      "maxRetryDuration": "MAX_RETRY_DURATION",
      "minBackoff": "MIN_INTERVAL",
      "maxBackoff": "MAX_INTERVAL",
      "maxDoublings": MAX_DOUBLINGS
    },
    "scheduleTime": "SCHEDULE_TIME"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

その後、次のコマンドを実行して REST リクエストを送信します。

$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/v2/projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks" | Select-Object -Expand Content

API Explorer（ブラウザ）

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

成功した場合、レスポンスの本文には、新しく作成された Task リソースのインスタンスが含まれます。

{
  "name": "projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_ID",
  "httpRequest": {
    "url": "URL",
    "httpMethod": "POST",
    "headers": {
      "User-Agent": "Google-Cloud-Tasks"
    },
    "oidcToken": {
      "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL",
      "audience": "URL"
    }
  },
  "retryConfig": {
    "maxAttempts": MAX_ATTEMPTS,
    "maxRetryDuration": "MAX_RETRY_DURATION",
    "minBackoff": "MIN_INTERVAL",
    "maxBackoff": "MAX_INTERVAL",
    "maxDoublings": MAX_DOUBLINGS
  },
  "scheduleTime": "SCHEDULE_TIME",
  "createTime": "2026-04-30T19:11:50Z",
  "dispatchDeadline": "600s",
  "view": "BASIC"
}