終止支援通知：2026 年 10 月 7 日 AWS 將終止 的支援 AWS Proton。2026 年 10 月 7 日之後，您將無法再存取 AWS Proton 主控台或 AWS Proton 資源。您部署的基礎設施將保持不變。如需詳細資訊，請參閱[AWS Proton 服務棄用和遷移指南](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# AWS Proton 資源和標記
AWS Proton 獲指派 Amazon Resource Name (ARN) 的 資源包括環境範本及其主要和次要版本、服務範本及其主要和次要版本、環境、服務、服務執行個體、元件和儲存庫。您可以標記這些資源，以協助您整理和識別這些資源。您可以使用標籤，依用途、擁有者、環境或其他條件來分類資源。如需詳細資訊，請參閱 [ 標記策略](https://aws.amazon.com/answers/account-management/aws-tagging-strategies/)。若要追蹤和管理 資源 AWS Proton ，您可以使用下列各節所述的標記功能。
## AWS 標記
您可以將中繼資料以標籤形式指派給 AWS 資源。每個標籤都包含客戶定義的金鑰和選用值。標籤可協助您管理、識別、組織、搜尋及篩選資源。
**重要**
請勿在標籤中加入個人身分識別資訊 (PII) 或其他機密或敏感資訊。許多 AWS 服務都可以存取標籤，包括帳單。標籤不適用於私有或敏感資料。
**每個 標籤都有兩個部分。**
+ 標籤鍵 (例如 `CostCenter`、`Environment` 或 `Project`)。標籤金鑰會區分大小寫。
+ 標籤值 （選用） （例如 `111122223333`或 `Production`)。與標籤金鑰相同，標籤值會區分大小寫。
**下列基本命名和使用需求適用於標籤。**
+ 每個資源最多可以有 50 個使用者建立的標籤。
**注意**
系統會保留以字`aws:`首開頭的系統建立標籤以供 AWS 使用，且不計入此限制。您無法編輯或刪除以 `aws:` 字首開頭的標籤。
+ 針對每一個資源，每個標籤鍵必須是唯一的，且每個標籤鍵只能有一個值。
+ 標籤索引鍵在 UTF-8 中必須至少為 1，最多為 128 個 Unicode 字元。
+ 在 UTF-8 中，標籤值必須至少為 1，最多為 256 個 Unicode 字元。
+ 標籤中允許的字元為以 UTF-8 表示的字母、數字、空格，以及下列字元：\$1 \$1 . ： / = \$1 - @。
## AWS Proton 標記
透過 AWS Proton，您可以使用您建立的標籤以及 AWS Proton 自動為您產生的標籤。
### AWS Proton AWS 受管標籤
當您建立 AWS Proton 資源時， AWS Proton 會自動為您的新資源產生 AWS 受管標籤，如下圖所示。 AWS 受管標籤稍後會傳播到以新 AWS Proton 資源為基礎的其他資源。例如，從環境範本傳播到其版本的受管標籤，以及從服務傳播到其服務執行個體的受管標籤。
**注意**
AWS 環境帳戶連線*不會*產生受管標籤。如需詳細資訊，請參閱[環境帳戶連線](ag-env-account-connections.md)。
![\[描述 AWS 受管標籤傳播的圖表。\]](http://docs.aws.amazon.com/zh_tw/proton/latest/userguide/images/tag-diag.png)
### 將標籤傳播至佈建的資源
如果佈建的資源，例如服務和環境範本中定義的資源，支援 AWS 標記， AWS 受管標籤會傳播為客戶受管標籤到佈建的資源。這些標籤不會傳播到不支援 AWS 標記的佈建資源。
AWS Proton 會依 AWS Proton 帳戶、已註冊的範本和部署的環境，以及 服務和 服務執行個體，將標籤套用至您的 資源，如下表所述。您可以使用 AWS 受管標籤來檢視和管理 AWS Proton 資源，但無法修改它們。
| AWS 受管標籤金鑰 | 傳播的客戶受管金鑰 | 說明 |
| --- | --- | --- |
| `aws:proton:account` | `proton:account` | 建立和部署 AWS Proton 資源 AWS 的帳戶。 |
| `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 Proton 資源的 AWS 受管標籤範例。
```
"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"
```
透過 [AWS受管佈建](ag-works-prov-methods.md#ag-works-prov-methods-direct)， 會將傳播的標籤直接 AWS Proton 套用至佈建的資源。
使用[自我管理佈建](ag-works-prov-methods.md#ag-works-prov-methods-self)， AWS Proton 讓傳播的標籤與其在佈建提取請求 (PR) 中提交的轉譯 IaC 檔案一起可用。標籤會在字串映射變數 中提供`proton_tags`。我們建議您在 Terraform 組態中參考此變數，以在 中包含 AWS Proton 標籤`default_tags`。這會將 AWS Proton 標籤傳播到所有佈建的資源。
下列範例顯示在環境 Terraform 範本中的此標籤傳播方法。
以下是`proton_tags`變數定義：
**https：//proton.environment.variables.tf：**
```
variable "environment" {
type = object({
inputs = map(string)
name = string
})
}
variable "proton_tags" {
type = map(string)
default = null
}
```
以下是標籤值指派給此變數的方式：
**proton.auto.tfvars.json：**
```
{
"environment": {
"name": "dev",
"inputs": {
"ssm_parameter_value": "MyNewParamValue"
}
}
"proton_tags" : {
"proton:account" : "123456789012",
"proton:template" : "arn:aws:proton:us-east-1:123456789012:environment-template/fargate-env",
"proton:environment" : "arn:aws:proton:us-east-1:123456789012:environment/dev"
}
}
```
以下是如何將 AWS Proton 標籤新增至 Terraform 組態，以便將標籤新增至佈建的資源：
```
# Configure the AWS Provider
provider "aws" {
region = var.aws_region
default_tags {
tags = var.proton_tags
}
}
```
### 客戶受管標籤
每個 AWS Proton 資源的配額上限為 50 個客戶受管標籤。客戶受管標籤傳播至子 AWS Proton 資源的方式與 AWS 受管標籤相同，但不傳播至現有 AWS Proton 資源或佈建的資源。如果您將新標籤套用到 AWS Proton 具有現有子資源的資源，並且希望使用新標籤來標記現有的子資源，則需要使用 主控台或 手動標記每個現有的子資源 AWS CLI。
### 使用主控台和 CLI 建立標籤
當您使用主控台建立 AWS Proton 資源時，您有機會在建立程序的第一或第二頁建立客戶受管標籤，如下列主控台快照所示。選擇**新增標籤**，輸入索引鍵和值並繼續。
![\[主控台建立標籤界面的快照。\]](http://docs.aws.amazon.com/zh_tw/proton/latest/userguide/images/tag-create.PNG)
使用 AWS Proton 主控台建立新資源後，您可以從詳細資訊頁面檢視其 AWS 受管和客戶受管標籤清單。
**建立或編輯標籤**
1. 在 [AWS Proton 主控台](https://console.aws.amazon.com//proton/)中，開啟 AWS Proton 資源詳細資訊頁面，您可以在其中看到標籤清單。
1. 選擇**管理標籤**。
1. 在**管理標籤**頁面中，您可以檢視、建立、移除和編輯標籤。您無法修改列在頂端的 AWS 受管標籤。不過，您可以使用編輯欄位來新增和修改客戶受管標籤，這些欄位列在 AWS 受管標籤之後。
選擇**新增標籤**以建立新的標籤。
1. 輸入新標籤的索引鍵和值。
1. 若要編輯標籤，請在所選索引鍵的標籤值欄位中輸入值。
1. 若要刪除標籤，請選擇**移除**所選標籤。
1. 完成變更後，請選擇**儲存變更**。
### 使用 建立標籤 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"
```