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

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

## Description
<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` 子命令選項結合為單一命令，至少需要其中一個選項。這三個子命令選項的任何一個均無法與 `--list` 結合使用。

如果沒有任何額外的引數，所有這些命令會列出或修改目前目錄的應用程式中預設環境的標籤。使用 {{environment-name}} 引數，此命令會列出或修改該環境的標籤。使用 `--resource` 選項，此命令會列出或修改任何 Elastic Beanstalk 資源 - 應用程式、環境、應用程式版本、已儲存的組態，或自訂平台版本的標籤。透過其 Amazon Resource Name (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` {{區域}}<br />或<br />`--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.
```