`job list`

List all jobs in the specified project or space. You must set either project_id or space_id.

Syntax

cpd-cli job list \
[--asset-ref=<asset-name>] \
[--asset-ref-type=<asset-ref-type>] \
[--context=<catalog-project-or-space-id>] \
[--cpd-config=<cpd-config-location>] \
[--cpd-scope=<cpd-scope>] \
[--jmes-query=<jmespath-query>] \
[--limit=<resource-limit>] \
[--next=next] \
[--output=json|yaml|table] \
[--output-file=<output-file-location>] \
--profile=<cpd-profile-name> \
[--project-id=<cpd-project-id>] \
[--quiet] \
[--raw-output=true|false] \
[--run-id=<job-run-id>] \
[--space-id=<space-identifier>] \
[--verbose]

Arguments

The job list command has no arguments.

Options

Option	Description
`--asset-ref`	Specify an asset name to retrieve all jobs that are associated with the asset. Status Optional. Syntax `--asset-ref=<asset-name>` Default value No default. Valid values Any valid asset name.
`--asset-ref-type`	Specify an asset ref type to retrieve all jobs that are associated with the asset ref type. Status Optional. Syntax `--asset-ref-type=<asset-ref-type>` Default value No default. Valid values Any valid asset ref type.
`--context`	Specify the configuration context  name. Status Optional. Syntax `--context=<catalog-project-or-space-id>` Default value Not applicable. Valid values A valid configuration context name.
`--cpd-config`	The Cloud Pak for Data  configuration location. For example, $HOME/.cpd-cli/config. Status Required. Syntax `--cpd-config=<cpd-config-location>` Default value $HOME/.cpd-cli/config Valid values A valid Cloud Pak for Data configuration location.
`--cpd-scope`	The Cloud Pak for Data space, project, or catalog scope. For example, cpd://default-context/spaces/7bccdda4-9752-4f37-868e-891de6c48135. Status Optional. Syntax `--cpd-scope=<cpd-scope>` Default value No default. Valid values A valid Cloud Pak for Data space, project, or catalog scope.
`--help` `-h`	Display command help. Status Optional. Syntax `--help` Default value No default. Valid values Not applicable.
`--jmes-query`	Provide a JMESPath query to customize the output. Status Optional. Syntax `--jmes-query=<jmespath-query>` Default value No default. Valid values A valid JMESPath query.
`--limit`	Specify the total number of resources. Status Optional. Syntax `--limit=<resource-limit>` Default value `100` Valid values An integer value in the range 0 - 200.
`--next`	Specify 'next' to retrieve the next batch. Each response can contain up to 200 results per batch. If there are more results, a 'next' field is returned in the response, which can be used to retrieve the next batch. Status Optional. Syntax `--next=next` Default value `next` Valid values `next`
`--output`	Specify an output format. Status Optional. Syntax `--output=json\|yaml\|text` Default value `text` Valid values Valid formats include JSON, YAML, or text (the default format).
`--output-file`	Specify a file path where all output is redirected. Status Optional. Syntax `--output-file=<output-file-location>` Default value No default. Valid values A valid output file path location.
`--profile`	The name of the profile that you created to store information about an instance of Cloud Pak for Data and your credentials for the instance. Status Required. Syntax `--profile=<cpd-profile-name>` Default value No default. Valid values The name of the profile that you created.
`--project-id`	Specify a Cloud Pak for Data project instance. Status Required. Syntax `--project-id=<cpd-project-id>` Default value No default. Valid values A valid project identifier.
`--quiet`	Suppress verbose messages. Status Optional. Syntax `--quiet` Default value No default. Valid values Not applicable.
`--raw-output`	When set to true, single values are not surrounded by quotation marks in  JSON output mode. Status Optional. Syntax `--raw-output=true\|false` Default value `false` Valid values `false` Single values in JSON output mode are surrounded by quotation marks. `true` Single values in JSON output mode are not surrounded by quotation marks.
`--run-id`	Specify a job run ID. The job run ID can be used to search the parent job of a job run. Status Required. Syntax `--run-id=<job-run-id>` Default value No default. Valid values A valid job run ID.
`--space-id`	Specify a space identifier. Status Required. Syntax `--space-id=<space-identifier>` Default value No default. Valid values A valid space identifier.
`--verbose`	Logs include more detailed messages. Status Optional. Syntax `--verbose` Default value No default. Valid values Not applicable.

Table 1: Command options