Get Evidence CLI

The Get Evidence command exports a list of all evidence associated with an artifact or a Release Bundle v2.

📘

Note

You can also get evidence using a GraphQL API command. For more information, see Get Evidence.

Syntax

JFrog CLI uses the following syntax for getting evidence:

Artifact Evidence

jf evd get --subject-repo-path <target-path> --output <file-name>

Release Bundle v2 Evidence

jf evd get --release-bundle <name> --release-bundle-version <version-number> --output <file-name>
📘

Note

For sample commands, click here.

Command Parameters

ParameterRequired/OptionalTypeDescription
--outputrequiredstringName of the file to which evidence is exported.
--include-predicateoptionalstringFlag that determines whether the predicate is included in the exported file. By default, the predicate is not included.
--formatoptionalstringEnables extended output. Supported formats: json, jsonl

Tip

We recommend not to include the predicate if the evidence list is large, as the predicate will have a significant impact on file size.

Artifact Command Parameters

Parameter

Required/Optional

Type

Description

--subject-repo-path

required

string

The path of the evidence target.

Each evidence file must contain a single subject and must include the path. Artifacts located in local repositories that are aggregated inside virtual repositories are supported.

Release Bundle v2 Command Parameters

ParameterRequired/OptionalTypeDescription
--release-bundlerequiredstringThe Release Bundle name.
--release-bundle-versionrequiredstringThe Release Bundle version.
--artifacts-limitoptionalintegerThe maximum number of artifacts in the Release Bundle to include in the evidence list. The default is 1000 artifacts.