Amazon ECS
AWS Fargate 用户指南 (API 版本 2014-11-13)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

Amazon Elastic Container Service 如何与 IAM 协同工作

使用 IAM 来管理 Amazon ECS 的访问权限之前,您应该了解哪些 IAM 功能可与 Amazon ECS 协同工作。要概括了解 Amazon ECS 及其他 AWS 服务如何与 IAM 协同工作,请参阅 IAM 用户指南 中的可与 IAM 协同工作的 AWS 服务

Amazon ECS 基于身份的策略

使用 IAM 基于身份的策略,您可以指定允许或拒绝操作和资源,以及指定在什么条件下允许或拒绝操作。Amazon ECS 支持特定操作、资源和条件键。要了解您在 JSON 策略中使用的所有元素,请参阅 IAM 用户指南 中的 IAM JSON 策略元素参考

操作

The Action element of an IAM identity-based policy describes the specific action or actions that will be allowed or denied by the policy. Policy actions usually have the same name as the associated AWS API operation. The action is used in a policy to grant permissions to perform the associated operation.

Amazon ECS 中的策略操作在操作前使用以下前缀:ecs:。例如,要授予某人使用 Amazon ECS CreateCluster API 操作创建 Amazon ECS 集群的权限,您应将 ecs:CreateCluster 操作纳入其策略中。策略语句必须包括 ActionNotAction 元素。Amazon ECS 定义了自己的一组操作,描述了您可以使用该服务执行的任务。

要在单个语句中指定多项操作,请使用逗号将它们隔开,如下所示:

"Action": [ "ecs:action1", "ecs:action2"

您也可以使用通配符 (*) 指定多个操作。例如,要指定以单词 Describe 开头的所有操作,包括以下操作:

"Action": "ecs:Describe*"

要查看 Amazon ECS 操作的列表,请参阅 Amazon ECS API 操作支持的资源级权限

资源

The Resource element specifies the object or objects to which the action applies. Statements must include either a Resource or a NotResource element. You specify a resource using an ARN or using the wildcard (*) to indicate that the statement applies to all resources.

Amazon ECS 集群资源具有以下 ARN:

arn:${Partition}:ecs:${Region}:${Account}:cluster/${clusterName}

有关 ARN 格式的更多信息,请参阅 Amazon 资源名称 (ARN) 和 AWS 服务命名空间

例如,要在语句中指定 my-cluster 容器,请使用以下 ARN:

"Resource": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster"

要指定属于特定账户的所有集群,请使用通配符 (*):

"Resource": "arn:aws:ecs:us-east-1:123456789012:cluster/*"

某些 Amazon ECS 操作(例如用于创建资源的那些操作)不能在特定资源上执行。在这些情况下,您必须使用通配符 (*)。

"Resource": "*"

一些 Amazon ECS API 操作可以在多个资源上执行。例如,在调用 DescribeClusters API 操作时可以引用多个集群。要在单个语句中指定多个资源,请使用逗号分隔其 ARN。

"Resource": [ "resource1", "resource2"

下表介绍了 Amazon ECS API 操作使用的每种类型资源的 ARN。

重要

下表为 Amazon ECS 任务、服务和容器实例使用新的较长的 ARN 格式。如果您未选择使用长 ARN 格式,ARN 将不包含群集名称。有关更多信息,请参阅 Amazon 资源名称 (ARN) 和 ID

资源类型 ARN

所有 Amazon ECS 资源

arn:aws:ecs:*

指定账户在指定地区拥有的所有 Amazon ECS 资源

arn:aws:ecs:region:account:*

群集

arn:aws:ecs:region:account:cluster/cluster-name

容器实例

arn:aws:ecs:region:account:container-instance/cluster-name/container-instance-id

任务定义

arn:aws:ecs:region:account:task-definition/task-definition-family-name:task-definition-revision-number

服务

arn:aws:ecs:region:account:service/cluster-name/service-name

任务

arn:aws:ecs:region:account:task/cluster-name/task-id

容器

arn:aws:ecs:region:account:container/container-id

要了解您可以使用哪些操作指定每个资源的 ARN,请参阅 Amazon ECS API 操作支持的资源级权限

条件键

The Condition element (or Condition block) lets you specify conditions in which a statement is in effect. The Condition element is optional. You can build conditional expressions that use condition operators, such as equals or less than, to match the condition in the policy with values in the request.

If you specify multiple Condition elements in a statement, or multiple keys in a single Condition element, AWS evaluates them using a logical AND operation. If you specify multiple values for a single condition key, AWS evaluates the condition using a logical OR operation. All of the conditions must be met before the statement's permissions are granted.

You can also use placeholder variables when you specify conditions. For example, you can grant an IAM user permission to access a resource only if it is tagged with their IAM user name. For more information, see IAM Policy Elements: Variables and Tags in the IAM User Guide.

Amazon ECS 定义了自己的一组条件键,还支持使用一些全局条件键。要查看所有 AWS 全局条件键,请参阅 IAM 用户指南 中的 AWS 全局条件上下文键

Amazon ECS 实施以下特定于服务的条件键。

条件键 描述 评估类型

aws:RequestTag/${TagKey}

上下文键的格式为 "aws:RequestTag/tag-key":"tag-value",其中 tag-keytag-value 是标签键值对。

检查 AWS 请求中是否存在目标键值对。例如,您可以检查请求是否包含标签键 "Dept" 并具有 "Accounting" 值。

字符串

aws:ResourceTag/${TagKey}

上下文键的格式为 "aws:ResourceTag/tag-key":"tag-value",其中 tag-keytag-value 是标签键值对。

检查附加到身份资源(用户或角色)的标签是否与指定的键名称和键值匹配。

字符串

aws:TagKeys

该上下文键的格式为 "aws:TagKeys":"tag-key",其中 tag-key 是没有值的标签键列表 (例如,["Dept","Cost-Center"])。

检查在 AWS 请求中包含的标签键。

字符串

ecs:ResourceTag/${TagKey}

上下文键的格式为 "ecs:ResourceTag/tag-key":"tag-value",其中 tag-keytag-value 是标签键值对。

检查附加到身份资源(用户或角色)的标签是否与指定的键名称和键值匹配。

字符串

ecs:cluster

上下文键的格式为 "ecs:cluster":"cluster-arn",其中 cluster-arn 是 Amazon ECS 集群的 ARN。

ARN,Null

ecs:container-instances

上下文键的格式为 "ecs:container-instances":"container-instance-arns",其中 container-instance-arns 是一个或多个容器实例 ARN。

ARN,Null

ecs:task-definition

上下文键的格式为 "ecs:task-definition":"task-definition-arn",其中 task-definition-arn 是 Amazon ECS 任务定义的 ARN。

ARN,Null

ecs:service

上下文键的格式为 "ecs:service":"service-arn",其中 service-arn 是 Amazon ECS 服务的 ARN。

ARN,Null

要了解您可以对哪些操作和资源使用条件键,请参阅 Amazon ECS API 操作支持的资源级权限

示例

要查看 Amazon ECS 基于身份的策略的示例,请参阅Amazon Elastic Container Service 基于身份的策略示例

Amazon ECS 基于资源的策略

Amazon ECS 不支持基于资源的策略。

基于 Amazon ECS 标签的授权

您可以将标签附加到 Amazon ECS 资源或将请求中的标签传递到 Amazon ECS。要基于标签控制访问,您需要使用 、aws:RequestTag/key-nameaws:TagKeys 条件键在策略的 condition 元素中提供标签信息。有关更多信息,请参阅 IAM 用户指南 中的使用标签控制访问

有关标记 Amazon ECS 资源的更多信息,请参阅资源和标签

若要查看基于身份的策略示例(基于资源上的标签来限制对该资源的访问),请参阅基于标签描述 Amazon ECS 服务

Amazon ECS IAM 角色

IAM 角色是 AWS 账户中具有特定权限的实体。

使用 Amazon ECS 的临时凭证

您可以使用临时凭证进行联合身份登录,代入 IAM 角色或代入跨账户角色。您可以通过调用 AWS STS API 操作(如 AssumeRoleGetFederationToken)获得临时安全凭证。

Amazon ECS 支持使用临时凭证。

服务相关角色

服务相关角色允许 AWS 服务访问其他服务中的资源以代表您完成操作。服务相关角色显示在您的 IAM 账户中,并由该服务拥有。IAM 管理员可以查看但不能编辑服务相关角色的权限。

Amazon ECS 支持服务相关角色。有关创建或管理 Amazon ECS 服务相关角色的详细信息,请参阅 对 Amazon ECS 使用服务相关角色

服务角色

此功能允许服务代表您代入服务角色。此角色允许服务访问其他服务中的资源以代表您完成操作。服务角色显示在您的 IAM 账户中,并由该账户拥有。这意味着 IAM 管理员可以更改此角色的权限。但是,这样操作可能会中断服务的功能。

Amazon ECS 支持服务角色。