本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
標記連線資源
標籤是您或 AWS 指派給 AWS 資源的自訂屬性標籤。每個 AWS 標籤有兩個部分:
-
標籤鍵 (例如,
CostCenter
、Environment
或Project
)。標籤鍵會區分大小寫。 -
一個名為標籤值 (例如,
111122223333
、Production
或團隊名稱) 的選用欄位。忽略標籤值基本上等同於使用空字串。與標籤鍵相同,標籤值會區分大小寫。
這些合稱為鍵值組。
您可以使用 主控台或 CLI來標記資源。
您可以在 AWS 中標記下列資源類型 CodeConnections:
-
連線
-
主機
這些步驟假設您已安裝最新版本的 AWS CLI 或已更新至目前版本。如需詳細資訊,請參閱《AWS Command Line Interface 使用者指南》中的安裝 AWS CLI。
除了使用標籤識別、組織和追蹤您的資源之外,您還可以使用 AWS Identity and Access Management (IAM) 政策中的標籤來協助控制誰可以檢視和與您的資源互動。如需以標籤為基礎的存取政策範例,請參閱使用標籤控制對 AWS CodeConnections 資源的存取。
標記資源 (主控台)
您可以使用主控台來新增、更新或移除連線資源的標籤。
將標籤新增至連線資源 (主控台)
您可以使用主控台將標籤新增到現有連線或主機。
注意
當您為 Enterprise Server 等 GitHub已安裝的提供者建立連線,而且也會為您建立主機資源時,建立期間的標籤只會新增至連線。如果您想要將標籤重複用於新連線,這可讓您分別標記主機。如果您想要將標籤新增到主機,請使用這裡說明的步驟。
為連線新增標籤
-
登入主控台。從導覽窗格中,選擇 Settings (設定)。
-
在 Settings (設定) 底下,選擇 Connections (連線)。選擇 Connections (連線) 索引標籤。
-
選擇您要編輯的連線。隨即會顯示連線設定頁面。
-
在 Connection tags (連線標籤) 底下,選擇 Edit (編輯)。隨即會顯示 Edit Connection tags (編輯連線標籤) 頁面。
-
在 Key (索引鍵) 和ValueValue (值) 欄中,在你想新增的各組標籤中輸入金鑰對。(Value (值) 欄為選用。) 例如,在 Key (索引鍵) 中輸入
Project
。在 Value (值) 中輸入ProjectA
。 -
(選用) 選擇 Add tag (新增標籤),新增更多列,然後輸入更多標籤。
-
選擇提交。標籤會列在連線設定之下。
為主機新增標籤
-
登入主控台。從導覽窗格中,選擇 Settings (設定)。
-
在 Settings (設定) 底下,選擇 Connections (連線)。選擇 Hosts (主機) 索引標籤。
-
選擇您要編輯的主機。隨即會顯示主機設定頁面。
-
在 Host tags(主機標籤) 底下,選擇 Edit (編輯)。隨即會顯示 Host tags (主機標籤) 頁面。
-
在 Key (索引鍵) 和ValueValue (值) 欄中,在你想新增的各組標籤中輸入金鑰對。(Value (值) 欄為選用。) 例如,在 Key (索引鍵) 中輸入
Project
。在 Value (值) 中輸入ProjectA
。 -
(選用) 選擇 Add tag (新增標籤),新增更多列,然後為主機輸入更多標籤。
-
選擇提交。標籤列在主機設定之下。
檢視連線資源的標籤 (主控台)
您可以使用主控台檢視現有資源的標籤。
檢視連線的標籤
-
登入主控台。從導覽窗格中,選擇 Settings (設定)。
-
在 Settings (設定) 底下,選擇 Connections (連線)。選擇 Connections (連線) 索引標籤。
-
選擇您要檢視的連線。隨即會顯示連線設定頁面。
-
在 Connection tags (連線標籤) 底下,檢視 Key (索引鍵) 和 Value (值) 欄下方的連線標籤。
檢視主機的標籤
-
登入主控台。從導覽窗格中,選擇 Settings (設定)。
-
在 Settings (設定) 底下,選擇 Connections (連線)。選擇 Hosts (主機) 索引標籤。
-
選擇您要檢視的主機。
-
在 Host tags (主機標籤) 底下,檢視 Key (索引鍵) 和 Value (值) 欄下方的主機標籤。
編輯連線資源的標籤 (主控台)
您可以使用主控台來編輯已新增到連線資源的標籤。
編輯連線的標籤
-
登入主控台。從導覽窗格中,選擇 Settings (設定)。
-
在 Settings (設定) 底下,選擇 Connections (連線)。選擇 Connections (連線) 索引標籤。
-
選擇您要編輯的連線。隨即會顯示連線設定頁面。
-
在 Connection tags (連線標籤) 底下,選擇 Edit (編輯)。隨即會顯示 Connection tags (連線標籤) 頁面。
-
在 Key (金鑰) 和 Value (加值) 欄,視需要更新每個欄位的值。例如,針對
Project
索引鍵,在 Value (值) 中將ProjectA
變為ProjectB
。 -
選擇提交。
編輯主機的標籤
-
登入主控台。從導覽窗格中,選擇 Settings (設定)。
-
在 Settings (設定) 底下,選擇 Connections (連線)。選擇 Hosts (主機) 索引標籤。
-
選擇您要編輯的主機。隨即會顯示主機設定頁面。
-
在 Host tags(主機標籤) 底下,選擇 Edit (編輯)。隨即會顯示 Host tags (主機標籤) 頁面。
-
在 Key (金鑰) 和 Value (加值) 欄,視需要更新每個欄位的值。例如,針對
Project
索引鍵,在 Value (值) 中將ProjectA
變為ProjectB
。 -
選擇提交。
移除連線資源的標籤 (主控台)
您可以使用主控台或移除連線資源的標籤。當您從關聯的資源移除標籤時,將會刪除這些標籤。
移除連線的標籤
-
登入主控台。從導覽窗格中,選擇 Settings (設定)。
-
在 Settings (設定) 底下,選擇 Connections (連線)。選擇 Connections (連線) 索引標籤。
-
選擇您要編輯的連線。隨即會顯示連線設定頁面。
-
在 Connection tags (連線標籤) 底下,選擇 Edit (編輯)。隨即會顯示 Connection tags (連線標籤) 頁面。
-
在您要刪除的金鑰和值的每個標籤旁邊,選擇 移除標籤 (Remove tag)。
-
選擇提交。
移除主機的標籤
-
登入主控台。從導覽窗格中,選擇 Settings (設定)。
-
在 Settings (設定) 底下,選擇 Connections (連線)。選擇 Hosts (主機) 索引標籤。
-
選擇您要編輯的主機。隨即會顯示主機設定頁面。
-
在 Host tags(主機標籤) 底下,選擇 Edit (編輯)。隨即會顯示 Host tags (主機標籤) 頁面。
-
在您要刪除的金鑰和值的每個標籤旁邊,選擇 移除標籤 (Remove tag)。
-
選擇提交。
標籤資源 (CLI)
您可以使用 CLI 檢視、新增、更新或移除連線資源上的標籤。
將標籤新增至連線資源 (CLI)
您可以使用 AWS CLI 來標記連線中的資源。
在終端機或命令列,執行 tag-resource命令,指定您要新增標籤的資源的 Amazon Resource Name (ARN),以及您要新增標籤的索引鍵和值。您可以新增一個以上的標籤。
為連線新增標籤
-
取得 資源ARN的 。使用 中顯示的list-connections命令列出連線來取得連線 ARN。
-
在終端機或命令列上執行 tag-resource 命令。
例如,使用下列命令來標記具有兩個標籤的連線、標籤值為
Project
的標籤金鑰ProjectA
,以及標籤值ReadOnly
為 的標籤金鑰true
。aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:
account_id
:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project
,Value=ProjectA
Key=IscontainerBased
,Value=true
若成功,此命令不會傳回任何內容。
為主機新增標籤
-
取得 資源ARN的 。使用 中顯示的list-hosts命令列出主機來取得主機 ARN。
-
在終端機或命令列上執行 tag-resource 命令。
例如,使用下列命令,將主機標記為兩個標籤、標籤值
Project
為 的標籤索引鍵ProjectA
,以及標籤值IscontainerBased
為 的標籤索引鍵true
。aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:
account_id
:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true若成功,此命令不會傳回任何內容。
檢視連線資源的標籤 (CLI)
您可以使用 AWS CLI 檢視連線資源的 AWS 標籤。若未新增標籤,傳回的清單空白。使用 list-tags-for-resource 命令檢視已新增至連線或主機的標籤。
檢視連線的標籤
-
取得 資源ARN的 。使用 中顯示的list-connections命令列出連線來取得連線 ARN。
-
在終端機或命令列上執行 list-tags-for-resource 命令。例如,使用下列命令來檢視連線的標籤索引鍵和標籤值清單。
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:
account_id
:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f這個命令會傳回與資源相關聯的標籤。這個範例會顯示針對連線傳回的兩個索引鍵值組。
{ "Tags": [ { "Key": "Project", "Value": "ProjectA" }, { "Key": "ReadOnly", "Value": "true" } ] }
檢視主機的標籤
-
取得 資源ARN的 。使用 中顯示的list-hosts命令列出主機來取得主機 ARN。
-
在終端機或命令列上執行 list-tags-for-resource 命令。例如,使用下列命令來檢視主機的標籤索引鍵和標籤值清單。
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:
account_id
:host/My-Host-28aef605這個命令會傳回與資源相關聯的標籤。此範例顯示針對主機傳回的兩個索引鍵值組。
{ "Tags": [ { "Key": "IscontainerBased", "Value": "true" }, { "Key": "Project", "Value": "ProjectA" } ] }
編輯連線資源的標籤 (CLI)
您可以使用 AWS CLI 編輯資源的標籤。您可以變更現有索引鍵的值或新增其他索引鍵。
在終端機或命令列,執行 tag-resource命令,指定您要更新標籤ARN的資源的 ,並指定要更新的標籤索引鍵和標籤值。
編輯標籤時,任何未指定的標籤索引鍵都會保留,任何項目的索引鍵都相同,但會以新值更新。使用 edit 命令新增的索引鍵會新增為一對新的鍵值組。
編輯連線的標籤
-
取得 資源ARN的 。使用 中顯示的list-connections命令列出連線來取得連線 ARN。
-
在終端機或命令列上執行 tag-resource 命令。
在這個範例中,索引鍵
Project
的數值會變更為ProjectB
。aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:
account_id
:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB若成功,此命令不會傳回任何內容。若要驗證與連線相關聯的標籤,請執行 list-tags-for-resource 命令。
編輯主機的標籤
-
取得 資源ARN的 。使用 中顯示的list-hosts命令列出主機來取得主機 ARN。
-
在終端機或命令列上執行 tag-resource 命令。
在這個範例中,索引鍵
Project
的數值會變更為ProjectB
。aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:
account_id
:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB若成功,此命令不會傳回任何內容。若要驗證與主機相關聯的標籤,請執行 list-tags-for-resource 命令。
從連線資源移除標籤 (CLI)
請依照下列步驟,使用 從資源 AWS CLI 移除標籤。當您從關聯的資源移除標籤時,將會刪除這些標籤。
注意
如果您刪除連線資源,則會從刪除的資源中移除所有標籤關聯。刪除連線資源之前,您不需要移除標籤。
在終端機或命令列,執行 untag-resource命令,指定您要移除標籤ARN的資源的 ,以及您要移除標籤的標籤索引鍵。例如,若要移除具有標籤索引鍵 Project
和 之連線上的多個標籤ReadOnly
,請使用下列命令。
aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:
account_id
:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keysProject
ReadOnly
若成功,此命令不會傳回任何內容。若要驗證與管道相關的標籤,請執行 list-tags-for-resource 命令。輸出顯示所有標籤皆已移除。
{ "Tags": [] }