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

# 为资源添加自定义标签
<a name="custom-tags-add"></a>

 下页演示了使用自定义标签传播所需的步骤。自定义标签传播需要以下步骤：
+  选择加入自定义标签传播 
+  为资源添加自定义标签 

 在现有域中激活自定义标签传播时，在重新启动应用程序之前，标记传播对现有应用程序不起作用。同样，当添加新的自定义标签时，现有资源上的标记也不会更新。例如，假设一个域有两个标签，用户在该域中创建了一个资源。然后，该资源就有了两个标签。如果域中添加了新标签，则该新标签不会添加到现有资源中。不过，创建的任何新资源都将附加新标签。

## 先决条件
<a name="custom-tags-add-prereq"></a>
+  用户必须拥有 `sagemaker:AddTags` 权限才能创建任何资源。
  +  对于使用`SageMakerFullAccess`托管策略或使用 SageMaker 角色管理器创建的新域，`sagemaker:AddTags`权限已预先填充。
  +  对于使用自定义 Amazon Identity and Access Management 策略的现有域，您必须更新策略以包含允许用户创建资源的`sagemaker:AddTags`权限。

## 选择加入自定义标签传播
<a name="custom-tags-add-opt-in"></a>

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



### 从管理控制台选择加入
<a name="custom-tags-add-opt-in-console"></a>

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

1. 打开 Amazon A SageMaker I 控制台，网址为[https://console.aws.amazon.com/sagemaker/](https://console.amazonaws.cn/sagemaker/)。

1. 在左侧导航栏中选择**管理配置**。在**管理配置**下，选择**域**。

1. 在**域**页面上，选择要激活自定义标签传播的域。

1. 在**域详细信息**页面上，选择**域设置**选项卡。

1. 在**域设置**选项卡上，导航至**自定义标签传播**。

1. 选择**编辑**。

1. 在**编辑自定义标签传播**页面上，选择**自动传播自定义标签**。

1. 选择**提交**。

### 使用 “选择加入” Amazon CLI
<a name="custom-tags-add-opt-in-cli"></a>

 要选择使用自定义标签传播 Amazon CLI，请使用[CreateDomain](https://docs.amazonaws.cn/sagemaker/latest/APIReference/API_CreateDomain.html)和[UpdateDomain](https://docs.amazonaws.cn/sagemaker/latest/APIReference/API_UpdateDomain.html) APIs中的`TagPropagation`属性。默认情况下，该字段的值为 `DISABLED`。空值也默认为 `DISABLED`。下面的示例显示了如何激活自定义标签传播。

```
aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation ENABLED
```

## 添加自定义标签
<a name="custom-tags-add-tags"></a>

添加自定义标签传播的过程因您是从管理控制台还是从 Amazon CLI添加而有所不同。

### 从管理控制台添加
<a name="custom-tags-add-tags-console"></a>

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

1. 打开 Amazon A SageMaker I 控制台，网址为[https://console.aws.amazon.com/sagemaker/](https://console.amazonaws.cn/sagemaker/)。

1. 在左侧导航栏中选择**管理配置**。在**管理配置**下，选择**域**。

1. 在**域**页面上，选择要添加自定义标签的域。

1. 在**域详细信息**页面上，选择**域设置**选项卡。

1. 在**域设置**选项卡上，导航至**标签**。

1. 选择**编辑**。

1. 在**标签**页面上，选择**添加标签**。为自定义标签添加键和值对。

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

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

1. 打开 Amazon A SageMaker I 控制台，网址为[https://console.aws.amazon.com/sagemaker/](https://console.amazonaws.cn/sagemaker/)。

1. 在左侧导航栏中选择**管理配置**。在**管理配置**下，选择**域**。

1. 在**域**页面上，选择包含要添加自定义标签的用户配置文件的域。

1. 在**域详细信息**页面上，选择**用户配置文件**选项卡。

1. 在**用户配置文件**选项卡上，选择要添加自定义标签的用户配置文件。

1. 在**用户详细信息**选项卡上，导航至**详细信息**部分。

1. 选择**编辑**。

1. 在**标签**部分，选择**添加标签**。为自定义标签添加键和值对。

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

### 使用添加 Amazon CLI
<a name="custom-tags-add-tags-cli"></a>

 激活自定义标签传播后，可以在创建或更新期间使用域、用户配置文件或空间级别添加自定义标签。 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
```

 您必须使用该 [AddTags](https://docs.amazonaws.cn/sagemaker/latest/APIReference/API_AddTags.html)API 为现有域名、用户个人资料和空间添加自定义标签，如下所示。

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