使用 AWS CodeConnections的服務連結角色

AWS CodeConnections 使用 AWS Identity and Access Management (IAM) 服務連結角色。服務連結角色是直接連結到 AWS CodeConnections的唯一 IAM 角色類型。服務連結角色由預先定義， AWS CodeConnections 並包含服務代表您呼叫其他服 AWS 務所需的所有權限。此角色是您第一次建立連線時為您建立的。您不必建立角色。

服務連結角色可讓您 AWS CodeConnections 更輕鬆地設定，因為您不需要手動新增權限。 AWS CodeConnections 定義其服務連結角色的權限，除非另有定義，否則只 AWS CodeConnections 能擔任其角色。定義的許可包括信任政策和許可政策，且該許可政策無法附加至其他 IAM 實體。

若要刪除服務連結角色，您必須先刪除其相關資源。這樣可以保護您的 AWS CodeConnections 資源，因為您無法不小心移除存取資源的權限。

關於支援服務連結角色的其他服務，如需相關資訊，請參閱與 IAM 搭配運作的AWS 服務。

注意

您可以使用針對在新服務前置詞下建立之資源codeconnections的動作。在新服務前綴下創建資源將codeconnections在資源 ARN 中使用。codestar-connections服務前綴的操作和資源仍然可用。在 IAM 政策中指定資源時，服務前綴需要與資源的前綴匹配。

服務連結角色權限 AWS CodeConnections

AWS CodeConnections 使用 AWSServiceRoleForGitSync 服務鏈接角色與連接的基於 GIT 的存儲庫使用 Git 同步。

服 AWSServiceRoleForGitSync 務連結角色會信任下列服務擔任該角色：

• repository.sync.codeconnections.amazonaws.com

名為的角色權限原則 AWSGitSyncServiceRolePolicy AWS CodeConnections 允許對指定的資源完成下列動作：

• 動作：授與許可，以允許使用者與外部 Git 型儲存庫建立連線，以及搭配這些儲存庫使用 Git 同步。

您必須設定許可，IAM 實體 (如使用者、群組或角色) 才可建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱《IAM 使用者指南》中的服務連結角色許可。

為 AWS CodeConnections建立服務連結角色

您不需要手動建立一個服務連結角色。您可以在使用 API 為 GIT 同步專案建立資源時建立角色。 CreateRepositoryLink

若您刪除此服務連結角色，之後需要再次建立，您可以在帳戶中使用相同程序重新建立角色。

為 AWS CodeConnections編輯服務連結角色

因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。不過，您可以使用 IAM 來編輯角色描述。如需詳細資訊，請參閱《IAM 使用者指南》中的編輯服務連結角色。

為 AWS CodeConnections刪除服務連結角色

若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。刪除服務連結角色之前，您必須先清理資源。這表示刪除 AWS 帳戶中使用服務角色的所有連線。

注意

當您嘗試刪除資源時，如果 AWS CodeConnections 服務正在使用此角色，則刪除可能會失敗。若此情況發生，請等待數分鐘後並再次嘗試操作。

若要刪除使用者的 AWS CodeConnections 資源 AWSServiceRoleForGitSync

1. 開啟 [開發人員工具] 主控台，然後選擇設定。

2. 選擇清單中出現的所有連線，然後選擇刪除。

3. 在您建立連線的所有「 AWS 區域」中重複這些步驟。

使用 IAM 來刪除服務連結角色

使用 IAM 主控 AWS CLI台或 AWS Identity and Access Management API 刪除 AWSServiceRoleForGitSync 服務連結角色。如需詳細資訊，請參閱《IAM 使用者指南》中的刪除服務連結角色。

支援 AWS CodeConnections 服務連結角色的區域

AWS CodeConnections 支援在所有提供服務的 AWS 區域中使用服務連結角色。如需詳細資訊，請參閱 AWS 區域與端點。