本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
为资源添加自定义标签
下一页演示了使用自定义标签传播所需的步骤。自定义标签传播需要以下步骤:
-
选择加入自定义标签传播
-
为资源添加自定义标签
在现有域中激活自定义标签传播时,在应用程序重新启动之前,标签传播不适用于现有应用程序。同样,添加新的自定义标签时,不会更新现有资源上的标签。例如,假设一个域有两个标签,而一个用户在该域中创建了一个资源。然后,该资源有两个标签。如果向域中添加了新标签,则该新标签不会添加到现有资源中。但是,创建的任何新资源都将为该资源附加新标签。
先决条件
-
用户必须拥有创建任何资源的
sagemaker:AddTags
权限。-
对于使用
SageMakerFullAccess
托管策略或使用 SageMaker 角色管理器创建的新域,sagemaker:AddTags
权限已预先填充。 -
对于使用自定义 Amazon Identity and Access Management 策略的现有域,您必须更新策略以包含允许用户创建资源的
sagemaker:AddTags
权限。
-
选择加入自定义标签传播
根据您是从控制台还是从控制台选择加入,选择加入自定义标签传播的过程会有所不同。 Amazon CLI在控制台中,您只能通过更新现有域来选择加入自定义标签传播。从中 Amazon CLI,您可以在创建域或更新现有域时选择加入自定义标签传播。
从控制台选择加入
以下步骤概述了如何从控制台选择加入自定义标签传播。您只能通过更新现有域名从控制台选择加入自定义标签传播。
-
打开 Amazon SageMaker 控制台,网址为https://console.aws.amazon.com/sagemaker/
。 -
在左侧导航栏中,选择管理员配置。在 “管理员配置” 下,选择 “域”。
-
在域名页面上,选择要为其激活自定义标签传播的域。
-
在域详细信息页面上,选择域设置选项卡。
-
在域设置选项卡上,导航到自定义标签传播。
-
选择编辑。
-
在 “编辑自定义标签传播” 页面中,选择 “自动传播自定义标签”
-
选择提交。
使用 “选择加入” Amazon CLI
要选择使用自定义标签传播 Amazon CLI,请使用CreateDomain和UpdateDomainAPIs中的TagPropagation
属性。默认情况下,此字段的值为DISABLED
。空值也默认为DISABLED
。以下示例说明如何激活自定义标签传播。
aws sagemaker update-domain \ --domain-id
domain-id
\ --regionregion
\ --tag-propagation DISABLED
添加自定义标签
添加自定义标签传播的过程因您是从控制台还是从控制台添加自定义标签而异 Amazon CLI。
从控制台添加
以下步骤概述了如何从控制台向域添加自定义标签。
-
打开 Amazon SageMaker 控制台,网址为https://console.aws.amazon.com/sagemaker/
。 -
在左侧导航栏中,选择管理员配置。在 “管理员配置” 下,选择 “域”。
-
在域名页面上,选择要向其添加自定义标签的域名。
-
在域详细信息页面上,选择域设置选项卡。
-
在域名设置选项卡上,导航到标签。
-
选择编辑。
-
在 “标签” 页面中,选择 “添加标签”。为自定义标签添加密钥和值对。
-
选择保存。现在,此自定义标签已传播到域中创建的 SageMaker 资源。
以下步骤概述了如何从控制台向用户配置文件添加自定义标签。
-
打开 Amazon SageMaker 控制台,网址为https://console.aws.amazon.com/sagemaker/
。 -
在左侧导航栏中,选择管理员配置。在 “管理员配置” 下,选择 “域”。
-
在域名页面上,选择包含要向其添加自定义标签的用户配置文件的域名。
-
在域名详细信息页面上,选择用户配置文件选项卡。
-
在用户配置文件选项卡上,选择要向其添加自定义标签的用户个人资料。
-
在 “用户详细信息” 选项卡上,导航到 “详细信息” 部分。
-
选择编辑。
-
从 “标签” 部分中,选择 “添加标签”。为自定义标签添加密钥和值对。
-
选择提交。现在,此自定义标签已传播到域中创建的 SageMaker资源。
使用添加 Amazon CLI
激活自定义标签传播后,可以在创建或更新期间 Amazon CLI 在域、用户配置文件或空间级别使用添加自定义标签。根据您创建新资源或向现有资源添加标签的不同,添加自定义标签的方法会有所不同。
以下示例说明如何在创建期间在域级别添加自定义标签。
aws sagemaker create-domain \ --domain-name
domain-id
\ --auth-mode IAM \ --default-user-settings '{"ExecutionRole": "execution-role
"}' \ --subnet-idssubnet-id
\ --vpc-idvpc-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