將自訂標籤新增至資源 - Amazon SageMaker
必要條件選擇加入自訂標籤傳播新增自訂標籤

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

將自訂標籤新增至資源

下頁示範使用自訂標籤傳播所需的步驟。自訂標籤傳播需要下列步驟：

  • 選擇加入自訂標籤傳播

  • 將自訂標籤新增至資源

當您在現有網域中啟用自訂標籤傳播時，在應用程式重新啟動之前，標籤傳播不適用於現有應用程式。同樣地，當新增新的自訂標籤時，不會更新現有資源上的標籤。例如，假設網域有兩個標籤，而使用者在該網域中建立資源。然後，資源有兩個標籤。如果將新標籤新增至網域，則該新標籤不會新增至現有資源。不過，任何新建立的資源都會將新標籤連接至資源。

必要條件

  • 使用者必須擁有sagemaker:AddTags建立任何資源的許可。

    • 對於使用 SageMakerFullAccess 受管政策或使用 SageMaker Role Manager 建立的新網域，sagemaker:AddTags會預先填入許可。

    • 對於使用自訂 AWS Identity and Access Management 政策的現有網域，您必須更新政策以包含允許使用者建立資源的sagemaker:AddTags許可。

選擇加入自訂標籤傳播

如果您選擇加入自訂標籤傳播的程序會因您是否從主控台或 選擇加入而有所不同 AWS CLI。從主控台，您只能透過更新現有網域來選擇加入自訂標籤傳播。在建立網域或更新現有網域時 AWS CLI，您可以選擇加入自訂標籤傳播。

從主控台選擇加入

下列步驟概述如何從主控台選擇加入自訂標籤傳播。您只能透過更新現有網域，選擇加入主控台的自訂標籤傳播。

  1. 在 開啟 Amazon SageMaker 主控台https://console.aws.amazon.com/sagemaker/。

  2. 在左側導覽上，選取管理組態 。在管理員組態 下，選取網域 。

  3. 在網域頁面上，選取要啟用自訂標籤傳播的網域。

  4. 在網域詳細資訊頁面中，選取網域設定標籤。

  5. 在網域設定索引標籤上，導覽至自訂標籤傳播 。

  6. 選擇 Edit (編輯)。

  7. 從編輯自訂標籤傳播頁面中，選取自動傳播自訂標籤

  8. 選取提交。

使用 選擇加入 AWS CLI

若要使用 選擇加入自訂標籤傳播 AWS CLI，請使用 CreateDomain和 UpdateDomain 中的 TagPropagation 屬性APIs。根據預設，此欄位的值為 DISABLED。空值也會預設為 DISABLED。下列範例示範如何啟用自訂標籤傳播。

aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation DISABLED

新增自訂標籤

如果您從主控台或從 新增自訂標籤傳播，新增自訂標籤傳播的程序會有所不同 AWS CLI。

從主控台新增

下列步驟概述如何從主控台將自訂標籤新增至網域。

  1. 在 開啟 Amazon SageMaker 主控台https://console.aws.amazon.com/sagemaker/。

  2. 在左側導覽上，選取管理組態 。在管理員組態 下，選取網域 。

  3. 在網域頁面上，選取要新增自訂標籤的網域。

  4. 在網域詳細資訊頁面中，選取網域設定標籤。

  5. 在網域設定索引標籤上，導覽至標籤 。

  6. 選擇 Edit (編輯)。

  7. 在標籤頁面中，選取新增標籤 。為自訂標籤新增金鑰和值對。

  8. 選取 Save (儲存)。此自訂標籤現在會傳播到網域中建立 SageMaker 的資源。

下列步驟概述如何從主控台將自訂標籤新增至使用者設定檔。

  1. 在 開啟 Amazon SageMaker 主控台https://console.aws.amazon.com/sagemaker/。

  2. 在左側導覽上，選取管理組態 。在管理員組態 下，選取網域 。

  3. 在網域頁面上，選取包含您要新增自訂標籤之使用者設定檔的網域。

  4. 在網域詳細資訊頁面中，選取使用者設定檔索引標籤。

  5. 在使用者設定檔索引標籤上，選取您要新增自訂標籤的使用者設定檔。

  6. 在使用者詳細資訊索引標籤上，導覽至詳細資訊區段。

  7. 選擇 Edit (編輯)。

  8. 從標籤區段中，選取新增標籤 。為自訂標籤新增金鑰和值對。

  9. 選取提交。此自訂標籤現在會傳播到 SageMaker網域中建立的資源。

使用 新增 AWS CLI

啟用自訂標籤傳播之後，您可以在建立或更新期間， AWS 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

您必須使用 AddTagsAPI來新增現有網域、使用者設定檔和空格的自訂標籤，如下所示。

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