Builds - Get Changes Between Builds
取得在兩個指定組建之間對存放庫所做的變更。
GET https://dev.azure.com/{organization}/{project}/_apis/build/changes?api-version=7.0GET https://dev.azure.com/{organization}/{project}/_apis/build/changes?fromBuildId={fromBuildId}&toBuildId={toBuildId}&$top={$top}&api-version=7.0URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps 組織的名稱。 |
|
project
|
path | True |
string |
專案識別碼或專案名稱 |
|
api-version
|
query | True |
string |
要使用的 API 版本。 這應該設定為 '7.0' 以使用此版本的 API。 |
|
$top
|
query |
integer int32 |
要傳回的變更數目上限。 |
|
|
from
|
query |
integer int32 |
第一個組建的識別碼。 |
|
|
to
|
query |
integer int32 |
上一個組建的識別碼。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
Change[] |
成功的作業 |
安全性
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
| 名稱 | Description |
|---|---|
| vso.build | 授與存取組建成品的能力，包括建置結果、定義和要求，以及透過服務勾點接收建置事件相關通知的能力。 |
定義
| 名稱 | Description |
|---|---|
| Change |
表示與組建相關聯的變更。 |
|
Identity |
|
|
Reference |
表示 REST 參考連結集合的類別。 |
Change
表示與組建相關聯的變更。
| 名稱 | 類型 | Description |
|---|---|---|
| author |
變更的作者。 |
|
| displayUri |
string |
使用者易記資源表示的位置。 |
| id |
string |
變更的識別碼。 針對認可，這會是 SHA1。 如果是 TFVC 變更集，這會是變更集識別碼。 |
| location |
string |
資源完整表示的位置。 |
| message |
string |
變更的描述。 這可能是認可訊息或變更集描述。 |
| messageTruncated |
boolean |
指出訊息是否已截斷。 |
| pusher |
string |
推送變更的人員或程式。 |
| timestamp |
string |
變更的時間戳記。 |
| type |
string |
變更的類型。 「commit」、「changeset」 等。 |
IdentityRef
| 名稱 | 類型 | Description |
|---|---|---|
| _links |
此欄位包含有關圖表主旨的零個或多個有趣連結。 您可以叫用這些連結來取得其他關聯性，或取得此圖表主體的詳細資訊。 |
|
| descriptor |
string |
描述項是在系統執行時參考圖形主旨的主要方式。 此欄位可唯一識別帳戶和組織之間的相同圖表主旨。 |
| directoryAlias |
string |
已淘汰 - 藉由查詢 IdentityRef 「_links」 字典之 「self」 專案中參考的 Graph 使用者，即可擷取 |
| displayName |
string |
這是圖表主旨的非唯一顯示名稱。 若要變更此欄位，您必須在來源提供者中變更其值。 |
| id |
string |
|
| imageUrl |
string |
已淘汰 - 可在 IdentityRef 「_links」 字典的 「avatar」 專案中使用 |
| inactive |
boolean |
已淘汰 - 您可以查詢 GraphUser 「_links」 字典的 「membershipState」 專案中參考的 Graph 成員資格狀態來擷取 |
| isAadIdentity |
boolean |
已被取代 - 可以從描述元的主旨類型推斷 (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
| isContainer |
boolean |
已被取代 - 可以從描述元的主旨類型推斷 (Descriptor.IsGroupType) |
| isDeletedInOrigin |
boolean |
|
| profileUrl |
string |
已淘汰 - 不在 ToIdentityRef 的大多數既有實作中使用 |
| uniqueName |
string |
已淘汰 - 請改用 Domain+PrincipalName |
| url |
string |
此 URL 是此圖表主體來源資源的完整路由。 |
ReferenceLinks
表示 REST 參考連結集合的類別。
| 名稱 | 類型 | Description |
|---|---|---|
| links |
object |
連結的唯讀檢視。 因為參考連結是唯讀的，所以我們只想要將它們公開為唯讀。 |