kosli list trails #
Synopsis #
kosli list trails [flags]
List Trails of an org.The list can be filtered by flow and artifact fingerprint. The results are paginated and ordered from latest to oldest.
Flags #
| Flag | Description |
|---|---|
| -F, --fingerprint string | [optional] The SHA256 fingerprint of the artifact to filter trails by. |
| -f, --flow string | [optional] The Kosli flow name. |
| -h, --help | help for trails |
| -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 20) |
Flags 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") |
| --http-proxy string | [optional] The HTTP proxy URL including protocol and port number. e.g. 'http://proxy-server-ip:proxy-port' |
| -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 Use Cases #
These examples all assume that the flags --api-token, --org, --host, (and --flow, --trail when required), are set/provided.
get a paginated list of trails for a flow #
kosli list trails
list the most recent 30 trails for a flow #
kosli list trails
--page-limit 30
show the second page of trails for a flow #
kosli list trails
--page-limit 30
--page 2
get a paginated list of trails for a flow (in JSON) #
kosli list trails
--output json
get a paginated list of trails across all flows that contain an artifact with the provided fingerprint (in JSON) #
kosli list trails
--fingerprint yourArtifactFingerprint
--output json
