AWS Proton資源和標記 - AWS Proton

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

AWS Proton資源和標記

AWS Proton指派 Amazon 資源名稱 (ARN) 的資源包括環境範本及其主要和次要版本、服務範本及其主要和次要版本、環境、服務執行個體、元件和存放庫。您可以標記這些資源,協助您整理和識別這些資源。您可使用標籤來依照用途、擁有者、環境或其他條件分類資源。如需詳細資訊,請參閱 標記策略。若要追蹤和管理您的AWS Proton資源時,您可以使用標記功能,如下列各節所述。

AWS標記

您可以用標籤的形式將中繼資料指派給 AWS 資源。每個標籤皆包含客戶定義的金鑰和選用值。標籤可協助您管理、識別、組織、搜尋及篩選資源。

重要

請勿在標籤中加入個人識別資訊 (PII) 或其他機密或敏感資訊。許多人都可以存取標籤AWS 服務,包括帳單。標籤不適用於私人或敏感資料。

每個標籤都有兩個部分。

  • 標籤鍵 (例如 CostCenterEnvironmentProject)。標籤鍵會區分大小寫。

  • 標籤值 (選用) (例如,111122223333或者Production。與標籤鍵相同,標籤值會區分大小寫。

下列基本命名和使用需求適用於標籤。

  • 每個資源最多可以有 50 個使用者建立的標籤。

    注意

    系統建立的標籤開頭為aws:前綴保留AWS使用,且不會計入此限制之內。您無法編輯或刪除以 aws: 字首開頭的標籤。

  • 對於每一個資源,每個標籤金鑰必須是唯一的,且每個標籤金鑰只能有一個值。

  • 在 UTF-8 中,標籤金鑰必須至少為 1 且最多為 128 個 Unicode 字元。

  • 在 UTF-8 中,標籤值必須至少為 1 且最多為 256 個 Unicode 字元。

  • 標籤中允許的字元包括:可用 UTF-8 表示的英文字母、數字、數字和空格,還有以下特殊字元:*-@。

AWS Proton標記

搭配AWS Proton,您可以使用您創建的標籤以及標籤AWS Proton會自動為您產生。

AWS Proton​ AWS受管標籤

建立時AWS Proton資源,AWS Proton自動產生AWS受管標記為您的新資源,如下圖所示。AWS受管理的標籤稍後會傳播至其他AWS Proton以新資源為基礎的資源。例如,環境範本中的受管理標籤會傳播至其版本,而受管理標籤則會從服務傳播至其服務執行個體。

注意

AWS受管標籤不是為環境帳戶連接生成。如需詳細資訊,請參閱 環境帳戶連線


          描述的圖表AWS受管標籤傳播。

如果佈建的資源 (例如在服務和環境範本中定義的資源),則支援AWS標記,AWS受管理標籤會以客戶管理標籤的形式傳播至佈建的資源。這些標籤不會傳播到不支援的已佈建資源AWS標記。

注意

對於使用自我管理佈建的環境,不會對已佈建資源進行標記傳播。如需詳細資訊,請參閱 自我管理佈建的運作

AWS Proton將標籤套用至您的資源AWS Proton帳戶、註冊範本和已部署的環境,以及服務和服務執行個體,如下表所述。您可以使用AWS用於查看和管理您的託管標籤AWS Proton資源,但您無法修改它們。

AWS受管標籤金鑰 傳播的客戶受管金鑰 描述

aws:proton:account

proton:account

所以此AWS建立和部署的帳戶AWS Proton的費用。

aws:proton:template

proton:template

所選範本的 ARN。

aws:proton:environment

proton:environment

所選環境的 ARN。

aws:proton:service

proton:service

所選服務的 ARN。

aws:proton:service-instance

proton:service-instance

所選服務執行處理的 ARN。

aws:proton:component

proton:component

所選元件的 ARN。

以下是的範例AWS受管理的標籤AWS Proton資源。

"aws:proton:template" = "arn:aws:proton:region-id:account-id:environment-template/env-template"

以下範例,說明客戶受管標籤套用至已佈建資源 (從傳播的資源)AWS受管標籤。

"proton:environment:database" = "arn:aws:proton:region-id:account-id:rds/env-db"

客戶受管標籤

EACHAWS Proton資源的配額上限為 50 個客戶管理的標籤。客戶管理的標籤會傳播至子系AWS Proton資源以相同的方式AWS託管標籤可以,除非它們不傳播到現有標籤AWS Proton資源或佈建資源。如果您將新標籤套用至AWS Proton具有現有子資源的資源,並且您希望現有的子資源用新標籤標記,您需要使用控制台或手動標記每個現有的子資源AWS CLI。

透過主控台和 CLI 建立標記

建立時AWS Proton使用主控台的資源,您可以在建立程序的第一頁或第二頁上建立客戶管理的標籤,如下列主控台快照集所示。選擇新增標籤」,進入金鑰和值,然後繼續。


          控制台創建標籤界面的快照。

使用建立新的資源之後AWS Proton控制台,您可以查看它的列表AWS詳細資訊頁面中的受管理和客戶管理標籤。

建立或編輯標籤

  1. 在 中AWS Proton安慰,開啟AWS Proton資源詳細信息頁面,您可以在其中查看標籤列表。

  2. 選擇 Manage tags (管理標籤)

  3. 在 中管理標籤頁面,您可以查看、建立、移除和編輯標籤。您無法修改AWS列在頂端的受管理標籤。不過,您可以使用編輯欄位新增和修改客戶管理的標籤,列在AWS受管標籤。

    選擇新增標籤建立新的標籤。

  4. 為新標籤輸入金鑰和值。

  5. 若要編輯標籤,請在所選鍵的標籤值欄位中輸入值。

  6. 刪除標籤請選擇Remove (移除)用於選取的標籤。

  7. 完成變更後,請選擇儲存變更

透過建立標籤AWS Proton​ AWS CLI

您可以使用檢視、建立、移除和編輯標籤AWS Proton AWS CLI。

您可以建立或編輯資源的標籤,如下列範圍所示。

$ aws proton tag-resource \ --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \ --tags '[{"key":"mykey1","value":"myval1"},{"key":"mykey2","value":"myval2"}]'

您可以移除資源的標記,如下一個範例所示。

$ aws proton untag-resource \ --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \ --tag-keys '["mykey1","mykey2"]'

您可以列出資源的標籤,如最後一個範例所示。

$ aws proton list-tags-for-resource \ --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice"