本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 自訂標籤傳播
<a name="custom-tags"></a>

 Amazon SageMaker AI 支援您能夠將網域、使用者設定檔和空間層級設定的自訂標籤傳播到 Amazon SageMaker Studio、JupyterLab、程式碼編輯器內容中建立的所有 SageMaker AI 資源，以 Code-OSS、Visual Studio Code - Open Source 和 Amazon SageMaker Canvas 為基礎。透過自訂標籤傳播，使用者可以將自己的自訂標籤傳播至資源，以改善成本追蹤並將資源繫結至特定專案和團隊。

 若要啟用此功能，請使用 [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html) 和 [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 個標籤的限制。