对 CloudWatch RUM 使用服务相关角色 - Amazon CloudWatch
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

对 CloudWatch RUM 使用服务相关角色

CloudWatch RUM 使用 Amazon Identity and Access Management (IAM) 服务相关角色。服务相关角色是一种独特类型的 IAM 角色,它与 RUM 直接相关。服务相关角色由 RUM 预定义,并包含服务代表您调用其他 Amazon 服务所需的所有权限。

RUM 定义这些服务相关角色的权限,除非另有定义,否则仅 RUM 能够代入该角色。定义的权限包括信任策略和权限策略,以及不能附加到任何其它 IAM 实体的权限策略。

只有在首先删除角色的相关资源后,才能删除角色。此限制可保护您的 RUM 资源,因为您不会无意中删除对资源的访问权限。

有关支持服务相关角色的其他服务的信息,请参阅使用 IAM 的 Amazon 服务并查找 Service-Linked Role(服务相关角色)列中显示为 Yes(是)的服务。选择和链接,查看该服务的服务相关角色文档。

RUM 的服务相关角色权限

RUM 对您为其启用了 X-Ray 跟踪的应用程序监控使用名为 AWSServiceRoleForCloudWatchRUM 的服务相关角色 – 此角色允许 RUM 将 Amazon X-Ray 跟踪数据发送到您的账户。

AWSServiceRoleForCloudWatchRUM 服务相关角色信任 X-Ray 服务来代入该角色。X-Ray 将跟踪数据发送到您的账户。

AWSServiceRoleForCloudWatchRUM 服务相关角色附加有名为 AmazonCloudWatchRUMServiceRolePolicy 的 IAM 策略。此策略向 CloudWatch RUM 授予将监控数据发布到其他相关 Amazon 服务的权限。其中包括允许 RUM 完成以下操作的权限:

  • xray:PutTraceSegments

为 RUM 创建服务相关角色

您无需手动为 CloudWatch RUM 创建服务相关角色。当您首次创建启用了 X-Ray 跟踪的应用程序监控,或更新应用程序监控以使用 X-Ray 跟踪时,RUM 会为您创建 AWSServiceRoleForCloudWatchRUM

有关更多信息,请参阅 IAM 用户指南 中的创建服务相关角色

编辑 RUM 的服务相关角色

CloudWatch RUM 不允许您编辑 AWSServiceRoleForCloudWatchRUM 角色。在创建这些角色后,您无法更改这些角色的名称,因为可能有不同的实体引用它们。但是,您可以使用 IAM 编辑这些角色的描述。

编辑服务相关角色描述(IAM 控制台)

您可以使用 IAM 控制台编辑服务相关角色的描述。

编辑服务相关角色的描述 (控制台)

  1. 在 IAM 控制台的导航窗格中,选择角色

  2. 选择要修改的角色的名称。

  3. Role description 的最右侧,选择 Edit

  4. 在框中键入新描述,然后选择 Save (保存)

编辑服务相关角色描述 (Amazon CLI)

您可以从 Amazon Command Line Interface 使用 IAM 命令编辑服务相关角色的描述。

更改服务相关角色描述 (Amazon CLI)

  1. (可选) 要查看角色的当前描述,请使用以下命令:

    $ aws iam get-role --role-name role-name

    可以在 Amazon CLI 命令中使用角色名称(而不是 ARN)引用角色。例如,如果某个角色的 ARN 为 arn:aws:iam::123456789012:role/myrole,则将该角色称为 myrole

  2. 要更新服务相关角色的描述,请使用以下命令:

    $ aws iam update-role-description --role-name role-name --description description

编辑服务相关角色描述 (IAM API)

您可以使用 IAM API 编辑服务相关角色的描述。

更改服务相关角色的描述 (API)

  1. (可选) 要查看角色的当前描述,请使用以下命令:

    GetRole

  2. 要更新角色的描述,请使用以下命令:

    UpdateRoleDescription

删除 RUM 的服务相关角色

如果您不再拥有启用了 X-Ray 的应用程序监控,我们建议您删除 AWSServiceRoleForCloudWatchRUM 角色。

这样您就没有未被主动监控或维护的未使用实体。但是,您必须先清除您的服务相关角色,然后才能将其删除。

清除服务相关角色

必须先确认服务相关角色没有活动会话并删除该角色使用的任何资源,然后才能使用 IAM 删除服务相关角色。

在 IAM 控制台中检查服务相关角色是否具有活动会话

  1. 通过以下网址打开 IAM 控制台:https://console.aws.amazon.com/iam/

  2. 在导航窗格中,选择 Roles(角色)。选择 AWSServiceRoleForCloudWatchRUM 角色的名称(而不是复选框)。

  3. 在选定角色的摘要页上,选择访问顾问并查看服务相关角色的近期活动。

    注意

    如果您不确定 RUM 是否正在使用 AWSServiceRoleForCloudWatchRUM 角色,请尝试删除该角色。如果服务正在使用该角色,则删除操作会失败,并且您可以查看正在使用该角色的 区域。如果该角色已被使用,则您必须等待会话结束,然后才能删除该角色。您无法撤销服务相关角色对会话的权限。

删除服务相关角色(IAM 控制台)

您可以使用 IAM 控制台删除服务相关角色。

删除服务相关角色(控制台)

  1. 通过以下网址打开 IAM 控制台:https://console.aws.amazon.com/iam/

  2. 在导航窗格中,选择 Roles(角色)。选中要删除的角色名称旁的复选框,而不是名称或行本身。

  3. 对于角色操作,请选择删除角色

  4. 在确认对话框中,查看上次访问服务数据,该数据显示每个选定角色上次访问 Amazon 服务的时间。这样可帮助您确认角色当前是否处于活动状态。要继续,请选择 Yes, Delete(是的,删除)

  5. 监视 IAM 控制台通知,以监控服务相关角色的删除进度。由于 IAM 服务相关角色的删除是异步操作,因此,在提交要删除的角色后,删除任务可能会成功,也可能会失败。如果该任务失败,请从通知中选择查看详细信息查看资源以了解删除失败的原因。如果因角色正在使用服务中的资源而导致删除操作失败,则失败原因将包含一个资源列表。

删除服务相关角色 (Amazon CLI)

您可以从 Amazon Command Line Interface 使用 IAM 命令删除服务相关角色。

删除服务相关角色 (Amazon CLI)

  1. 如果服务相关角色正被使用或具有关联的资源,则无法删除它,因此您必须提交删除请求。如果不满足这些条件,该请求可能会被拒绝。您必须从响应中捕获 deletion-task-id 以检查删除任务的状态。键入以下命令以提交服务相关角色的删除请求:

    $ aws iam delete-service-linked-role --role-name service-linked-role-name
  2. 键入以下命令以检查删除任务的状态:

    $ aws iam get-service-linked-role-deletion-status --deletion-task-id deletion-task-id

    删除任务的状态可能是 NOT_STARTEDIN_PROGRESSSUCCEEDEDFAILED。如果删除失败,则调用会返回失败的原因,以便您进行问题排查。

删除服务相关角色(IAM API)

您可以使用 IAM API 删除服务相关角色。

删除服务相关角色 (API)

  1. 要提交服务相关角色的删除请求,请调用 DeleteServiceLinkedRole。在请求中,指定您要删除的角色名称。

    如果服务相关角色正被使用或具有关联的资源,则无法删除它,因此您必须提交删除请求。如果不满足这些条件,该请求可能会被拒绝。您必须从响应中捕获 DeletionTaskId 以检查删除任务的状态。

  2. 要检查删除的状态,请调用 GetServiceLinkedRoleDeletionStatus。在请求中,指定 DeletionTaskId

    删除任务的状态可能是 NOT_STARTEDIN_PROGRESSSUCCEEDEDFAILED。如果删除失败,则调用会返回失败的原因,以便您进行问题排查。