以程式設計方式顯示 Amazon Pinpoint 資源的標籤 - Amazon Pinpoint

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

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

以程式設計方式顯示 Amazon Pinpoint 資源的標籤

以下範例顯示如何使用 AWS CLIAmazon Pinpoint REST API,藉以顯示所有與 Amazon Pinpoint 資源相關聯的所有標籤 (金鑰和值) 的清單。您也可以使用任何支援的 AWS SDK 來顯示與資源相關聯的標籤。

使用 API 顯示標籤

若要使用 Amazon Pinpoint REST API 顯示與特定資源相關聯的所有標籤,請將 GET 請求傳送到標籤 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 命令。將 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 資源。此清單包含與每個資源相關聯的所有標籤金鑰和值。