eb tags

描述

新增、刪除、更新和列出 Elastic Beanstalk 資源的標籤。

如需 Elastic Beanstalk 中資源標記的詳細資訊，請參閱標記 Elastic Beanstalk 應用程式資源。

語法

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) 指定資源。

選項

這些選項均非必要。若您不帶任何選項執行 eb create，將提示您輸入或選取每個設定的值。

名稱	描述
-l 或 --list	列出目前套用至資源的所有標籤。
-a key1=value1[,key2=value2 ...] 或 --add key1=value1[,key2=value2 ...]	將新標籤套用至資源。將標籤指定為以逗號分隔的 key=value 對清單。您無法指定現有標籤的金鑰。 有效值：請參閱 標記 資源。
-u key1=value1[,key2=value2 ...] 或 --update key1=value1[,key2=value2 ...]	更新現有資源標籤的值。將標籤指定為以逗號分隔的 key=value 對清單。您必須指定現有標籤的金鑰。 有效值：請參閱 標記 資源。
-d key1[,key2 ...] 或 --delete key1[,key2 ...]	刪除現有的資源標籤。將標籤指定為以逗號分隔的金鑰清單。您必須指定現有標籤的金鑰。 有效值：請參閱 標記 資源。
-r 區域 或 --region 區域	您的資源所在的 AWS 區域。 預設值：設定的預設區域。 如需可以為此選項指定的值之清單，請參閱《AWS 一般參考》中的AWS Elastic Beanstalk 端點與配額。
--resource ARN	命令修改或列出標籤之資源的 ARN。如果未指定，此命令是指目錄中的應用程式的 (預設或指定) 環境。 有效值：請參閱 標記 資源 中您感興趣的特定資源的其中一個子主題。這些主題會說明資源的 ARN 的建構方式，並說明如何取得存在可供您的應用程式或帳戶使用的此資源 ARN 的清單。

輸出

--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

範例

以下命令會成功將具有索引鍵 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.