**支援終止通知：**2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 [Amazon Pinpoint 終止支援](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：**與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 管理 Amazon Pinpoint 資源標籤
*標籤*是您選擇性定義並與 AWS 資源建立關聯的標籤，包括特定類型的 Amazon Pinpoint 資源。標籤可協助您以不同方式分類和管理資源，例如透過用途、擁有者、環境或其他條件。例如，您可以使用標籤來套用政策或自動化，或識別受制於特定合規要求的資源。您可以將標籤加入以下類型的 Amazon Pinpoint 資源：
+ 行銷活動
+ 訊息範本
+ 專案 (應用程式)
+ 客群
資源最多可以擁有 50 個標籤。每個標籤皆包含由您定義的必要「標籤金鑰」**與選用「標籤值」**。*標籤金鑰*是一般標籤，做為更特定標籤值的類別。*標籤值*是標籤金鑰的描述項。
標籤金鑰最多可包含 128 個字元。標籤值最多可包含 256 個字元。這些字元可以是 Unicode 字母、數字、空格或以下其中一個符號：\$1、:、/、=、\$1、-。以下額外限制適用於標籤：
+ 標籤鍵與值皆區分大小寫。
+ 對於每個相關聯的資源，每個標籤金鑰必須是唯一的，而且只能有一個值。
+ 字`aws:`首保留供 使用 AWS；您無法在定義的任何標籤索引鍵或值中使用。此外，您無法編輯或移除使用此字首的標籤金鑰或值。使用此字首的標籤不會計入每個資源 50 個標籤的配額。
+ 您無法更新或刪除僅以其標籤為基礎的資源。您也須指定 Amazon Resource Name (ARN) 或資源 ID，取決於您使用的操作。
+ 您可以將標籤與公有或共用資源建立關聯。不過，這些標籤僅適用於您的帳戶 AWS ，不適用於共用資源的任何其他帳戶。此外，這些標籤僅適用於位於您 AWS 帳戶指定 AWS 區域中的資源。
若要從 Amazon Pinpoint 資源新增、顯示、更新和移除標籤金鑰和值，您可以使用 AWS Command Line Interface (AWS CLI)、Amazon Pinpoint API、 AWS Resource Groups 標記 API 或 AWS SDK。若要管理您 AWS 帳戶特定 AWS 區域中所有 AWS 資源 （包括 Amazon Pinpoint 資源） 的標籤索引鍵和值，請使用[AWS Resource Groups 標記 API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html)。
如需可用於管理 Amazon Pinpoint 資源的 CLI 命令的詳細資訊，請參閱 [AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/)的 Amazon Pinpoint 部分。
如需深入了解 Amazon Pinpoint API 中的資源 (包括支援的 HTTP(S) 方法、參數和結構描述) 的詳細資訊，請參閱 [Amazon Pinpoint API 參考](https://docs.aws.amazon.com/pinpoint/latest/apireference/)。
# 在 IAM 政策和 API 操作中使用 Amazon Pinpoint 標籤
開始實作標籤後，您可以將標籤型資源層級許可套用至 AWS Identity and Access Management (IAM) 政策和 API 操作。這包括支援在建立資源時將標籤新增至資源的作業。透過以這種方式使用標籤，您可以對 AWS 帳戶中的哪些群組和使用者具有建立和標記資源的許可，以及哪些群組和使用者具有更廣泛建立、更新和移除標籤的許可，實作精細的控制。
例如您可以建立一個政策，讓使用者針對所有 Amazon Pinpoint 資源擁有完全存取權，其名稱是資源 `Owner` 標籤中的值：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "ModifyResourceIfOwner",
"Effect": "Allow",
"Action": "mobiletargeting:*",
"Resource": "*",
"Condition": {
"StringEqualsIgnoreCase": {
"aws:ResourceTag/Owner": "${aws:username}"
}
}
}
]
}
```
------
如果您定義標籤型、資源層級許可，則許可會立即生效。這表示您的資源一旦建立就會更安全，而且您可以快速開始強制使用新資源的標籤。您也可以使用資源層級許可，以控制哪些標籤金鑰和值可以與新的和現有的資源相關聯。詳情請參閱 *AWS IAM 使用者指南*中的[使用標籤控制存取權](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。
# 以程式設計方式將標籤新增至 Amazon Pinpoint 資源
以下範例說明如何使用 [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) 和 [Amazon Pinpoint REST API](https://docs.aws.amazon.com/pinpoint/latest/apireference/)，將標籤加入 Amazon Pinpoint 資源。您也可以使用任何支援的 AWS SDK 將標籤新增至資源。
若要在單一操作中將標籤新增至多個 Amazon Pinpoint 資源，請使用 AWS CLI 或 [AWS Resource Groups 標記 API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) 的資源群組標記操作。
## 使用 API 新增標籤
若要使用 Amazon Pinpoint REST API 建立新資源並將標籤加入其中，請將 POST 請求傳送到適當的資源 URI。在請求內文中包含 `tags` 參數和值。以下範例說明如何在建立新專案時指定標籤。
```
POST /v1/apps HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
Accept: application/json
Cache-Control: no-cache
{
"Name":"MyProject",
"tags":{
"key1":"value1"
}
}
```
若要將標籤新增到現有資源，請將 POST 請求傳送到[標籤](https://docs.aws.amazon.com/pinpoint/latest/apireference/tags-resource-arn.html) URI。在 URI 中包含資源的 Amazon Resource Name (ARN)。ARN 應為 URL 編碼。在請求的內文中，附上 `tags` 參數和值，如以下範例所示。
```
POST /v1/tags/resource-arn HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
{
"tags":{
"key1":"value1"
}
}
```
## 使用 新增標籤 AWS CLI
若要使用 建立新的資源並新增標籤 AWS CLI，請使用適當的資源`create`命令。包括 `tags` 參數和值。以下範例說明如何在建立新專案時指定標籤。
------
#### [ Linux, macOS, or Unix ]
```
$ aws pinpoint create-app \
--create-application-request '{
"Name":"MyProject",
"tags": {
"key1":"value1",
"key2":"value2"
}
}'
```
------
#### [ Windows Command prompt ]
```
C:\> aws pinpoint create-app ^
--create-application-request Name=MyProject,tags={key1=value1,key2=value2}
```
------
在上述範例中，執行下列動作：
+ 將 *MyProject* 替換成您要為專案指定的名稱。
+ 將 *key1* 和 *key2* 替換成您要加入資源的標籤的索引鍵。
+ 將 *value1* 和 *value2* 替換成您要為各索引鍵加入的標籤的值。
如需可建立 Amazon Pinpoint 資源的命令的相關資訊，請參閱 [AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/)。
若要新增標籤至現有的資源，請使用 `tag-resource` 命令，然後針對所需參數指定正確的值：
------
#### [ Linux, macOS, or Unix ]
```
$ aws pinpoint tag-resource \
--resource-arn resource-arn \
--tags-model '{
"tags": {
"key1":"value1",
"key2":"value2"
}
}'
```
------
#### [ Windows Command Prompt ]
```
C:\> aws pinpoint tag-resource ^
--resource-arn resource-arn ^
--tags-model tags={key1=value1,key2=value2}
```
------
在上述範例中，執行下列動作：
+ 將 *resource-arn* 替換成您要新增標籤的資源的 Amazon Resource Name (ARN)。
+ 將 *key1* 和 *key2* 替換成您要加入資源的標籤的索引鍵。
+ 將 *value1* 和 *value2* 替換成您要為各索引鍵加入的標籤的值。
# 以程式設計方式顯示 Amazon Pinpoint 資源的標籤
以下範例顯示如何使用 [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) 及 [Amazon Pinpoint REST API](https://docs.aws.amazon.com/pinpoint/latest/apireference/)，藉以顯示所有與 Amazon Pinpoint 資源相關聯的所有標籤 (金鑰和值) 的清單。您也可以使用任何支援的 AWS SDK 來顯示與資源相關聯的標籤。
## 使用 API 顯示標籤
若要使用 Amazon Pinpoint REST API 顯示與特定資源相關聯的所有標籤，請將 GET 請求傳送到[標籤](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html) URI，並在 URI 中加入資源的 Amazon Resource Name (ARN)。ARN 應為 URL 編碼。例如，以下請求會擷取所有與指定行銷活動相關聯的標籤 (*resource-arn*)：
```
GET /v1/tags/resource-arn HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
```
JSON 對於請求的回應包含一個 `tags` 物件。`tags` 物件會列出與行銷活動相關聯的所有標籤金鑰和值。
若要顯示與相同類型的多個資源相關聯的所有標籤，請針對該資源類型，將 GET 請求傳送至適當的 URI。例如，以下請求會擷取指定專案 (*application-id*) 中所有行銷活動的相關資訊：
```
GET /v1/apps/application-id/campaigns HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
```
JSON 對於請求的回應會列出所有在專案中的行銷活動。每個行銷活動的 `tags` 物件會列出與行銷活動相關聯的所有標籤金鑰和值。
## 使用 顯示標籤 AWS CLI
若要使用 AWS CLI 顯示與特定資源相關聯的標籤清單，請執行 `list-tags-for-resource`命令，並為 `resource-arn` 參數指定資源的 Amazon Resource Name (ARN)，如下列範例所示。
------
#### [ Linux, macOS, or Unix ]
```
$ aws pinpoint list-tags-for-resource \
--resource-arn resource-arn
```
------
#### [ Windows Command Prompt ]
```
C:\> aws pinpoint list-tags-for-resource ^
--resource-arn resource-arn
```
------
若要顯示具有標籤的所有 Amazon Pinpoint 資源清單，以及與每個資源相關聯的所有標籤，請使用 AWS Resource Groups 標記 API 的 [get-resources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html) 命令。將 `resource-type-filters` 參數設為 `mobiletargeting`，如以下範例所示。
------
#### [ Linux, macOS, or Unix ]
```
$ aws resourcegroupstaggingapi get-resources \
--resource-type-filters "mobiletargeting"
```
------
#### [ Windows Command Prompt ]
```
C:\> aws resourcegroupstaggingapi get-resources ^
--resource-type-filters "mobiletargeting"
```
------
命令的輸出是一份 ARN 清單，列出具有標籤的所有 Amazon Pinpoint 資源。此清單包含與每個資源相關聯的所有標籤金鑰和值。
# 以程式設計方式更新或覆寫 Amazon Pinpoint 資源的標籤
有多種方法可以更新 (覆寫) Amazon Pinpoint 資源的標籤。更新標籤的最佳方式取決於：
+ 您要更新其標籤的資源類型。
+ 您想要更新一個或多個資源的標籤。
+ 您想要更新標籤金鑰、標籤值，還是兩者。
若要同時更新 Amazon Pinpoint 專案或多個資源的標籤，請使用 AWS CLI 或 標記 [AWS Resource Groups API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) 的資源群組標記操作。Amazon Pinpoint API 目前無法為這兩個任務，提供直接支援。
若要更新一個資源的標籤，可以使用 Amazon Pinpoint API [移除目前的標籤](tags-remove.md)和[新增標籤](tags-add.md)。
# 以程式設計方式從 Amazon Pinpoint 資源移除標籤
以下範例說明如何使用 [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) 和 [Amazon Pinpoint REST API](https://docs.aws.amazon.com/pinpoint/latest/apireference/)，從 Amazon Pinpoint 資源移除標籤 (索引鍵和值)。您也可以使用任何支援的 AWS SDK 從資源中移除標籤。
若要在單一操作中移除多個 Amazon Pinpoint 資源的標籤，請使用 AWS CLI 或 [AWS Resource Groups 標記 API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) 的資源群組標記操作。若要從資源中只移除特定的標籤值 (而非標籤金鑰)，您可以[更新資源的標籤](tags-update.md)。
## 使用 API 移除標籤
若要使用 Amazon Pinpoint REST API 從資源移除標籤，請傳送 DELETE 請求到[標籤](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html) URI。在 URI 中，加入要從中移除標籤之資源的 Amazon Resource Name (ARN)，然後是要移除的 `tagKeys` 參數和標籤。例如：
```
https://endpoint/v1/tags/resource-arn?tagKeys=key
```
其中：
+ *端點*是託管資源的 AWS 區域的 Amazon Pinpoint 端點。
+ *resource-arn* 是您要從中移除標籤之資源的 ARN。
+ *key* 是您要從資源中移除的標籤。
所有參數都必須針對 URL 進行編碼。
若要從資源中移除多個標籤金鑰及其關聯值，請對每個要移除的額外標籤附加 `tagKeys` 參數和引數，並以 & 符號區隔。例如：
```
https://endpoint/v1/tags/resource-arn?tagKeys=key1&tagKeys=key2
```
所有參數都必須針對 URL 進行編碼。
## 使用 移除標籤 AWS CLI
若要使用 從資源移除標籤 AWS CLI，請執行 `untag-resource`命令。加入 `tag-keys` 參數和引數，如以下範例所示。
------
#### [ Linux, macOS, or Unix ]
```
$ aws pinpoint untag-resource \
--resource-arn resource-arn \
--tag-keys key1 key2
```
------
#### [ Windows Command Prompt ]
```
C:\> aws pinpoint untag-resource ^
--resource-arn resource-arn ^
--tag-keys key1 key2
```
------
在上述範例中，進行下列變更：
+ 將 *resource-arn* 替換成您要移除標籤的資源的 ARN。
+ 將 *key1* 和 *key2* 替換成您要移除資源的標籤的索引鍵。