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

# **eb tags**
<a name="eb3-tags"></a>

## 説明
<a name="eb3-tagsdescription"></a>

Elastic Beanstalk リソースのタグを追加、削除、更新、一覧表示します。

Elastic Beanstalk でのリソースへのタグ付けの詳細については、「[Elastic Beanstalk アプリケーションリソースのタグ付け](applications-tagging-resources.md)」を参照してください。

## 構文
<a name="eb3-tagsyntax"></a>

**eb tags [{{environment-name}}] [--resource {{ARN}}] -l \| --list**

**eb tags [{{environment-name}}] [--resource {{ARN}}] -a \| --add {{key1}}={{value1}}[,{{key2}}={{value2}} ...]**

**eb tags [{{environment-name}}] [--resource {{ARN}}] -u \| --update {{key1}}={{value1}}[,{{key2}}={{value2}} ...]**

**eb tags [{{environment-name}}] [--resource {{ARN}}] -d \| --delete {{key1}}[,{{key2}} ...]**

`--add`、`--update`、`--delete` のサブコマンドオプションは、1 つのコマンドで組み合わせることができます。少なくとも 1 つのサブコマンドオプションが必要です。これらの 3 つのサブコマンドオプションを `--list` で組み合わせることはできません。

追加の引数を指定しない場合、これらすべてのコマンドは、現在のディレクトリのアプリケーションでデフォルト環境のタグを一覧表示または変更します。{{environment-name}} 引数を使用すると、コマンドはその環境のタグを一覧表示または変更します。`--resource` オプションを使用すると、コマンドは任意の Elastic Beanstalk リソース (アプリケーション、環境、アプリケーションバージョン、保存された設定、またはカスタムプラットフォームバージョン) のタグを一覧表示または変更します。リソースを Amazon リソースネーム (ARN) で指定します。

## オプション
<a name="eb3-tagsoptions"></a>

これらのオプションはいずれも必須ではありません。オプションを使用せずに **eb create** を実行すると、各設定の値を入力または選択するよう求められます。


****  

|  名前  |  説明  | 
| --- | --- | 
| `-l`<br />または<br />`--list` | リソースに現在適用されているすべてのタグを一覧表示します。 | 
| `-a {{key1}}={{value1}}[,{{key2}}={{value2}} ...]`<br />または<br />`--add {{key1}}={{value1}}[,{{key2}}={{value2}} ...]` | リソースに新しいタグを適用します。`key=value` ペアのカンマ区切りリストとしてタグを指定します。既存のタグのキーを指定することはできません。<br />有効な値: 「[ リソースのタグ付け](applications-tagging-resources.md)」を参照。 | 
| `-u {{key1}}={{value1}}[,{{key2}}={{value2}} ...]`<br />または<br />`--update {{key1}}={{value1}}[,{{key2}}={{value2}} ...]` | 既存のリソースタグの値を更新します。`key=value` ペアのカンマ区切りリストとしてタグを指定します。既存のタグのキーを指定する必要があります。<br />有効な値: 「[ リソースのタグ付け](applications-tagging-resources.md)」を参照。 | 
| `-d {{key1}}[,{{key2}} ...]`<br />または<br />`--delete {{key1}}[,{{key2}} ...]` | 既存のリソースタグを削除します。キーのカンマ区切りリストとしてタグを指定します。既存のタグのキーを指定する必要があります。<br />有効な値: 「[ リソースのタグ付け](applications-tagging-resources.md)」を参照。 | 
| `-r` {{region}}<br />または<br />`--region` {{region}} | リソースが存在する AWS リージョン 。<br />デフォルト: 設定されたデフォルトリージョン。<br />このオプションに指定できる値のリストについては、「AWS 全般のリファレンス」の「[AWS Elastic Beanstalk エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html)」を参照してください。 | 
| `--resource {{ARN}}` | コマンドでタグを変更または一覧表示するリソースの ARN。指定しない場合、コマンドは現在のディレクトリのアプリケーションにおける (デフォルトまたは指定された) 環境を参照します。<br />有効な値については、該当するリソース別の [ リソースのタグ付け](applications-tagging-resources.md) のサブトピックを参照してください。これらのトピックでは、リソースの ARN の構築方法を示し、該当するリソースの ARN のリストをアプリケーションまたはアカウントで取得する方法について説明しています。 | 

## Output
<a name="eb3-tagsoutput"></a>

`--list` サブコマンドオプションは、リソースのタグを一覧表示します。出力には、Elastic Beanstalk でデフォルトで適用するタグとカスタムタグの両方が表示されます。

```
$ eb tags --list
Showing tags for environment 'MyApp-env':

Key                                 Value

Name                                MyApp-env
elasticbeanstalk:environment-id     e-63cmxwjaut
elasticbeanstalk:environment-name   MyApp-env
mytag                               tagvalue
tag2                                2nd value
```

成功した場合、`--add`、`--update`、`--delete` のサブコマンドオプションには出力されません。コマンドのアクティビティの詳細な出力を表示するには、`--verbose` オプションを追加します。

```
$ eb tags --verbose --update "mytag=tag value"
Updated Tags:

Key                                 Value

mytag                               tag value
```

## 例
<a name="eb3-tagsexamples"></a>

次のコマンドは、キー `tag1` と値 `value1` を使用するタグをアプリケーションのデフォルト環境に正常に追加し、同時にタグ `tag2` を削除します。

```
$ eb tags --add tag1=value1 --delete tag2
```

次のコマンドは、アプリケーション内の保存された設定にタグを正常に追加します。

```
$ eb tags --add tag1=value1 \
      --resource "arn:aws:elasticbeanstalk:us-east-2:{{my-account-id}}:configurationtemplate/{{my-app}}/{{my-template}}"
```

次のコマンドは、存在しないタグを更新しようとしているため失敗します。

```
$ eb tags --update tag3=newval
ERROR: Tags with the following keys can't be updated because they don't exist:

  tag3
```

次のコマンドは、同じキーを更新しようとしているため失敗します。

```
$ eb tags --update mytag=newval --delete mytag
ERROR: A tag with the key 'mytag' is specified for both '--delete' and '--update'. Each tag can be either deleted or updated in a single operation.
```