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

将服务相关角色用于 Amazon ElastiCache

Amazon ElastiCache 使用 Amazon Identity and Access Management (IAM) 服务相关角色。服务相关角色是一种独特类型的 IAM 角色,它与 Amazon ElastiCache 等 Amazon 服务直接相关。Amazon ElastiCache 服务相关角色由 Amazon ElastiCache 预定义。它们包含该服务代表您的集群调用 Amazon 服务所需的一切权限。

服务相关角色可让您更轻松地设置 Amazon ElastiCache,因为您不必手动添加必要的权限。这些角色已存在于您的 Amazon 账户中,但与 Amazon ElastiCache 使用案例有关并有预定义的权限。只有 Amazon ElastiCache 可以代入这些角色,并且只有这些角色可以使用预定义的权限策略。只有先删除角色的相关资源,才能删除角色。这样可以保护您的 Amazon ElastiCache 资源,因为您不会无意中删除访问资源所需的必要权限。

有关支持服务相关角色的其他服务的信息,请参见用于 IAM 的 Amazon 服务,查找服务相关角色列为的服务。选择和链接,查看该服务的服务相关角色文档。

Amazon ElastiCache 的服务相关角色权限

Amazon ElastiCache 使用名为 Amazon ServiceRoleForElastiCache 的服务相关角色 – 此策略允许 ElastiCache 根据管理缓存的需要,代表您管理 Amazon 资源。

Amazon ServiceRoleForElastiCache 服务相关角色权限策略允许 Amazon ElastiCache 对指定资源完成以下操作:

Permission policy: { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:AuthorizeSecurityGroupIngress", "ec2:CreateNetworkInterface", "ec2:CreateSecurityGroup", "ec2:DeleteNetworkInterface", "ec2:DeleteSecurityGroup", "ec2:DescribeAvailabilityZones", "ec2:DescribeNetworkInterfaces", "ec2:DescribeSecurityGroups", "ec2:DescribeSubnets", "ec2:DescribeVpcs", "ec2:ModifyNetworkInterfaceAttribute", "ec2:RevokeSecurityGroupIngress", "cloudwatch:PutMetricData", "outposts:GetOutpost", "outposts:GetOutpostInstanceTypes", "outposts:ListOutposts", "outposts:ListSites", "application-autoscaling:DeregisterScalableTarget", "application-autoscaling:DescribeScalableTargets" ], "Resource": "*" } ] }

允许 IAM 实体创建 Amazon ServiceRoleForElastiCache 服务相关角色

向该 IAM 实体的权限中添加以下策略声明:

{ "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole", "iam:PutRolePolicy" ], "Resource": "arn:aws:iam::*:role/aws-service-role/elasticache.amazonaws.com/AmazonServiceRoleForElastiCache*", "Condition": {"StringLike": {"iam:AmazonServiceName": "elasticache.amazonaws.com"}} }

允许 IAM 实体删除 Amazon ServiceRoleForElastiCache 服务相关角色

向该 IAM 实体的权限中添加以下策略声明:

{ "Effect": "Allow", "Action": [ "iam:DeleteServiceLinkedRole", "iam:GetServiceLinkedRoleDeletionStatus" ], "Resource": "arn:aws:iam::*:role/aws-service-role/elasticache.amazonaws.com/AmazonServiceRoleForElastiCache*", "Condition": {"StringLike": {"iam:AmazonServiceName": "elasticache.amazonaws.com"}} }

或者,您可以使用 Amazon 托管式策略提供对 Amazon ElastiCache 的完全访问权限。

创建服务相关角色 (IAM)

您可以使用 IAM 控制台、CLI 或 API 创建服务相关角色。

创建服务相关角色(IAM 控制台)

您可使用 IAM 控制台创建服务相关角色。

创建服务相关角色 (控制台)

  1. 登录 Amazon Web Services Management Console,打开 IAM 控制台:https://console.aws.amazon.com/iam/

  2. 在 IAM 控制台的导航窗格中,选择角色。然后选择 Create new role (创建新角色)

  3. Select type of trusted entity(选择受信任实体的类型)下,选择 Amazon Service(亚马逊云科技服务)

  4. Or select a service to view its use cases(或选择服务以查看其使用案例)下,选择 ElastiCache

  5. 选择下一步:权限

  6. Policy name(策略名称)下,请注意此角色需要 ElastiCacheServiceRolePolicy。选择 Next:Tags (下一步: 标签)

  7. 请注意,服务相关角色不支持标签。选择下一步:审核

  8. (可选) 对于 Role description,编辑新服务相关角色的描述。

  9. 检查角色,然后选择 Create role

创建服务相关角色 (IAM CLI)

您可以从 Amazon Command Line Interface 中使用 IAM 操作创建服务相关角色。此角色可以包括服务代入角色时所需的信任策略和内联策略。

创建服务相关角色 (CLI)

使用以下操作:

$ aws iam create-service-linked-role --aws-service-name elasticache.amazonaws.com

创建服务相关角色 (IAM API)

您可以使用 IAM API 创建服务相关角色。此角色可以包括服务代入角色时所需的信任策略和内联策略。

创建服务相关角色 (API)

使用 CreateServiceLinkedRole API 调用。在请求中,指定 elasticache.amazonaws.com 的服务名称。

编辑 Amazon ElastiCache 的服务相关角色的描述

Amazon ElastiCache 不允许您编辑 Amazon ServiceRoleForElastiCache 服务相关角色。创建服务相关角色后,将无法更改角色名称,因为可能有多个实体引用该角色。但是可以使用 IAM 编辑角色说明。

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

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

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

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

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

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

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

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

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

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

  1. (可选)要查看角色的当前描述,请使用 Amazon CLI 执行 IAM 操作 get-role

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

    通过 CLI 操作使用角色名称(并非 ARN)指向角色。例如,如果一个角色的 ARN 为 arn:aws:iam::123456789012:role/myrole,则应将角色称为 myrole

  2. 要更新服务相关角色的描述,请使用 Amazon CLI 执行 IAM 操作 update-role-description

    对于 Linux、macOS 或 Unix:

    $ aws iam update-role-description \ --role-name AmazonServiceRoleForElastiCache \ --description "new description"

    对于 Windows:

    $ aws iam update-role-description ^ --role-name AmazonServiceRoleForElastiCache ^ --description "new description"

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

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

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

  1. (可选)要查看角色的当前描述,请使用 IAM API 操作 GetRole。

    https://iam.amazonaws.com/ ?Action=GetRole &RoleName=AmazonServiceRoleForElastiCache &Version=2010-05-08 &AUTHPARAMS
  2. 要更新角色的描述,请使用 IAM API 操作 UpdateRoleDescription。

    https://iam.amazonaws.com/ ?Action=UpdateRoleDescription &RoleName=AmazonServiceRoleForElastiCache &Version=2010-05-08 &Description="New description"

删除 Amazon ElastiCache 的服务相关角色

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

Amazon ElastiCache 不会删除您的服务相关角色。

清除服务相关角色

您必须先确认该角色没有与之关联的资源(集群),然后才能使用 IAM 删除服务相关角色。

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

  1. 登录 Amazon Web Services Management Console,打开 IAM 控制台:https://console.aws.amazon.com/iam/

  2. 在 IAM 控制台的导航窗格中,选择角色。然后选择 Amazon ServiceRoleForElastiCache 角色的名称(而不是复选框)。

  3. 在所选角色的摘要页面上,选择访问顾问选项卡。

  4. 访问顾问选项卡查看服务相关角色的近期活动。

删除需要 Amazon ServiceRoleForElastiCache 的 Amazon ElastiCache 资源(控制台)

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

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

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

  1. 登录 Amazon Web Services Management Console,打开 IAM 控制台:https://console.aws.amazon.com/iam/

  2. 在 IAM 控制台的导航窗格中,选择角色。然后,选中要删除的角色名称旁边的复选框,而不是名称或行本身。

  3. 对于页面顶部的角色操作,请选择删除角色

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

  5. 监视 IAM 控制台通知,以监控服务相关角色的删除进度。由于 IAM 服务相关角色删除是异步的,因此,在您提交角色进行删除后,删除任务可能成功,也可能失败。如果任务失败,您可以从通知中选择 View detailsView Resources 以了解删除失败的原因。

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

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

删除服务相关角色 (CLI)

  1. 如果您不知道要删除的服务相关角色的名称,请输入以下命令。此命令会列出您账户中的角色及其 Amazon 资源名称 (ARN)。

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

    通过 CLI 操作使用角色名称(并非 ARN)指向角色。例如,如果某个角色具有 ARN arn:aws:iam::123456789012:role/myrole,则将该角色称为 myrole

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

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

    $ 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。如果删除失败,则调用会返回失败的原因,以便您进行问题排查。