DownloadPipelineArtifact@0 - Download pipeline artifact v0 task

Use this task to download pipeline artifacts from earlier stages in this pipeline, or from another pipeline.

There is a newer version of this task. For more information, see DownloadPipelineArtifact@2.

Note

For more information, including Azure CLI commands, see downloading artifacts.

Syntax

# Download Pipeline Artifacts v0
# Downloads an artifact associated with a pipeline.
- task: DownloadPipelineArtifact@0
  inputs:
    #pipelineId: # string. The specific pipeline to download from. 
    artifactName: 'drop' # string. Required. The name of artifact to download. Default: drop.
    targetPath: # string. Required. Path to download to.

Inputs

pipelineId - The specific pipeline to download from
string.

The build from which to download the artifacts. For example: 1764. If missing, target the current pipeline.

artifactName - The name of artifact to download.
string. Required. Default value: drop.

Specifies the name of the artifact to download. If the value is left empty, the task downloads all artifacts associated with the pipeline run.

targetPath - Path to download to
string. Required.

The folder path to download the artifact to. This can be a fully-qualified path or a path relative to the root of the repository. Wildcards are not supported. Variables are supported. If the folder doesn't exist it will be created.

Task control options

All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.

Output variables

None.

Remarks

There is a newer version of this task. For more information, see DownloadPipelineArtifact@2.

Important

This task is supported on Azure DevOps Services only. If you use it on Azure DevOps Server, you'll receive an error message similar to Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Use Download Build Artifacts if you're using Azure DevOps Server or TFS 2018.

By default, artifacts are downloaded to $(Pipeline.Workspace). If you don't specify an artifact name, a subdirectory will be created for each downloaded artifact. You can use file matching patterns to limit the files you want to download.

How can I find the ID of the Pipeline I want to download an artifact from?

You can find the ID of the pipeline in the 'Pipeline variables'. The pipeline ID is the system.definitionId variable. You can also find it in the URL path.

Requirements

Requirement	Description
Pipeline types	YAML, Classic build, Classic release
Runs on	Agent, DeploymentGroup
Demands	None
Capabilities	This task does not satisfy any demands for subsequent tasks in the job.
Command restrictions	Any
Settable variables	Any
Agent version	2.155.1 or greater
Task category	Utility