Skip to main content

cluster update ttl

Increase or decrease the Time to Live (TTL) for a running cluster that was provisioned with the Replicated Compatibility Matrix. The cluster update ttl command updates the expiration timestamp for a cluster and does not change the creation timestamp.

For more information, see About Compatibility Matrix.

Usage

replicated cluster update ttl [ID] [flags]

The cluster update ttl command first looks for the target cluster based on the value supplied for [ID]. If [ID] is not specified, the command looks for the first matching cluster with the same name as specified by the --name flag. If --name is also not provided, then the command looks for a cluster with the same ID as specified by the --id flag.

FlagType (if applicable)Description
-h, --helpHelp for the command.
--outputstring

The output format to use. Valid values: json or table. Some commands also support wide Default: table

--ttlstring

The updated TTL for the cluster, in hours or minutes. Must be a duration longer than the current lifespan of the cluster. Valid values: 10m through 48h. For example, 15h or 120min.

--idstring

ID of the cluster to update TTL (when --name is not provided).

--namestring

Name of the cluster to update TTL.

Example

Given the following cluster with a TTL of one hour:

replicated cluster ls 81cd2169
ID NAME DISTRIBUTION VERSION STATUS CREATED EXPIRES TAGS
81cd2169 gallant_fermat gke 1.27 running 2023-12-15 19:16:56 +0000 UTC 2023-12-15 20:21:35 +0000 UTC

Update the TTL to two hours:

replicated cluster update ttl 81cd2169 --ttl 2h
ID NAME DISTRIBUTION VERSION STATUS CREATED EXPIRES TAGS
81cd2169 gallant_fermat gke 1.27 running 2023-12-15 19:16:56 +0000 UTC 2023-12-15 21:21:35 +0000 UTC

Update the TTL to two hours using the cluster name:

replicated cluster update ttl --name gallant_fermat --ttl 2h
ID NAME DISTRIBUTION VERSION STATUS CREATED EXPIRES TAGS
81cd2169 gallant_fermat gke 1.27 running 2023-12-15 19:16:56 +0000 UTC 2023-12-15 21:21:35 +0000 UTC