共用方式為

Jira

Jira 是一款軟體開發工具，供敏捷團隊規劃、追蹤和發布世界級軟體。 將 Jira 問題與其他工具連結起來有助於打破障礙並釋放團隊的潛力。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 由 21Vianet 營運的中國雲
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 由 21Vianet 營運的中國雲
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 由 21Vianet 營運的中國雲
連絡人​​
名稱 Microsoft
URL https://support.microsoft.com/
Email abapi@microsoft.com
連接器中繼資料
Publisher Microsoft
網站 https://www.atlassian.com/software/jira
隱私策略 https://www.atlassian.com/legal/privacy-policy
類別 IT運營;通敵

要使用此集成，您需要一個 Jira 帳戶。

這很重要

由於 Jira 後端 API 的最新變更，下列更新會影響 Jira 連接器：

  • 搜尋一致性：後端端點不會提供寫入後立即搜尋一致性。 用戶最近的更新可能不會立即反映在搜尋結果中。
  • 傳回項目的限制：端點最多傳回 20 個註解和 40 個變更記錄項目。
  • 觸發器中的 JQL 查詢：不支援無限制的 JQL 查詢。 具有無限查詢的要求將導致 400 個錯誤的要求回應。

如需更多詳細資訊： 什麼是 Jira Cloud 中的進階搜尋？ 參考： Atlassian 開發人員變更日誌

已知問題和限制

  • 若要進行驗證，您需要使用 API 權杖。 要獲取代幣，請轉到 此鏈接。
  • 已淘汰使用密碼的基本驗證。 如需詳細資訊，請參閱 jira API 文件。
  • 不支援防火牆後面或停用 REST API 的 Jira Server。
  • 建立與 Jira Cloud 的連線時，您需要使用有效的電子郵件地址作為使用者名稱。 否則，連接將不會建立，儘管看起來很成功。
  • Jira Cloud 中的使用者名稱已被取代，無法再用於 Reporter 等欄位。 如需詳細資訊，請參閱 Atlassian Cloud 文件。
  • 根據 Jira API 文檔，Jira API 最多返回 50 個項目，因此前 50 個項目將列在操作/觸發程序的下拉菜單下。
  • 分頁是在 Get 專案上實作的。 它將返回所有項目。
  • 此 建立新問題 （V2） 動作僅支援動態結構描述中的簡單欄位型別，例如「字串」、「數字」、「日期」和「日期時間」。 如果專案設定具有複雜資料類型的必要欄位，則作業將會失敗，並顯示錯誤：「不支援類型 '{type}' 的欄位 '{key}'」。 若要解決此問題，請變更專案欄位設定，並使這些欄位不再必要。
  • 此 建立新問題 （V3） 動作僅支援動態結構描述中的簡單欄位型別，例如「字串」、「數字」、「日期」和「日期時間」。 如果專案設定具有複雜資料類型的必要欄位，則作業將會失敗，並顯示錯誤：「不支援類型 '{type}' 的欄位 '{key}'」。 若要解決此問題，請變更專案欄位設定，並使這些欄位不再必要。
  • Project連接器動作和觸發程式所預期的屬性應該使用下列其中一個選項來填入：
    • 從專案選擇器中挑選專案。 請注意，Jira Cloud 連線只會在選擇器中顯示前 50 個專案。
    • 使用 「取得專案 」 Project Key 動作 （專案屬性） 的輸出。
  • 如需更多 編輯問題 作業詳細資訊，請參閱 Jira API 文件
  • 當工作流程開始失敗並出現 400 回應或任何動作或觸發器的錯誤請求時，請檢查用於建立連線的 API 金鑰是否已過期，如果過期，請使用新的 API 金鑰重新建立連線。

正在建立連線

連接器支援下列驗證類型：
API 權杖 使用 API 權杖存取 Jira 所有區域 不可共享
奧特 使用 Oauth 存取 Jira。 所有區域 不可共享
預設值 [已棄用] 此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。 所有區域 不可共享

API 令牌

驗證 ID：APIToken

適用：所有地區

使用 API 權杖存取 Jira

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
使用者名稱或電子郵件 字串 您的 Jira 使用者名稱。 對於 Jira Cloud，您需要使用有效的電子郵件地址。 對
API 權杖 securestring 您的 API 權杖 （https://id.atlassian.com/manage/api-tokens）。 對

奧特

驗證 ID：oauth

適用：所有地區

使用 Oauth 存取 Jira。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

預設值 [已棄用]

適用：所有地區

此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
Jira 執行個體 字串 託管 Jira 執行個體的 URL （必須支援 https）。 對
使用者名稱或電子郵件 字串 您的 Jira 使用者名稱。 對於 Jira Cloud，您需要使用有效的電子郵件地址。 對
API 權杖 securestring 您的 API 權杖 （https://id.atlassian.com/manage/api-tokens）。 對

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒
觸發輪詢的頻率 1 60 秒

動作

Jira MCP 伺服器

Jira MCP 伺服器
依專案列出使用者

此作業可用來擷取與專案相關聯之所有使用者的清單。
依專案列出使用者 （V2）

此作業可用來擷取與專案相關聯之所有使用者的清單。
依金鑰取得問題

此作業可用來擷取指定問題索引鍵的問題物件。
依金鑰取得問題 （V2）

此作業可用來擷取指定問題索引鍵的問題物件。
刪除專案

刪除專案。 所需權限：管理 Jira （全域權限）
刪除專案 （V2）

刪除專案。 所需權限：管理 Jira （全域權限）
加入註解

此作業可用來將註解新增至現有的 Jira 問題。
取得使用者

傳回使用者。 所需權限：瀏覽使用者和群組。
取得使用者 （V2）

傳回使用者。 所需權限：瀏覽使用者和群組。
取得問題清單

此作業會傳回使用 JQL 的問題清單。
取得問題清單（資料中心）

此作業會傳回使用 JQL 的問題清單。
取得專案

此作業可用來擷取 Jira 執行個體的專案清單。
取得專案 [已淘汰]

此動作已被取代。 請改用 取得專案 。

此作業可用來擷取 Jira 執行個體的專案清單。
取得專案 （V2）

此作業可用來擷取 Jira 執行個體的專案清單。
取得工作 （V2）

傳回長時間執行的非同步工作的狀態。 當工作完成時，此作業會傳回適用於工作的 JSON Blob。
取得所有專案類別

傳回所有專案類別。
取得所有專案類別 （V2）

傳回所有專案類別。
取得目前的使用者

此作業會傳回目前使用者的詳細資料
取得篩選器清單

此作業會傳回使用者可存取的篩選清單。
取得篩選清單 （V2）

此作業會傳回使用者可存取的篩選清單。
取得轉換清單

傳回目前使用者可能針對此問題進行的轉換清單
取消任務

取消任務。 所需權限：管理 Jira 或任務的建立者。
取消任務 （V2）

取消任務。 所需權限：管理 Jira 或任務的建立者。
執行問題轉換

將問題轉換至新狀態。
建立專案類別

建立專案類別。 所需權限：管理 Jira （全域權限）
建立專案類別 （V2）

建立專案類別。 所需權限：管理 Jira （全域權限）
建立新問題 [已棄用]

此動作已被取代。 請改用建立新問題 （V3）。

此作業可用來建立新問題。
建立新問題 （V2） [已淘汰]

此動作已被取代。 請改用建立新問題 （V3）。

此作業可用來建立新問題。
建立新問題 （V3）

此作業可用來建立新問題。
建立新專案

此作業用於建立新的 Jira 專案。
建立新專案 （V2）

此作業用於建立新的 Jira 專案。
新增註解 （V2）

此作業可用來將註解新增至現有的 Jira 問題。
更新專案

更新專案的專案詳細資料。
更新專案 （V2）

更新專案的專案詳細資料。
獲取任務

傳回長時間執行的非同步工作的狀態。 當工作完成時，此作業會傳回適用於工作的 JSON Blob。
獲取資源列表

此作業會傳回使用者可存取的資源清單。
移除專案類別

刪除專案類別。 所需權限：管理 Jira （全域權限）
移除專案類別 （V2）

刪除專案類別。 所需權限：管理 Jira （全域權限）
編輯問題

編輯問題。 在編輯過程中，可能會套用轉換，並更新問題屬性。 對問題欄位的編輯是使用 update 和 fields。
編輯問題 （V2）

編輯問題。 在編輯過程中，可能會套用轉換，並更新問題屬性。 對問題欄位的編輯是使用 update 和 fields。

Jira MCP 伺服器

作業識別碼：
mcp_JiraIssueManagement

Jira MCP 伺服器

參數

名稱 機碼 必要 類型 Description
jsonrpc
 jsonrpc string
識別碼
 id string
方法
 method string
參數
 params object
結果
 result object
錯誤
 error object
sessionId
 sessionId string

傳回

身體
MCPQueryResponse

依專案列出使用者

作業識別碼：
ListProjectUsers

此作業可用來擷取與專案相關聯之所有使用者的清單。

參數

名稱 機碼 必要 類型 Description
專案金鑰
 projectKey True string

專案的唯一金鑰。

傳回

物品
UserList

依專案列出使用者 （V2）

作業識別碼：
ListProjectUsers_V2

此作業可用來擷取與專案相關聯之所有使用者的清單。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
專案金鑰
 projectKey True string

專案的唯一金鑰。

傳回

物品
UserList

依金鑰取得問題

作業識別碼：
GetIssue

此作業可用來擷取指定問題索引鍵的問題物件。

參數

名稱 機碼 必要 類型 Description
問題索引鍵
 issueKey True string

問題的唯一金鑰。

傳回

問題
FullIssue

依金鑰取得問題 （V2）

作業識別碼：
GetIssue_V2

此作業可用來擷取指定問題索引鍵的問題物件。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
問題索引鍵
 issueKey True string

問題的唯一金鑰。

傳回

問題
FullIssue

刪除專案

作業識別碼：
DeleteProject

刪除專案。 所需權限：管理 Jira （全域權限）

參數

名稱 機碼 必要 類型 Description
專案 ID 或金鑰
 projectIdOrKey True string

專案 ID 或專案金鑰 （區分大小寫）。
啟用復原
 enableUndo boolean

此專案是否放置在 Jira 資源回收筒中，以便還原。

刪除專案 （V2）

作業識別碼：
DeleteProject_V2

刪除專案。 所需權限：管理 Jira （全域權限）

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
專案 ID 或金鑰
 projectIdOrKey True string

專案 ID 或專案金鑰 （區分大小寫）。
啟用復原
 enableUndo boolean

此專案是否放置在 Jira 資源回收筒中，以便還原。

加入註解

作業識別碼：
AddComment

此作業可用來將註解新增至現有的 Jira 問題。

參數

名稱 機碼 必要 類型 Description
問題索引鍵
 issueKey True string

要新增註解的問題的唯一索引鍵。
評論
 body True string

評論正文。

傳回

身體
CommentResponse

取得使用者

作業識別碼：
GetUser

傳回使用者。 所需權限：瀏覽使用者和群組。

參數

名稱 機碼 必要 類型 Description
帳戶識別碼
 accountId True string

使用者的帳戶 ID，可唯一識別所有 Atlassian 產品中的使用者。 例如， 5b10ac8d82e05b22cc7d4ef5。 必須的。
展開
 expand string

使用展開，在回應中包含使用者的其他相關資訊。 此參數接受逗號分隔的清單。 展開選項包括：* groups 包括使用者所屬的所有群組和巢狀群組。 * applicationRoles 包括使用者有權存取之所有應用程式的詳細資料。

取得使用者 （V2）

作業識別碼：
GetUser_V2

傳回使用者。 所需權限：瀏覽使用者和群組。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
帳戶識別碼
 accountId True string

使用者的帳戶 ID，可唯一識別所有 Atlassian 產品中的使用者。 例如， 5b10ac8d82e05b22cc7d4ef5。 必須的。
展開
 expand string

使用展開，在回應中包含使用者的其他相關資訊。 此參數接受逗號分隔的清單。 展開選項包括：* groups 包括使用者所屬的所有群組和巢狀群組。 * applicationRoles 包括使用者有權存取之所有應用程式的詳細資料。

取得問題清單

作業識別碼：
ListIssues

此作業會傳回使用 JQL 的問題清單。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。

傳回

身體
ListIssuesResponse

取得問題清單（資料中心）

作業識別碼：
ListIssues_Datacenter

此作業會傳回使用 JQL 的問題清單。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。

傳回

身體
ListIssuesResponseDatacenter

取得專案

作業識別碼：
ListProjects_V2

此作業可用來擷取 Jira 執行個體的專案清單。

傳回

身體
ListProjects_ResponseV2

取得專案 [已淘汰]

作業識別碼：
ListProjects

此動作已被取代。 請改用 取得專案 。

此作業可用來擷取 Jira 執行個體的專案清單。

傳回

物品
ProjectArray

取得專案 （V2）

作業識別碼：
ListProjects_V3

此作業可用來擷取 Jira 執行個體的專案清單。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。

傳回

身體
ListProjects_ResponseV2

取得工作 （V2）

作業識別碼：
GetTask_V2

傳回長時間執行的非同步工作的狀態。 當工作完成時，此作業會傳回適用於工作的 JSON Blob。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
工作識別碼
 taskId True string

任務的 ID。

取得所有專案類別

作業識別碼：
GetAllProjectCategories

傳回所有專案類別。

傳回

名稱 路徑 類型 Description
array of object
自我
 self string

Self
識別碼
 id string

ID
說明
 description string

Description
名稱
 name string

名稱

取得所有專案類別 （V2）

作業識別碼：
GetAllProjectCategories_V2

傳回所有專案類別。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。

傳回

名稱 路徑 類型 Description
array of object
自我
 self string

Self
識別碼
 id string

ID
說明
 description string

Description
名稱
 name string

名稱

取得目前的使用者

作業識別碼：
GetCurrentUser

此作業會傳回目前使用者的詳細資料

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
展開
 expand string

使用展開，在回應中包含使用者的其他相關資訊。 此參數接受逗號分隔的清單。 展開選項包括：* groups 包括使用者所屬的所有群組和巢狀群組。 * applicationRoles 包括使用者有權存取之所有應用程式的詳細資料。

取得篩選器清單

作業識別碼：
ListFilters

此作業會傳回使用者可存取的篩選清單。

傳回

身體
ListFiltersResponse

取得篩選清單 （V2）

作業識別碼：
ListFilters_V2

此作業會傳回使用者可存取的篩選清單。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。

傳回

身體
ListFiltersResponse

取得轉換清單

作業識別碼：
ListTransitions

傳回目前使用者可能針對此問題進行的轉換清單

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
問題 ID 或金鑰
 issueIdOrKey True string

要擷取轉換的問題的ID或索引鍵

傳回

名稱 路徑 類型 Description
轉換
 transitions array of Transition

取消任務

作業識別碼：
CancelTask

取消任務。 所需權限：管理 Jira 或任務的建立者。

參數

名稱 機碼 必要 類型 Description
工作識別碼
 taskId True string

任務的 ID。

取消任務 （V2）

作業識別碼：
CancelTask_V2

取消任務。 所需權限：管理 Jira 或任務的建立者。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
工作識別碼
 taskId True string

任務的 ID。

執行問題轉換

作業識別碼：
UpdateTransition

將問題轉換至新狀態。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
問題 ID 或金鑰
 issueIdOrKey True string

要轉換的問題的 ID 或金鑰
名稱
 name string
名稱
 name string
活動說明
 activityDescription string
avatar網址
 avatarUrl string
顯示名稱
 displayName string
識別碼
 id string
型別
 type string
url
 url string
識別碼
 id string
型別
 type string
說明
 description string
反覆運算
 Iteration string
Step
 Step string
識別碼
 id string
型別
 type string
型別
 type string
識別碼
 id string
body
 body string

建立專案類別

作業識別碼：
CreateProjectCategory

建立專案類別。 所需權限：管理 Jira （全域權限）

參數

名稱 機碼 必要 類型 Description
名稱
 name string

名稱
說明
 description string

Description

建立專案類別 （V2）

作業識別碼：
CreateProjectCategory_V2

建立專案類別。 所需權限：管理 Jira （全域權限）

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
名稱
 name string

名稱
說明
 description string

Description

建立新問題 [已棄用]

作業識別碼：
CreateIssue

此動作已被取代。 請改用建立新問題 （V3）。

此作業可用來建立新問題。

參數

名稱 機碼 必要 類型 Description
專案
 projectKey True string

挑選要在其中建立問題的專案。
問題類型識別碼
 id True string

挑選問題類型。
總結
 summary True string

問題的簡要描述。
Components
 components string

系統欄位，其是由 'name' 定址的多個值 （例如 Microsoft Entra ID、網路交換器）。
記者編號
 id string

報告問題的人員。
Description
 description string

問題的詳細描述。
優先順序 ID
 id string

為問題選擇優先順序。
Labels
 labels string

輸入以逗號分隔的標籤清單
受指派人ID
 id string

問題指派給的客服專員。
上層問題標識碼
 id string

設定子任務的父項。
史詩名稱 （customfield_10011）
 customfield_10119 string

Epic 問題類型需要 Epic 名稱。 此欄位與 Jira 伺服器上的「customfield_10011」欄位相符。

傳回

身體
CreateIssueResponse

建立新問題 （V2） [已淘汰]

作業識別碼：
CreateIssueV2

此動作已被取代。 請改用建立新問題 （V3）。

此作業可用來建立新問題。

參數

名稱 機碼 必要 類型 Description
專案
 projectKey True string

挑選要在其中建立問題的專案。
問題類型識別碼
 issueTypeIds True string

挑選問題類型。
項目
 item dynamic

項目

傳回

身體
CreateIssueResponse

建立新問題 （V3）

作業識別碼：
CreateIssue_V3

此作業可用來建立新問題。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
專案
 projectKey True string

挑選要在其中建立問題的專案。
問題類型識別碼
 issueTypeIds True string

挑選問題類型。
項目
 item dynamic

項目

傳回

身體
CreateIssueResponse

建立新專案

作業識別碼：
CreateProject

此作業用於建立新的 Jira 專案。

參數

名稱 機碼 必要 類型 Description
專案金鑰
 key True string

唯一鍵以大寫字母開頭。
名稱
 name True string

專案的標題。
類型
 projectTypeKey True string

專案類型索引鍵。
潛在客戶 ID
 leadAccountId True string

專案負責人的 ID。
Description
 description string

專案的詳細描述。

傳回

身體
CreateProjectResponse

建立新專案 （V2）

作業識別碼：
CreateProject_V2

此作業用於建立新的 Jira 專案。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
專案金鑰
 key True string

唯一鍵以大寫字母開頭。
名稱
 name True string

專案的標題。
類型
 projectTypeKey True string

專案類型索引鍵。
潛在客戶 ID
 leadAccountId True string

專案負責人的 ID。
Description
 description string

專案的詳細描述。

傳回

身體
CreateProjectResponse

新增註解 （V2）

作業識別碼：
AddComment_V2

此作業可用來將註解新增至現有的 Jira 問題。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
問題索引鍵
 issueKey True string

要新增註解的問題的唯一索引鍵。
評論
 body True string

評論正文。

傳回

身體
CommentResponse

更新專案

作業識別碼：
UpdateProject

更新專案的專案詳細資料。

參數

名稱 機碼 必要 類型 Description
專案 ID 或金鑰
 projectIdOrKey True string

提供您要更新的專案 ID 或金鑰1
Key
 key string

Key
名稱
 name string

名稱
projectTypeKey
 projectTypeKey string

專案類型索引鍵
專案範本索引鍵
 projectTemplateKey string

專案範本索引鍵
說明
 description string

Description
潛在客戶
 lead string

鉛
leadAccountId
 leadAccountId string

潛在客戶帳戶 ID
url
 url string

URL
assigneeType
 assigneeType string

受讓人類型
avatarId
 avatarId string

頭像 ID
issueSecurityScheme 的
 issueSecurityScheme string

發行安全方案
許可方案
 permissionScheme string

許可計劃
通知方案
 notificationScheme string

通知計劃
categoryId
 categoryId string

類別標識碼

更新專案 （V2）

作業識別碼：
UpdateProject_V2

更新專案的專案詳細資料。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
專案 ID 或金鑰
 projectIdOrKey True string

提供您要更新的專案 ID 或金鑰1
Key
 key string

Key
名稱
 name string

名稱
projectTypeKey
 projectTypeKey string

專案類型索引鍵
專案範本索引鍵
 projectTemplateKey string

專案範本索引鍵
說明
 description string

Description
潛在客戶
 lead string

鉛
leadAccountId
 leadAccountId string

潛在客戶帳戶 ID
url
 url string

URL
assigneeType
 assigneeType string

受讓人類型
avatarId
 avatarId string

頭像 ID
issueSecurityScheme 的
 issueSecurityScheme string

發行安全方案
許可方案
 permissionScheme string

許可計劃
通知方案
 notificationScheme string

通知計劃
categoryId
 categoryId string

類別標識碼

獲取任務

作業識別碼：
GetTask

傳回長時間執行的非同步工作的狀態。 當工作完成時，此作業會傳回適用於工作的 JSON Blob。

參數

名稱 機碼 必要 類型 Description
工作識別碼
 taskId True string

任務的 ID。

獲取資源列表

作業識別碼：
ListResources

此作業會傳回使用者可存取的資源清單。

傳回

物品
Sites

移除專案類別

作業識別碼：
RemoveProjectCategory

刪除專案類別。 所需權限：管理 Jira （全域權限）

參數

名稱 機碼 必要 類型 Description
專案識別碼
 id True integer

要刪除的專案類別的 ID。

移除專案類別 （V2）

作業識別碼：
RemoveProjectCategory_V2

刪除專案類別。 所需權限：管理 Jira （全域權限）

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
專案識別碼
 id True integer

要刪除的專案類別的 ID。

編輯問題

作業識別碼：
EditIssue

編輯問題。 在編輯過程中，可能會套用轉換，並更新問題屬性。 對問題欄位的編輯是使用 update 和 fields。

參數

名稱 機碼 必要 類型 Description
問題 ID 或金鑰
 issueIdOrKey True string

提供您要編輯之問題的問題 ID 或金鑰
通知使用者
 notifyUsers boolean

您要通知使用者嗎？
覆寫螢幕安全性
 overrideScreenSecurity boolean

您想覆蓋屏幕安全性嗎？
覆寫可編輯旗標
 overrideEditableFlag boolean

您要覆蓋可編輯的標誌嗎？
轉換識別碼
 id string

轉換識別碼
過渡循環
 looped string

過渡循環
Fields
 fields object

要更新的問題畫面欄位清單，指定要更新的子欄位及其每個欄位的值。 此欄位在設定子欄位時提供簡單的選項。 當需要多個子欄位或其他作業時，請使用更新。 此處包含的欄位無法包含在更新中。
Update
 update object

包含欄位欄位名稱和要在問題畫面欄位上執行的作業清單的對應。 請注意，此處包含的欄位不能包含在欄位中。
中繼資料類型
 type string

歷程記錄中繼資料類型
中繼資料說明
 description string

歷程記錄中繼資料描述
中繼資料描述索引鍵
 descriptionKey string

歷程中繼資料描述索引鍵
中繼資料活動說明
 activityDescription string

歷程記錄中繼資料活動描述
中繼資料活動描述索引鍵
 activityDescriptionKey string

歷程記錄中繼資料活動描述索引鍵
中繼資料電子郵件描述
 emailDescription string

歷史中繼資料電子郵件描述
中繼資料電子郵件描述索引鍵
 emailDescriptionKey string

歷程記錄中繼資料電子郵件描述索引鍵
執行者ID
 id string

執行者ID
Actor 顯示名稱
 displayName string

Actor 顯示名稱
Actor 顯示名稱索引鍵
 displayNameKey string

Actor 顯示名稱索引鍵
執行者類型
 type string

執行者類型
演員頭像網址
 avatarUrl string

演員頭像網址
動作者網址
 url string

動作者網址
產生器識別碼
 id string

產生器識別碼
生成器顯示名稱
 displayName string

生成器顯示名稱
產生器顯示名稱索引鍵
 displayNameKey string

產生器顯示名稱索引鍵
發電機類型
 type string

發電機類型
生成器頭像網址
 avatarUrl string

生成器頭像網址
產生器網址
 url string

產生器網址
原因 ID
 id string

原因 ID
原因顯示名稱
 displayName string

原因顯示名稱
原因顯示名稱索引鍵
 displayNameKey string

原因顯示名稱索引鍵
原因類型
 type string

原因類型
原因頭像網址
 avatarUrl string

原因頭像網址
原因網址
 url string

原因網址
額外數據
 extraData string

額外數據
Key
 key string

Key

編輯問題 （V2）

作業識別碼：
EditIssue_V2

編輯問題。 在編輯過程中，可能會套用轉換，並更新問題屬性。 對問題欄位的編輯是使用 update 和 fields。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance True string

託管 Jira 執行個體的 URL （必須支援 https）。
問題 ID 或金鑰
 issueIdOrKey True string

提供您要編輯之問題的問題 ID 或金鑰
通知使用者
 notifyUsers boolean

您要通知使用者嗎？
覆寫螢幕安全性
 overrideScreenSecurity boolean

您想覆蓋屏幕安全性嗎？
覆寫可編輯旗標
 overrideEditableFlag boolean

您要覆蓋可編輯的標誌嗎？
轉換識別碼
 id string

轉換識別碼
過渡循環
 looped string

過渡循環
Fields
 fields object

要更新的問題畫面欄位清單，指定要更新的子欄位及其每個欄位的值。 此欄位在設定子欄位時提供簡單的選項。 當需要多個子欄位或其他作業時，請使用更新。 此處包含的欄位無法包含在更新中。
Update
 update object

包含欄位欄位名稱和要在問題畫面欄位上執行的作業清單的對應。 請注意，此處包含的欄位不能包含在欄位中。
中繼資料類型
 type string

歷程記錄中繼資料類型
中繼資料說明
 description string

歷程記錄中繼資料描述
中繼資料描述索引鍵
 descriptionKey string

歷程中繼資料描述索引鍵
中繼資料活動說明
 activityDescription string

歷程記錄中繼資料活動描述
中繼資料活動描述索引鍵
 activityDescriptionKey string

歷程記錄中繼資料活動描述索引鍵
中繼資料電子郵件描述
 emailDescription string

歷史中繼資料電子郵件描述
中繼資料電子郵件描述索引鍵
 emailDescriptionKey string

歷程記錄中繼資料電子郵件描述索引鍵
執行者ID
 id string

執行者ID
Actor 顯示名稱
 displayName string

Actor 顯示名稱
Actor 顯示名稱索引鍵
 displayNameKey string

Actor 顯示名稱索引鍵
執行者類型
 type string

執行者類型
演員頭像網址
 avatarUrl string

演員頭像網址
動作者網址
 url string

動作者網址
產生器識別碼
 id string

產生器識別碼
生成器顯示名稱
 displayName string

生成器顯示名稱
產生器顯示名稱索引鍵
 displayNameKey string

產生器顯示名稱索引鍵
發電機類型
 type string

發電機類型
生成器頭像網址
 avatarUrl string

生成器頭像網址
產生器網址
 url string

產生器網址
原因 ID
 id string

原因 ID
原因顯示名稱
 displayName string

原因顯示名稱
原因顯示名稱索引鍵
 displayNameKey string

原因顯示名稱索引鍵
原因類型
 type string

原因類型
原因頭像網址
 avatarUrl string

原因頭像網址
原因網址
 url string

原因網址
額外數據
 extraData string

額外數據
Key
 key string

Key

觸發程序

建立新問題時

當新問題新增至指定專案時，會觸發此作業。
建立新問題時 （V2）

當新問題新增至指定專案時，會觸發此作業。
當 JQL 查詢傳回新問題時

當 JQL 查詢的最新 100 個結果中出現新問題時，會觸發此作業。
當 JQL 查詢傳回新問題時 （V2）

當 JQL 查詢的最新 100 個結果中出現新問題時，會觸發此作業。
當 JQL 查詢（資料中心）回傳新問題時

當 JQL 查詢的最新 100 個結果中出現新問題時，會觸發此作業。
當問題關閉時

當指定專案中的現有問題關閉時，會觸發此作業。
當問題關閉時 （V2）

當指定專案中的現有問題關閉時，會觸發此作業。
當新議題被建立（資料中心）

當新問題新增至指定專案時，會觸發此作業。
當某個議題被關閉（資料中心）

當指定專案中的現有問題關閉時，會觸發此作業。

建立新問題時

作業識別碼：
OnNewIssue

當新問題新增至指定專案時，會觸發此作業。

參數

名稱 機碼 必要 類型 Description
專案
 projectKey True string

尋找新問題的專案的唯一金鑰。

傳回

問題
FullIssue

建立新問題時 （V2）

作業識別碼：
OnNewIssue_V2

當新問題新增至指定專案時，會觸發此作業。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance string

託管 Jira 執行個體的 URL （必須支援 https）。
專案
 projectKey True string

尋找新問題的專案的唯一金鑰。

傳回

問題
FullIssue

當 JQL 查詢傳回新問題時

作業識別碼：
OnNewIssueJQL

當 JQL 查詢的最新 100 個結果中出現新問題時，會觸發此作業。

參數

名稱 機碼 必要 類型 Description
JQL 查詢
 jql True string

要使用的查詢。

傳回

問題
FullIssue

當 JQL 查詢傳回新問題時 （V2）

作業識別碼：
OnNewIssueJQL_V2

當 JQL 查詢的最新 100 個結果中出現新問題時，會觸發此作業。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance string

託管 Jira 執行個體的 URL （必須支援 https）。
JQL 查詢
 jql True string

要使用的查詢。

傳回

問題
FullIssue

當 JQL 查詢（資料中心）回傳新問題時

作業識別碼：
OnNewIssueJQL_Datacenter

當 JQL 查詢的最新 100 個結果中出現新問題時，會觸發此作業。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance string

託管 Jira 執行個體的 URL （必須支援 https）。
JQL 查詢
 jql True string

要使用的查詢。

傳回

問題
FullIssue

當問題關閉時

作業識別碼：
OnCloseIssue

當指定專案中的現有問題關閉時，會觸發此作業。

參數

名稱 機碼 必要 類型 Description
專案
 projectKey True string

尋找新問題的專案的唯一金鑰。

傳回

問題
FullIssue

當問題關閉時 （V2）

作業識別碼：
OnCloseIssue_V2

當指定專案中的現有問題關閉時，會觸發此作業。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance string

託管 Jira 執行個體的 URL （必須支援 https）。
專案
 projectKey True string

尋找新問題的專案的唯一金鑰。

傳回

問題
FullIssue

當新議題被建立（資料中心）

作業識別碼：
OnNewIssue_Datacenter

當新問題新增至指定專案時，會觸發此作業。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance string

託管 Jira 執行個體的 URL （必須支援 https）。
專案
 projectKey True string

尋找新問題的專案的唯一金鑰。

傳回

問題
FullIssue

當某個議題被關閉（資料中心）

作業識別碼：
OnCloseIssue_Datacenter

當指定專案中的現有問題關閉時，會觸發此作業。

參數

名稱 機碼 必要 類型 Description
Jira 執行個體
 X-Request-Jirainstance string

託管 Jira 執行個體的 URL （必須支援 https）。
專案
 projectKey True string

尋找新問題的專案的唯一金鑰。

傳回

問題
FullIssue

定義

建立專案回應

名稱 路徑 類型 Description
專案編號
 id integer

專案的唯一識別碼。
專案金鑰
 key string

專案的唯一金鑰。

建立問題回應

名稱 路徑 類型 Description
問題編號
 id string

問題的唯一識別碼。
問題索引鍵
 key string

問題的唯一金鑰。

ListProjects_ResponseV2

名稱 路徑 類型 Description
values
 values ProjectArray

專案陣列

名稱 路徑 類型 Description
專案編號
 id string

專案的唯一識別碼。
專案金鑰
 key string

專案的唯一金鑰。
專案名稱
 name string

項目的名稱。
專案類型索引鍵
 projectTypeKey string

專案類型的唯一索引鍵。

完整問題

名稱 路徑 類型 Description
問題編號
 id string

問題的唯一識別碼。
問題索引鍵
 key string

問題的唯一金鑰。
問題網址
 self string

使用此 URL 瀏覽至問題。
問題類型識別碼
 fields.issuetype.id string

問題型別的唯一識別碼。
問題類型描述
 fields.issuetype.description string

問題類型的詳細標題。
問題型別圖示 URL
 fields.issuetype.iconUrl string

與問題類型相關聯的圖示。
問題類型名稱
 fields.issuetype.name string

問題類型的標題。
花費的時間
 fields.timespent integer

在問題上花費的時間
專案編號
 fields.project.id string

專案的唯一識別碼。
專案金鑰
 fields.project.key string

專案的唯一金鑰。
專案名稱
 fields.project.name string

專案的標題。
專案類型索引鍵
 fields.project.projectTypeKey string

專案類型的唯一索引鍵。
總花費時間
 fields.aggregatetimespent integer

在子任務上花費的總時間。
問題解決方案的 URL
 fields.resolution.self string
問題解決方案的 ID
 fields.resolution.id string
問題解決方案的描述
 fields.resolution.description string
問題解決方案的名稱
 fields.resolution.name string
決議日期
 fields.resolutiondate date-time

yyyy-MM-ddTHH：mm：ss.fffZ
工作比例
 fields.workratio integer

記錄的工作百分比與問題估計值。
建立日期
 fields.created date-time

yyyy-MM-ddTHH：mm：ss.fffZ
優先順序圖示 URL
 fields.priority.iconUrl string

與問題優先順序相關聯的圖示。
優先順序名稱
 fields.priority.name string

優先順序的標題。
優先順序 ID
 fields.priority.id string

問題優先順序的 ID。
時間預估
 fields.timeestimate integer

剩餘時間預估時間（以秒為單位）。
總時間估計
 fields.aggregatetimeoriginalestimate integer

所有子任務時間估計值的原始總和（以秒為單位）。
受指派人ID
 fields.assignee.accountId string

問題指派給的人員。
受指派人金鑰
 fields.assignee.key string

人員問題的使用者金鑰已指派給。
受指派人電子郵件
 fields.assignee.emailAddress string

人員問題的電子郵件已指派給。
受指派人顯示名稱
 fields.assignee.displayName string

指派給人員問題的顯示名稱。
更新 Date-Time
 fields.updated date-time

yyyy-MM-ddTHH：mm：ss.fffZ
狀態說明
 fields.status.description string

問題狀態。
狀態圖示 URL
 fields.status.iconUrl string

問題狀態。
狀態名稱
 fields.status.name string

問題狀態。
狀態識別碼
 fields.status.id string

問題狀態。
狀態類別識別碼
 fields.status.statusCategory.id integer

問題狀態類別。
狀態類別索引鍵
 fields.status.statusCategory.key string

問題狀態類別。
狀態類別顏色名稱
 fields.status.statusCategory.colorName string

問題狀態類別。
狀態類別名稱
 fields.status.statusCategory.name string

問題狀態類別。
原始時間預估
 fields.timeoriginalestimate integer

原始時間估計值（以秒為單位）。
Description
 fields.description string

問題描述。
總時間估計
 fields.aggregatetimeestimate integer

所有子任務剩餘預估時間的時間總和（以秒為單位）。
總結
 fields.summary string

問題的標題。
Components
 fields.components array of object

系統欄位，其是由 'name' 定址的多個值 （例如 Microsoft Entra ID、網路交換器）。
元件識別碼
 fields.components.id string
元件名稱
 fields.components.name string
創作者 ID
 fields.creator.accountId string

建立問題的使用者。
創作者鑰匙
 fields.creator.key string

建立問題之使用者的唯一金鑰。
創作者電子郵件
 fields.creator.emailAddress string

建立問題之使用者的電子郵件。
創作者顯示名稱
 fields.creator.displayName string

建立問題的使用者名稱。
記者編號
 fields.reporter.accountId string

回報問題的使用者。
記者關鍵
 fields.reporter.key string

回報問題之使用者的唯一金鑰。
記者郵箱
 fields.reporter.emailAddress string

回報問題之使用者的電子郵件。
報告者顯示名稱
 fields.reporter.displayName string

回報問題之使用者的顯示名稱。
已完成的彙總進度
 fields.aggregateprogress.progress integer

所有子任務完成的總進度（以秒為單位）。
彙總預估工作量
 fields.aggregateprogress.total integer

所有預估子任務投入量的總和。
總進度百分比
 fields.aggregateprogress.percent integer

與預估工作量相關的總完成進度百分比。
應 Date-Time
 fields.duedate date-time

yyyy-MM-ddTHH：mm：ss.fffZ
進度完成
 fields.progress.progress integer

進度在幾秒鐘內完成。
估計工作量
 fields.progress.total integer

估計的努力。
進度百分比
 fields.progress.percent integer

已完成進度相對於預估工作量的百分比。
史詩名稱 （customfield_10011）
 fields.customfield_10119

Epic 問題類型需要 Epic 名稱。 此欄位與 Jira 伺服器上的「customfield_10011」欄位相符。

使用者清單

名稱 路徑 類型 Description
身份識別碼
 accountId string

專案成員的識別碼。
Key
 key string

與使用者相關聯的唯一金鑰。
Email
 emailAddress string

使用者的電子郵件地址。
顯示名稱
 displayName string

使用者的全名。

ListFilters回應

名稱 路徑 類型 Description
values
 values FilterArray

過濾器陣列

名稱 路徑 類型 Description
身份識別碼
 id string

篩選器的 ID。
名稱
 name string

篩選器名稱。
JQL
 jql string

jql 用於 Filter。

ListIssues回應

名稱 路徑 類型 Description
問題
 issues array of FullIssue

清單問題回應資料中心

名稱 路徑 類型 Description
問題
 issues array of FullIssue

評論回應

名稱 路徑 類型 Description
註解 ID
 id string

註解的唯一識別碼。
註解內文
 body string

評論正文。
創建 Date-Time
 created date-time

yyyy-MM-ddTHH：mm：ss.fffZ

Sites

名稱 路徑 類型 Description
雲端識別碼
 id string

Jira 執行個體 ID
網站名稱
 name string
網站 URL
 url string

過渡

名稱 路徑 類型 Description
識別碼
 id string

轉換的識別碼
名稱
 name string

轉換的名稱
至
 to TransitionStatus
fields
 fields object

此轉換所需的欄位

轉換狀態

名稱 路徑 類型 Description
識別碼
 id string

狀態的ID
名稱
 name string

狀態名稱

MCPQuery回應

名稱 路徑 類型 Description
jsonrpc
 jsonrpc string
識別碼
 id string
方法
 method string
參數
 params object
結果
 result object
錯誤
 error object