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

# 自定义标签传播
<a name="custom-tags"></a>

 Amazon SageMaker AI 支持将域、用户个人资料和空间级别设置的自定义标签传播到在 Amazon Studio、基于代码操作系统 JupyterLab、Visual SageMaker Studio 代码——开源和 Amazon Canvas 的环境中创建的所有 SageMaker 人工智能资源。 SageMaker 通过自定义标签传播，用户可以将自己的自定义标签传播到资源中，以改进成本跟踪，并将资源与特定项目和团队联系起来。

 要激活此功能，请使用[CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)和中的`TagPropagation`属性[UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html) APIs。自定义标签传播只能在域级别设置，这意味着域中的所有用户和空间在激活后都会使用该功能。无法在用户配置文件或空间级别修改自定义标签传播设置。有关使用自定义标签传播的更多信息，请参阅 [为资源添加自定义标签](custom-tags-add.md)。

**注意**  
 AWS 服务在域、用户配置文件和空间上添加的系统标签不会被传播。

## 使用案例示例
<a name="custom-tags-use-cases"></a>

 自定义标签传播对以下使用场景特别有用。
+  跟踪在 Amazon SageMaker Studio 中创建的所有 SageMaker 人工智能资源的成本。
+  跟踪在 Amazon C SageMaker anv SageMaker as 中创建的人工智能资源的成本。这包括在 SageMaker AI 端点上部署的模型。
+  通过将亚马逊 DataZone 项目 ID 传播到 Amazon SageMaker Studio 创建的所有资源，跟踪亚马逊 DataZone项目产生的成本。

## 标签合并
<a name="custom-tags-use-merging"></a>

 激活自定义标签传播后，在用户配置文件和空间级别创建的资源将使用域级别指定的标记，以及在创建用户配置文件或空间时指定的标记。

 SageMaker AI 资源有 50 个标签的限制。如果向资源添加的标签数量超过 50， SageMaker AI 将在资源创建过程中返回错误。我们建议限制标签数量，以避免出现这种情况。例如，假设用户的域有 25 个标签，用户配置文件有 30 个标签。当用户创建一个资源时，共有 55 个标记会传播到该资源。由于标签总数超过 50 个，在用户删除至少 5 个标签之前，资源创建将失败。

**注意**  
默认情况下， SageMaker AI 会自动向 A SageMaker I 资源添加`sagemaker:user-profile-arn``sagemaker:domain-arn`、或`sagemaker:space-arn`标签。 SageMaker 无论域是否使用自定义标签传播，AI 都会添加 ARN 标签。这些 ARN 标记也将计入 50 个标签限额。