支援終止通知：2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 Amazon Pinpoint 終止支援。注意：與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。

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

以程式設計方式將標籤新增至 Amazon Pinpoint 資源

以下範例說明如何使用 AWS CLI 和 Amazon Pinpoint REST API，將標籤加入 Amazon Pinpoint 資源。您也可以使用任何支援的 AWS SDK 將標籤新增至資源。

若要在單一操作中將標籤新增至多個 Amazon Pinpoint 資源，請使用 AWS CLI 或 AWS Resource Groups 標記 API 的資源群組標記操作。

使用 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 請求傳送到標籤 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}

在上述範例中，執行下列動作：

如需可建立 Amazon Pinpoint 資源的命令的相關資訊，請參閱 AWS CLI 命令參考。

若要新增標籤至現有的資源，請使用 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}

在上述範例中，執行下列動作：