az ml pipeline

Note

This reference is part of the azure-cli-ml extension for the Azure CLI (version 2.0.28 or higher). The extension will automatically install the first time you run an az ml pipeline command. Learn more about extensions.

Pipeline subgroup commands.

Commands

az ml pipeline clone

Generate yml definition describing the pipeline run, supported only for ModuleStep for now.

az ml pipeline clone-draft

Create a pipeline draft from an existing pipeline.

az ml pipeline create

Create a pipeline from a yaml definition.

az ml pipeline create-draft

Create a pipeline draft from a yml definition.

az ml pipeline create-schedule

Create a schedule.

az ml pipeline delete-draft

Delete a pipeline draft.

az ml pipeline disable

Disable a pipeline from running.

az ml pipeline disable-schedule

Disable a schedule from running.

az ml pipeline enable

Enable a pipeline and allow it to run.

az ml pipeline enable-schedule

Enable a schedule and allow it to run.

az ml pipeline get

Generate yml definition describing the pipeline.

az ml pipeline last-pipeline-run

Show last pipeline run for a schedule.

az ml pipeline list

List all pipelines and respective schedules in the workspace.

az ml pipeline list-drafts

List pipeline drafts in the workspace.

az ml pipeline list-steps

List the step runs generated from a pipeline run.

az ml pipeline pipeline-runs-list

List pipeline runs generated from a schedule.

az ml pipeline publish-draft

Publish a pipeline draft as a published pipeline.

az ml pipeline show

Show details of a pipeline and respective schedules.

az ml pipeline show-draft

Show details of a pipeline draft.

az ml pipeline show-schedule

Show details of a schedule.

az ml pipeline submit-draft

Submit a run from the pipeline draft.

az ml pipeline update-draft

Update a pipeline draft.

az ml pipeline update-schedule

Update a schedule.

az ml pipeline clone

Generate yml definition describing the pipeline run, supported only for ModuleStep for now.

az ml pipeline clone --path
                     --pipeline-run-id
                     [--output-file]
                     [--resource-group]
                     [--workspace-name]

Required Parameters

--path -p

File path to save pipeline yaml to.

--pipeline-run-id -i

ID of the PipelineRun to clone (guid).

Optional Parameters

--output-file -f

File to write output in JSON format.

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline clone-draft

Create a pipeline draft from an existing pipeline.

az ml pipeline clone-draft [--experiment-name]
                           [--pipeline-draft-id]
                           [--pipeline-id]
                           [--pipeline-run-id]
                           [--resource-group]
                           [--workspace-name]

Optional Parameters

--experiment-name -e

Experiment name of the specified PipelineRun.

--pipeline-draft-id -i

ID of the PipelineDraft to create PipelineDraft from.

--pipeline-id -p

ID of the PublishedPipeline to create PipelineDraft from.

--pipeline-run-id -r

ID of the PipelineRun to create PipelineDraft from.

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline create

Create a pipeline from a yaml definition.

az ml pipeline create --name
                      --pipeline-yaml
                      [--continue]
                      [--description]
                      [--output-file]
                      [--resource-group]
                      [--version]
                      [--workspace-name]

Required Parameters

--name -n

Name to assign to the pipeline.

--pipeline-yaml -y

YAML file which defines a pipeline.

Optional Parameters

--continue -c

Boolean flag to allow a pipeline to continue executing after a step fails.

--description -d

Description text of the pipeline.

--output-file -f

File to write output in JSON format.

--resource-group -g

Resource group name.

--version -v

Version string of the pipeline.

--workspace-name -w

Workspace name.

az ml pipeline create-draft

Create a pipeline draft from a yml definition.

az ml pipeline create-draft --experiment_name
                            --name
                            --pipeline-yaml
                            [--continue]
                            [--description]
                            [--parameters]
                            [--properties]
                            [--resource-group]
                            [--tags]
                            [--workspace-name]

Required Parameters

--experiment_name -e

Experiment name for the pipeline draft.

--name -n

Name to assign to the pipeline draft.

--pipeline-yaml -y

YAML file which defines the pipeline draft.

Optional Parameters

--continue -c

Boolean flag to allow a pipeline to continue executing after a step fails.

--description -d

Description text of the pipeline draft.

--parameters

PipelineParameters for the draft with 'key=value' syntax.

--properties -p

Properties for the draft with 'key=value' syntax.

--resource-group -g

Resource group name.

--tags -t

Tags for the draft with 'key=value' syntax.

--workspace-name -w

Workspace name.

az ml pipeline create-schedule

Create a schedule.

az ml pipeline create-schedule --experiment-name
                               --name
                               --pipeline-id
                               [--resource-group]
                               [--schedule-yaml]
                               [--workspace-name]

Required Parameters

--experiment-name -e

Name of experiment.

--name -n

Name of schedule.

--pipeline-id -i

ID of the pipeline to create schedule (guid).

Optional Parameters

--resource-group -g

Resource group name.

--schedule-yaml -y

Schedule YAML input.

--workspace-name -w

Workspace name.

az ml pipeline delete-draft

Delete a pipeline draft.

az ml pipeline delete-draft --pipeline-draft-id
                            [--resource-group]
                            [--workspace-name]

Required Parameters

--pipeline-draft-id -i

ID of the PipelineDraft to delete (guid).

Optional Parameters

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline disable

Disable a pipeline from running.

az ml pipeline disable --pipeline-id
                       [--output-file]
                       [--resource-group]
                       [--workspace-name]

Required Parameters

--pipeline-id -i

ID of the pipeline to disable (guid).

Optional Parameters

--output-file -f

File to write output in JSON format.

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline disable-schedule

Disable a schedule from running.

az ml pipeline disable-schedule --schedule-id
                                [--resource-group]
                                [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline enable

Enable a pipeline and allow it to run.

az ml pipeline enable --pipeline-id
                      [--output-file]
                      [--resource-group]
                      [--workspace-name]

Required Parameters

--pipeline-id -i

ID of the pipeline to enable (guid).

Optional Parameters

--output-file -f

File to write output in JSON format.

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline enable-schedule

Enable a schedule and allow it to run.

az ml pipeline enable-schedule --schedule-id
                               [--resource-group]
                               [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline get

Generate yml definition describing the pipeline.

az ml pipeline get --path
                   [--pipeline-draft-id]
                   [--pipeline-id]
                   [--resource-group]
                   [--workspace-name]

Required Parameters

--path -p

File path to save Pipeline yaml to.

Optional Parameters

--pipeline-draft-id -d

ID of the PipelineDraft to get (guid).

--pipeline-id -i

ID of the Pipeline to get (guid).

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline last-pipeline-run

Show last pipeline run for a schedule.

az ml pipeline last-pipeline-run --schedule-id
                                 [--resource-group]
                                 [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline list

List all pipelines and respective schedules in the workspace.

az ml pipeline list [--output-file]
                    [--resource-group]
                    [--workspace-name]

Optional Parameters

--output-file -f

File to write output in JSON format.

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline list-drafts

List pipeline drafts in the workspace.

az ml pipeline list-drafts [--resource-group]
                           [--tags]
                           [--workspace-name]

Optional Parameters

--resource-group -g

Resource group name.

--tags -t

Tags for a draft with 'key=value' syntax.

--workspace-name -w

Workspace name.

az ml pipeline list-steps

List the step runs generated from a pipeline run.

az ml pipeline list-steps --run
                          [--output-file]
                          [--resource-group]
                          [--workspace-name]

Required Parameters

--run -r

The runId of an experiment run.

Optional Parameters

--output-file -f

File to write output in JSON format.

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline pipeline-runs-list

List pipeline runs generated from a schedule.

az ml pipeline pipeline-runs-list --schedule-id
                                  [--resource-group]
                                  [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline publish-draft

Publish a pipeline draft as a published pipeline.

az ml pipeline publish-draft --pipeline-draft-id
                             [--resource-group]
                             [--workspace-name]

Required Parameters

--pipeline-draft-id -i

ID of the PipelineDraft to publish.

Optional Parameters

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline show

Show details of a pipeline and respective schedules.

az ml pipeline show --pipeline-id
                    [--output-file]
                    [--resource-group]
                    [--workspace-name]

Required Parameters

--pipeline-id -i

ID of the pipeline to show (guid).

Optional Parameters

--output-file -f

File to write output in JSON format.

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline show-draft

Show details of a pipeline draft.

az ml pipeline show-draft --pipeline-draft-id
                          [--resource-group]
                          [--workspace-name]

Required Parameters

--pipeline-draft-id -i

ID of the PipelineDraft to show (guid).

Optional Parameters

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline show-schedule

Show details of a schedule.

az ml pipeline show-schedule --schedule-id
                             [--resource-group]
                             [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline submit-draft

Submit a run from the pipeline draft.

az ml pipeline submit-draft --pipeline-draft-id
                            [--resource-group]
                            [--workspace-name]

Required Parameters

--pipeline-draft-id -i

ID of the PipelineDraft to use to submit run.

Optional Parameters

--resource-group -g

Resource group name.

--workspace-name -w

Workspace name.

az ml pipeline update-draft

Update a pipeline draft.

az ml pipeline update-draft [--continue]
                            [--description]
                            [--experiment_name]
                            [--name]
                            [--parameters]
                            [--pipeline-draft-id]
                            [--pipeline-yaml]
                            [--resource-group]
                            [--tags]
                            [--workspace-name]

Optional Parameters

--continue -c

Boolean flag to allow a pipeline to continue executing after a step fails.

--description -d

Description text of the pipeline draft.

--experiment_name -e

Experiment name for the pipeline draft.

--name -n

Name to assign to the pipeline draft.

--parameters

PipelineParameters for the draft with 'key=value' syntax.

--pipeline-draft-id -i

ID of the PipelineDraft to update.

--pipeline-yaml -y

YAML file which defines the pipeline draft.

--resource-group -g

Resource group name.

--tags -t

Tags for the draft with 'key=value' syntax.

--workspace-name -w

Workspace name.

az ml pipeline update-schedule

Update a schedule.

az ml pipeline update-schedule --schedule-id
                               [--name]
                               [--resource-group]
                               [--schedule-yaml]
                               [--status]
                               [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

--name -n

Name of the schedule to show (guid).

--resource-group -g

Resource group name.

--schedule-yaml -y

Schedule YAML input.

--status -t

Status of the schedule to show (guid).

--workspace-name -w

Workspace name.