Azure DevOps Pipelines ListRuns
CertifiedList Azure DevOps pipeline runs
Azure DevOps Pipelines ListRuns
List Azure DevOps pipeline runs
Queries recent pipeline runs or builds for an Azure DevOps pipeline. Supports server-side filtering by state, result, and top N limit.
type: io.kestra.plugin.azure.devops.pipelines.ListRunsExamples
List recent completed runs for an Azure DevOps pipeline
id: list_pipeline_runs
namespace: company.team
tasks:
- id: list_runs
type: io.kestra.plugin.azure.devops.pipelines.ListRuns
organization: my-org
project: my-project
pipelineId: 42
personalAccessToken: "{{ secret('AZURE_DEVOPS_PAT') }}"
state: completed
maxRuns: 20
Properties
organization *string
Azure DevOps organization
The name of the Azure DevOps organization or Azure DevOps Server collection.
pipelineId *integerstring
Pipeline ID
The unique identifier of the pipeline whose runs to retrieve.
project *string
Azure DevOps project
The name or ID of the Azure DevOps project containing the pipeline.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150baseUrl string
https://dev.azure.comBase URL
Base URL of the Azure DevOps instance. Defaults to https://dev.azure.com.
Configure this property when connecting to an on-premises Azure DevOps Server.
clientId string
Azure client ID
Client ID of the Azure service principal.
clientSecret string
Azure client secret
Client secret of the Azure service principal.
maxRuns integerstring
50Maximum runs to return
Maximum number of runs to return in outputs (between 1 and 1000). Defaults to 50.
pemCertificate string
PEM certificate
PEM certificate content for certificate-based authentication.
personalAccessToken string
Personal Access Token
Azure DevOps Personal Access Token (PAT) with Build: Read & execute scope.
If omitted, Microsoft Entra ID service principal credentials must be configured.
result string
Run result filter
Filter runs by result outcome (e.g. succeeded, failed, canceled).
state string
Run state filter
Filter runs by state (e.g. completed, inProgress, notStarted, cancelling).
tenantId string
Azure tenant ID
Azure Entra tenant ID used for service principal authentication.
Outputs
runs array
Pipeline runs
The retrieved pipeline runs.
io.kestra.plugin.azure.devops.pipelines.PipelineRun
date-timeCreation timestamp
Timestamp when the pipeline run was created.
date-timeFinish timestamp
Timestamp when the pipeline run finished executing.
Run ID
The unique identifier of the pipeline run.
Run name
The name or build number of the pipeline run.
Run result
Final outcome of the pipeline run (e.g. succeeded, failed, canceled).
Run state
Current state of the pipeline run (e.g. inProgress, completed, canceling, notStarted).
API URL
REST API URL of the pipeline run resource.
Web URL
Azure DevOps browser URL to view the pipeline run execution.
total integer
Total runs
The total number of runs returned.
