翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# カスタムタグの伝搬
<a name="custom-tags"></a>

 Amazon SageMaker AI では、ドメイン、ユーザープロファイル、スペースのレベルで設定されたカスタムタグを、Amazon SageMaker Studio、JupyterLab、Code-OSS (Visual Studio Code - Open Source) に基づく Code Editor、Amazon SageMaker Canvas のコンテキストで作成されたすべての SageMaker AI リソースに伝播する機能をサポートしています。カスタムタグ伝搬を使用すると、ユーザーは独自のカスタムタグをリソースに伝播して、コスト追跡を改善し、リソースを特定のプロジェクトやチームに関連付けることができます。

 この機能を有効にするには、[CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html) API と [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html) API の `TagPropagation` 属性を使用します。カスタムタグ伝搬を設定できるのは、ドメインレベルでのみです。つまり、カスタムタグ伝搬を有効にすると、ドメイン内のすべてのユーザーとスペースがこの機能を使用することになります。ユーザープロファイルまたはスペースレベルでカスタムタグ伝搬の設定を変更することはできません。カスタムタグ伝搬の使用の詳細については、「[リソースにカスタムタグを追加する](custom-tags-add.md)」を参照してください。

**注記**  
ドメイン、ユーザープロファイル、およびスペース AWS のサービスによって追加されたシステムタグは伝播されません。

## ユースケースの例
<a name="custom-tags-use-cases"></a>

 カスタムタグ伝搬は、以下のユースケースで特に役立ちます。
+  Amazon SageMaker Studio で作成されたすべての SageMaker AI リソースにわたるコストを追跡する。
+  Amazon SageMaker Canvas で作成された SageMaker AI リソースのコストを追跡する。これには、SageMaker AI エンドポイントにデプロイされたモデルも含まれる。
+  Amazon DataZone プロジェクト ID を Amazon SageMaker Studio で作成したすべてのリソースに伝播して、Amazon DataZone プロジェクトで発生するコストを追跡する。

## タグのマージ
<a name="custom-tags-use-merging"></a>

 カスタムタグ伝搬を有効にすると、ユーザープロファイルやスペースレベルで作成されたリソースは、ドメインレベルで指定されたタグのみでなく、ユーザープロファイルまたはスペースの作成中に指定されたタグも引き受けます。

 SageMaker AI リソースには、50 個までのタグ制限があります。リソースに追加されたタグの数が 50 個を超えると、SageMaker AI はリソースの作成中にエラーを返します。エラーを回避するために、タグの数を制限することをお勧めします。例えば、ユーザーにドメインのタグが 25 個、ユーザープロファイルのタグが 30 個あるとします。ユーザーがリソースを作成すると、合計 55 個のタグがリソースに伝播されます。集計されたタグの合計が 50 個を超えるため、ユーザーが少なくとも 5 個のタグを削除するまでリソースの作成は失敗します。

**注記**  
デフォルトでは、SageMaker AI は `sagemaker:user-profile-arn` タグ、`sagemaker:domain-arn` タグ、または `sagemaker:space-arn` タグを SageMaker AI リソースに自動的に追加します。SageMaker AI は、ドメインでカスタムタグ伝搬を使用しているかどうかを問わず、ARN タグを追加します。このような ARN タグも、タグの 50 個の制限に含まれます。