

**サポート終了通知:** 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 エンドユーザーメッセージングでサポートされています。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# トラブルシューティング
<a name="troubleshooting"></a>

**注記**  
次のトラブルシューティングトピックが移動されました。  
[セグメントのトラブルシューティング](segments-troubleshooting.md)
[キャンペーンのトラブルシューティング](campaigns-troubleshooting.md)
[ジャーニーのトラブルシューティング](journeys-troubleshooting.md)
[SMS チャネルのトラブルシューティング](channels-sms-troubleshooting.md)
[音声チャネルのトラブルシューティング](channels-voice-troubleshooting.md)
[プッシュチャネルのトラブルシューティング](channels-push-troubleshooting.md)
[E メールチャネルのトラブルシューティング](channels-email-troubleshooting.md)

 Amazon Pinpoint を使用するときの問題解決に役立つトラブルシューティング情報と、考え得る解決策をよく理解します。<a name="troubleshooting-logging"></a>

**モニタリングとログ記録**

ベストプラクティスとして、以下の方法により、Amazon Pinpoint でイベントをログに記録しておくことを検討します。
+ 「」の手順に従って でイベントストリームをオンに Amazon Kinesis Data Streams します[Amazon Pinpoint によるイベントのストリーミング](analytics-streaming.md)。
+ カスタムログ記録ソリューションを使用する。詳細については、「[デジタルユーザーエンゲージメントイベントデータベース](https://aws.amazon.com/solutions/implementations/digital-user-engagement-events-database/)」を参照してください。複数のサービスが関係し、追加費用が発生します。
+ Amazon Pinpoint でサポートされている Amazon CloudWatch メトリクスの使用。詳細については、「[Amazon CloudWatch による Amazon Pinpoint のモニタリング](monitoring.md)」を参照してください。
+ CloudTrail にログが記録された Amazon Pinpoint API コールを使用する。詳細については、「*Amazon Pinpoint デベロッパーガイド*」の「[Amazon Pinpoint API コールを AWS CloudTrailでログに記録する](https://docs.aws.amazon.com/pinpoint/latest/developerguide/logging-using-cloudtrail.html)」を参照してください。

**Topics**
+ [一般的なタスクの CLI の例](#troubleshooting-cli-examples)

## 一般的なタスクの CLI の例
<a name="troubleshooting-cli-examples"></a>

以下の例は、Amazon Pinpoint の一般的な CLI コマンドです。
+ エンドポイントデータの取得: [get-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/get-endpoint.html) CLI

  ```
  aws pinpoint get-endpoint —application-id {{AppId}} —endpoint-id {{EndpointId}}
  ```

**上のコマンドに、以下の変更を加えます。**
  + {{AppId}} を、エンドポイントを含む Amazon Pinpoint プロジェクトの ID に置き換えます。
  + {{EndpointId}} を、取得する既存のエンドポイントの ID に置き換えます。
+ ユーザーデータの取得: [get-user-endpoints](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/get-user-endpoints.html) CLI

  ```
  aws pinpoint get-user-endpoints —application-id {{AppId}} —user-id {{UserId}}
  ```

**上のコマンドに、以下の変更を加えます。**
  + {{AppId}} を、エンドポイントを含む Amazon Pinpoint プロジェクトの ID に置き換えます。
  + {{UserId}} を、ユーザーの ID に置き換えます。
+ エンドポイントの更新または新規作成: [update-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/update-endpoint.html) CLI

  ```
  aws pinpoint update-endpoint —application-id {{AppId}} —endpoint-id {{EndpointId}} —endpoint-request '{"ChannelType":"SMS","Address":"+12345678","Location":{"Country":"USA"},"User":{"UserId":"{{UserId}}"}}'
  ```

**上のコマンドに、以下の変更を加えます。**
  + {{AppId}} を、エンドポイントを含む Amazon Pinpoint プロジェクトの ID に置き換えます。
  + {{EndpointId}} を、作成または更新する既存のエンドポイントの ID に置き換えます。
  + {{UserId}} を、ユーザーの ID に置き換えます。
+ エンドポイントの削除: [delete-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/delete-endpoint.html) CLI

  ```
  aws pinpoint delete-endpoint —application-id {{AppId}} —endpoint-id {{EndpointId}} 
  ```

**上のコマンドに、以下の変更を加えます。**
  + {{AppId}} を、エンドポイントを含む Amazon Pinpoint プロジェクトの ID に置き換えます。
  + {{EndpointId}} を、削除する既存のエンドポイントの ID に置き換えます。
+ 電話番号の検証: [phone-number-validate](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/phone-number-validate.html) CLI

  ```
  aws pinpoint phone-number-validate —number-validate-request PhoneNumber={{+12065550100}}
  ```

**上のコマンドに、以下の変更を加えます。**
  + {{\+12065550100}} を、検証する電話番号に置き換えます。
+ [send-messages](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/send-messages.html) 例 CLI: 電話番号への SMS

  ```
  aws pinpoint send-messages --application-id {{AppID}} --message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test message"}},"Addresses": {"{{DestinationPhoneNumber}}": {"ChannelType":"SMS"}}}‘
  ```

**上のコマンドに、以下の変更を加えます。**
  + {{AppId}} を、エンドポイントを含む Amazon Pinpoint プロジェクトの ID に置き換えます。
  + {{DestinationPhoneNumber}} を送信先電話番号に置き換えます。
+ [send-messages](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/send-messages.html) 例 CLI: SMS への発信番号

  ```
  aws pinpoint send-messages --application-id {{AppID}} --message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"hello, how are you?","OriginationNumber": "{{OriginPhoneNumber}}"}},"Addresses": {"{{DestinationPhoneNumber}}": {"ChannelType":"SMS"}}}‘
  ```

**上のコマンドに、以下の変更を加えます。**
  + {{AppId}} を、エンドポイントを含む Amazon Pinpoint プロジェクトの ID に置き換えます。
  + {{OriginPhoneNumber}} を、メッセージの送信元の電話番号に置き換えます。
  + {{DestinationPhoneNumber}} を送信先電話番号に置き換えます。
+ [send-messages](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/send-messages.html) 例 CLI: エンドポイントへの SMS

  ```
  aws pinpoint send-messages —application-id {{AppID}}  —message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test message"}},"Endpoints": {"{{EndPointId}}": {}}}'
  ```

**上のコマンドに、以下の変更を加えます。**
  + {{AppId}} を、エンドポイントを含む Amazon Pinpoint プロジェクトの ID に置き換えます。
  + {{EndPointId}} を、送信先の既存のエンドポイントの ID に置き換えます。
+ [send-messages](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/send-messages.html) 例 CLI: userId への SMS

  ```
  aws pinpoint send-users-messages —application-id {{AppID}} —send-users-message-request '{"MessageConfiguration": {"SMSMessage":{"Body":"This is a test"}},"Users": {"{{UserId}}": {}}}'
  ```

**上のコマンドに、以下の変更を加えます。**
  + {{AppId}} を、エンドポイントを含む Amazon Pinpoint プロジェクトの ID に置き換えます。
  + {{UserId}} を、ユーザーの ID に置き換えます。
+ [Amazon Pinpoint メッセージテンプレート](messages-templates.md) [create-campaign](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/create-campaign.html) CLI によるキャンペーン作成

  ```
  aws pinpoint create-campaign —application-id {{AppId}} —write-campaign-request file://campaignclirequest.json 
  
  file://campaignclirequest.json 
  {
  	"Description": "CLITestCampaign",
  	"HoldoutPercent": 0,
  	"MessageConfiguration": 
  	{
  		"DefaultMessage": 
  		{
  			"Body": "TestFromCLI"
  		}
  	},
  	"Name": "TestingCLICampaign",
  	"Schedule": 
  	{
  		"StartTime": "IMMEDIATE"
  	},
  	"TemplateConfiguration": 
  		{
  		"EmailTemplate": 
  			{
  			"Name": "{{TemplateName}}",
  			"Version": "{{Version}}"
  			}
  		},
  	"SegmentId": "{{SegmentID}}",
  	"SegmentVersion": 1
  }
  ```

**上のコマンドおよびファイルに、以下の変更を加えます。**
  + {{AppId}} を、エンドポイントを含む Amazon Pinpoint プロジェクトの ID に置き換えます。
  + {{[TemplateName]}} をテンプレートの名前に置き換えます。
  + {{バージョン}} を、テンプレートのバージョンに置き換えます。
  + {{SegmentID}} を、ターゲットとするセグメントの ID に置き換えます。