top of page

【重要公告】Atlassian Cloud API 使用機制大改版 ,快速判斷您的 Jira / Confluence 是否會受影響

  • 作家相片: Linktech
    Linktech
  • 1月21日
  • 讀畢需時 3 分鐘

Atlassian 近期發布公告,將針對 Jira / Confluence Cloud 的 API 使用機制進行更新,改採 Points-based API rate limiting(點數制限流),並搭配 Tiered quotas(分級配額) 的策略。


這篇文章將助您快速判斷:

  • 一般 Jira / Confluence 使用者是否會受影響?

  • Marketplace Plugin 供應商需注意什麼?

  • 貴公司有自建整合程式 / AI / 同步任務,應如何提前應對?


|一句話先講結論:大多數一般客戶「幾乎不受影響」

這次改動主要是寫給 Plugin / App 開發商與重度 API 整合用戶的各位做確認的,而不是一般 Jira / Confluence 使用者。


 如果你只是以下角色,99% 基本可以安心使用,不需要調整任何設定。

  • 管理 Jira / Confluence

  • 使用 Marketplace 外掛(正常使用)

  • 使用 Automation / Webhook(一般等級)

  • 日常操作 Jira UI、Confluence 頁面瀏覽


|為什麼 Atlassian 要改 API 限制?

Atlassian 的核心目標是:在雲端平台規模持續成長下,仍然維持整體穩定與可靠性。

簡單來說,過去 API 限制多採「每秒幾次 request」這種粗暴方式衡量流量。但實際上有些 App / AI / 同步工具,一次呼叫 API 可能掃大量 Issue / User / Page,對系統負擔非常不均衡。少數高流量 App 會拖累整體平台品質。

因此 Atlassian 決定改為用「系統負擔」來計算 API 使用成本。


|什麼是 Points-based API Rate Limiting?

新的方式不再只看「API 呼叫次數」,而是依照每次呼叫造成的負擔,換算成 points(點數)


可以理解為:

  • 每一個 API request ≠ 1 次成本

  • 而是依照呼叫內容,計算不同點數


例如(概念示意):

  • 基礎呼叫:1 point

  • 一次讀取大量 Issue / Page / User → points 會提高

  • 帶權限/身分驗證相關的讀取 → 更貴

  • 寫入(POST / PUT / DELETE)反而很便宜,多數只算 1 point


這代表:平台希望限制的是「大量掃資料」的行為,而不是限制一般正常寫入與使用。


|Atlassian 把 App 分成兩種 Tier(配額等級)

🟢 Tier 1:Global Pool(預設)

  • 65,000 points / 小時

  • 所有 tenant 共用配額池

  • 絕大多數 App 都在這一層

  • Atlassian 表示:「大部分 App 完全夠用」

對一般 Plugin / App 供應商而言,通常 Tier 1 就足夠。


🔵 Tier 2:Per-Tenant Pool(需申請審核)

這是為少數「高流量、重度資料處理」App 設計的等級:

  • 每個 tenant(每個客戶)都有獨立 quota pool

  • 需要申請與 Atlassian 審核

  • 不是想升就升


適用情境包含

  • Cloud ↔ DC Migration 工具

  • DLP / 大量稽核、掃描

  • AI / 大量資料同步

  • 大型 reporting / sync job

這種 App 才可能需要 Tier 2。


|對一般客戶會造成哪些影響?

不會影響的範圍

  • Jira / Confluence UI 操作

  • 頁面瀏覽與日常使用

  • Automation rules

  • 一般 webhook

  • 大多數 Marketplace 外掛(若供應商實作合理)


只有以下情況才需要注意

  • 公司自建 API 整合程式

  • 背景服務會「高頻掃 Issue / User / Page」

  • 大量 AI / Reporting / Sync 程式

  • Migration 類型工具


只有在大量 API 使用或批次掃資料的系統,才可能碰到 quota/限流問題。


|什麼時候開始?

Atlassian 預計 2026 年 2 月 2 日 起分階段啟用(逐步 rollout),不是一次全部上線。

你可以放心的是:

  • 會先小比例 App 試行

  • 若發現 App 可能會受影響,Atlassian 通常會直接聯繫 App 開發商/供應商

  • 不會突然砍帳號或直接讓客戶服務中斷


|對您的建議是?

  • 一般 Jira / Confluence的客戶

    • 現行使用方式無需變更

    • 無需調整設定

    • 若有自建整合程式,建議做一次 API 使用量盤點


  • Plugin / App 供應商以及超大型企業

建議貴司檢視:

  1. 是否有「大量讀取資料」API(尤其 Issue / User / Content)

  2. 是否有 background job 會定時全量掃描

  3. 是否已實作:

    • 分頁(pagination)

    • 增量同步(incremental sync)

    • cache / last-updated timestamp 機制

    • retry/backoff 機制(避免被限流後雪崩)


|總結

這份公告主要針對第三方 App 或自建整合程式的 API 使用行為調整,一般使用者不會受到影響。若沒有自行開發高頻 API 整合或 AI 類型服務,現行使用方式與設定都不需要調整。

若您是 Plugin 供應商或有大量 API 整合需求,我們建議提前檢視 API 讀取量與同步策略,避免於 2026/02 之後受到點數制配額影響

 

有任何疑慮或者問題或者擔憂公司會否受到影響的,不要顧慮,歡迎隨時與Linktech友環企業聯繫。


Linktech 友環企業 團隊洽詢方式:


留言


bottom of page