IAM 政策管理 API 變更記錄

在此變更記錄中，您可以瞭解 IAM Policy Management API 的最新變更、改進和更新。變更記錄會列出已進行的變更，依發佈日期排序。現有 API 版本的變更是為了與現有用戶端應用程式相容。

有關 IAM Policy Management SDK 和 CLI 的最新變更資訊，請參閱 SDK 套件庫中的變更記錄：

API 版本化

IAM 策略管理 API 使用 URI 路徑版本控制。不相容的變更會透過遞增 URI 路徑號碼 (../v1/policies) 而被視為重大變更。api 的所有其他變更都會與現有的使用方式相容。

作用中的版本

下表顯示各版本的行為變更。

IAM 政策管理 API 版本
版本	變更摘要
`v2`	新模式支援處理日期和時間的條件和進階運算符號
`v1`	IAM 政策管理 API 的初始版本

v1 API 與 v2 API 並不向前相容。您無法在使用 v1 API 建立的政策中加入條件。若要新增條件，您必須刪除 v1 政策，並以包含條件的新存取政策取代。

2025 年 12 月 01 日

IBM Cloud 現在支援自訂角色範本 API，以集中管理企業帳戶的角色。它允許管理員建立、版本、驗證和指派自訂角色範本，以進行一致的規模存取控制。主要功能包括具有已承諾和草稿狀態的範本生命週期管理、跨帳戶和群組的角色指派、與政策範本整合以簡化工作流程，以及透過使用 /v2/roles API 增強基於範本的角色的可見性。新的 IAM 動作有助於確保模板和指派作業的安全性。如需相關資訊，請參閱：

2023 年 8 月 31 日

此變更記錄為 v2 IAM Policy Management API 引入了與 v1 不相容的新功能。此新版本新增在企業帳戶中建立 IAM 政策範本的功能，您可以參考這些範本在存取群組範本和可信賴的設定檔範本中指派存取權限。如需詳細資訊，請參閱建立企業管理式政策範本和企業管理式 IAM 如何運作。

2023 年 1 月 24 日

此變更記錄介紹了 IAM Policy Management API 的新版本 (v1 -> v2)。此版本新增 JSON 結構描述，以支援條件式政策結構和多種基於時間的比較運算符號。這些操作員提供根據時間和日期限制存取的功能。透過以時間為基礎的存取控制，客戶可以根據指定的時間週期建立細緻的政策執行。

若要開始使用，請參閱以時間為基礎的條件限制存取。

如需詳細的操作員說明和範例，請參閱：v2 存取政策中的條件

新的 v2/polices 模式提供向後的功能相容性，並允許更複雜的比較和運算符號。 v1/polices 方案仍然受支援並可用。如需詳細資訊，請參閱比較 /v1/policies 與 /v2/policies 語法。