为资源添加自定义标签 - Amazon SageMaker
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

为资源添加自定义标签

下一页演示了使用自定义标签传播所需的步骤。自定义标签传播需要以下步骤:

  • 选择加入自定义标签传播

  • 为资源添加自定义标签

在现有域中激活自定义标签传播时,在应用程序重新启动之前,标签传播不适用于现有应用程序。同样,添加新的自定义标签时,不会更新现有资源上的标签。例如,假设一个域有两个标签,而一个用户在该域中创建了一个资源。然后,该资源有两个标签。如果向域中添加了新标签,则该新标签不会添加到现有资源中。但是,创建的任何新资源都将为该资源附加新标签。

先决条件

  • 用户必须拥有创建任何资源的sagemaker:AddTags权限。

    • 对于使用SageMakerFullAccess托管策略或使用 SageMaker 角色管理器创建的新域,sagemaker:AddTags权限已预先填充。

    • 对于使用自定义 Amazon Identity and Access Management 策略的现有域,您必须更新策略以包含允许用户创建资源的sagemaker:AddTags权限。

选择加入自定义标签传播

根据您是从控制台还是从控制台选择加入,选择加入自定义标签传播的过程会有所不同。 Amazon CLI在控制台中,您只能通过更新现有域来选择加入自定义标签传播。从中 Amazon CLI,您可以在创建域或更新现有域时选择加入自定义标签传播。

从控制台选择加入

以下步骤概述了如何从控制台选择加入自定义标签传播。您只能通过更新现有域名从控制台选择加入自定义标签传播。

  1. 打开 Amazon SageMaker 控制台,网址为https://console.aws.amazon.com/sagemaker/

  2. 在左侧导航栏中,选择管理员配置。在 “管理员配置” 下,选择 “”。

  3. 域名页面上,选择要为其激活自定义标签传播的域。

  4. 域详细信息页面上,选择域设置选项卡。

  5. 域设置选项卡上,导航到自定义标签传播

  6. 选择编辑

  7. “编辑自定义标签传播” 页面中,选择 “自动传播自定义标签”

  8. 选择提交

使用 “选择加入” Amazon CLI

要选择使用自定义标签传播 Amazon CLI,请使用CreateDomainUpdateDomainAPIs中的TagPropagation属性。默认情况下,此字段的值为DISABLED。空值也默认为DISABLED。以下示例说明如何激活自定义标签传播。

aws sagemaker update-domain \ --domain-id domain-id \ --region region \ --tag-propagation DISABLED

添加自定义标签

添加自定义标签传播的过程因您是从控制台还是从控制台添加自定义标签而异 Amazon CLI。

从控制台添加

以下步骤概述了如何从控制台向域添加自定义标签。

  1. 打开 Amazon SageMaker 控制台,网址为https://console.aws.amazon.com/sagemaker/

  2. 在左侧导航栏中,选择管理员配置。在 “管理员配置” 下,选择 “”。

  3. 域名页面上,选择要向其添加自定义标签的域名。

  4. 域详细信息页面上,选择域设置选项卡。

  5. 域名设置选项卡上,导航到标签

  6. 选择编辑

  7. 在 “标签” 页面中,选择 “添加标签”。为自定义标签添加密钥和值对。

  8. 选择保存。现在,此自定义标签已传播到域中创建的 SageMaker 资源。

以下步骤概述了如何从控制台向用户配置文件添加自定义标签。

  1. 打开 Amazon SageMaker 控制台,网址为https://console.aws.amazon.com/sagemaker/

  2. 在左侧导航栏中,选择管理员配置。在 “管理员配置” 下,选择 “”。

  3. 域名页面上,选择包含要向其添加自定义标签的用户配置文件的域名。

  4. 域名详细信息页面上,选择用户配置文件选项卡。

  5. 用户配置文件选项卡上,选择要向其添加自定义标签的用户个人资料。

  6. 在 “用户详细信息” 选项卡上,导航到 “详细信息” 部分。

  7. 选择编辑

  8. 从 “标签” 部分中,选择 “添加标签”。为自定义标签添加密钥和值对。

  9. 选择提交。现在,此自定义标签已传播到域中创建的 SageMaker资源。

使用添加 Amazon CLI

激活自定义标签传播后,可以在创建或更新期间 Amazon CLI 在域、用户配置文件或空间级别使用添加自定义标签。根据您创建新资源或向现有资源添加标签的不同,添加自定义标签的方法会有所不同。

以下示例说明如何在创建期间在域级别添加自定义标签。

aws sagemaker create-domain \ --domain-name domain-id \ --auth-mode IAM \ --default-user-settings '{"ExecutionRole": "execution-role"}' \ --subnet-ids subnet-id \ --vpc-id vpc-id \ --tags Key=key,Value=value \ --tag-propagation ENABLED

您必须使用AddTagsAPI为现有域、用户配置文件和空间添加自定义标签,如下所示。

aws sagemaker add-tags \ --resource-arn resource-arn-to-attach-tags \ --tags Key=key, Value=value