kosli list snapshots #

Synopsis #

List environment snapshots. The results are paginated and ordered from latest to oldest. By default, the page limit is 15 snapshots per page.

You can optionally specify an INTERVAL between two snapshot expressions with [expression]..[expression].

Expressions can be:

~N N'th behind the latest snapshot
N snapshot number N
NOW the latest snapshot

Either expression can be omitted to default to NOW.

kosli list snapshots ENV_NAME [flags]

Flags #

Flag	Description
-h, --help	help for snapshots
-i, --interval string	[optional] Expression to define specified snapshots range.
-o, --output string	[defaulted] The format of the output. Valid formats are: [table, json]. (default "table")
--page int	[defaulted] The page number of a response. (default 1)
-n, --page-limit int	[defaulted] The number of elements per page. (default 15)
--reverse	[defaulted] Reverse the order of output list.

Options inherited from parent commands #

Flag	Description
-a, --api-token string	The Kosli API token.
-c, --config-file string	[optional] The Kosli config file path. (default "kosli")
--debug	[optional] Print debug logs to stdout. A boolean flag https://docs.kosli.com/faq/#boolean-flags (default false)
-H, --host string	[defaulted] The Kosli endpoint. (default "https://app.kosli.com")
-r, --max-api-retries int	[defaulted] How many times should API calls be retried when the API host is not reachable. (default 3)
--org string	The Kosli organization.

Examples #


# list the last 15 snapshots for an environment:
kosli list snapshots yourEnvironmentName \
	--api-token yourAPIToken \
	--org yourOrgName

# list the last 30 snapshots for an environment:
kosli list snapshots yourEnvironmentName \
	--page-limit 30 \
	--api-token yourAPIToken \
	--org yourOrgName

# list the last 30 snapshots for an environment (in JSON):
kosli list snapshots yourEnvironmentName \
	--page-limit 30 \
	--api-token yourAPIToken \
	--org yourOrgName \
	--output json