本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 的服務連結角色 AWS CodeConnections
<a name="service-linked-role-connections"></a>

AWS CodeConnections use AWS Identity and Access Management (IAM)[ 服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)。服務連結角色是直接連結至 的唯一 IAM 角色類型 AWS CodeConnections。服務連結角色由 預先定義， AWS CodeConnections 並包含該服務代表您呼叫其他 AWS 服務所需的所有許可。此角色是您第一次建立連線時為您建立的。您不必建立角色。

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

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

關於支援服務連結角色的其他服務，如需相關資訊，請參閱[與 IAM 搭配運作的AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。

**注意**  
在新服務字首下建立的資源動作`codeconnections`可供使用。在新服務字首下建立資源將在資源 ARN `codeconnections`中使用 。`codestar-connections` 服務字首的動作和資源仍然可用。在 IAM 政策中指定資源時，服務字首需要符合資源的字首。

## 的服務連結角色許可 AWS CodeConnections
<a name="slr-permissions"></a>

AWS CodeConnections 使用 AWSServiceRoleForGitSync 服務連結角色，將 Git 同步與連接的 Git 型儲存庫搭配使用。

AWSServiceRoleForGitSync 服務連結角色信任下列服務擔任該角色：
+ `repository.sync.codeconnections.amazonaws.com`

名為 AWSGitSyncServiceRolePolicy 的角色許可政策允許 對指定的資源 AWS CodeConnections 完成下列動作：
+ 動作：授與許可，以允許使用者與外部 Git 型儲存庫建立連線，以及搭配這些儲存庫使用 Git 同步。

您必須設定許可，IAM 實體 (如使用者、群組或角色) 才可建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[服務連結角色許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

## 為 建立服務連結角色 AWS CodeConnections
<a name="create-slr-connections"></a>

您不需要手動建立服務連結角色，當您使用 CreateRepositoryLink API 為 Git 同步的專案建立資源時，您就會建立該角色。

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

## 編輯 的服務連結角色 AWS CodeConnections
<a name="edit-slr-connections"></a>

因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。不過，您可以使用 IAM 來編輯角色描述。如需詳細資訊，請參閱*《IAM 使用者指南》*中的[編輯服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。

## 刪除 的服務連結角色 AWS CodeConnections
<a name="delete-slr-connections"></a>

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

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

**刪除 AWSServiceRoleForGitSync 使用 AWS CodeConnections 的資源**

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

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

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

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

使用 IAM 主控台 AWS CLI或 AWS Identity and Access Management API 來刪除 AWSServiceRoleForGitSync 服務連結角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[刪除服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。

## AWS CodeConnections 服務連結角色支援的區域
<a name="slr-regions-connections"></a>

AWS CodeConnections 支援在所有提供服務的 AWS 區域中使用服務連結角色。如需詳細資訊，請參閱 [AWS 區域與端點](https://docs.aws.amazon.com/general/latest/gr/rande.html)。