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

在您的 Elastic Beanstalk 环境中标记资源

环境标记简介

AWS Elastic Beanstalk 支持您指定标签以应用于您的环境中的资源。标签是与 AWS 资源关联的键/值对。标签可帮助您分类资源。如果您管理很多环境,它们将特别有用。

下面是您可以使用 Elastic Beanstalk 环境添加标签的一些方法:

  • 环境阶段 — 标识不同阶段(如开发、测试和生产)中的环境。

  • 成本分配 — 标识与成本分配报告中的各个支出账户关联的环境。

  • 访问控制 — 使用标签管理对请求和资源的权限。有关详细信息,请参阅 使用标签控制对 Elastic Beanstalk 资源的访问

您还可以使用标签管理某个环境内的特定资源级权限。有关更多信息,请参阅Amazon EC2 用户指南(适用于 Linux 实例) 中的标记 Amazon EC2 资源

默认情况下,Elastic Beanstalk 会应用三个标签:

  • elasticbeanstalk:environment-name – 环境的名称。

  • elasticbeanstalk:environment-id – 环境 ID。

  • Name – 也是环境名称。Name 在 Amazon EC2 控制面板中用于对资源进行标识和排序。

您不能编辑这些默认标签。

您可以在创建 Elastic Beanstalk 环境时指定标签。在现有环境中,您可以添加或删除标签,还可以更新现有标签的值。除了默认标签之外,最多可向每个环境中添加 47 个附加标签。

约束

  • 键和值可以包含字母、数字、空格和以下符号:_ . : / = + - @

  • 键最多可包含 128 个字符。值最多可包含 256 个字符。

  • 键区分大小写。

  • 键不能以 aws:elasticbeanstalk: 开头。

您可以使用成本分配报告来跟踪 AWS 资源的使用情况。这些报告包括已标记和未标记的资源,但是它们会根据标签来汇总成本。有关成本分配报告如何使用标签的信息,请参阅 AWS 账单和成本管理用户指南 中的为自定义账单报告使用成本分配标签

在环境创建过程中添加标签

当您使用 Elastic Beanstalk 控制台创建环境时,可以在“创建新环境”向导标签页上指定键和值,如下所示。


        您可以指定标签键和值的标签页

如果使用 EB CLI 创建环境,则可使用带 --tagseb create 选项来添加标签。

~/workspace/my-app$ eb create --tags mytag1=value1,mytag2=value2

对于 AWS CLI 或其他基于 API 的客户端,使用 create-environment 命令的 --tags 参数。

$ aws elasticbeanstalk create-environment --tags Key=mytag1,Value=value1 Key=mytag2,Value=value2 --application-name my-app --environment-name my-env --cname-prefix my-app --version-label v1 --template-name my-saved-config

保存的配置包括用户定义的标签。当您在创建环境期间应用包含标签的已保存配置时,只要您不指定任何新标签,这些标签就将应用于新环境。如果使用前述方法之一向环境添加标签,则将弃用已保存配置中定义的任何标签。

管理现有环境的标签

您可以在现有的 Elastic Beanstalk 环境中添加、更新和删除标签。Elastic Beanstalk 会将更改应用到您的环境中的资源。

不过,您不能编辑 Elastic Beanstalk 应用于您的环境的默认标签。有关这些默认标签的详细信息,请参阅环境标记简介

在 Elastic Beanstalk 控制台中管理环境的标签

  1. 导航到您的环境的环境管理控制台

  2. 在侧导航窗格中,选择标签

    标签管理页会显示环境中当前存在的标签的列表。

    
            标签管理页显示环境的标签
  3. 添加、更新或删除标签:

    • 要添加标签,请将其键入列表底部的空白框中。

    • 要更新标签的键或值,请编辑标签行中的相应框。

    • 要删除标签,请选择标签的值框旁边的 
                  Remove tag

  4. 选择 Apply

如果使用 EB CLI 更新环境,则可使用 eb tags 来添加、更新、删除或列出标签。

例如,以下命令会列出默认环境中的标签。

~/workspace/my-app$ eb tags --list

以下命令会更新标签 mytag1 并删除标签 mytag2

~/workspace/my-app$ eb tags --update mytag1=newvalue --delete mytag2

有关选项和更多示例的完整列表,请参阅 eb tags

对于 AWS CLI 或其他基于 API 的客户端,可使用 list-tags-for-resource 命令列出环境的标签。

$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws-cn:elasticbeanstalk:us-west-2:my-account-id:environment/my-app/my-env"

使用 update-tags-for-resource 命令可在环境中添加、更新或删除标签。

$ aws elasticbeanstalk update-tags-for-resource --tags-to-add Key=mytag1,Value=newvalue --tags-to-remove mytag2 --resource-arn "arn:aws-cn:elasticbeanstalk:us-west-2:my-account-id:environment/my-app/my-env"

注意

要将这两个命令用于 Elastic Beanstalk 环境,您需要该环境的 ARN。您可以使用下面的命令检索该 ARN。

aws elasticbeanstalk describe-environments

--tags-to-addupdate-tags-for-resource 参数中指定要添加的标签和要更新的标签。添加了一个不存在的标签,更新了现有标签的值。