AWS Elastic Beanstalk
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

The Monitoring Service-Linked Role

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

服务相关角色使 Elastic Beanstalk 的设置更轻松,因为您不必手动添加必要的权限。Elastic Beanstalk 定义其服务相关角色的权限,除非另行定义,否则仅 Elastic Beanstalk 可以代入其角色。定义的权限包括信任策略和权限策略,并且权限策略不能附加到任何其他 IAM 实体。

只有在首先删除相关资源后,才能删除服务相关角色。这将保护您的 Elastic Beanstalk 资源,因为您不会无意中删除对资源的访问权限。

有关支持服务相关角色的其他服务的信息,请参阅与 IAM 配合使用的 AWS 服务并查找 Service-Linked Role 列为 Yes 的服务。选择 Yes 与查看该服务的服务相关角色文档的链接。

Elastic Beanstalk 的服务相关角色权限

Elastic Beanstalk 使用名为 AWSServiceRoleForElasticBeanstalk – Allows Elastic Beanstalk to monitor the health of running environments and publish health event notifications 的服务相关角色。

AWSServiceRoleForElasticBeanstalk 服务相关角色信任以下服务代入该角色:

  • elasticbeanstalk.amazonaws.com.cn

AWSServiceRoleForElasticBeanstalk 服务相关角色的权限策略包含 Elastic Beanstalk 代表您完成操作需要的所有权限:

{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowCloudformationReadOperationsOnElasticBeanstalkStacks", "Effect": "Allow", "Action": [ "cloudformation:DescribeStackResource", "cloudformation:DescribeStackResources", "cloudformation:DescribeStacks" ], "Resource": [ "arn:aws-cn:cloudformation:*:*:stack/awseb-*", "arn:aws-cn:cloudformation:*:*:stack/eb-*" ] }, { "Sid": "AllowOperations", "Effect": "Allow", "Action": [ "autoscaling:DescribeAutoScalingGroups", "autoscaling:DescribeAutoScalingInstances", "autoscaling:DescribeNotificationConfigurations", "autoscaling:DescribeScalingActivities", "autoscaling:PutNotificationConfiguration", "ec2:DescribeInstanceStatus", "ec2:AssociateAddress", "ec2:DescribeAddresses", "ec2:DescribeInstances", "ec2:DescribeSecurityGroups", "elasticloadbalancing:DescribeInstanceHealth", "elasticloadbalancing:DescribeLoadBalancers", "elasticloadbalancing:DescribeTargetHealth", "elasticloadbalancing:DescribeTargetGroups", "sqs:GetQueueAttributes", "sqs:GetQueueUrl", "sns:Publish" ], "Resource": [ "*" ] } ] }

您必须配置权限以允许 IAM 实体(如用户、组或角色)创建、编辑或删除服务相关角色。有关更多信息,请参阅 IAM 用户指南 中的服务相关角色权限

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

将以下语句添加到需要创建服务相关角色的 IAM 实体的权限策略:

{ "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole", "iam:PutRolePolicy" ], "Resource": "arn:aws-cn:iam::*:role/aws-service-role//*", "Condition": {"StringLike": {"iam:AWSServiceName": ""}} }

允许 IAM 实体编辑 服务相关角色的描述

将以下语句添加到需要编辑服务相关角色的描述的 IAM 实体的权限策略:

{ "Effect": "Allow", "Action": [ "iam:UpdateRoleDescription" ], "Resource": "arn:aws-cn:iam::*:role/aws-service-role//*", "Condition": {"StringLike": {"iam:AWSServiceName": ""}} }

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

将以下语句添加到需要删除服务相关角色的 IAM 实体的权限策略:

{ "Effect": "Allow", "Action": [ "iam:DeleteServiceLinkedRole", "iam:GetServiceLinkedRoleDeletionStatus" ], "Resource": "arn:aws-cn:iam::*:role/aws-service-role//*", "Condition": {"StringLike": {"iam:AWSServiceName": ""}} }

或者,您可以使用 AWS 托管策略提供对 Elastic Beanstalk 的完全访问权限

为 创建服务相关角色Elastic Beanstalk

您无需手动创建服务相关角色。当您create an Elastic Beanstalk environment using the Elastic Beanstalk API and don't specify a service role时,Elastic Beanstalk 将为您创建服务相关角色。

重要

如果您在September 27, 2017之前(它从此时间开始支持 AWSServiceRoleForElasticBeanstalk 服务相关角色)使用 Elastic Beanstalk 服务,并且您的账户需要它,则 Elastic Beanstalk 会在您的账户中创建 AWSServiceRoleForElasticBeanstalk 角色。 要了解更多信息,请参阅我的 IAM 账户中出现新角色

在您创建环境时,如果 Elastic Beanstalk 尝试为您的账户创建 AWSServiceRoleForElasticBeanstalk 服务相关角色,您必须具有 iam:CreateServiceLinkedRole 权限。如果您没有此权限,环境创建将失败,您会看到说明问题的消息。

作为替代方案,也可以让具有创建服务相关角色权限的另一用户使用 IAM 预先创建服务相关角色。这样,即使您没有 iam:CreateServiceLinkedRole 权限,也可以创建环境。

您(或另一用户)可以使用 IAM 控制台用 Elastic Beanstalk 使用案例创建服务相关角色。在 IAM CLI 或 IAM API 中,用 elasticbeanstalk.amazonaws.com.cn 服务名称创建一个服务相关角色。有关更多信息,请参阅 IAM 用户指南 中的创建服务相关角色。如果您删除了此服务相关角色,则可以使用此相同过程再次创建角色。

如果您删除了此服务相关角色然后需要再次创建它,则可以使用相同的流程在您的账户中重新创建此角色。当您create an Elastic Beanstalk environment using the Elastic Beanstalk API and don't specify a service role时,Elastic Beanstalk 将再次为您创建服务相关角色。

编辑 Elastic Beanstalk 的服务相关角色

Elastic Beanstalk 不允许您编辑 AWSServiceRoleForElasticBeanstalk 服务相关角色。创建服务相关角色后,您将无法更改角色的名称,因为可能有多种实体引用该角色。但是,您可以使用 IAM 编辑角色的说明。有关更多信息,请参阅 IAM 用户指南 中的编辑服务相关角色

删除 Elastic Beanstalk 的服务相关角色

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

清除服务相关角色

在使用 IAM 删除服务相关角色之前,必须先终止使用此服务相关角色的任何 Elastic Beanstalk 环境。

注意

在您尝试终止环境时,如果 Elastic Beanstalk 服务正在使用此角色,终止操作可能会失败。如果发生这种情况,则请等待几分钟后重试。

终止使用 AWSServiceRoleForElasticBeanstalk 的 Elastic Beanstalk 环境(控制台)

  1. 打开 Elastic Beanstalk 控制台

  2. 导航到您的环境的管理页

  3. 选择操作,然后选择终止环境

  4. Confirm Termination (确认终止) 对话框中,键入环境名称,然后选择 Terminate (终止)

有关使用 EB CLI 终止 Elastic Beanstalk 环境的详细信息,请参阅 eb terminate

有关使用 API 终止 Elastic Beanstalk 环境的详细信息,请参阅 TerminateEnvironment

手动删除服务相关角色

使用 IAM 控制台、IAM CLI 或 IAM API 删除 AWSServiceRoleForElasticBeanstalk 服务相关角色。有关更多信息,请参阅 IAM 用户指南 中的删除服务相关角色

Elastic Beanstalk 服务相关角色的受支持区域

Elastic Beanstalk 支持在服务可用的所有区域中使用服务相关角色。有关更多信息,请参阅 Elastic Beanstalk Regions and Endpoints