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

# 將自訂標籤新增至資源
<a name="custom-tags-add"></a>

 以下頁面示範使用自訂標籤傳播所需的步驟。自訂標籤傳播需要下列步驟：
+  選擇加入自訂標籤傳播 
+  將自訂標籤新增至資源 

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

## 先決條件
<a name="custom-tags-add-prereq"></a>
+  使用者必須具有 `sagemaker:AddTags` 許可，才能建立任何資源。
  +  對於使用 `SageMakerFullAccess` 受管政策或使用 SageMaker 角色管理員建立的新網域，會預先填入 `sagemaker:AddTags` 許可。
  +  對於使用自訂 AWS Identity and Access Management 政策的現有網域，您必須更新政策以包含允許使用者建立資源的 `sagemaker:AddTags`許可。

## 選擇加入自訂標籤傳播
<a name="custom-tags-add-opt-in"></a>

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



### 從主控台選擇加入
<a name="custom-tags-add-opt-in-console"></a>

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

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

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

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

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

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

1. 選擇 **Edit** (編輯)。

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

1. 選取**提交**。

### 使用 選擇加入 AWS CLI
<a name="custom-tags-add-opt-in-cli"></a>

 若要使用 選擇加入自訂標籤傳播 AWS CLI，請使用 [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html) 和 [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html) APIs中的 `TagPropagation` 屬性。根據預設，此欄位的預設值為 `DISABLED`。空白值也會預設為 `DISABLED`。下列範例顯示如何啟用自訂標籤傳播。

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

## 新增自訂標籤
<a name="custom-tags-add-tags"></a>

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

### 從主控台新增
<a name="custom-tags-add-tags-console"></a>

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

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

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

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

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

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

1. 選擇 **Edit** (編輯)。

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

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

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

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

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

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

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

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

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

1. 選擇 **Edit** (編輯)。

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

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

### 使用 新增 AWS CLI
<a name="custom-tags-add-tags-cli"></a>

 啟用自訂標籤傳播之後，您可以在建立或更新期間， 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](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AddTags.html) API 來新增現有網域、使用者設定檔和空間的自訂標籤，如下所示。

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