

我們不再更新 Amazon Machine Learning 服務或接受新使用者。本文件可供現有使用者使用，但我們不再更新。如需詳細資訊，請參閱[什麼是 Amazon Machine Learning](https://docs.aws.amazon.com/machine-learning/latest/dg/what-is-amazon-machine-learning.html)。

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

# 標記您的 Amazon ML 物件
<a name="tagging-objects"></a>

透過使用標籤將中繼資料指派給 Amazon Machine Learning (Amazon ML) 物件，來組織和管理這些物件。*「標籤」*是您針對物件所定義的索引鍵值組。

 除了使用標籤來組織和管理 Amazon ML 物件之外，您還可以使用它們來分類和追蹤您的 AWS 成本。當您將標籤套用至 AWS 物件 (包含 ML 模型) 時，AWS 成本分配報告會包含依標籤彙總的使用情況和成本。套用代表商業類別的標籤 (例如成本中心、應用程式名稱或擁有者)，來整理多個服務中的成本。如需詳細資訊，請參閱《AWS Billing 使用者指南**》中的[將成本分配標籤用於自訂帳單報告](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。

**Topics**
+ [標籤基本概念](#tagging-basics)
+ [標籤限制](#tagging-restrictions)
+ [標記 Amazon ML 物件 （主控台）](#tagging-console)
+ [標記 Amazon ML 物件 (API)](#tagging-api)

## 標籤基本概念
<a name="tagging-basics"></a>

使用標籤分類物件，讓您更輕鬆地進行管理。例如，您可以依用途、擁有者或環境來分類物件。然後，您可以定義一組標籤，協助您依擁有者和相關聯應用程式來追蹤模型。以下是數個範例：
+ 專案：專案名稱
+ 擁有者：名稱
+ 用途：行銷預測
+ 應用程式：應用程式名稱
+ 環境：生產 

您可以使用 Amazon ML 主控台或 API 來完成下列任務：
+ 為物件新增標籤
+ 檢視物件的標籤
+ 編輯物件的標籤
+ 刪除物件的標籤

根據預設，套用至 Amazon ML 物件的標籤會複製到使用該物件建立的物件。例如，如果 Amazon Simple Storage Service (Amazon S3) 資料來源具有「行銷成本：目標行銷活動」標籤，則使用該資料來源建立的模型也會具有「行銷成本：目標行銷活動」標籤，如同模型的評估。這可讓您使用標籤來追蹤相關物件，例如用於行銷活動的所有物件。如果標籤來源之間發生衝突，例如標籤為「行銷成本：目標行銷活動」的模型，以及標籤為「行銷成本：目標行銷客戶」的資料來源，Amazon ML 會套用模型中的標籤。

## 標籤限制
<a name="tagging-restrictions"></a>

下列限制適用於標籤。

基本限制：
+ 每個物件的標籤數量上限為 50。
+ 標籤鍵與值皆區分大小寫。
+ 您無法變更或編輯已刪除物件的標籤。

標籤鍵限制：
+ 每個標籤鍵都必須是唯一的。如果您新增具有已使用鍵的標籤，則新的標籤會覆寫該物件的現有鍵值組。
+ 您無法使用 `aws:` 來啟動標籤鍵，因為此字首保留供 AWS 使用。AWS 會代表您建立開頭為此字首的標籤，但您無法編輯或刪除它們。
+ 標籤鍵的長度必須介於 1 到 128 個 Unicode 字元之間。
+ 標籤鍵必須包含下列字元：Unicode 字母、數字、空格以及下列特殊字元：`_ . / = + - @`。

標籤值限制：
+ 標籤值的長度必須介於 0 到 255 個 Unicode 字元之間。
+ 標籤值可以空白。否則，它們必須包含下列字元：Unicode 字母、數字、空格以及下列任何特殊字元：`_ . / = + - @`。

## 標記 Amazon ML 物件 （主控台）
<a name="tagging-console"></a>

您可以使用 Amazon ML 主控台檢視、新增、編輯和刪除標籤。

**檢視物件的標籤 (主控台)**

1. 登入 AWS 管理主控台 並開啟 Amazon Machine Learning 主控台，網址為 [https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/)：//。

1. 在導覽列中，展開區域選取器，然後選擇區域。

1. 在 **Objects (物件)** 頁面上，選擇任一物件。

1. 捲動至所選擇物件的 **Tags (標籤)** 區段。該物件的標籤會列在區段底部。

**將標籤新增至物件 (主控台)**

1. 登入 AWS 管理主控台 並開啟 Amazon Machine Learning 主控台，網址為 [https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/)：//。

1. 在導覽列中，展開區域選取器，然後選擇區域。

1. 在 **Objects (物件)** 頁面上，選擇任一物件。

1. 捲動至所選擇物件的 **Tags (標籤)** 區段。該物件的標籤會列在區段底部。

1. 選擇 **Add or edit tags (新增或編輯標籤)**。

1. 在 **Add Tag (新增標籤)** 的 **Key (索引鍵)** 欄位內指定標籤鍵，(選用) 在 **Value** (值) 欄位內指定標籤值，然後選擇 **Apply changes (套用變更)**。

   如果 **Apply changes (套用變更)** 按鈕未啟用，表示您所指定的標籤鍵或標籤值不符合標籤限制。如需詳細資訊，請參閱[標籤限制](#tagging-restrictions)。

1. 重新整理頁面，即可在 **Tags (標籤)** 區段的清單中看到新標籤。

**編輯標籤 (主控台)**

1. 登入 AWS 管理主控台 並開啟 Amazon Machine Learning 主控台，網址為 [https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/)：//。

1. 在導覽列中，展開區域選取器，然後選取區域。

1. 在 **Objects (物件)** 頁面上，選擇任一物件。

1. 捲動至所選擇物件的 **Tags (標籤)** 區段。該物件的標籤會列在區段底部。

1. 選擇 **Add or edit tags (新增或編輯標籤)**。

1. 在 **Applied tags (已套用標籤)** 下編輯 **Value** (值) 欄位內的標籤值，然後選擇 **Apply changes (套用變更)**。

   如果 **Apply changes (套用變更)** 按鈕未啟用，表示您所指定的標籤值不符合標籤限制。如需詳細資訊，請參閱[標籤限制](#tagging-restrictions)。

1. 重新整理頁面，即可在 **Tags (標籤)** 區段的清單中看到已更新的標籤。

**刪除物件中的標籤 (主控台)**

1. 登入 AWS 管理主控台 並開啟 Amazon Machine Learning 主控台，網址為 [https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/)：//。

1. 在導覽列中，展開區域選取器，然後選擇區域。

1. 在 **Objects (物件)** 頁面上，選擇任一物件。

1. 捲動至所選擇物件的 **Tags (標籤)** 區段。該物件的標籤會列在區段底部。

1. 選擇 **Add or edit tags (新增或編輯標籤)**。

1. 在 **Applied tags (已套用標籤)** 下選擇您想要刪除的標籤，然後選擇 **Apply changes (套用變更)**。

## 標記 Amazon ML 物件 (API)
<a name="tagging-api"></a>

您可以使用 Amazon ML API 新增、列出和刪除標籤。如需範例，請參閱下列文件：

 [AddTags](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_AddTags.html)   
新增或編輯所指定物件的標籤。

 [DescribeTags](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DescribeTags.html)  
列出所指定物件的標籤。

 [DeleteTags](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DeleteTags.html)  
刪除所指定物件中的標籤。