gcloud beta colab schedules update Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud beta colab schedules update - update a schedule
- SYNOPSIS
gcloud beta colab schedules update(SCHEDULE:--region=REGION)(--cron-schedule=CRON_SCHEDULE--display-name=DISPLAY_NAME--enable-queueing--end-time=END_TIME--max-concurrent-runs=MAX_CONCURRENT_RUNS--max-runs=MAX_RUNS--start-time=START_TIME)[GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(BETA)Update a Colab Enterprise notebook execution schedule.- EXAMPLES
- To update the cron schedule and max runs of a schedule with id
my-schedule, in regionus-central1, run:gcloudbetacolabschedulesupdatemy-schedule--region=us-central1--cron-schedule='TZ=America/Los_Angeles 0 0 * * 0'--max-runs=2 - POSITIONAL ARGUMENTS
- Schedule resource - Unique, system-generated resource name of the schedule toupdate. The arguments in this group can be used to specify the attributes ofthis resource. (NOTE) Some attributes are not given arguments in this group butcan be set in other ways.
To set the
projectattribute:- provide the argument
scheduleon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
SCHEDULE- ID of the schedule or fully qualified identifier for the schedule.
To set the
nameattribute:- provide the argument
scheduleon the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--region=REGION- Cloud region for the schedule.
To set the
regionattribute:- provide the argument
scheduleon the command line with a fullyspecified name; - provide the argument
--regionon the command line; - set the property
colab/region.
- provide the argument
- provide the argument
- Schedule resource - Unique, system-generated resource name of the schedule toupdate. The arguments in this group can be used to specify the attributes ofthis resource. (NOTE) Some attributes are not given arguments in this group butcan be set in other ways.
- REQUIRED FLAGS
- Configuration of the schedule.
At least one of these must be specified:
--cron-schedule=CRON_SCHEDULE- Cron schedule (https://en.wikipedia.org/wiki/Cron) to launch scheduled runs. Toexplicitly set a timezone to the cron tab, apply a prefix in the cron tab:"CRON_TZ=${IANA_TIME_ZONE}" or "TZ=${IANA_TIME_ZONE}". The ${IANA_TIME_ZONE} mayonly be a valid string from IANA time zone database. For example,"CRON_TZ=America/New_York 1 * * *
", or "TZ=America/New_York 1 * * *". --display-name=DISPLAY_NAME- The display name of the schedule.
--enable-queueing- Enables new scheduled runs to be queued when max_concurrent_runs limit isreached. If set to true, new runs will be queued instead of skipped.
--end-time=END_TIME- Timestamp after which no new runs can be scheduled. If specified, the schedulewill be completed when either end_time is reached or when scheduled_run_count>= max_run_count. If neither end time nor max_run_count is specified, newruns will keep getting scheduled until this Schedule is paused or deleted. Mustbe in the RFC 3339 (https://www.rfc-editor.org/rfc/rfc3339.txt) format. E.g."2026-01-01T00:00:00Z" or "2026-01-01T00:00:00-05:00"
--max-concurrent-runs=MAX_CONCURRENT_RUNS- Maximum number of runs that can be started concurrently for this Schedule. Thisis the limit for starting the scheduled requests and not the execution of thenotebook execution jobs created by the requests.
--max-runs=MAX_RUNS- The max runs for the schedule.
--start-time=START_TIME- The timestamp after which the first run can be scheduled. Defaults to theschedule creation time. Must be in the RFC 3339(https://www.rfc-editor.org/rfc/rfc3339.txt) format. E.g. "2026-01-01T00:00:00Z"or "2026-01-01T00:00:00-05:00"
- Configuration of the schedule.
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$gcloud helpfor details. - NOTES
- This command is currently in beta and might change without notice. This variantis also available:
gcloudcolabschedulesupdate
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-10-07 UTC.