Logs - List

Service:

Pipelines

API Version:

7.1

Get a list of logs from a pipeline run.

GET https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs/{runId}/logs?api-version=7.1

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs/{runId}/logs?$expand={$expand}&api-version=7.1

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
pipelineId	path	True	integer (int32)	ID of the pipeline.
project	path	True	string	Project ID or project name
runId	path	True	integer (int32)	ID of the run of that pipeline.
api-version	query	True	string	Version of the API to use. This should be set to '7.1' to use this version of the api.
$expand	query		GetLogExpandOptions	Expand options. Default is None.

Responses

Name	Type	Description
200 OK	LogCollection	successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name	Description
vso.build	Grants the ability to access build artifacts, including build results, definitions, and requests, and the ability to receive notifications about build events via service hooks.

Definitions

Name	Description
GetLogExpandOptions	Expand options. Default is None.
Log	Log for a pipeline.
LogCollection	A collection of logs.
SignedUrl	A signed url allowing limited-time anonymous access to private resources.

GetLogExpandOptions

Enumeration

Expand options. Default is None.

Value	Description
none
signedContent

Log

Object

Log for a pipeline.

Name	Type	Description
createdOn	string (date-time)	The date and time the log was created.
id	integer (int32)	The ID of the log.
lastChangedOn	string (date-time)	The date and time the log was last changed.
lineCount	integer (int64)	The number of lines in the log.
signedContent	SignedUrl	A signed url allowing limited-time anonymous access to private resources.
url	string

LogCollection

Object

A collection of logs.

Name	Type	Description
logs	Log[]	The list of logs.
signedContent	SignedUrl	A signed url allowing limited-time anonymous access to private resources.
url	string	URL of the log.

SignedUrl

Object

A signed url allowing limited-time anonymous access to private resources.

Name	Type	Description
signatureExpires	string (date-time)	Timestamp when access expires.
url	string	The URL to allow access to.