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

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

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

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

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

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

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

PROJECT_ID: 必須。タスクが作成されるプロジェクトのプロジェクト ID。 Google Cloud
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に設定します。に達した場合、または -1 に設定した場合でも、MAX_RETRY_DURATION は適用されます。MAX_ATTEMPTS
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: 省略可。失敗したタスクの再試行の間隔が、増加が一定になる前に 2 倍になる最大回数。タスクの再試行間隔は 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/v2beta3/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/v2beta3/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"
}