Synopsis
FLOW_NAME``SEPARATOR``COMMIT_SHA1|ARTIFACT_FINGERPRINT
Expression can be specified as follows:
- flowName@
fingerprintartifact with a given fingerprint. The fingerprint can be short or complete. - flowName:
commit_shaartifact with a given commit SHA. The commit sha can be short or complete.
- flow@184c799cd551dd1d8d5c5f9a5d593b2e931f5e36122ee5c793c1d08a19839cc0
- flow@184c7
- flow:110d048bf1fce72ba546cbafc4427fb21b958dee
- flow:110d0
Flags
| Flag | Description |
|---|---|
| -h, —help | help for artifact |
| -o, —output string | [defaulted] The format of the output. Valid formats are: [table, json]. (default “table”) |
| -t, —trail string | [optional] The Kosli trail name. |
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 docs (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 an artifact with a given fingerprint from a flow
get an artifact with a given fingerprint from a flow
get the latest artifact with a given fingerprint from a flow in a specific trail
get the latest artifact with a given fingerprint from a flow in a specific trail
get an artifact with a given commit SHA from a flow
get an artifact with a given commit SHA from a flow
get a list of artifacts with a given commit SHA from a flow in a particular trail
get a list of artifacts with a given commit SHA from a flow in a particular trail