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

# 了解服務連結角色
<a name="service-linked-roles"></a>

Amazon DocumentDB （與 MongoDB 相容） 使用 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)是直接連結至 Amazon DocumentDB 的唯一 IAM 角色類型。服務連結角色由 Amazon DocumentDB 預先定義，並包含該服務代表您呼叫其他 AWS 服務所需的所有許可。

服務連結角色可讓您更輕鬆地使用 Amazon DocumentDB，因為您不必手動新增必要的許可。Amazon DocumentDB 會定義其服務連結角色的許可，除非另有定義，否則只有 Amazon DocumentDB 可以擔任其角色。定義的許可包括信任政策和許可政策，並且該許可政策不能附加到任何其他 IAM 實體。

您必須先刪除角色的相關資源，才能刪除角色。這可保護您的 Amazon DocumentDB 資源，因為您不會不小心移除存取資源的許可。

如需關於支援服務連結角色的其他服務的資訊，請參閱[可搭配 IAM 運作的AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)，並尋找 **Service-Linked Role** (服務連結角色) 欄顯示為 **Yes** (是) 的服務。選擇具有連結的**是**，以檢視該服務的服務連結角色文件。

## Amazon DocumentDB 服務連結角色許可
<a name="service-linked-role-permissions"></a>

Amazon DocumentDB （與 MongoDB 相容） 使用名為 **AWSServiceRoleForRDS** 的服務連結角色，以允許 Amazon DocumentDB 代表您叢集呼叫 AWS 服務。

AWSServiceRoleForRDS 服務連結角色信任下列服務可擔任該角色：
+ `docdb.amazonaws.com`

角色許可政策允許 Amazon DocumentDB 對指定的資源完成下列動作：
+ 在 `ec2` 上的動作：
  + `AssignPrivateIpAddresses`
  + `AuthorizeSecurityGroupIngress`
  + `CreateNetworkInterface`
  + `CreateSecurityGroup`
  + `DeleteNetworkInterface`
  + `DeleteSecurityGroup`
  + `DescribeAvailabilityZones`
  + `DescribeInternetGateways`
  + `DescribeSecurityGroups`
  + `DescribeSubnets`
  + `DescribeVpcAttribute`
  + `DescribeVpcs`
  + `ModifyNetworkInterfaceAttribute`
  + `RevokeSecurityGroupIngress`
  + `UnassignPrivateIpAddresses`
+ 在 `sns` 上的動作：
  + `ListTopic`
  + `Publish`
+ 在 `cloudwatch` 上的動作：
  + `PutMetricData`
  + `GetMetricData`
  + `CreateLogStream`
  + `PullLogEvents`
  + `DescribeLogStreams`
  + `CreateLogGroup`

**注意**  
您必須設定許可，IAM 實體 (如使用者、群組或角色) 才可建立、編輯或刪除服務連結角色。您可能會遇到下列錯誤訊息：  
**無法建立資源。請確認您擁有建立服務連結角色的許可。否則請等待，然後再試一次。**  
如果您看到此錯誤，請確認您已啟用以下許可：  

```
{
    "Action": "iam:CreateServiceLinkedRole",
    "Effect": "Allow",
    "Resource": "arn:aws:iam::*:role/aws-service-role/rds.amazonaws.com/AWSServiceRoleForRDS",
    "Condition": {
        "StringLike": {
            "iam:AWSServiceName":"rds.amazonaws.com"
        }
    }
}
```

如需詳細資訊，請參閱《*IAM 使用者指南*》中的[服務連結角色許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

## 建立 Amazon DocumentDB 服務連結角色
<a name="service-linked-roles-create"></a>

您不需要手動建立服務連結角色，當您建立叢集時，Amazon DocumentDB 會為您建立服務連結角色。

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

## 修改 Amazon DocumentDB 服務連結角色
<a name="service-linked-roles-edit"></a>

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

## 刪除 Amazon DocumentDB 服務連結角色
<a name="service-linked-roles-delete"></a>

若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。不過您必須先刪除您的所有 叢集，才能刪除服務連結角色。

### 清除 Amazon DocumentDB 服務連結角色
<a name="service-linked-roles-clean-up"></a>

您必須先確認服務連結角色沒有作用中的工作階段，並移除該角色使用的資源，之後才能使用 IAM 將其刪除。

**檢查服務連結角色是否有使用主控台的作用中工作階段**

1. 登入 AWS 管理主控台 ，並在 開啟 IAM 主控台[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。

1. 在 IAM 主控台的導覽窗格中，選擇**角色**，然後選擇 **AWSServiceRoleForRDS** 角色的名稱 （而非核取方塊）。

1. 在所選角色的 **Summary (摘要)** 頁面中，選擇 **Access Advisor (存取 Advisor)** 分頁。

1. 在 **Access Advisor (存取 Advisor)** 標籤中，檢閱服務連結角色的近期活動。
**注意**  
如果您不確定 Amazon DocumentDB 是否使用 AWSServiceRoleForRDS 角色，您可以嘗試刪除該角色。如果服務正在使用該角色，則刪除會失敗，而您可以檢視正在使用該角色的 區域。如果服務正在使用該角色，您必須先等到工作階段結束，才能刪除該角色。您無法撤銷服務連結角色的工作階段。

如果您想要移除 AWSServiceRoleForRDS 角色，您必須先刪除*所有*執行個體和叢集。如需有關刪除執行個體和叢集的詳細資訊，請參閱下列主題：
+ [刪除 Amazon DocumentDB 執行個體](db-instance-delete.md)
+ [刪除 Amazon DocumentDB 叢集](db-cluster-delete.md)

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

Amazon DocumentDB 支援在提供服務的所有區域中使用服務連結角色。如需詳細資訊，請參閱[https://docs.aws.amazon.com/documentdb/latest/developerguide/regions-and-azs.html#regions-and-azs-availability](https://docs.aws.amazon.com/documentdb/latest/developerguide/regions-and-azs.html#regions-and-azs-availability)。