{
  "slug": "cloud-tasks-create-commands-accept-task-level-retry-flags-f34accc9be69",
  "title": "Cloud Tasks create commands accept task-level retry flags",
  "tools": [
    "gcloud"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-29T00:00:00.000Z",
  "announced_at": "2026-09-29T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When creating an HTTP or App Engine task with alpha or beta gcloud, pass the task-level retry flags to set that task’s retry behavior. For HTTP tasks, the documented flags are --max-attempts, --max-backoff, --max-doublings, --max-retry-duration, and --min-backoff; the App Engine reference does not document these flags.",
    "examples": [
      "gcloud alpha tasks create-http-task --queue=<QUEUE> --url=<HTTP_URL> --max-attempts=<N> --max-retry-duration=<DURATION> --min-backoff=<DURATION> --max-backoff=<DURATION> --max-doublings=<N>",
      "gcloud alpha tasks create-app-engine-task --queue=<QUEUE> --url=<RELATIVE_URL> <TASK_ID>"
    ],
    "gotchas": [
      "Availability: alpha, beta",
      "--queue=<QUEUE> (required): Queue the task belongs to.",
      "--url=<HTTP_URL> (required): Full target URL; must begin with http:// or https://.",
      "--max-attempts=<N>: Maximum attempts; 1 means no retries and -1 means unlimited.",
      "--max-retry-duration=<DURATION>: Maximum time window for retrying a failed task; example 3600s.",
      "--min-backoff=<DURATION>: Minimum wait before retrying; example 10s.",
      "--max-backoff=<DURATION>: Maximum wait before retrying; example 300s.",
      "--max-doublings=<N>: Maximum number of times the backoff period will double.",
      "--queue=<QUEUE> (required): Queue the App Engine task belongs to.",
      "--url=<RELATIVE_URL>: Relative request URL; must begin with /; defaults to /.",
      "<TASK_ID>: Optional task ID; omitted IDs are generated automatically.",
      "The flags override the queue-level retry configuration for an individual task.",
      "Docs conflict: The official App Engine task reference last updated 2026-05-27 does not list any of the five task-level retry flags, despite the release note saying they were added on 2026-09-29. No conflicting behavior is asserted; App Engine usage and flag descriptions are therefore not documented in the sources found."
    ]
  },
  "why_it_matters": "Override queue-level retry settings for an individual HTTP or App Engine task.",
  "sources": [
    "https://docs.cloud.google.com/sdk/docs/release-notes#58700_2026-09-29",
    "https://docs.cloud.google.com/sdk/gcloud/reference/alpha/tasks/create-http-task",
    "https://docs.cloud.google.com/sdk/gcloud/reference/alpha/tasks/create-app-engine-task"
  ],
  "rank": 0.96031,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "cloud-20261008",
    "verdict_id": "cloud-20261008:cloud-20261008-361ce8e7254bac08-17:gate",
    "evidence_hash": "14dd3287273a31f2f5043b6780294d9d21c31f084517ed5d8074f5c2372c8307"
  },
  "review": {
    "draft_hash": "610c1b999464578650b0035bda8edead510f40c269d8fd551bd92e690ec025fb",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "cloud-20261008:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.96 >= 0.9; 2 needed) and Jev gave 0.70 (>= 0.6 needed)."
  }
}