artifact list.md

nsc artifact list

List artifacts in your workspace.

artifact list finds stored artifacts. Filter the results by artifact namespace, labels, or a regular expression matching the artifact path.

Usage

nsc artifact list [flags]

Example

List artifacts whose paths begin with build-outputs/:

nsc artifact list --match_path_regex '^build-outputs/' --output json

Options

--include_expired

Include expired entries in the results.

--labels <key=value>

Only return artifacts with these labels. Accepts a stringToString map of key-value pairs, such as --labels project=app,branch=main. Defaults to an empty map ([]).

--match_path_regex string

Only return artifacts whose path matches this regular expression.

--max_entries int32

Maximum number of artifacts to return, up to 10000. Defaults to 50.

--namespaces strings

Only return artifacts belonging to any of the specified namespaces.

--output, -o

Output format. One of plain or json. Defaults to plain.