

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 マネジメントコンソール し、[https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/) で Amazon Machine Learning コンソールを開きます。

1. ナビゲーションバーで、リージョンセレクターを展開し、リージョンを選択します。

1. [**オブジェクト**] ページで、オブジェクトを選択します。

1. 選択したオブジェクトの [**タグ**] セクションにスクロールします。そのオブジェクトのタグは、セクションの下部に一覧表示されます。

**オブジェクトにタグを追加するには (コンソール)**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/) で Amazon Machine Learning コンソールを開きます。

1. ナビゲーションバーで、リージョンセレクターを展開し、リージョンを選択します。

1. [**オブジェクト**] ページで、オブジェクトを選択します。

1. 選択したオブジェクトの [**タグ**] セクションにスクロールします。そのオブジェクトのタグは、セクションの下部に一覧表示されます。

1. [**タグの追加または編集**] を選択します。

1. [**タグの追加**] で [**キー**] フィールドにタグキーを指定して、オプションで [**値**] フィールドにタグ値を指定し、[**変更の適用**] を選択します。

   [**変更の適用**] ボタンが有効でない場合は、指定したタグキーまたはタグ値のいずれかがタグの制限を満たしていません。詳細については、「[タグの制限](#tagging-restrictions)」を参照してください。

1. [**タグ**] セクションのリストに新しいタグを表示するには、ページを更新します。

**タグを編集するには (コンソール)**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/) で Amazon Machine Learning コンソールを開きます。

1. ナビゲーションバーで、リージョンセレクターを展開し、リージョンを選択します。

1. [**オブジェクト**] ページで、オブジェクトを選択します。

1. 選択したオブジェクトの [**タグ**] セクションにスクロールします。そのオブジェクトのタグは、セクションの下部に一覧表示されます。

1. [**タグの追加または編集**] を選択します。

1. [**適用したタグ**] で、[**値**] フィールドでタグ値を編集し、[**変更の適用**] を選択します。

   [**適用の変更**] ボタンが有効でない場合は、指定したタグ値がタグの制限を満たしていません。詳細については、「[タグの制限](#tagging-restrictions)」を参照してください。

1. [**タグ**] セクションのリストに更新されたタグを表示するには、ページを更新します。

**オブジェクトからタグを削除するには (コンソール)**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/) で Amazon Machine Learning コンソールを開きます。

1. ナビゲーションバーで、リージョンセレクターを展開し、リージョンを選択します。

1. [**オブジェクト**] ページで、オブジェクトを選択します。

1. 選択したオブジェクトの [**タグ**] セクションにスクロールします。そのオブジェクトのタグは、セクションの下部に一覧表示されます。

1. [**タグの追加または編集**] を選択します。

1. [**適用した変更**] で、削除するタグを選択し、[**変更の適用**] を選択します。

## 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)  
指定されたオブジェクトからタグを削除します。