使用 CodeCatalyst 的服務連結角色

Amazon CodeCatalyst 使用 AWS Identity and Access Management (IAM) 服務連結角色。服務連結角色是直接連結到 CodeCatalyst的唯一 IAM 角色類型。服務連結角色由預先定義， CodeCatalyst 並包含服務代表您呼叫其他服AWS務所需的所有權限。

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

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

如需關於支援服務連結角色的其他服務資訊，請參閱《可搭配 IAM 運作的 AWS 服務》，尋找服務連結角色欄中顯示為是的服務。選擇具有連結的是，以檢視該服務的服務連結角色文件。

服務連結角色權限 CodeCatalyst

CodeCatalyst 使用名為的服務連結角色 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization— 允許 Amazon 代表您存取應用程式執行個體設定檔和關聯目錄使用者和群組的 CodeCatalyst 唯讀權限。

AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 服務連結角色信任下列服務以擔任角色：

• codecatalyst.amazonaws.com

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

• 動作：View application instance profiles and associated directory users and groups對於 CodeCatalyst spaces that support identity federation and SSO users and groups

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

建立服務連結角色 CodeCatalyst

您不需要手動建立一個服務連結角色。當您在AWS Management Console、或 AWS API 中建 CodeCatalyst 立空間時AWS CLI，會為您建立服務連結角色。

重要

此服務連結角色可以顯示在您的帳戶，如果您於其他服務中完成一項動作時，可以使用支援此角色的功能。此外，如果您在 2023 年 11 月 17 日之前使用該 CodeCatalyst 服務，則該服務開始支援服務連結角色時，請在您的帳戶中 CodeCatalyst 建立該AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization角色。若要進一步了解，請參閱在我的 AWS 帳戶 中顯示新角色。

若您刪除此服務連結角色然後需要再次建立，便可在帳戶中使用相同程序重新建立角色。當您建立空間時，請再次為您建 CodeCatalyst 立服務連結角色。

您也可以使用 IAM 主控台，透過 View 應用程式執行個體設定檔以及關聯的目錄使用者和群組使用案例建立服務連結角色。在 AWS CLI CLI 或 AWS API 中，建立一個服務名稱為 codecatalyst.amazonaws.com 的服務連結角色。如需詳細資訊，請參閱《IAM 使用者指南》中的「建立服務連結角色」。如果您刪除此服務連結角色，您可以使用此相同的程序以再次建立該角色。

編輯下列項目的服務連結角色 CodeCatalyst

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

刪除下列項目的服務連結角色 CodeCatalyst

您不需要手動刪除 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 角色。當您刪除AWS Management Console、或 AWS API 中的空間時AWS CLI，會為您 CodeCatalyst 清除資源並刪除服務連結角色。

您也可以使用 IAM 主控台、AWS CLI 或 AWS API 來手動刪除服務連結角色。若要執行此操作，您必須先手動清除服務連結角色的資源，然後才能手動刪除它。

注意

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

若要刪除使用的 CodeCatalyst 資源 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization

• 刪除空間。

使用 IAM 手動刪除服務連結角色

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

支援 CodeCatalyst 服務連結角色的區域

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

CodeCatalyst 不支援在每個提供服務的區域中使用服務連結角色。您可以在下列區域中使用 AmazonCodeCatalystServiceRoleForIdentityCenterApplicationSynchronization 角色。

區域名稱	區域身分	中的 Support CodeCatalyst
美國東部 (維吉尼亞北部)	us-east-1	否
美國東部 (俄亥俄)	us-east-2	否
美國西部 (加利佛尼亞北部)	us-west-1	否
美國西部 (奧勒岡)	us-west-2	是
非洲 (開普敦)	af-south-1	否
亞太區域 (香港)	ap-east-1	否
亞太區域 (雅加達)	ap-southeast-3	否
亞太區域 (孟買)	ap-south-1	否
亞太區域 (大阪)	ap-northeast-3	否
亞太區域 (首爾)	ap-northeast-2	否
亞太區域 (新加坡)	ap-southeast-1	否
亞太區域 (雪梨)	ap-southeast-2	否
亞太區域 (東京)	ap-northeast-1	否
加拿大 (中部)	ca-central-1	否
歐洲 (法蘭克福)	eu-central-1	否
歐洲 (愛爾蘭)	eu-west-1	是
歐洲 (倫敦)	eu-west-2	否
歐洲 (米蘭)	eu-south-1	否
歐洲 (巴黎)	eu-west-3	否
歐洲 (斯德哥爾摩)	eu-north-1	否
中東 (巴林)	me-south-1	否
中東 (阿拉伯聯合大公國)	me-central-1	否
南美洲 (聖保羅)	sa-east-1	否
AWS GovCloud (美國東部)	us-gov-east-1	否
AWS GovCloud (美國西部)	us-gov-west-1	否