翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon WorkSpaces アプリケーションリソースのタグ付け
<a name="tagging-basic"></a>

AWS を使用すると、タグの形式で AWS リソースにメタデータを割り当てることができます。これらのタグを使用して、WorkSpaces Applications イメージビルダー、イメージ、フリート、スタックを管理し、請求データを含むデータを整理できます。

以下の操作を実行できます。
+ リソースを (目的、所有者、環境など) さまざまな方法で論理的にグループ化することができます。

  これは、同じ種類のリソースが多い場合に役立ちます。
+ リソースに割り当てたタグに基づいて特定のリソースをすばやく特定します。
+  AWS コストの特定と管理

たとえば、異なる環境 (開発や本番など) にある WorkSpaces アプリケーションフリートや、異なるビジネスユニット (人事やマーケティングなど) に割り当てられた WorkSpaces アプリケーションフリートを特定してグループ化できます。その後、これらのフリートの関連 AWS コストを詳細レベルで追跡できます。そのためには、サインアップして、タグキー値が含まれたアマゾン ウェブ サービスアカウントの請求書を取得する必要があります。タグによるコスト配分レポートの設定の詳細については、*AWS Billing ユーザーガイド*の「[コスト配分月次レポート](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html)」を参照してください。

**Topics**
+ [タグ付けの基本](tagging-introduction.md)
+ [タグの制限](tag-restrictions.md)
+ [リソース作成中のタグの追加](basic-tagging-resource-creation-console.md)
+ [タグの追加、編集、削除](basic-tagging-console.md)
+ [API、SDK、または CLI の使用](basic-tagging-API-SDK-CLI.md)

# Amazon WorkSpaces アプリケーションのタグ付けの基本
<a name="tagging-introduction"></a>

タグは、他の AWS サービスタグと同様に、キーと値のペアで構成されます。リソースにタグを付けるには、各タグの*キー*と*値*を指定します。キーは、「プロジェクト」、「所有者」、「環境」など一般的なカテゴリとすることができ、特定の値を指定できます。また、複数のリソース間で同じキーと値を共有できます。WorkSpaces Applications リソースは、作成後すぐにタグ付けすることも、後でタグ付けすることもできます。リソースを削除すると、そのリソースからタグが削除されます。ただし、同じタグキーを持つ他の WorkSpaces アプリケーションと AWS リソースは影響を受けません。

タグキーと値は編集でき、リソースからタグはいつでも削除できます。タグの値を空の文字列に設定することはできますが、タグの名前を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、以前の値は新しい値によって上書きされます。リソースを削除すると、リソースのタグもすべて削除されます。

**注記**  
WorkSpaces Applications リソースの AWS コストを追跡するために毎月のコスト配分レポートを設定する場合は、既存の WorkSpaces Applications リソースに追加されたタグが、その月に更新されたリソースの翌月の最初のコスト配分レポートに表示されることに注意してください。

# Amazon WorkSpaces アプリケーションのタグ制限
<a name="tag-restrictions"></a>
+ WorkSpaces Applications リソースあたりのタグの最大数は 50 です。
+ キーの最大長は UTF-8 で 128 Unicode 文字です。
+ 値の最大長は UTF-8 で 256 Unicode 文字です。
+ タグキーと値は大文字と小文字が区別されます。
+ タグ名または値に「aws:」プレフィックスを使用しないでください。これは AWS 、使用のために予約されているシステムタグです。このプレフィックスが含まれるタグの名前や値は編集または削除できません。このプレフィックスを持つタグは、リソースあたりのタグ数の制限には計算されません。
+ 通常使用できる文字は、UTF-8 で表現できる文字、数字、およびスペースと、特殊文字 \$1、-、=、.、\$1、:、/、@ です。
+ 同じキーと値を複数のリソースで共有できますが、同じリソースで重複したキーを持つことはできません。
+ リソースの作成中にリソースのタグを追加できます。作成済みのリソースのタグを追加、編集、削除することもできます。

# Amazon WorkSpaces アプリケーションコンソールでのリソース作成中のタグの追加
<a name="basic-tagging-resource-creation-console"></a>

WorkSpaces アプリケーションコンソールでリソースを作成するときに、1 つ以上のタグを追加してリソースを管理できます。詳細については、以下の各トピックを参照してください。
+ Image builders — [Image Builder を起動し、ストリーミングアプリケーションをインストールして設定する](tutorial-image-builder-create.md)、ステップ 4
+ イメージ — [ステップ 6: イメージの作成を完了する](tutorial-image-builder.md#tutorial-image-builder-finish-create-image)、ステップ 1
+ フリート — [Amazon WorkSpaces アプリケーションでフリートを作成する](set-up-stacks-fleets-create.md)、ステップ 3
+ スタック — [Amazon WorkSpaces アプリケーションでスタックを作成する](set-up-stacks-fleets-install.md)、ステップ 2

# Amazon WorkSpaces アプリケーションコンソールでの既存のリソースのタグの追加、編集、削除
<a name="basic-tagging-console"></a>

WorkSpaces アプリケーションコンソールを使用して、既存のリソースのタグを追加、編集、削除できます。

**既存の WorkSpaces Applications リソースのタグを追加、編集、または削除するには**

1. [https://console.aws.amazon.com/appstream2/home](https://console.aws.amazon.com/appstream2/home) で WorkSpaces アプリケーションコンソールを開きます。

1. ナビゲーションバーから、タグを追加、編集、または削除するリソースを含むリージョンを選択します。

1. ナビゲーションペインで、リソースタイプを選択します。リソースタイプは、Image Builder、イメージ、フリート、またはスタックとすることができます。

1. リソースリストからリソースを選択します。

1. [**Tags**]、[**Add/Edit Tags**] を選択し、次のうち 1 つ以上を実行します。
   + タグを追加するには、[**Add Tag (タグを追加)**] を選択し、各タグのキーと値を入力します。
   + タグを編集するには、必要に応じて、タグのキーと値を変更します。
   + タグを削除するには、タグの **Delete (削除)** アイコン (X) を選択します。

1. **[保存]** を選択します。

# Amazon WorkSpaces アプリケーション API、 AWS SDK、または AWS CLI を使用したタグの操作
<a name="basic-tagging-API-SDK-CLI"></a>

WorkSpaces アプリケーション API、 AWS SDK、または AWS コマンドラインインターフェイス (AWS CLI) を使用している場合は、 `tags`パラメータで次の WorkSpaces アプリケーションオペレーションを使用して、新しいリソースを作成するときにタグを追加できます。

**注記**  
タグのキーと値にはスペースを使用できます。 AWS CLI を使用するときにスペースを指定するには、「\$1s」を使用します (引用符なし）。


| タスク | AWS CLI | API 操作 | 
| --- | --- | --- | 
| 新しいフリートに 1 つ以上のタグを追加する | [create-fleet](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-fleet.html)  |  [CreateFleet](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateFleet.html#AppStream2-CreateFleet-request-Tags)  | 
| 新しいイメージビルダーに 1 つ以上のタグを追加する | [create-imagebuilder](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-imagebuilder.html) |  [CreateImageBuilder](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateImageBuilder.html#AppStream2-CreateImageBuilder-request-Tags)  | 
| 新しいスタックに 1 つ以上のタグを追加する |  [create-stack](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-stack.html)  |  [CreateStack](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStack.html#AppStream2-CreateStack-request-Tags)  | 

次の WorkSpaces アプリケーションオペレーションを使用して、既存のリソースのタグを追加、編集、削除、または一覧表示できます。


| タスク | AWS CLI | API 操作 | 
| --- | --- | --- | 
| リソースの 1 つ以上のタグを追加または上書きする | [タグリソース](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html)  |  [TagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_TagResource.html)  | 
| リソースの 1 つ以上のタグを削除する | [タグなしリソース](https://docs.aws.amazon.com/cli/latest/reference/appstream/untag-resource.html)  |  [UntagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_UntagResource.html)  | 
| リソースの 1 つ以上のタグを一覧表示する |  [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/list-tags-for-resource.html)  |  [ListTagsForResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_ListTagsForResource.html)  | 

WorkSpaces Applications API、 AWS SDK、または CLI AWS アクションを使用して既存の WorkSpaces Applications リソースのタグを追加、編集、削除、または一覧表示する場合は、Amazon リソースネーム (ARN) を使用してリソースを指定します。ARN は AWS リソースを一意に識別し、次の一般的な構文を使用します。

```
arn:aws:appstream:region:account:resourceType/resourceName
```

***region***  
リソースが作成された AWS リージョン ( など`us-east-1`)。

***アカウント***  
 AWS アカウント ID。ハイフンなし (例: `123456789012`)。

***resourceType***  
リソースのタイプ。、`image-builder`、`image`、`fleet`および の WorkSpaces Applications リソースタイプにタグを付けることができます`stack`。

***resourceName***  
リソースの名前。

たとえば、CLI [describe-fleets ](https://docs.aws.amazon.com/cli/latest/reference/appstream/describe-fleets.html)コマンドを使用して WorkSpaces アプリケーションフリートの ARN AWS を取得できます。次の コマンドをコピーします。

```
aws appstream describe-fleets
```

`TestFleet` という名前の単一のフリートを含む環境の場合、このリソースの ARN は、次のような JSON 出力に表示されます。

```
"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"
```

このリソースの ARN を取得した後、[tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html) コマンドを使用して 2 つのタグを追加できます。

```
aws appstream tag-resource --resource arn:awsappstream:us-east-1:123456789012:fleet/TestFleet --tags Environment=Test,Department=IT
```

最初のタグ `Environment=Test` は、フリートがテスト環境であることを示します。2 番目のタグ `Department=IT` は、フリートが IT 部門に属していることを示します。

次のコマンドを使用して、フリートに追加した 2 つのタグをリストできます。

```
aws appstream list-tags-for-resource --resource arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet
```

この例の JSON 出力は次のとおりです。

```
{
    "Tags": {
       "Environment" : "Test",
       "Department" : "IT"
    }
}
```