ADO 董事會
Azure DevOps Boards 提供團隊追蹤工作的工作服務——涵蓋任何語言，全部集中在單一套件中。
此連接器適用於以下產品和區域：
| Service | Class | Regions |
|---|---|---|
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 列出專案 |
擷取組織中的專案清單。 |
| 列出工作專案類型 |
取得特定 Azure DevOps 專案中可存取的工作項目類型清單。 |
| 列出工作項目 |
傳回工作專案清單。 |
| 列出根層級查詢 |
擷取專案中根層級工作專案查詢的清單。 |
| 列出組織 |
擷取使用者所屬的組織清單。 |
| 列出資料夾內的查詢 |
擷取指定專案資料夾內的工作專案查詢清單。 |
| 取得查詢結果（預覽） |
擷取工作專案查詢的結果。 |
| 更新工作項目 |
依識別碼更新現有的工作專案。 |
| 根據查詢取得主題 |
根據查詢取得主題 |
| 獲取用戶個人資料 |
取得使用者配置檔。 |
列出專案
擷取組織中的專案清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
組織名稱
|
account | True | string |
組織的名稱。 這可以在實例 URL 中找到，即 {Organization}.visualstudio.com。 組織應啟用「透過 OAuth 存取第三方應用程式」，以防止作業發生錯誤。 |
傳回
VSTS 模型清單。
列出工作專案類型
取得特定 Azure DevOps 專案中可存取的工作項目類型清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
組織名稱
|
account | True | string |
組織的名稱。 這可以在實例 URL 中找到，即 {Organization}.visualstudio.com。 組織應啟用「透過 OAuth 存取第三方應用程式」，以防止作業發生錯誤。 |
|
專案名稱
|
project | True | string |
指定組織內的專案名稱。 |
傳回
VSTS 模型清單。
列出工作項目
傳回工作專案清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
組織名稱
|
account | True | string |
組織的名稱。 這可以在實例 URL 中找到，即 {Organization}.visualstudio.com。 組織應啟用「透過 OAuth 存取第三方應用程式」，以防止作業發生錯誤。 |
|
專案名稱
|
project | True | string |
指定組織內的專案名稱。 |
|
工作專案識別碼
|
ids | True | string |
要求工作專案識別碼的逗號分隔清單。 |
傳回
列出根層級查詢
擷取專案中根層級工作專案查詢的清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
組織名稱
|
account | True | string |
組織的名稱。 這可以在實例 URL 中找到，即 {Organization}.visualstudio.com。 組織應啟用「透過 OAuth 存取第三方應用程式」，以防止作業發生錯誤。 |
|
專案名稱
|
project | True | string |
指定組織內的專案名稱。 |
傳回
VSTS 模型清單。
列出組織
擷取使用者所屬的組織清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
會員編號
|
memberId | True | string |
會員編號 |
傳回
VSTS 模型清單。
列出資料夾內的查詢
擷取指定專案資料夾內的工作專案查詢清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
組織名稱
|
account | True | string |
組織的名稱。 這可以在實例 URL 中找到，即 {Organization}.visualstudio.com。 組織應啟用「透過 OAuth 存取第三方應用程式」，以防止作業發生錯誤。 |
|
專案名稱
|
project | True | string |
指定組織內的專案名稱。 |
|
資料夾路徑
|
folderPath | True | string |
要在其下尋找查詢的資料夾路徑。 |
傳回
VSTS 模型清單。
取得查詢結果（預覽）
擷取工作專案查詢的結果。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
組織名稱
|
account | True | string |
組織的名稱。 這可以在實例 URL 中找到，即 {Organization}.visualstudio.com。 組織應啟用「透過 OAuth 存取第三方應用程式」，以防止作業發生錯誤。 |
|
專案名稱
|
project | True | string |
指定組織內的專案名稱。 |
|
查詢標識碼
|
queryId | True | string |
要執行之儲存查詢的識別碼。 |
傳回
VSTS 模型清單。
更新工作項目
依識別碼更新現有的工作專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
組織名稱
|
account | True | string |
組織的名稱。 這可以在實例 URL 中找到，即 {Organization}.visualstudio.com。 組織應啟用「透過 OAuth 存取第三方應用程式」，以防止作業發生錯誤。 |
|
工作項目識別碼
|
id | True | string |
要更新之工作專案的唯一識別碼。 |
|
專案名稱
|
project | True | string |
指定組織內的專案名稱。 |
|
Priority
|
priority | integer |
工作專案的優先順序。 |
|
|
鑰匙
|
key | string |
場的鍵 |
|
|
value
|
value | string |
場的值 |
傳回
- response
- object
根據查詢取得主題
根據查詢取得主題
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
組織名稱
|
account | True | string |
組織的名稱。 這可以在實例 URL 中找到，即 {Organization}.visualstudio.com。 組織應啟用「透過 OAuth 存取第三方應用程式」，以防止作業發生錯誤。 |
|
搜尋詞
|
query | True | string |
搜尋關鍵字以搜尋 Azure DevOps 使用者或/及群組。 |
|
主題種類
|
subjectKind | True | array of string |
使用者或群組可以指定，兩者皆可或任一 |
|
範圍描述符
|
scopeDescriptor | string |
選擇性 Param |
傳回
圖譜主題列表。
獲取用戶個人資料
取得使用者配置檔。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
設定檔ID
|
id | True | string |
相同組織內設定檔的 ID，或「我」以取得目前已驗證使用者的設定檔。 |
傳回
個人檔案
- 身體
- Profile
定義
VstsListAccount
VSTS 模型清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
價值
|
value | array of Account |
VSTS 模型 |
帳戶
帳戶
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
帳戶 ID
|
accountId | string |
帳戶的 ID。 |
|
帳戶 URI
|
accountUri | string |
帳戶的 URI。 |
|
客戶名稱
|
accountName | string |
帳戶的名稱。 |
|
帳戶擁有者
|
accountOwner | string |
帳戶的集合擁有者。 |
|
組織名稱
|
organizationName | string |
與帳戶相對應的組織名稱。 |
|
帳戶類型
|
accountType | string |
帳戶的類型。 |
個人檔案
個人檔案
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顯示名稱
|
displayName | string |
使用者的顯示名稱 |
|
id
|
id | string |
設定檔的唯一識別碼。 |
|
publicAlias
|
publicAlias | string |
公共別名。 |
|
電子郵件地址
|
emailAddress | string |
帳戶的電子郵件地址。 |
|
時間戳記
|
timeStamp | date-time |
上次變更此設定檔的時間。 |
|
修訂
|
revision | integer |
任何屬性的修訂編號上限。 |
|
核心修訂
|
coreRevision | integer |
核心修訂 |
VSTS列表專案
VSTS 模型清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
價值
|
value | array of Project |
VSTS 模型 |
計畫
計畫
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專案編號
|
id | string |
專案的唯一標識碼。 |
|
專案名稱
|
name | string |
項目的名稱。 |
|
專案網址
|
url | string |
專案的 API URL。 |
VstsListQueryHierarchyItem
VSTS 模型清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
價值
|
value | array of QueryHierarchyItem |
VSTS 模型 |
查詢階層項目
查詢階層項目
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
有孩子
|
hasChildren | boolean |
指定查詢階層項目是否有子項。 |
|
識別碼
|
id | string |
查詢階層專案的唯一識別碼。 |
|
是資料夾
|
isFolder | boolean |
指定查詢階層項目是否為資料夾。 |
|
是公開的
|
isPublic | boolean |
指定查詢階層項目是否為公用。 |
|
名稱
|
name | string |
查詢階層項目的名稱。 |
|
路徑
|
path | string |
查詢階層項目的路徑。 |
|
連結
|
_links | object |
與查詢階層專案相關的連結集合。 |
|
URL
|
url | string |
查詢階層專案的完整 HTTP 連結。 |
VstsListWorkItemType
VSTS 模型清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
價值
|
value | array of WorkItemType |
VSTS 模型。 |
WorkItemType
工作項目類型
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
說明
|
description | string |
類型的描述。 |
|
名稱
|
name | string |
類型的名稱。 |
|
圖標標識號
|
icon.id | string |
圖示的識別碼 |
|
圖示網址
|
icon.url | string |
資源的 REST URL |
|
States
|
states | array of WorkItemStateColor |
工作專案類型的狀態 |
WorkItemStateColor
工作專案狀態色彩
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態類別
|
category | string |
狀態類別 |
|
色彩值
|
color | string |
色彩值 |
|
州名稱
|
name | string |
工作項目類型狀態名稱 |
VSTSListListWorkItemResponse
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of ListWorkItemResponse |
清單工作項目回應
清單工作項目操作的回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | integer |
工作項目的唯一 ID。 |
|
區域路徑
|
areaPath | string |
工作項目的區域路徑。 |
|
團隊項目
|
teamProject | string |
工作項目所屬的團隊專案。 |
|
迭代路徑
|
iterationPath | string |
工作項目的迭代路徑。 |
|
工作項目類型
|
workItemType | string |
工作項目的類型。 |
|
State
|
state | string |
工作項目的狀態。 |
|
Reason
|
reason | string |
工作項目的理由被輸入。 |
|
已變更日期
|
updatedAt | string |
工作項目的日期時間被更改。 |
|
到期日
|
dueDate | string |
截止日期、工作項目。 |
|
priority
|
priority | string |
priority |
|
標題
|
title | string |
工作項目的標題。 |
|
標籤
|
tags | string |
工作項目的標籤。 |
|
指派至
|
assignedTo | string |
目前擁有該工作項目的團隊成員的電子郵件。 |
|
指定名稱
|
assignedToName | string |
目前擁有工作專案的小組成員名稱。 |
VstsListJObject
VSTS 模型清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
價值
|
value | array of Object |
VSTS 模型 |
VSTS列表主體
圖譜主題列表。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
價值
|
value | array of Subject |
圖主題 |
主旨
主體定義
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
DisplayName
|
displayName | string |
建置定義的唯一識別碼。 |
|
郵件地址
|
mailAddress | string |
主旨的郵寄地址 |
|
校長名稱
|
principalName | string |
主題的主要名稱 |
|
主題種類
|
subjectKind | string |
主題的主要名稱 |
|
阿凡達
|
avatar | string |
頭像網址 |
物件
物件
這是類型 'object'。