CloudFormation 資源標記

使用 CloudFormation 範本中的 Tags 屬性可將標籤套用至資源，協助您識別和分類那些資源。

如需有關哪些資源支援 Tags 屬性的資訊，請參閱 AWS 資源和屬性類型參考中的個別資源。如果資源尚不支援 Tags 屬性，資源的服務可能會支援使用自己的 API 操作進行標記。如需詳細資訊，請參閱該服務的說明文件。

除了您定義的任何標籤之外，CloudFormation 會建立具有 aws: 字首的下列堆疊層級標籤：

• aws:cloudformation:logical-id

• aws:cloudformation:stack-id

• aws:cloudformation:stack-name

字aws:首會保留供 AWS 使用。此字首不區分大小寫。如果您在 Key 或 Value 屬性中使用此字首，則無法更新或刪除標籤。具有此字首的標籤不會計入每個資源的標籤數。

堆疊層級標籤到資源的傳播 (包括具有 aws: 字首的標籤) 因資源類型而異。例如，標籤不會傳播到從區塊型裝置映射建立的 Amazon EBS 磁碟區。

注意

有些資源需要明確的標籤傳播設定。例如，AWS::AutoScaling::AutoScalingGroup 資源的 PropagateAtLaunch 屬性必須設為 true，才能將標籤傳播至其 EC2 執行個體。不過，無論 PropagateAtLaunch 設定為何，堆疊層級標籤都會自動套用至 EC2 執行個體。

語法

JSON

{
  "Key" : String,
  "Value" : String
}

YAML

Key: String
Value: String

Properties

Key

標籤的鍵名稱。您可以指定長度為 1 到 128 個 Unicode 字元的值，並且不可在前面加上 aws:。您可以使用以下任何字元：Unicode 字母、數字、空格、_、.、:、/、=、+、@、- 和 " 的組合。

必要：是

類型：字串

Value

標籤的值。您可以指定長度為 1 到 256 個字元的值。您可以使用以下任何字元：Unicode 字母、數字、空格、_、.、/、=、+ 和 - 的組合。

必要：是

類型：字串

範例

此範例顯示 Tags 屬性。您可以在支援此屬性資源內的 Properties 區段指定此屬性。建立資源時，會使用參數動態設定 Environment 標籤，並將 Owner 標籤靜態設定為 MyName。

JSON

"Tags" : [
   {
      "Key" : "Environment",
      "Value" : { "Ref": "Environment" }
   },
   {
      "Key" : "Owner",
      "Value" : "MyName"
   }
]

YAML

Tags: 
  - Key: Environment
    Value: !Ref Environment
  - Key: Owner
    Value: MyName

另請參閱

• 《AWS CloudFormation 使用者指南》中的設定堆疊選項

• 《AWS CloudFormation 使用者指南》中的在 AWS 管理主控台上檢視 CloudFormation 堆疊資料和資源