Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

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

Name Description Type Status
az ml pipeline clone

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

 Extension GA
az ml pipeline clone-draft

Create a pipeline draft from an existing pipeline.

 Extension GA
az ml pipeline create

Create a pipeline from a yaml definition.

 Extension GA
az ml pipeline create-draft

Create a pipeline draft from a yml definition.

 Extension GA
az ml pipeline create-schedule

Create a schedule.

 Extension GA
az ml pipeline delete-draft

Delete a pipeline draft.

 Extension GA
az ml pipeline disable

Disable a pipeline from running.

 Extension GA
az ml pipeline disable-schedule

Disable a schedule from running.

 Extension GA
az ml pipeline enable

Enable a pipeline and allow it to run.

 Extension GA
az ml pipeline enable-schedule

Enable a schedule and allow it to run.

 Extension GA
az ml pipeline get

Generate yml definition describing the pipeline.

 Extension GA
az ml pipeline last-pipeline-run

Show last pipeline run for a schedule.

 Extension GA
az ml pipeline list

List all pipelines and respective schedules in the workspace.

 Extension GA
az ml pipeline list-drafts

List pipeline drafts in the workspace.

 Extension GA
az ml pipeline list-steps

List the step runs generated from a pipeline run.

 Extension GA
az ml pipeline pipeline-runs-list

List pipeline runs generated from a schedule.

 Extension GA
az ml pipeline publish-draft

Publish a pipeline draft as a published pipeline.

 Extension GA
az ml pipeline show

Show details of a pipeline and respective schedules.

 Extension GA
az ml pipeline show-draft

Show details of a pipeline draft.

 Extension GA
az ml pipeline show-schedule

Show details of a schedule.

 Extension GA
az ml pipeline submit-draft

Submit a run from the pipeline draft.

 Extension GA
az ml pipeline update-draft

Update a pipeline draft.

 Extension GA
az ml pipeline update-schedule

Update a schedule.

 Extension GA

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
 [--acquire-policy-token]
 [--change-reference]
 [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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 [--acquire-policy-token]
 [--change-reference]
 [--experiment-name]
 [--pipeline-draft-id]
 [--pipeline-id]
 [--pipeline-run-id]
 [--resource-group]
 [--workspace-name]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--resource-group]
 [--workspace-name]

Required Parameters

--pipeline-draft-id -i

ID of the PipelineDraft to delete (guid).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--output-file]
 [--resource-group]
 [--workspace-name]

Required Parameters

--pipeline-id -i

ID of the pipeline to disable (guid).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--resource-group]
 [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--output-file]
 [--resource-group]
 [--workspace-name]

Required Parameters

--pipeline-id -i

ID of the pipeline to enable (guid).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--resource-group]
 [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--pipeline-draft-id]
 [--pipeline-id]
 [--resource-group]
 [--workspace-name]

Required Parameters

--path -p

File path to save Pipeline yaml to.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--resource-group]
 [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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 [--acquire-policy-token]
 [--change-reference]
 [--resource-group]
 [--tags]
 [--workspace-name]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--output-file]
 [--resource-group]
 [--workspace-name]

Required Parameters

--run -r

The runId of an experiment run.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--resource-group]
 [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--resource-group]
 [--workspace-name]

Required Parameters

--pipeline-draft-id -i

ID of the PipelineDraft to publish.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
 [--acquire-policy-token]
 [--change-reference]
 [--resource-group]
 [--workspace-name]

Required Parameters

--pipeline-draft-id -i

ID of the PipelineDraft to show (guid).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--resource-group]
 [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--resource-group]
 [--workspace-name]

Required Parameters

--pipeline-draft-id -i

ID of the PipelineDraft to use to submit run.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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 [--acquire-policy-token]
 [--change-reference]
 [--continue]
 [--description]
 [--experiment_name]
 [--name]
 [--parameters]
 [--pipeline-draft-id]
 [--pipeline-yaml]
 [--resource-group]
 [--tags]
 [--workspace-name]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
 [--acquire-policy-token]
 [--change-reference]
 [--name]
 [--resource-group]
 [--schedule-yaml]
 [--status]
 [--workspace-name]

Required Parameters

--schedule-id -s

ID of the schedule to show (guid).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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.

Feedback

Was this page helpful?