iai services update
Update a service in a project
Synopsis
Update a service in a specific project.
Only the flags you pass are applied; everything else is left at its current value.
Lists (--env, --secret) replace the entire current list when provided — pass every value you want to keep.
Replicas and autoscaling are mutually exclusive: passing --replicas disables autoscaling, and passing any --autoscaling-* flag switches back to autoscaling.
For schedules, passing --schedule-uptime auto-clears any existing downtime, and --schedule-downtime auto-clears any existing uptime. Pass --schedule-timezone alongside either to change the timezone.
Use --clear-env, --clear-secret, --clear-healthcheck, --clear-schedule, or --clear-stack-id to remove those configurations entirely.
Before applying, the CLI prints deploy-awareness output to stderr: the live revision this update replaces, and the names of any env vars or secret refs that --env/--secret would drop from the live service (the flags replace the entire list). The update is refused when it would drop live env vars or secret refs via --env/--secret; pass --force to apply anyway. --clear-env and --clear-secret never trigger the gate: clearing is explicit intent. The checks fail open when live state cannot be fetched; use --expect-revision to fail instead when the live revision differs from what you expect.
iai services update <service_name> [flags]Examples
iai services update my-svc --image-tag v2
iai services update my-svc --image-tag v2 --expect-revision 47
iai services update my-svc --memory 1G --cpu 0.5
iai services update my-svc --replicas 3
iai services update my-svc --autoscaling-max-replicas 8
iai services update my-svc --schedule-downtime "Sat-Sun 00:00-24:00"
iai services update my-svc --clear-healthcheck
iai services update my-svc --stack-id my-stack
iai services update my-svc --clear-stack-idOptions
Options inherited from parent commands
SEE ALSO
iai services - Deploy and manage HTTP services
Last updated
Was this helpful?

