View a markdown version of this page

将角色用于 AWS Batch - AWS Batch
Service-linked 的角色权限 AWS Batch为创建服务相关角色 AWS Batch编辑的服务相关角色 AWS Batch删除的服务相关角色 AWS BatchAWS Batch 服务相关角色支持的区域

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

将角色用于 AWS Batch

AWS Batch 使用 AWS Identity and Access Management (IAM) 服务相关角色。服务相关角色是一种与之直接关联的 IAM 角色的独特类型。 AWS Batch Service-linked 角色由预定义 AWS Batch ，包括该服务代表您调用其他 AWS 服务所需的所有权限。

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

注意

执行以下任一操作为 AWS Batch 计算环境指定服务角色。

  • 对服务角色使用空字符串。这样就可以 AWS Batch 创建服务角色了。

  • 采用以下格式指定服务角色：arn:aws:iam::account_number:role/aws-service-role/batch.amazonaws.com/AWSServiceRoleForBatch。

有关更多信息，请参阅角色名称或 ARN 不正确《 AWS Batch 用户指南》。

重要

Service-linked 角色自动创建仅适用于MANAGED计算环境。对于UNMANAGED计算环境，必须明确指定serviceRole。省略UNMANAGED计算环境的角色会导致ServiceRole is required错误。

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

有关支持服务相关角色的其他服务的信息，请参阅与 IAM 配合使用的AWS 服务，并在Service-linked 角色列中查找带有 “是” 的服务。请选择是与查看该服务的服务关联角色文档的链接。

Service-linked 的角色权限 AWS Batch

AWS Batch 使用名为的服务相关角色 AWSServiceRoleForBatch— AWS Batch 允许代表您创建和管理 AWS 资源。

AWSServiceRoleForBatch 服务相关角色信任以下服务来代入该角色：

  • batch.amazonaws.com

名为的角色权限策略BatchServiceRolePolicy AWS Batch 允许对指定资源完成以下操作：

  • autoscaling— AWS Batch 允许创建和管理 Amazon EC2 Auto Scaling 资源。 AWS Batch 为大多数计算环境创建和管理 Amazon EC2 Auto Scaling 组。

  • ec2— AWS Batch 允许控制 Amazon EC2 实例的生命周期以及创建和管理启动模板和标签。 AWS Batch 为某些 EC2 竞价计算环境创建和管理 EC2 竞价型队列请求。

  • ecs- AWS Batch 允许创建和管理 Amazon ECS 集群、任务定义和任务执行任务。

  • eks- AWS Batch 允许描述用于验证的 Amazon EKS 集群资源。

  • iam-允许 AWS Batch 验证所有者提供的角色并将其传递给 Amazon EC2、Amazon EC2 Auto Scaling 和 Amazon ECS。

  • logs— AWS Batch 允许创建和管理 AWS Batch 作业的日志组和日志流。

您必须配置使用户、组或角色能够创建、编辑或删除服务相关角色的权限。有关更多信息，请参阅 IAM 用户指南中的Service-linked 角色权限。

为创建服务相关角色 AWS Batch

您无需手动创建服务关联角色。当您在 AWS 管理控制台、或 AWS API 中创建计算环境时， AWS Batch 会为您创建服务相关角色。 AWS CLI

注意

这种自动创建与服务相关的角色仅适用于MANAGED计算环境。对于UNMANAGED计算环境，调用serviceRole时必须明确提供CreateComputeEnvironment。

重要

如果您在其他使用此角色支持的功能的服务中完成某个操作，此服务关联角色可以出现在您的账户中。如果您在 2021 年 3 月 10 日 AWS Batch 服务开始支持服务相关角色之前使用该服务，则在您的账户中 AWS Batch 创建了该 AWSServiceRoleForBatch 角色。要了解更多信息，请参阅 “我的” 中出现了一个新角色 AWS 账户。

如果您删除该服务关联角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。创建计算环境时， AWS Batch 会再次为您创建服务相关角色。

编辑的服务相关角色 AWS Batch

AWS Batch 不允许您编辑 AWSServiceRoleForBatch 服务相关角色。创建服务关联角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。有关更多信息，请参阅《IAM 用户指南》中的编辑服务关联角色。

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

向该权限策略添加以下声明。这允许 IAM 实体编辑服务相关角色的描述。

{
    "Effect": "Allow",
    "Action": [
        "iam:UpdateRoleDescription"
    ],
    "Resource": "arn:aws:iam::*:role/aws-service-role/batch.amazonaws.com/AWSServiceRoleForBatch",
    "Condition": {"StringLike": {"iam:AWSServiceName": "batch.amazonaws.com"}}
}

删除的服务相关角色 AWS Batch

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

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

向该权限策略添加以下声明。这允许 IAM 实体删除服务相关角色。

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

清除服务相关角色

在使用 IAM 删除服务相关角色之前，必须先确认该角色没有活动会话，然后删除单个分区中所有 AWS 区域中使用该角色的所有 AWS Batch 计算环境。

检查服务相关角色是否有活动会话

  1. 使用 https://console.aws.amazon.com/iam/ 打开 IAM 控制台。

  2. 在导航窗格中，选择角色，然后选择 AWSServiceRoleForBatch 名称（不是复选框）。

  3. 在 Summary 页面上，选择 Access Advisor，查看服务相关角色的近期活动。

    注意

    如果您不知道 AWS Batch 是否在使用该 AWSServiceRoleForBatch 角色，可以尝试删除该角色。如果服务正在使用该角色，则该角色将无法删除。您可以查看正在使用该角色的区域。如果该角色已被使用，则您必须等待会话结束，然后才能删除该角色。无法撤销服务相关角色对会话的权限。

移除 AWSServiceRoleForBatch 服务相关角色使用的 AWS Batch 资源

必须先删除所有 AWS 区域中使用该 AWSServiceRoleForBatch 角色的所有 AWS Batch 计算环境，然后才能删除该 AWSServiceRoleForBatch 角色。

  1. 打开 AWS Batch 控制台，网址为https://console.aws.amazon.com/batch/。

  2. 从导航栏中，选择要使用的区域。

  3. 在导航窗格中，选择计算环境。

  4. 选择计算环境。

  5. 选择 Disable (禁用)。等待状态变为已禁用。

  6. 选择计算环境。

  7. 选择删除。通过选择删除计算环境来确认您要删除计算环境。

  8. 对所有区域中使用服务相关角色的所有计算环境重复步骤 1—7。

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

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

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

  1. 登录 AWS 管理控制台 并打开 IAM 控制台，网址为https://console.aws.amazon.com/iam/。

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

  3. 选择删除角色。

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

  5. 监视 IAM 控制台通知，以监控服务相关角色的删除进度。由于 IAM 服务相关角色删除是异步的，因此，在您提交角色进行删除后，删除任务可能成功，也可能失败。

    • 如果任务成功，则角色将从列表中删除，并会在页面顶部显示成功通知。

    • 如果任务失败，您可以从通知中选择 View details 或 View Resources 以了解删除失败的原因。如果因为角色正在使用服务的资源而使删除失败，则通知包含一个资源列表 (如果服务返回该信息)。然后您可以清除资源并再次提交删除。

      注意

      您可能需要多次重复执行此过程，这取决于服务返回的信息。例如，您的服务相关角色可能使用六个资源，而您的服务可能返回有关其中五个资源的信息。如果您清除这五个资源并再次提交该角色以进行删除，则删除会失败，并且服务会报告一个剩余资源。服务可能会返回所有资源、其中一些资源，也可能不报告任何资源。

    • 如果任务失败，并且通知不包含资源列表，则服务可能不会返回该信息。要了解如何清除该服务的资源，请参阅 使用 IAM 的AWS 服务。在表中查找您的服务，然后选择 Yes 链接以查看该服务的服务相关角色文档。

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

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

删除服务相关角色（CLI）

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

    $ aws iam delete-service-linked-role --role-name AWSServiceRoleForBatch

  2. 使用以下命令以检查删除任务的状态：

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

    删除任务的状态可能是 NOT_STARTED、IN_PROGRESS、SUCCEEDED 或 FAILED。如果删除失败，则调用会返回失败的原因，以便您进行问题排查。如果因为角色正在使用服务的资源而使删除失败，则通知包含一个资源列表 (如果服务返回该信息)。然后您可以清除资源并再次提交删除。

    注意

    您可能需要多次重复执行此过程，这取决于服务返回的信息。例如，您的服务相关角色可能使用六个资源，而您的服务可能返回有关其中五个资源的信息。如果您清除这五个资源并再次提交该角色以进行删除，则删除会失败，并且服务会报告一个剩余资源。服务可能会返回所有资源，其中一些资源。或者，它可能不会报告任何资源。要了解如何为不报告任何资源的服务清除资源，请参阅 AWS 使用 IAM 的服务。在表中查找您的服务，然后选择 Yes 链接以查看该服务的服务相关角色文档。

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

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

删除服务相关角色（API）

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

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

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

    删除任务的状态可能是 NOT_STARTED、IN_PROGRESS、SUCCEEDED 或 FAILED。如果删除失败，则调用会返回失败的原因，以便您进行问题排查。如果因为角色正在使用服务的资源而使删除失败，则通知包含一个资源列表 (如果服务返回该信息)。然后您可以清除资源并再次提交删除。

    注意

    您可能需要多次重复执行此过程，这取决于服务返回的信息。例如，您的服务相关角色可能使用六个资源，而您的服务可能返回有关其中五个资源的信息。如果您清除这五个资源并再次提交该角色以进行删除，则删除会失败，并且服务会报告一个剩余资源。服务可能会返回所有资源、其中一些资源，也可能不报告任何资源。要了解如何为不报告任何资源的服务清除资源，请参阅 使用 IAM 的AWS 服务。在表中查找您的服务，然后选择 Yes 链接以查看该服务的服务相关角色文档。

AWS Batch 服务相关角色支持的区域

AWS Batch 支持在提供服务的所有地区使用服务相关角色。有关更多信息，请参阅 AWS Batch 端点。