翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS Batch リソースのタグ付け
AWS Batch リソースを管理しやすくするために、*タグ*形式で各リソースに独自のメタデータを割り当てることができます。ここではタグとその作成方法について説明します。
**Topics**
+ [タグの基本](tag-basics.md)
+ [リソースのタグ付け](tag-resources.md)
+ [タグの制限](tag-restrictions.md)
+ [チュートリアル: コンソールを使用してタグを管理する](tag-resources-console.md)
+ [CLI または API を使用してタグを管理する](tag-resources-api-sdk.md)
# タグの基本
タグとはAWS リソースに割り当てるラベルです。タグはそれぞれ、1 つの*キー*とオプションの 1 つの*値*で構成されており、どちらもお客様側が定義します。
タグを使用すると、AWS リソースを目的、所有者、環境などで分類できます。同じ型のリソースが多い場合に、割り当てたタグに基づいて特定のリソースをすばやく識別できます。たとえば、AWS Batch サービスに一連のタグを定義して、各サービスの所有者とスタックレベルを追跡できます。リソースタイプごとに一貫した一連のタグキーを考案することをお勧めします。
タグは自動的にはリソースに割り当てられません。タグを追加したら、いつでもタグキーと値は編集でき、タグはリソースからいつでも削除できます。リソースを削除すると、リソースのタグも削除されます。
タグには、AWS Batch に関連する意味はなく、完全に文字列として解釈されます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、以前の値は新しい値によって上書きされます。
AWS マネジメントコンソール、AWS CLI、および AWS Batch API を使用してタグを操作できます。
AWS Identity and Access Management (IAM) を使用している場合はタグを作成、編集、削除する許可を持つ AWS アカウントのユーザーを制御できます。
# リソースのタグ付け
新規または既存のAWS Batch コンピューティング環境、ジョブ、ジョブ定義、ジョブキュー、スケジューリングポリシーのタグをつけることができます。
AWS Batch コンソールを使用している場合、新規リソースには作成時にタグを適用でき、既存のリソースには関連するリソースページの **Tags]** (タグ) タブを使用していつでもタグを適用できます。
AWS Batch API、AWS CLI、または AWS SDK を使用している場合、新しいリソースには、関連する API アクションの `tags` パラメータを使用してタグを適用でき、既存のリソースには、`TagResource` API アクションを使用してタグを適用できます。詳細については、「[TagResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_TagResource.html)」を参照してください。
リソース作成アクションによっては、リソースの作成時にリソースのタグを指定できます。リソースの作成時にタグを適用できない場合、リソースの作成プロセスは失敗します。これにより、作成時にタグ付けするリソースが、指定したタグで作成されるか、まったく作成されないことが確認されます。作成時にリソースにタグを付ける場合、リソースの作成後にカスタムのタグ付けスクリプトを実行する必要はありません。
次の表では、タグ付け可能な AWS Batch リソースと、作成時にタグ付け可能なリソースについて説明します。
**AWS Batch リソースのタグのサポート**
| リソース | タグをサポート | タグの伝播をサポート | 作成時のタグ付けをサポート (AWS Batch API、AWS CLI、AWS SDK) |
| --- | --- | --- | --- |
| AWS Batch コンピューティング環境 | はい | いいえ。 コンピューティング環境タグは、他のリソースには伝播されません。リソースのタグは、[CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html) API オペレーションで渡される computeResources オブジェクトの tags メンバーで指定されます。 | はい |
| AWS Batch ジョブ | 可能 | あり | はい |
| AWS Batchジョブ定義 | はい | なし | はい |
| AWS Batchジョブキュー | はい | なし | はい |
| AWS Batchスケジューリングポリシー | はい | なし | はい |
# タグの制限
タグには以下のような基本制限があります。
+ リソースあたりのタグの最大数 - 50 件
+ タグキーはリソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。
+ キーの最大長 - UTF-8 の 128 Unicode 文字
+ 値の最大長 - UTF-8 の 256 Unicode 文字
+ 複数の AWS サービス間およびリソース間でタグ付けスキーマを使用する場合、他のサービスでも許可される文字に制限が適用されることがあるのでご注意ください。一般的に使用が許可される文字は、UTF-8 で表現できる文字、数字、スペース、および \$1、-、=、.、\$1、:、/、@。
+ タグのキーと値では、大文字と小文字が区別されます。
+ `aws:`、`AWS:`、またはその大文字または小文字の組み合わせを、キーまたは値のプレフィックスとして使用しないでください。これらの文字列は AWS による使用のために予約されています。このプレフィックスを持つタグのキーや値を編集または削除することはできません。このプレフィックスを持つタグは、リソースごとのタグ数の制限にはカウントされません。
# チュートリアル: コンソールを使用してタグを管理する
AWS Batch コンソールを使用して、新規または既存のコンピューティング環境、ジョブ、ジョブ定義、ジョブキューに関連付けられたタグを管理できます。
## 作成時に個々のリソースにタグを追加する
AWS Batch コンピューティング環境、ジョブ、ジョブ定義、ジョブキュー、スケジューリングポリシーの作成時にタグを追加できます。
## 個々のリソースのタグの追加および削除
AWS Batch では、リソースのページから直接クラスターに関連付けられたタグを追加または削除できます。
**個々のリソースのタグを追加または削除するには**
1. [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/) で AWS Batch コンソールを開きます。
1. ナビゲーションバーから、使用するリージョンを選択します。
1. ナビゲーションペインでリソースタイプ (例: **ジョブキュー**) を選択します。
1. 特定のリソースを選択し、**Edit tags]** (タグの編集) を選択します。
1. 必要に応じてタグを追加または削除します。
+ タグを追加するには — リストの末尾にある空のテキストボックスにキーと値を指定します。
+ タグを削除するには — タグの横にある ![\[\]](http://docs.aws.amazon.com/ja_jp/batch/latest/userguide/images/DeleteIcon.png) ボタンを選択します。
1. 追加または削除するタグごとにこのプロセスを繰り返し、**Edit tags]** (タグの編集) を選択して終了します。
# CLI または API を使用してタグを管理する
リソースのタグの追加、更新、リスト表示、および削除には、次の AWS CLI コマンドまたは AWS Batch API オペレーションを使用します。
**AWS Batch リソースのタグのサポート**
| タスク | API アクション | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| 1 つ以上のタグを追加、または上書きします。 | [TagResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_TagResource.html) | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/tag-resource.html) | [追加-BATResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Add-BATResourceTag.html) |
| 1 つ以上のタグを削除します。 | [UntagResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_UntagResource.html) | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/untag-resource.html) | [削除-BATResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-BATResourceTag.html) |
| リソースのタグの一覧表示 | [ListTagsForResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_ListTagsForResource.html) | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/list-tags-for-resource.html) | [Get-BATResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-BATResourceTag.html) |
以下の例では、AWS CLI を使用して、リソースに対してタグ付けまたはタグ削除する方法を示しています。
**例 1: 既存のリソースにタグ付けする**
次のコマンドでは、既存のリソースにタグ付けします。
```
aws batch tag-resource --resource-arn resource_ARN --tags team=devs
```
**例 2: 既存のリソースからタグを削除する**
次のコマンドでは、既存のリソースからタグを削除します。
```
aws batch untag-resource --resource-arn resource_ARN --tag-keys tag_key
```
**例 3: リソースのタグのリスト取得**
次のコマンドは、既存のリソースに関連付けられているタグのリストを取得します。
```
aws batch list-tags-for-resource --resource-arn resource_ARN
```
一部のリソース作成アクションでは、リソースの作成時にタグを指定できます。以下のアクションでは、作成時のタグ付けがサポートされます。
| タスク | API アクション | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| コンピューティング環境の作成 | [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html) | [create-compute-environment](https://docs.aws.amazon.com/cli/latest/reference/batch/create-compute-environment.html) | [New-BATComputeEnvironment](https://docs.aws.amazon.com/powershell/latest/reference/items/New-BATComputeEnvironment.html) |
| ジョブキューの作成 | [CreateJobQueue](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateJobQueue.html) | [create-job-queue](https://docs.aws.amazon.com/cli/latest/reference/batch/create-job-queue.html) | [New-BATJobQueue](https://docs.aws.amazon.com/powershell/latest/reference/items/New-BATJobQueue.html) |
| スケジューリングポリシーの作成 | [CreateSchedulingPolicy](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateSchedulingPolicy.html) | [create-scheduling-policy](https://docs.aws.amazon.com/cli/latest/reference/batch/create-scheduling-policy.html) | [New-BATSchedulingPolicy](https://docs.aws.amazon.com/powershell/latest/reference/items/New-BATSchedulingPolicy.html) |
| ジョブ定義を登録する | [RegisterJobDefinition](https://docs.aws.amazon.com/batch/latest/APIReference/API_RegisterJobDefinition.html) | [register-job-definition](https://docs.aws.amazon.com/cli/latest/reference/batch/register-job-definition.html) | [Register-BATJobDefinition](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-BATJobDefinition.html) |
| ジョブを送信する | [SubmitJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html) | [submit-job](https://docs.aws.amazon.com/cli/latest/reference/batch/submit-job.html) | [Submit-BATJob](https://docs.aws.amazon.com/powershell/latest/reference/items/Submit-BATJob.html) |
| 消費型リソースの作成 | [CreateConsumableResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateConsumableResource.html) | [create-consumable-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/create-consumable-resource.html) | [Create-BATConsumableResource](https://docs.aws.amazon.com/powershell/latest/reference/items/Create-BATConsumableResource.html) |