{
  "slug": "gcloud-spanner-instances-adds-total-cpu-based-autoscaling-flags-bdae58b7fa4f",
  "title": "gcloud spanner instances adds total CPU based autoscaling flags",
  "tools": [
    "gcloud"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-01-06T00:00:00.000Z",
  "announced_at": "2026-01-06T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When configuring managed autoscaling for a Spanner instance, set `--autoscaling-total-cpu-target` with the required autoscaling limits and storage target. Use `gcloud spanner instances create` to create an instance or `gcloud spanner instances update` to configure an existing one.",
    "examples": [
      "gcloud spanner instances create <instance-id> --config=<instance-config> --description=<description> --autoscaling-min-nodes=<min-nodes> --autoscaling-max-nodes=<max-nodes> --autoscaling-total-cpu-target=<total-cpu-percent> --autoscaling-storage-target=<storage-percent>",
      "gcloud spanner instances update <instance-id> --autoscaling-min-nodes=<min-nodes> --autoscaling-max-nodes=<max-nodes> --autoscaling-total-cpu-target=<total-cpu-percent> --autoscaling-storage-target=<storage-percent>"
    ],
    "gotchas": [
      "Availability: beta and GA",
      "INSTANCE (required): Cloud Spanner instance ID.",
      "--config (required): Instance configuration; defines geographic placement and replication.",
      "--description (required): Instance description.",
      "--autoscaling-total-cpu-target (required): Target percentage of total CPU the autoscaled instance can utilize. At least one CPU target must be specified; the documented target range is 10–90%.",
      "--autoscaling-storage-target (required): Target percentage of storage for the autoscaled instance; required when other autoscaling arguments are specified.",
      "--autoscaling-min-nodes (required): Minimum node count for autoscaling. Specify this and max nodes, or use the processing-unit limits instead; the two limit units are mutually exclusive.",
      "--autoscaling-max-nodes (required): Maximum node count for autoscaling. Specify this and min nodes, or use the processing-unit limits instead; the two limit units are mutually exclusive.",
      "--autoscaling-min-processing-units (required): Minimum processing units for autoscaling. Use with max processing units instead of node limits; the two limit units are mutually exclusive.",
      "--autoscaling-max-processing-units (required): Maximum processing units for autoscaling. Use with min processing units instead of node limits; the two limit units are mutually exclusive.",
      "--autoscaling-high-priority-cpu-target: Target percentage of high-priority CPU; may be specified alongside the total CPU target.",
      "--asymmetric-autoscaling-option.location (required): Location of the read-only region to scale asymmetrically; required when using this option.",
      "--asymmetric-autoscaling-option.min_nodes: Minimum nodes for asymmetric autoscaling; otherwise inherited from the base instance configuration.",
      "--asymmetric-autoscaling-option.max_nodes: Maximum nodes for asymmetric autoscaling; otherwise inherited from the base instance configuration.",
      "--asymmetric-autoscaling-option.min_processing_units: Minimum processing units for asymmetric autoscaling.",
      "--asymmetric-autoscaling-option.max_processing_units: Maximum processing units for asymmetric autoscaling.",
      "--asymmetric-autoscaling-option.total_cpu_target: Total CPU target for asymmetric autoscaling; documented range is 10–90%.",
      "--asymmetric-autoscaling-option.high_priority_cpu_target: High-priority CPU target for asymmetric autoscaling.",
      "--asymmetric-autoscaling-option.disable_total_cpu_autoscaling: Set TRUE to disable total CPU autoscaling for the replica; cannot disable both total CPU and high-priority CPU autoscaling on the same replica.",
      "--asymmetric-autoscaling-option.disable_high_priority_cpu_autoscaling: Set TRUE to disable high-priority CPU autoscaling for the replica; cannot disable both total CPU and high-priority CPU autoscaling on the same replica.",
      "Prerequisite: The managed autoscaler create examples are for Enterprise and Enterprise Plus edition instances.",
      "Prerequisite: For creation, provide `--config` and `--description`; managed autoscaling requires storage target, limits in nodes or processing units, and at least one CPU target."
    ]
  },
  "why_it_matters": "Configure total CPU based autoscaling for Spanner instances.",
  "sources": [
    "https://docs.cloud.google.com/sdk/docs/release-notes#55100_2026-01-06",
    "https://docs.cloud.google.com/sdk/gcloud/reference/spanner/instances/create",
    "https://docs.cloud.google.com/sdk/gcloud/reference/spanner/instances/update",
    "https://docs.cloud.google.com/spanner/docs/create-manage-instances"
  ],
  "rank": 0.95023,
  "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-09f50c53d8e7c61d-7:gate",
    "evidence_hash": "f7e91e62836d36fb538a6fbd9dab32e92384a89f86ec2c32c89d369ece6b0163"
  },
  "review": {
    "draft_hash": "f99be8fccd5fbbd325ad215c8d8c54a436c5a7bc8ff3ef45f4bd466329c43787",
    "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.95 >= 0.9; 2 needed) and Jev gave 0.63 (>= 0.6 needed)."
  }
}