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

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

將自訂標籤新增至資源

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

  • 選擇加入自訂標籤傳播

  • 將自訂標籤新增至資源

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

先決條件

  • 使用者必須具有 sagemaker:AddTags 許可，才能建立任何資源。

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

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

選擇加入自訂標籤傳播

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

從主控台選擇加入

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

  1. 開啟 Amazon SageMaker AI 主控台，網址為 https://console.aws.amazon.com/sagemaker/。

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

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

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

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

  6. 選擇 Edit (編輯)。

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

  8. 選取提交。

使用 選擇加入 AWS CLI

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

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

新增自訂標籤

新增自訂標籤傳播的程序會根據您是從主控台還是從 AWS CLI新增它們而有所不同。

從主控台新增

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

  1. 開啟 Amazon SageMaker AI 主控台，網址為 https://console.aws.amazon.com/sagemaker/。

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

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

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

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

  6. 選擇 Edit (編輯)。

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

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

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

  1. 開啟 Amazon SageMaker AI 主控台，網址為 https://console.aws.amazon.com/sagemaker/。

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

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

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

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

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

  7. 選擇 Edit (編輯)。

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

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

使用 新增 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

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

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