Logs - Create
建立記錄,並將它連線到管線執行的執行計劃。
POST https://dev.azure.com/{organization}/{scopeIdentifier}/_apis/distributedtask/hubs/{hubName}/plans/{planId}/logs?api-version=7.1
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
hub
|
path | True |
string |
伺服器中樞的名稱。 常見範例:“build”、“rm”、“checks” |
organization
|
path | True |
string |
Azure DevOps 組織的名稱。 |
plan
|
path | True |
string (uuid) |
方案的標識碼。 |
scope
|
path | True |
string (uuid) |
要設定要求範圍的專案 GUID |
api-version
|
query | True |
string |
要使用的 API 版本。 這應該設定為 『7.1』 以使用此版本的 API。 |
要求本文
名稱 | 類型 | Description |
---|---|---|
createdOn |
string (date-time) |
工作記錄建立的時間。 |
id |
integer (int32) |
工作記錄檔的標識碼。 |
indexLocation |
string |
編製索引時工作記錄檔的 REST URL。 |
lastChangedOn |
string (date-time) |
工作記錄檔上次修改的時間。 |
lineCount |
integer (int64) |
工作記錄行的數目。 |
location |
string |
工作記錄的 REST URL。 |
path |
string |
工作記錄檔的路徑。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
成功作業 |
安全性
accessToken
個人存取令牌。 針對使用者名稱和令牌使用任何值做為密碼。
類型:
basic
範例
Create a log
範例要求
POST https://dev.azure.com/{organization}/{scopeIdentifier}/_apis/distributedtask/hubs/{hubName}/plans/{planId}/logs?api-version=7.1
{
"path": "logs\\5e6d5dbf-ac69-5f56-8b85-8e9038703a8b",
"createdOn": "0001-01-01T00:00:00",
"lastChangedOn": "0001-01-01T00:00:00",
"id": 0,
"location": null
}
範例回覆
{
"path": "logs\\5e6d5dbf-ac69-5f56-8b85-8e9038703a8b",
"lineCount": 49,
"createdOn": "2022-12-02T09:33:14.873Z",
"lastChangedOn": "2022-12-02T09:50:19.033Z",
"id": 3,
"location": null
}
定義
TaskLog
聯機到時間軸記錄的工作記錄。
名稱 | 類型 | Description |
---|---|---|
createdOn |
string (date-time) |
工作記錄建立的時間。 |
id |
integer (int32) |
工作記錄檔的標識碼。 |
indexLocation |
string |
編製索引時工作記錄檔的 REST URL。 |
lastChangedOn |
string (date-time) |
工作記錄檔上次修改的時間。 |
lineCount |
integer (int64) |
工作記錄行的數目。 |
location |
string |
工作記錄的 REST URL。 |
path |
string |
工作記錄檔的路徑。 |