eb tags - AWS Elastic Beanstalk

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

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.