

终止支持通知：2027 年 3 月 31 日， AWS 将终止对亚马逊 WorkMail的支持。2027 年 3 月 31 日之后，您将无法再访问亚马逊 WorkMail 控制台或亚马逊 WorkMail 资源。有关更多信息，请参阅 [Amazon WorkMail 终止支持](https://docs.aws.amazon.com/workmail/latest/adminguide/workmail-end-of-support.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用适用于 Amazon 的服务相关角色 WorkMail
<a name="using-service-linked-roles"></a>

亚马逊 WorkMail 使用 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 WorkMail 直接关联的独特的 IAM 角色。 Service-linked 角色由 Amazon WorkMail 预定义，包括该服务代表您调用其他 AWS 服务所需的所有权限。

服务相关角色使设置 Amazon WorkMail 变得更加容易，因为您不必手动添加必要的权限。亚马逊 WorkMail 定义其服务相关角色的权限，除非另有定义，否则只有亚马逊 WorkMail 可以担任其角色。定义的权限包括信任策略和权限策略，以及不能附加到任何其他 IAM 实体的权限策略。

只有在先删除相关 资源后，才能删除服务相关角色。这样可以保护您的 Amazon WorkMail 资源，因为您不会无意中删除访问这些资源的权限。

有关支持服务相关角色的其他服务的信息，请参阅与 IA [M 配合使用的 AWS 服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)，并查找**Service-linked 角色**列中标有 “**是**” 的服务。请选择**是**与查看该服务的服务关联角色文档的链接。

## Service-linked Amazon 的角色权限 WorkMail
<a name="slr-permissions"></a>

Amazon WorkMail 使用名为 **AmazonWorkMailEvents**— Amazon 的服务相关角色 WorkMail 使用此服务相关角色来允许访问亚马逊 WorkMail 事件使用或管理的 AWS 服务和资源，例如监控记录的电子邮件事件。 CloudWatch有关为 Amazon 启用电子邮件事件记录的更多信息 WorkMail，请参阅[启用电子邮件事件日志记录](tracking.md)。

 AmazonWorkMailEvents 服务相关角色信任以下服务来代入该角色：
+ `events.workmail.amazonaws.com`

角色权限策略允许 Amazon WorkMail 对指定资源完成以下操作：
+ 操作：`all AWS resources` 上的 `logs:CreateLogGroup`
+ 操作：`logs:CreateLogStream` 上的 `all AWS resources`
+ 操作：`all AWS resources` 上的 `logs:PutLogEvents`

必须配置权限，允许 IAM 实体（如用户、组或角色）创建、编辑或删除服务相关角色。有关更多信息，请参阅 *IAM 用户指南*中的[Service-linked 角色权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

## 为 Amazon 创建服务相关角色 WorkMail
<a name="create-slr"></a>

您无需手动创建服务关联角色。当您开启亚马逊 WorkMail 事件记录并使用亚马逊 WorkMail 控制台中的默认设置时，亚马逊 WorkMail会为您创建服务相关角色。

如果您删除该服务关联角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。当您打开 Amazon WorkMail 事件记录并使用默认设置时，Amazon WorkMail 会再次为您创建服务相关角色。

## 编辑 Amazon 的服务相关角色 WorkMail
<a name="edit-slr"></a>

Amazon WorkMail 不允许您编辑 AmazonWorkMailEvents 服务相关角色。在创建服务相关角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。不过，您可以使用 IAM 编辑角色的说明。有关更多信息，请参阅 *IAM 用户指南*中的[编辑 Service-Linked 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。

## 删除 Amazon 的服务相关角色 WorkMail
<a name="delete-slr"></a>

如果不再需要使用某个需要服务关联角色的功能或服务，我们建议您删除该角色。这样就没有未被主动监控或维护的未使用实体。但是，必须先清除服务相关角色的资源，然后才能手动删除它。

**注意**  
如果您尝试删除资源时，Amazon WorkMail 服务正在使用该角色，则删除可能会失败。如果发生这种情况，请等待几分钟后重试。

**删除使用的 Amazon WorkMail 资源 AmazonWorkMailEvents**

1. 关闭 Amazon WorkMail 事件记录。

   1. 打开亚马逊 WorkMail 控制台，网址为[https://console.aws.amazon.com/workmail/](https://console.aws.amazon.com/workmail/)。

      如有必要，请更改 AWS 区域。在控制台窗口顶部的栏中，打开**选择区域**列表，然后选择一个区域。有关更多信息，请参阅《Amazon Web Services 一般参考》中的[区域和端点](https://docs.aws.amazon.com/general/latest/gr/rande.html)。**

   1. 在导航窗格中，选择**组织**，然后选择贵组织的名称。

   1. 在导航窗格中，选择**组织设置**，然后选择**监控**。

   1. 对于 **Log settings (日志设置)**，选择 **Edit (编辑)**。

   1. 将**启用邮件事件**滑块移动到“关闭”位置。

   1. 选择**保存**。

1. 删除 Amazon CloudWatch 日志组。

   1. 打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。

   1. 选择 **Logs (日志)**。

   1. 对于 **Log Groups (日志组)**，选择要删除的日志组。

   1. 对于 **Actions (操作)**，选择 **Delete log group (删除日志组)**。

   1. 选择**是，删除**。

**使用 IAM 手动删除服务关联角色**

使用 IAM 控制台 AWS CLI、或 AWS API 删除 AmazonWorkMailEvents服务相关角色。有关更多信息，请参阅《IAM 用户指南》**中的[删除服务关联角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。

## Amazon WorkMail 服务相关角色支持的区域
<a name="slr-regions"></a>

Amazon WorkMail 支持在提供服务的所有地区使用服务相关角色。有关更多信息，请参阅 [Amazon WorkMail 区域和终端节点](https://docs.aws.amazon.com/general/latest/gr/rande.html#wm_region)。