Compartilhar via


Builds - Get Changes Between Builds

Obtém as alterações feitas no repositório entre dois builds determinados.

GET https://dev.azure.com/{organization}/{project}/_apis/build/changes?api-version=7.1-preview.2
GET https://dev.azure.com/{organization}/{project}/_apis/build/changes?fromBuildId={fromBuildId}&toBuildId={toBuildId}&$top={$top}&api-version=7.1-preview.2

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
path True

string

O nome da organização do Azure DevOps.

project
path True

string

ID do projeto ou nome do projeto

api-version
query True

string

Versão da API a ser usada. Isso deve ser definido como '7.1-preview.2' para usar essa versão da API.

$top
query

integer

int32

O número máximo de alterações a serem retornadas.

fromBuildId
query

integer

int32

A ID do primeiro build.

toBuildId
query

integer

int32

A ID do último build.

Respostas

Nome Tipo Description
200 OK

Change[]

operação bem-sucedida

Segurança

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

Nome Description
vso.build Concede a capacidade de acessar artefatos de build, incluindo resultados de build, definições e solicitações e a capacidade de receber notificações sobre eventos de build por meio de ganchos de serviço.

Definições

Nome Description
Change

Representa uma alteração associada a um build.

IdentityRef
ReferenceLinks

A classe para representar uma coleção de links de referência REST.

Change

Representa uma alteração associada a um build.

Nome Tipo Description
author

IdentityRef

O autor da alteração.

displayUri

string

O local de uma representação amigável do recurso.

id

string

O identificador da alteração. Para um commit, esse seria o SHA1. Para um conjunto de alterações do TFVC, essa seria a ID do conjunto de alterações.

location

string

O local da representação completa do recurso.

message

string

A descrição da alteração. Pode ser uma mensagem do commit ou uma descrição do conjunto de alterações.

messageTruncated

boolean

Indica se a mensagem foi truncada.

pusher

string

A pessoa ou processo que efetuou push da alteração.

timestamp

string

O carimbo de data/hora da alteração.

type

string

O tipo de alteração. "commit", "changeset", etc.

IdentityRef

Nome Tipo Description
_links

ReferenceLinks

Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.

descriptor

string

O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto do grafo entre contas e organizações.

directoryAlias

string

Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário "_links" identityRef

displayName

string

Este é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.

id

string

imageUrl

string

Preterido - Disponível na entrada "avatar" do dicionário "_links" IdentityRef

inactive

boolean

Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser

isAadIdentity

boolean

Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

Preterido – não em uso na maioria das implementações preexistidas de ToIdentityRef

uniqueName

string

Preterido – use Domain+PrincipalName

url

string

Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

A classe para representar uma coleção de links de referência REST.

Nome Tipo Description
links

object

A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.