翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS エンドユーザーメッセージング SMS のイベント送信先
*イベント送信先*とは、SMS イベントと音声イベントが送信される場所 (CloudWatch グループ、Amazon Data Firehose ストリーム、Amazon SNS トピックなど) です。イベント送信先を使用するには、まず送信先を作成し、次にその送信先を [AWS End User Messaging SMS の設定セット](configuration-sets.md) に関連付けます。最大 5 つのイベント送信先を 1 つの設定セットに関連付けることができます。メッセージを送信するとき、API コールに設定セットへの参照が含まれます。
通信事業者が生成したイベントまたは配信確認 (DLR) は、受信されるまでに最大 72 時間かかることがあるため、送信メッセージの配信に遅延があるかどうかを判断するのには使用しないでください。72 時間後、 AWS エンドユーザーメッセージング SMS がキャリアから最終イベントを受信していない場合、そのメッセージに何が起こったかわからない`messageStatus`ため、サービスは自動的に UNKNOWN を返します。
**前提条件**
イベント送信先を関連付けるには、事前に設定セットを作成しておく必要があります。「[AWS End User Messaging SMS の設定セット](configuration-sets.md)」を参照してください。
**Topics**
+ [イベントタイプ](configuration-sets-event-types.md)
+ [イベントデータの例](configuration-sets-event-format.md)
+ [Amazon CloudWatch イベントの送信先のセットアップ](configuration-sets-cloud-watch.md)
+ [Amazon Data Firehose の送信先を設定する](configuration-sets-kinesis.md)
+ [Amazon SNS イベント送信先の設定](configuration-sets-sns.md)
# SMS、MMS、音声のイベントタイプ
イベント送信先を使用する最も簡単な方法は、すべての SMS イベント、MMS イベント、音声イベントを 1 つの送信先に送信することです。ただし、特定のタイプのイベントがそれぞれ異なる宛先に送信されるようにイベント送信先を設定できます。例えば、配信関連のすべてのイベントを Firehose に送信して保存し、すべての失敗イベントを Amazon SNS トピックに送信して発生時に通知を受け取ることができます。SMS イベントと音声イベントを別々の場所に送信することもできます。
次のタイプのイベントを送信するようにイベント送信先を設定できます。
**SMS、MMS、音声イベント**
+ **ALL** – すべての SMS、MMS、音声イベントを、指定された宛先に送信します。
**SMS イベント**
+ **TEXT\$1ALL** – すべての SMS イベントを、指定された宛先に送信します。
+ **TEXT\$1DELIVERED (配信済み)** – すべての SMS 配信イベントを、指定された宛先に送信します。送信先の国によっては、**TEXT\$1DELIVERED** イベントと **TEXT\$1SUCCESSFUL** イベントを同じ意味で使用する場合があります。
+ **TEXT\$1SUCCESSFUL (成功)** - 成功イベントは、メッセージが受信者の通信事業者によって受け入れられたときに発生します。送信先の国によっては、**TEXT\$1DELIVERED** イベントと **TEXT\$1SUCCESSFUL** イベントを同じ意味で使用する場合があります。
+ **TEXT\$1QUEUED (キューに追加済み)** - キューイベントは、メッセージが配信待ちになっているが、まだ配信されていないときに発生します。
+ **TEXT\$1PENDING (保留中)** - 保留イベントは、メッセージが配信処理中であるが、まだ配信が完了していない (または配信に失敗した) ときに発生します。
+ **TEXT\$1BLOCKED (ブロック)** - ブロックイベントは、受信者のデバイスまたは通信事業者が受信者へのメッセージをブロックしているときに発生します。
+ **TEXT\$1TTL\$1EXPIRED (TTL 伝送期限切れ)** - TTL 伝送期限切れイベントは、メッセージの配信に必要な時間が、メッセージ送信時に指定した `TTL` 値を超えたときに発生します。
+ **TEXT\$1CARRIER\$1UNREACHABLE (キャリア到達不能)** - キャリア到達不能イベントは、メッセージ受信者のキャリアネットワークで一時的なエラーが発生したときに発生します。
+ **TEXT\$1INVALID (SMS 無効)** - 無効イベントは、送信先電話番号が有効でない場合に発生します。
+ **TEXT\$1INVALID\$1MESSAGE (無効メッセージ)** - 無効メッセージイベントは、SMS メッセージの本文が無効なため配信できないときに発生します。
+ **TEXT\$1CARRIER\$1BLOCKED (キャリアブロック)** - キャリアブロックイベントは、受信者の通信事業者がメッセージの配信をブロックしたときに発生します。これは通常、悪意あるメッセージ (例: メッセージにフィッシング詐欺関連の情報が含まれている場合)、または攻撃的メッセージ (例: メッセージが未承諾または禁止されているコンテンツであると疑われる場合) であると通信事業者が判断したときに発生します。
+ **TEXT\$1UNREACHABLE (到達不能)** – 到達不能イベントは、受信者のデバイスが使用できないときに発生します。これは、デバイスがモバイルネットワークに接続されていないか、電源がオフになっているときに発生することがあります。
+ **TEXT\$1SPAM (スパム)** – スパムイベントは、受信者の通信事業者がメッセージに未承諾の商用コンテンツが含まれていると判断し、メッセージの配信をブロックした場合に発生します。
+ **TEXT\$1UNKNOWN (不明)** – 不明イベントは、他のどのイベントタイプにも当てはまらない理由でメッセージが配信されなかった場合に発生します。不明エラーには、一時的なものと永続的なものがあります。
+ **TEXT\$1PROTECT\$1BLOCKED (保護によるブロック)** – 保護設定によってブロックされたメッセージ。
**音声イベント**
+ **VOICE\$1ALL** – すべての音声イベントを、指定された宛先に送信します。
+ **VOICE\$1COMPLETED (完了)** – 完了イベントは、音声メッセージが受信者に対して再生されたときに発生します。この状態は、メッセージが必ずしも受信者に配信されたことを意味するわけではありません。例えば、メッセージがボイスメールシステムに配信されたことを示す場合があります。
+ **VOICE\$1ANSWERED (応答)** – 応答イベントは、受信者が電話に応答したときに発生します。
+ **VOICE\$1INITIATED (開始)** – 音声メッセージが開始されるたびに、指定された宛先にイベントを送信します。
+ **VOICE\$1TTL\$1EXPIRED (TTL 伝送期限切れ)** - TTL 伝送期限切れイベントは、メッセージの配信に必要な時間が、メッセージ送信時に指定した `TTL` 値を超えたときに発生します。
+ **VOICE\$1BUSY (ビジー)** – ビジーイベントは、受信者の電話回線がビジー状態のときに発生します。
+ **VOICE\$1NO\$1ANSWER (応答なし)** – 応答なしイベントは、電話をかけたが受信者 (またはボイスメールシステム) が応答しなかったときに発生します。
+ **VOICE\$1RINGING (呼び出し)** – 呼び出しイベントは、電話をかけた後、受信者が応答する前に発生します。
+ **VOICE\$1FAILED (失敗)** – 失敗イベントは、メッセージが配信されなかったときに発生します。
**MMS イベント**
+ **MEDIA\$1ALL** – すべての MMS イベントを、指定された宛先に送信します。
+ **MEDIA\$1PENDING (保留中)** - 保留イベントは、メッセージが配信処理中であるが、まだ配信が完了していない (または配信に失敗した) ときに発生します。
+ **MEDIA\$1QUEUED (キューに追加済み)** - キューイベントは、メッセージが配信待ちになっているが、まだ配信されていないときに発生します。
+ **MEDIA\$1SUCCESSFUL (成功)** - 成功イベントは、メッセージが受信者の通信事業者によって受け入れられたときに発生します。
+ **MEDIA\$1DELIVERED (配信済み)** – すべての MMS 配信イベントを、指定された宛先に送信します。
+ **MEDIA\$1INVALID (MMS 無効)** - 無効イベントは、送信先電話番号が有効でない場合に発生します。
+ **MEDIA\$1INVALID\$1MESSAGE (無効メッセージ)** - 無効メッセージイベントは、MMS メッセージの本文が無効なため配信できないときに発生します。
+ **MEDIA\$1UNREACHABLE (到達不能)** – 到達不能イベントは、受信者のデバイスが使用できないときに発生します。これは、デバイスがモバイルネットワークに接続されていないか、電源がオフになっているときに発生することがあります。
+ **MEDIA\$1CARRIER\$1UNREACHABLE (キャリア到達不能)** - キャリア到達不能イベントは、メッセージ受信者のキャリアネットワークで一時的なエラーが発生したときに発生します。
+ **MEDIA\$1BLOCKED (ブロック)** - ブロックイベントは、受信者のデバイスまたは通信事業者が受信者へのメッセージをブロックしているときに発生します。
+ **MEDIA\$1CARRIER\$1BLOCKED (キャリアブロック)** - キャリアブロックイベントは、受信者の通信事業者がメッセージの配信をブロックしたときに発生します。これは通常、悪意あるメッセージ (例: メッセージにフィッシング詐欺関連の情報が含まれている場合)、または攻撃的メッセージ (例: メッセージが未承諾または禁止されているコンテンツであると疑われる場合) であると通信事業者が判断したときに発生します。
+ **MEDIA\$1SPAM (スパム)** – スパムイベントは、受信者の通信事業者がメッセージに未承諾の商用コンテンツが含まれていると判断し、メッセージの配信をブロックした場合に発生します。
+ **MEDIA\$1UNKNOWN (不明)** – 不明イベントは、他のどのイベントタイプにも当てはまらない理由でメッセージが配信されなかった場合に発生します。不明エラーには、一時的なものと永続的なものがあります。
+ **MEDIA\$1TTL\$1EXPIRED (TTL 伝送期限切れ)** - TTL 伝送期限切れイベントは、メッセージの配信に必要な時間が、メッセージ送信時に指定した `TTL` 値を超えたときに発生します。
+ **MEDIA\$1FILE\$1TYPE\$1UNSUPPORTED (ファイルタイプ未サポート)** – ファイルタイプ未サポートイベントは、メディアファイルがサポートされていない形式の場合に発生します。サポートされているファイルタイプのリストについては、[MMS ファイルの種類、サイズ、文字数の制限](mms-limitations-character.md) を参照してください。
+ **MEDIA\$1FILE\$1SIZE\$1EXCEEDED (ファイルサイズ)** – ファイルサイズ超過イベントは、メディアファイルが 600 KB を超えた場合に発生します。
+ **MEDIA\$1FILE\$1INACCESSIBLE (ファイルにアクセスできない)** – ファイルにアクセスできないイベントは、 AWS エンドユーザーメッセージング SMS にファイルへのアクセス許可がない場合に発生します。
# AWS エンドユーザーメッセージング SMS イベントデータの例
AWS エンドユーザーメッセージング SMS は、SMS、MMS、および音声メッセージ配信のイベントデータをストリーミングできます。通信事業者が生成したイベントは、受信されるまでに最大 72 時間かかることがあるため、送信メッセージの配信に遅延があるかどうかを判断するのには使用しないでください。72 時間後、 AWS エンドユーザーメッセージング SMS がキャリアから最終イベントを受信していない場合、そのメッセージに何が起こったかわからない`UNKNOWN``messageStatus`ため、サービスは自動的に を返します。
**Topics**
+ [SMS サンプルログ](#configuration-sets-event-format-sms-example)
+ [SMS Protect のサンプルログ](#configuration-sets-event-format-sms-protect-example)
+ [音声イベントログの例](#configuration-sets-event-format-voice-example)
+ [MMS サンプルログ](#configuration-sets-event-format-mms-example)
## SMS サンプルログ
SMS イベントの JSON オブジェクトには以下の例に示されているデータが含まれています。
```
{
"eventType": "TEXT_SUCCESSFUL",
"eventVersion": "1.0",
"eventTimestamp": 1686975103470,
"isFinal": true,
"originationPhoneNumber": "+12065550152",
"destinationPhoneNumber": "+14255550156",
"isInternationalSend": false,
"mcc": "310",
"mnc": "800",
"messageId": "862a8790-60c0-4430-9b2b-658bdexample",
"messageRequestTimestamp": 1686975103170,
"messageEncoding": "GSM",
"messageType": "PROMOTIONAL",
"messageStatus": "SUCCESSFUL",
"messageStatusDescription": "Message has been accepted by phone carrier",
"context": {
"account": "bar"
},
"totalMessageParts": 1,
"totalMessagePrice": 0.09582,
"totalCarrierFee": 0.0
}
```
****
| 属性 | 説明 |
| --- | --- |
| eventType | イベントのタイプ。値は「[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md)」に記載されています。 |
| eventVersion | イベントの JSON スキーマのバージョン。 |
| eventTimestamp | イベントが報告された時刻。Unix 時間 (ミリ秒単位) として表示されます。 |
| isFinal | これがメッセージの最終ステータスである場合は True となります。中間メッセージステータスがあるため、最終的なメッセージステータスが受信されるまでに最大 72 時間かかる場合があります。 |
| originationPhoneNumber | メッセージの送信元の電話番号。 |
| destinationPhoneNumber | メッセージを送信しようとした電話番号。 |
| isInternationalSend | この電話番号で国際メッセージングが有効になっている場合は True となります。 |
| isoCountryCode | 受信者の電話番号に関連付けられている国 (ISO 3166-1 alpha-2 形式で表示)。 |
| mcc | モバイル国コードは、電話番号が属する国を識別します。このフィールドはオプションであり、存在しない場合があります。 |
| mnc | モバイルネットワークコードは、モバイルネットワークオペレーターを識別します。このフィールドはオプションであり、存在しない場合があります。 |
| messageId | AWS End User Messaging SMS がメッセージを受け入れるときに生成する一意の ID。 |
| messageRequestTimestamp | SMS メッセージリクエストが送信された時刻で、Unix 時間 (ミリ秒単位) として表示されます。 |
| messageEncoding | メッセージのエンコード。指定できる値は GSM と Unicode です。メッセージのエンコードの詳細については、「[SMS 文字制限](sms-limitations-character.md)」を参照してください。 |
| messageType | メッセージのタイプ。指定できる値は、Promotional および Transactionalです。 |
| messageStatus | メッセージのステータス。可能な値は以下のとおりです。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | メッセージステータスの説明。 |
| context | カスタム属性を指定でき、メッセージを送信するとログに記録されます。 |
| totalMessageParts | メッセージを送信するために AWS エンドユーザーメッセージング SMS が作成したメッセージパートの数。 通常、SMS メッセージには GSM-7 文字 160 文字または非 GSM 文字 67 文字のみを含めることができますが、これらの制限は国によって異なる場合があります。これらの制限を超えるメッセージを送信すると、 AWS End User Messaging SMS は自動的にメッセージを小さな部分に分割します。送信したメッセージパートの数に基づいて請求されます。メッセージパーツの詳細については、「[メッセージパーツ/秒 (MPS) の制限とは](sms-limitations-mps.md)」を参照してください。 |
| totalMessagePrice | メッセージの送信に課金された金額。この価格は、米ドルセントの 1000 分の 1 で示されます。例えば、この属性の値が 645 の場合、メッセージの送信に 0.645¢ が課金されます (645 / 1000 = 0.645¢ = \$10.00645)。 |
| totalCarrierFee | メッセージに対する通信事業者料金の総額。 |
## SMS Protect のサンプルログ
[SMS Protect](protect.md) を使用した場合の SMS イベントの JSON オブジェクトには、以下の例に示されているデータが含まれています。
```
{
"eventType": "TEXT_PROTECT_BLOCKED",
"eventVersion": "1.0",
"eventTimestamp": 1686975103470,
"isFinal": true,
"originationPhoneNumber": "+12065550152",
"destinationPhoneNumber": "+14255550156",
"isoCountryCode": "US",
"mcc": "310",
"mnc": "800",
"messageId": "862a8790-60c0-4430-9b2b-658bdexample",
"messageRequestTimestamp": 1686975103170,
"messageEncoding": "GSM",
"messageType": "PROMOTIONAL",
"messageStatus": "PROTECT_BLOCKED",
"messageStatusDescription": "Message blocked by protect configuration",
"context": {
"account": "bar"
},
"totalMessageParts": 1,
"totalMessagePrice": 0,
"totalCarrierFee": 0,
"protectConfiguration": {
"protectConfigurationId": "protect-d777777777777771bbd5d59f4d903479",
"protectStatus": "FILTER"
},
"protectConfigurationAssessment": {
"protectRecommendation": "BLOCK"
"protectInsights": {
"blockReason": "AIT_SUSPECTED"
}
}
}
```
****
| 属性 | 説明 |
| --- | --- |
| eventType | イベントのタイプ。値は「[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md)」に記載されています。 |
| eventVersion | イベントの JSON スキーマのバージョン。 |
| eventTimestamp | イベントが報告された時刻。Unix 時間 (ミリ秒単位) として表示されます。 |
| isFinal | これがメッセージの最終ステータスである場合は True となります。中間メッセージステータスがあるため、最終的なメッセージステータスが受信されるまでに最大 72 時間かかる場合があります。 |
| originationPhoneNumber | メッセージの送信元の電話番号。 |
| destinationPhoneNumber | メッセージを送信しようとした電話番号。 |
| isoCountryCode | 受信者の電話番号に関連付けられている国 (ISO 3166-1 alpha-2 形式で表示)。 |
| mcc | モバイル国コードは、電話番号が属する国を識別します。このフィールドはオプションであり、存在しない場合があります。 |
| mnc | モバイルネットワークコードは、モバイルネットワークオペレーターを識別します。このフィールドはオプションであり、存在しない場合があります。 |
| messageId | AWS End User Messaging SMS がメッセージを受け入れるときに生成する一意の ID。 |
| messageRequestTimestamp | SMS メッセージリクエストが送信された時刻で、Unix 時間 (ミリ秒単位) として表示されます。 |
| messageEncoding | メッセージのエンコード。指定できる値は GSM と Unicode です。メッセージのエンコードの詳細については、「[SMS 文字制限](sms-limitations-character.md)」を参照してください。 |
| messageType | メッセージのタイプ。指定できる値は、Promotional および Transactionalです。 |
| messageStatus | メッセージのステータス。可能な値は以下のとおりです。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | メッセージステータスの説明。 |
| context | カスタム属性を指定でき、メッセージを送信するとログに記録されます。 |
| totalMessageParts | メッセージを送信するために AWS エンドユーザーメッセージング SMS が作成したメッセージパートの数。 通常、SMS メッセージには GSM-7 文字 160 文字または非 GSM 文字 67 文字のみを含めることができますが、これらの制限は国によって異なる場合があります。これらの制限を超えるメッセージを送信すると、 AWS End User Messaging SMS は自動的にメッセージを小さな部分に分割します。送信したメッセージパートの数に基づいて請求されます。メッセージパーツの詳細については、「[メッセージパーツ/秒 (MPS) の制限とは](sms-limitations-mps.md)」を参照してください。 |
| totalMessagePrice | メッセージの送信に課金された金額。この価格は、米ドルセントの 1000 分の 1 で示されます。例えば、この属性の値が 645 の場合、メッセージの送信に 0.645¢ が課金されます (645 / 1000 = 0.645¢ = \$10.00645)。 |
| totalCarrierFee | メッセージに対する通信事業者料金の総額。 |
| protectConfiguration | メッセージの送信時に使用された保護設定の ID と、その時点での送信先の国のステータス。SMS Protect の詳細については、「[SMS Protect](protect.md)」を参照してください。 |
| protectConfigurationAssessment | SMS Protect がメッセージの送信を許可またはブロックすべきと判断するかどうかの評価と、可能な場合はブロックの理由。 |
## 音声イベントログの例
音声イベントの JSON オブジェクトには以下の例に示されているデータが含まれています。
```
{
"eventType": "VOICE_COMPLETED",
"eventVersion": "1.0",
"eventTimestamp": 1697835373500,
"isFinal": true,
"originationPhoneNumber": "+12065550153",
"destinationPhoneNumber": "+14255550159",
"isoCountryCode": "US",
"messageId": "567f6c11-6e8b-4352-9749-a42a0example",
"messageRequestTimestamp": 1697835372720,
"messageStatus": "COMPLETED",
"callDurationInSeconds": 60,
"totalDurationInMinutes": 1,
"totalMessagePrice": 0.013,
"context": {
"account": "bar"
}
}
```
****
| 属性 | 説明 |
| --- | --- |
| eventType | イベントのタイプ。値は「[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md)」に記載されています。 |
| eventVersion | イベントの JSON スキーマのバージョン。 |
| eventTimestamp | イベントが報告された時刻。Unix 時間 (ミリ秒単位) として表示されます。 |
| isFinal | これがメッセージの最終ステータスである場合は True となります。中間メッセージのステータスがあります。 |
| originationPhoneNumber | メッセージの送信元の電話番号。 |
| destinationPhoneNumber | メッセージを送信しようとした電話番号。 |
| isoCountryCode | 受信者の電話番号に関連付けられている国 (ISO 3166-1 alpha-2 形式で表示)。 |
| messageId | AWS End User Messaging SMS がメッセージを受け入れるときに生成する一意の ID。 |
| messageRequestTimestamp | SMS メッセージリクエストが送信された時刻で、Unix 時間 (ミリ秒単位) として表示されます。 |
| messageStatus | メッセージのステータス。可能な値は以下のとおりです。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| callDurationInSeconds | 通話の長さ (秒単位)。 |
| totalDurationInMinutes | 通話時間 (分単位)。 |
| totalMessagePrice | 音声メッセージの送信に課金された金額。この価格は、米ドルセントの 1000 分の 1 で示されます。 |
| context | カスタム属性を指定でき、メッセージを送信するとログに記録されます。 |
## MMS サンプルログ
MMS イベントの JSON オブジェクトには以下の例に示されているデータが含まれています。
```
{
"contentType":"MMS",
"eventType": "MEDIA_DELIVERED",
"eventVersion": "1.0",
"eventTimestamp": 1635197695208,
"isFinal": true,
"originationPhoneNumber": "+12065550153",
"destinationPhoneNumber": "+14255550159",
"isoCountryCode": "US",
"messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235example",
"messageRequestTimestamp": 1635197693241,
"messageType": "TRANSACTIONAL",
"messageStatus": "DELIVERED",
"messageStatusDescription": "Message has been accepted by phone",
"context": {"foo":"bar"},
"totalMessageParts": 1,
"totalMessagePrice": 0.0195,
"totalCarrierFee": 0.00266
}
```
****
| 属性 | 説明 |
| --- | --- |
| eventType | イベントのタイプ。値は「[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md)」に記載されています。 |
| eventVersion | イベントの JSON スキーマのバージョン。 |
| eventTimestamp | イベントが報告された時刻。Unix 時間 (ミリ秒単位) として表示されます。 |
| isFinal | これがメッセージの最終ステータスである場合は True となります。中間メッセージステータスがあるため、最終的なメッセージステータスが受信されるまでに最大 72 時間かかる場合があります。 |
| originationPhoneNumber | メッセージの送信元の電話番号。 |
| destinationPhoneNumber | メッセージを送信しようとした電話番号。 |
| isoCountryCode | 受信者の電話番号に関連付けられている国 (ISO 3166-1 alpha-2 形式で表示)。 |
| messageId | AWS End User Messaging SMS がメッセージを受け入れるときに生成する一意の ID。 |
| messageRequestTimestamp | SMS メッセージリクエストが送信された時刻で、Unix 時間 (ミリ秒単位) として表示されます。 |
| messageType | メッセージのタイプ。指定できる値は、Promotional および Transactionalです。 |
| messageStatus | メッセージのステータス。可能な値は以下のとおりです。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/sms-voice/latest/userguide/configuration-sets-event-format.html) |
| messageStatusDescription | メッセージステータスの説明。 |
| context | カスタム属性を指定でき、メッセージを送信するとログに記録されます。 |
| totalMessageParts | メッセージを送信するために AWS エンドユーザーメッセージング SMS が作成したメッセージパートの数。メッセージパーツの詳細については、「[メッセージパーツ/秒 (MPS) の制限とは](sms-limitations-mps.md)」を参照してください。 |
| totalMessagePrice | メッセージの送信に課金された金額。この価格は、米ドルセントの 1000 分の 1 で示されます。例えば、この属性の値が 645 の場合、メッセージの送信に 0.645¢ が課金されます (645 / 1000 = 0.645¢ = \$10.00645)。 |
| totalCarrierFee | メッセージに対する通信事業者料金の総額。 |
# AWS エンドユーザーメッセージング SMS で Amazon CloudWatch イベント送信先を設定する
Amazon CloudWatch Logs は、ログファイルのモニタリング、保存、アクセスに使用できる AWS サービスです。CloudWatch イベント送信先を作成すると、 AWS End User Messaging SMS は、イベント送信先で指定したタイプのイベントを CloudWatch グループに送信します。CloudWatch の詳細については、「[Amazon CloudWatch Logs ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/)」を参照してください。
**前提条件**
1. CloudWatch イベント送信先を作成するには、まず CloudWatch グループを作成する必要があります。ロググループ作成の詳細については、『Amazon CloudWatch Logs ユーザーガイド』の「[ロググループとログストリームの操作](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)」を参照してください。**
**重要**
イベント送信先を作成するには、CloudWatch グループの Amazon リソースネーム (ARN) が必要です。
1. End AWS User Messaging SMS がロググループに書き込むことを許可する [IAM ロール](configuration-sets-cloud-watch-creating-role.md#configuration-sets-cloud-watch-creating-role.title)を作成する必要があります。
**重要**
イベント送信先を作成するには、IAM ロールの Amazon リソースネーム (ARN) が必要です。
1. また、イベント送信先を関連付ける設定セットを設定します。「[AWS End User Messaging SMS で設定セットを作成する](configuration-set-create.md)」を参照してください。
# Amazon CloudWatch の IAM ポリシー
次の例を使用して、CloudWatch グループにイベントを送信するためのポリシーを作成します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:CreateLogStream",
"logs:DescribeLogStreams",
"logs:PutLogEvents"
],
"Resource": [
"arn:aws:logs:us-east-1:111122223333:log-group:log-group-name:*"
]
}
]
}
```
------
IAM ポリシーの詳細については、『IAM ユーザーガイド』の「[IAM でのポリシーとアクセス管理](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)」を参照してください。**
次のステートメント例では、オプションだが推奨される `SourceAccount` および `SourceArn`条件を使用して、 AWS エンドユーザーメッセージング SMS 所有者アカウントのみが設定セットにアクセスできることを確認します。この例では、*accountId* を AWS アカウント ID に置き換え、*region* を AWS リージョン の名前に置き換え、*ConfigSetName* を 設定セットの名前に置き換えます。
ポリシーを作成したら、新しい IAM ロールを作成して、そのポリシーをアタッチします。ロールを作成したら、次の信頼ポリシーも追加します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
}
```
------
IAM ロールの作成の詳細については、*IAM ユーザーガイド*の「[IAM ロールの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)」を参照してください。
# AWS エンドユーザーメッセージング SMS で Amazon CloudWatch イベント送信先を作成する
IAM ロールと CloudWatch グループを作成後、イベント送信先を作成できます。
------
#### [ Create event destination (Console) ]
AWS エンドユーザーメッセージング SMS コンソールを使用してイベント送信先を作成するには、次の手順に従います。
1. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) で AWS エンドユーザーメッセージング SMS コンソールを開きます。
1. ナビゲーションペインの **[設定]** で、**[設定セット]** を選択します。
1. **[設定セット]** ページで、イベント送信先を追加する設定セットを選択します。
1. **[設定セットの詳細]** ページで、**[送信先イベントを追加]** を選択します。
1. **[イベントの詳細]** セクションで、**[イベント送信先名]** にわかりやすい名前を入力します。
1. **[送信先タイプ]** のドロップダウンから Amazon CloudWatch を選択します。
1. **[IAM ロール ARN]** に、IAM ロールの ARN を入力します。IAM ロール ARN の詳細については、「[Amazon CloudWatch の IAM ポリシー](configuration-sets-cloud-watch-creating-role.md)」を参照してください。
1. **[ロググループ ARN]** に、イベントを配信する Amazon CloudWatch ロググループの ARN を入力します。
1. **[イベント発行]** を有効にします。
1. **[イベントタイプ]** で、以下を選択します。
+ **すべての SMS イベント (推奨)** – このオプションを選択すると、[イベントタイプ](configuration-sets-event-types.md) に記載されているすべての SMS イベントが Amazon CloudWatch に送信されます。
+ **カスタム SMS イベント** – CloudWatch に送信する特定の SMS イベントを選択します。イベントのリストを編集するには、**[SMS イベント選択を編集]** を選択します。**[SMS イベント選択を編集]** で、Amazon CloudWatch に送信するイベントのみをチェックします。**[選択を保存]** を選択します。
+ **すべての音声イベント (推奨)** – このオプションを選択すると、[イベントタイプ](configuration-sets-event-types.md) に記載されているすべての音声イベントが Amazon CloudWatch に送信されます。
+ **カスタム音声イベント** – CloudWatch に送信する特定の音声イベントを選択します。イベントのリストを編集するには、**[音声イベント選択を編集]** を選択します。**[音声イベント選択を編集]** で、Amazon CloudWatch に送信するイベントのみをチェックします。**[選択を保存]** を選択します。
+ **すべての MMS イベント (推奨)** – このオプションを選択すると、[イベントタイプ](configuration-sets-event-types.md) に記載されているすべての MMS イベントが Amazon CloudWatch に送信されます。
+ **カスタム MMS イベント** – CloudWatch に送信する特定の MMS イベントを選択します。イベントのリストを編集するには、**[MMS イベント選択を編集]** を選択します。**[MMS イベント選択を編集]** で、Amazon CloudWatch に送信するイベントのみをチェックします。**[選択を保存]** を選択します。
1. [** イベントの作成 **] を選択します。
------
#### [ Create event destination (AWS CLI) ]
[create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html) コマンドを使用してイベント送信先を作成できます。
コマンドラインから、以下のコマンドを実行します。
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```
上のコマンドに、以下の変更を加えます。
+ *eventDestinationName* を、イベント送信先を説明する名前に置き換えます。
+ *configurationSet* を、イベント送信先に関連付ける設定セットの名前に置き換えます。
+ *eventTypes* を、[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md) に列挙されているイベントタイプの 1 つまたは複数に置き換えます。
+ `IamRoleArn` の値を、[Amazon CloudWatch の IAM ポリシー](configuration-sets-cloud-watch-creating-role.md) で説明されているポリシーを持つ IAM ロールの Amazon リソースネーム (ARN) に置き換えます。
+ `LogGroupArn` の値を、イベントの送信先にする CloudWatch グループの ARN に置き換えます。
------
# AWS エンドユーザーメッセージング SMS で Amazon CloudWatch イベント送信先を編集する
AWS エンドユーザーメッセージング SMS コンソールまたは AWS CLI を使用して、CloudWatch イベント送信先を編集します。
------
#### [ Update event destination (Console) ]
AWS エンドユーザーメッセージング SMS コンソールを使用してイベント送信先を更新するには、次の手順に従います。
1. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) で AWS エンドユーザーメッセージング SMS コンソールを開きます。
1. ナビゲーションペインの **[設定]** で、**[設定セット]** を選択します。
1. **[設定セット]** ページで、編集する設定セットを選択します。
1. **[イベント設定]** タブで、Amazon CloudWatch イベント送信先を選択し、**[編集]** を選択します。
1. **[IAM ロール ARN]** に、IAM ロールの ARN を入力します。IAM ロール ARN の詳細については、「[Amazon CloudWatch の IAM ポリシー](configuration-sets-cloud-watch-creating-role.md)」を参照してください。
1. **[ロググループ ARN]** に、イベントを配信する Amazon CloudWatch ロググループの ARN を入力します。
1. **[イベントタイプ]** で、以下を選択します。
+ **すべての SMS イベント (推奨)** – このオプションを選択すると、[イベントタイプ](configuration-sets-event-types.md) に記載されているすべての SMS イベントが Amazon CloudWatch に送信されます。
+ **カスタム SMS イベント** – このオプションを選択すると、CloudWatch に送信する特定の SMS イベントが選択されます。イベントのリストを編集するには、**[SMS イベント選択を編集]** を選択します。**[SMS イベント選択を編集]** で、Amazon CloudWatch に送信するイベントのみをチェックします。**[選択を保存]** を選択します。
+ **すべての音声イベント (推奨)** – このオプションを選択すると、[イベントタイプ](configuration-sets-event-types.md) に記載されているすべての音声イベントが Amazon CloudWatch に送信されます。
+ **カスタム音声イベント** – このオプションを選択すると、CloudWatch に送信する特定の音声イベントが選択されます。イベントのリストを編集するには、**[音声イベント選択を編集]** を選択します。**[音声イベント選択を編集]** で、Amazon CloudWatch に送信するイベントのみをチェックします。**[選択を保存]** を選択します。
+ **すべての MMS イベント (推奨)** – このオプションを選択すると、[イベントタイプ](configuration-sets-event-types.md) に記載されているすべての MMS イベントが Amazon CloudWatch に送信されます。
+ **カスタム MMS イベント** – このオプションを選択すると、CloudWatch に送信する特定の MMS イベントが選択されます。イベントのリストを編集するには、**[MMS イベント選択を編集]** を選択します。**[MMS イベント選択を編集]** で、Amazon CloudWatch に送信するイベントのみをチェックします。**[選択を保存]** を選択します。
1. **[イベントを編集]** を選択します。
------
#### [ Update event destination AWS CLI) ]
[update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html) コマンドを使用して、イベント送信先を更新できます。
CloudWatch イベント送信先を更新する手順は、イベント送信先を作成するプロセスと同様です。コマンドラインから、以下のコマンドを実行します。
```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```
上のコマンドに、以下の変更を加えます。
+ *eventDestinationName* を、変更するイベント送信先の名前に置き換えます。
+ *configurationSet* を、イベント送信先に関連付ける設定セットの名前に置き換えます。イベント送信先に、異なる設定セットに関連付けることができます。
+ *eventTypes* を、[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md) に列挙されているイベントタイプのいずれかに置き換えます。
+ `IamRoleArn` の値を、[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md) で説明されているポリシーを持つ IAM ロールの Amazon リソースネーム (ARN) に置き換えます。
+ `LogGroupArn` の値を、イベントの送信先にする CloudWatch グループの ARN に置き換えます。
------
# AWS エンドユーザーメッセージング SMS で Amazon CloudWatch イベント送信先を削除する
AWS エンドユーザーメッセージング SMS コンソールまたは AWS CLI を使用して、CloudWatch イベント送信先を削除します。
------
#### [ Delete an CloudWatch event destination (Console) ]
イベント送信先を削除するプロセスは、削除するイベント送信先のタイプにかかわらず、同じです。
**コンソールで CloudWatch イベント送信先を削除するには**
1. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) で AWS エンドユーザーメッセージング SMS コンソールを開きます。
1. ナビゲーションペインの **[設定]** で、**[設定セット]** を選択します。
1. **[設定セット]** ページで、イベント送信先を削除する設定セットを選択します。
1. **[すべての送信先]** セクションで、イベントの送信先を選択し、**[削除]** を選択します。
------
#### [ Delete an CloudWatch event destination (AWS CLI) ]
イベント送信先を削除するには、[delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html) コマンドを使用できます。
イベント送信先を削除するプロセスは、削除するイベント送信先のタイプにかかわらず、同じです。
**で CloudWatch イベント送信先を削除するには AWS CLI**
+ コマンドラインから、以下のコマンドを実行します。
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
上のコマンドに、以下の変更を加えます。
+ *eventDestinationName* を、削除するイベント送信先の Amazon リソースネーム (ARN)に置き換えます。
+ *configurationSetName* を、イベント送信先に関連付ける設定セットの名前または ARN に置き換えます。
------
# AWS エンドユーザーメッセージング SMS で Amazon Data Firehose イベント送信先を設定する
Amazon Data Firehose は、複数のタイプの送信先にリアルタイムのストリーミングデータを提供する、フルマネージドサービスです。Amazon Data Firehose は Kinesis ストリーミングデータプラットフォームの一部です。Amazon Data Firehose の詳細については、「[Amazon Data Firehose デベロッパーガイド](https://docs.aws.amazon.com/firehose/latest/dev/)」を参照してください。
このセクションの一部の例では、 AWS Command Line Interfaceが既にインストールされ、設定されていることを前提としています。の設定の詳細については AWS CLI、[AWS Command Line Interface 「 ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)」を参照してください。
**前提条件**
1. Amazon Data Firehose イベント送信先を作成するには、まず Amazon Data Firehose 配信ストリームを作成する必要があります。ストリーム作成の詳細については、「*Amazon Data Firehose デベロッパーガイド*」の「[Amazon Data Firehose 配信ストリームの作成](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)」を参照してください。
**重要**
イベント送信先を作成するには、Amazon Data Firehose 配信ストリームの Amazon リソースネーム (ARN) が必要です。
1. End AWS User Messaging SMS が配信ストリームに書き込むことを許可する IAM ロールを作成する必要があります。「」を参照してください[Amazon Data Firehose の IAM ポリシー](configuration-sets-kinesis-creating-role.md)。
**重要**
イベント送信先を作成するには、IAM ロールの Amazon リソースネーム (ARN) が必要です。
1. また、イベント送信先を関連付ける設定セットを設定します。「[AWS End User Messaging SMS で設定セットを作成する](configuration-set-create.md)」を参照してください。
**Topics**
+ [Amazon Data Firehose の IAM ポリシー](configuration-sets-kinesis-creating-role.md)
+ [Amazon Data Firehose イベント送信先を作成する](configuration-set-kinesis-add.md)
+ [Amazon Data Firehose イベント送信先を編集する](configuration-set-kinesis-edit.md)
+ [Amazon Data Firehose イベント送信先を削除する](configuration-set-kinesis-delete.md)
# Amazon Data Firehose の IAM ポリシー
次の例を使用して、Amazon Data Firehose ストリームにイベントを送信するためのポリシーを作成します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "firehose:PutRecord",
"Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
}
]
}
```
------
IAM ポリシーの詳細については、『IAM ユーザーガイド』の「[IAM でのポリシーとアクセス管理](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)」を参照してください。**
次のステートメント例では、オプションだが推奨される `SourceAccount` および `SourceArn`条件を使用して、 AWS エンドユーザーメッセージング SMS 所有者アカウントのみが設定セットにアクセスできることを確認します。この例では、*accountId* を AWS アカウント ID に置き換え、*region* を AWS リージョン の名前に置き換え、*ConfigSetName* を 設定セットの名前に置き換えます。
ポリシーを作成したら、新しい IAM ロールを作成して、そのポリシーをアタッチします。ロールを作成したら、次の信頼ポリシーも追加します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
}
```
------
IAM ロールの作成の詳細については、*IAM ユーザーガイド*の「[IAM ロールの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)」を参照してください。
# AWS エンドユーザーメッセージング SMS で Amazon Data Firehose イベント送信先を作成する
Amazon Data Firehose イベント送信先を作成する前に、まず Amazon Data Firehose ストリームを作成する必要があります。ロググループの作成の詳細については、[「Amazon Data Firehose デベロッパーガイド」の「Amazon Data Firehose 配信ストリーム](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)の作成」を参照してください。 **
End User Messaging SMS and Voice AWS v2 API がストリームにデータを送信できるようにする IAM ロールを作成する必要があります。次のセクションには、このロールの要件に関する情報が記載されています。
イベント送信先を関連付ける設定セットも準備しておきます。「[AWS End User Messaging SMS の設定セット](configuration-sets.md)」を参照してください。
------
#### [ Create Amazon Data Firehose event destination (Console) ]
AWS エンドユーザーメッセージング SMS コンソールを使用して Amazon Data Firehose イベント送信先を作成するには、次の手順に従います。
1. 「https://[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).com で AWS エンドユーザーメッセージング SMS コンソールを開きます。
1. ナビゲーションペインの**「設定**」で、**「設定セット**」を選択します。
1. **設定セット**ページで、イベント送信先を追加する設定セットを選択します。
1. **設定セットの詳細**ページで、送信**先イベントの追加**を選択します。
1. **イベントの詳細**セクションで、**イベント送信先**名のわかりやすい名前を入力します。
1. **送信先タイプの**ドロップダウンから Amazon Data Firehose を選択します。
1. **IAM ロール arn** には、IAM ロールの ARN を入力します。IAM ロール ARN の詳細については、「」を参照してください[Amazon Data Firehose の IAM ポリシー](configuration-sets-kinesis-creating-role.md)。
1. **配信ストリーム arn** には、イベントを配信する Amazon Data Firehose ロググループの ARN を入力します。
1. **イベント発行**を有効にします。
1. **イベントタイプ**で、以下を選択します。
+ **すべての SMS イベント (推奨）** – にリストされているすべての SMS イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon Data Firehose に送信するには、このオプションを選択します。
+ **カスタム SMS イベント** – Amazon Data Firehose に送信する特定の SMS イベントを選択します。イベントのリストを編集するには、**SMS イベント選択の編集**を選択します。**SMS イベント選択の編集**で、Amazon Data Firehose に送信するイベントのみをチェックします。**選択を保存**を選択します。
+ **すべての音声イベント (推奨）** – にリストされているすべての音声イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon Data Firehose に送信するには、このオプションを選択します。
+ **カスタム音声イベント** – Amazon Data Firehose に送信する特定の音声イベントを選択します。イベントのリストを編集するには、**音声イベント選択の編集**を選択します。**音声イベント選択の編集** で、Amazon Data Firehose に送信するイベントのみをチェックします。**選択を保存**を選択します。
+ **すべての MMS イベント (推奨）** – にリストされているすべての MMS イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon Data Firehose に送信するには、このオプションを選択します。
+ **カスタム MMS イベント** – Amazon Data Firehose に送信する特定の MMS イベントを選択します。イベントのリストを編集するには、**MMS イベント選択の編集**を選択します。**MMS イベント選択の編集**では、Amazon Data Firehose に送信するイベントのみをチェックします。**選択を保存**を選択します。
1. [** イベントの作成 **] を選択します。
------
#### [ Create Amazon Data Firehose event destination (AWS CLI) ]
IAM ロールと Amazon Data Firehose 配信ストリームを作成したら、イベント送信先を作成できます。
[create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html) コマンドを使用して、イベント送信先を作成できます。
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream
```
上のコマンドに、以下の変更を加えます。
+ *eventDestinationName* を、イベント送信先を説明する名前に置き換えます。
+ *configurationSet* を、イベント送信先に関連付ける設定セットの名前に置き換えます。
+ *eventTypes* を、 にリストされている 1 つ以上のイベントタイプに置き換えます[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md)。
+ `IamRoleArn` の値を、[Amazon Data Firehose の IAM ポリシー](configuration-sets-kinesis-creating-role.md) で説明されているポリシーを持つ IAM ロールの Amazon リソースネーム (ARN) に置き換えます。
+ の値を、イベントを送信する Amazon Data Firehose ストリームの ARN `DeliveryStreamArn`に置き換えます。
------
# AWS エンドユーザーメッセージング SMS で Amazon Data Firehose イベント送信先を編集する
AWS エンドユーザーメッセージング SMS コンソールまたは AWS CLI を使用して、Amazon Data Firehose イベント送信先を編集します。
------
#### [ Update Amazon Data Firehose event destination (Console) ]
AWS End User Messaging SMS コンソールを使用して Amazon Data Firehose イベント送信先を更新するには、次の手順に従います。
1. 「https://[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).com で AWS エンドユーザーメッセージング SMS コンソールを開きます。
1. ナビゲーションペインの**「設定**」で、**「設定セット**」を選択します。
1. **設定セット**ページで、イベント送信先を追加する設定セットを選択します。
1. **設定セット**ページで、編集する設定セットを選択します。
1. **設定セットの詳細**ページで、Amazon Data Firehose イベントの送信先を選択し、**編集**します。
1. **IAM ロール arn** には、IAM ロールの ARN を入力します。IAM ロール ARN の詳細については、「」を参照してください[Amazon Data Firehose の IAM ポリシー](configuration-sets-kinesis-creating-role.md)。
1. **配信ストリーム arn** には、イベントを配信する Amazon Data Firehose ロググループの ARN を入力します。
1. **イベントタイプ**で、以下を選択します。
+ **すべての SMS イベント (推奨）** – にリストされているすべての SMS イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon Data Firehose に送信するには、このオプションを選択します。
+ **カスタム SMS イベント** – このオプションを選択すると、CloudWatch に送信する特定の SMS イベントが選択されます。イベントのリストを編集するには、**SMS イベント選択の編集**を選択します。**SMS イベント選択の編集**では、Amazon Data Firehose に送信するイベントのみをチェックします。**選択を保存**を選択します。
+ **すべての音声イベント (推奨）** – にリストされているすべての音声イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon Data Firehose に送信するには、このオプションを選択します。
+ **カスタム音声イベント** – このオプションを選択すると、Amazon Data Firehose に送信する特定の音声イベントが選択されます。イベントのリストを編集するには、**音声イベント選択の編集**を選択します。**音声イベント選択の編集**では、Amazon Data Firehose に送信するイベントのみをチェックします。**選択を保存**を選択します。
+ **すべての MMS イベント (推奨）** – にリストされているすべての MMS イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon Data Firehose に送信するには、このオプションを選択します。
+ **カスタム MMS イベント** – このオプションを選択すると、CloudWatch に送信する特定の MMS イベントが選択されます。イベントのリストを編集するには、**MMS イベント選択の編集**を選択します。**MMS イベント選択の編集**では、Amazon Data Firehose に送信するイベントのみをチェックします。**選択を保存**を選択します。
1. **イベントの編集** を選択します。
------
#### [ Update Amazon Data Firehose event destination (AWS CLI) ]
[update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html) コマンドを使用して、イベント送信先を更新できます。
Amazon Data Firehose イベント送信先を更新する手順は、イベント送信先を作成するプロセスと似ています。
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream
```
上のコマンドに、以下の変更を加えます。
+ *eventDestinationName* を、変更するイベント送信先の名前に置き換えます。
+ *configurationSet* を、イベント送信先に関連付ける設定セットの名前に置き換えます。イベント送信先に、異なる設定セットに関連付けることができます。
+ *eventTypes* を、[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md) に列挙されているイベントタイプのいずれかに置き換えます。
+ `IamRoleArn` の値を、[Amazon Data Firehose の IAM ポリシー](configuration-sets-kinesis-creating-role.md) で説明されているポリシーを持つ IAM ロールの Amazon リソースネーム (ARN) に置き換えます。
+ の値を、イベントを送信する Amazon Data Firehose ストリームの ARN `DeliveryStreamArn`に置き換えます。
------
# AWS エンドユーザーメッセージング SMS で Amazon Data Firehose イベント送信先を削除する
AWS エンドユーザーメッセージング SMS コンソールまたは AWS CLI を使用して、Amazon Data Firehose イベント送信先を削除します。
------
#### [ Delete an Amazon Data Firehose event destination (Console) ]
イベント送信先を削除するプロセスは、削除するイベント送信先のタイプにかかわらず、同じです。
**コンソールで Amazon Data Firehose イベント送信先を削除するには**
1. 「https://[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).com で AWS エンドユーザーメッセージング SMS コンソールを開きます。
1. ナビゲーションペインの**「設定**」で、**「設定セット**」を選択します。
1. **設定セット**ページで、イベント送信先を削除する設定セットを選択します。
1. **すべての送信先**セクションで、イベントの送信先を選択し、**削除**を選択します。
------
#### [ Delete an Amazon Data Firehose event destination (AWS CLI) ]
[delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html) コマンドを使用して、イベント送信先を削除できます。
イベント送信先を削除するプロセスは、削除するイベント送信先のタイプにかかわらず、同じです。
**で Amazon Data Firehose イベント送信先を削除するには AWS CLI**
+ コマンドラインから、以下のコマンドを実行します。
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
上のコマンドに、以下の変更を加えます。
+ *eventDestinationName* を、削除するイベント送信先の Amazon リソースネーム (ARN)に置き換えます。
+ *configurationSetName* を、イベント送信先に関連付ける設定セットの名前または ARN に置き換えます。
------
# AWS エンドユーザーメッセージング SMS で Amazon SNS イベント送信先を設定する
Amazon Simple Notification Service (Amazon SNS) は、アプリケーション、エンドユーザー、およびデバイスで通知を瞬時に送受信できるようにするウェブサービスです。Amazon SNS の詳細については、『[Amazon Simple Notification Service デベロッパーガイド](https://docs.aws.amazon.com/sns/latest/dg/)』を参照してください。
このセクションの一部の例では、 AWS Command Line Interfaceが既にインストールされ、設定されていることを前提としています。の設定の詳細については AWS CLI、[AWS Command Line Interface 「 ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)」を参照してください。
**Topics**
+ [Amazon SNS アクセスポリシー](configuration-sets-sns-creating-role.md)
+ [Amazon SNS イベント送信先を作成する](configuration-sets-sns-add.md)
+ [Amazon SNS イベント送信先を編集する](configuration-sets-sns-edit.md)
+ [Amazon SNS イベント送信先を削除する](configuration-sets-sns-delete.md)
# Amazon SNS アクセスポリシー
Amazon SNS トピックへのアクセスは、Amazon SNS トピックにアタッチされた*リソースポリシー*によって制御されます。これは、*アクセスポリシー*とも呼ばれます。Amazon SNS *アクセスポリシー*の詳細については、「*Amazon SNS デベロッパーガイド*」の「[Identity and Access Management](https://docs.aws.amazon.com/sns/latest/dg/security-iam.html)」を参照してください。
**注記**
Amazon SNS トピックで でサーバー側の暗号化が有効になってい AWS Key Management Service る場合は、関連する[対称暗号化カスタマー](#configuration-sets-sns-creating-role-encrypted)マネージドキーにもポリシーを追加します。
次のステートメントを使用して*アクセスポリシー*を更新し、 AWS エンドユーザーメッセージング SMS が Amazon SNS トピックに発行できるようにします。
+ *111122223333* を AWS アカウントの一意の ID に置き換えます。
+ *TopicName* を Amazon SNS の名前に置き換えます。
+ *Region* AWS リージョン を、Amazon SNS トピックと設定セットを含む に置き換えます。
+ *ConfigSetName* を設定セットの名前に置き換えます。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:TopicName",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
]
}
```
------
## 暗号化された Amazon SNS トピックのアクセスポリシー
Amazon SNS トピックで でサーバー側の暗号化が有効になっている場合は AWS Key Management Service、関連する対称暗号化カスタマーマネージドキーに次のポリシーを追加します。Amazon SNS の マネージドキーは変更できないため、カスタマー AWS マネージドキーにポリシーを追加する必要があります。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "example-statement-ID",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
# AWS エンドユーザーメッセージング SMS で Amazon SNS イベント送信先を作成する
Amazon SNS イベント送信先を作成するには、まず Amazon SNS トピックを作成する必要があります。Amazon SNS トピックの作成の詳細については、*「Amazon Simple Notification Service* [デベロッパーガイド」の「トピック](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html)の作成」を参照してください。
また、イベント送信先を関連付ける設定セットを既に設定している必要があります。「」を参照してください[AWS End User Messaging SMS の設定セット](configuration-sets.md)。
------
#### [ Create an Amazon SNS event destination (Console) ]
AWS エンドユーザーメッセージング SMS コンソールを使用して Amazon SNS イベント送信先を作成するには、次の手順に従います。
1. 「https://[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).com で AWS エンドユーザーメッセージング SMS コンソールを開きます。
1. ナビゲーションペインの**「設定**」で、**「設定セット**」を選択します。
1. **設定セット**ページで、イベント送信先を追加する設定セットを選択します。
1. **設定セットの詳細**ページで、**送信先イベントの追加**を選択します。
1. **イベントの詳細** セクションに名前を入力します。
1. **送信先タイプの**ドロップダウンから Amazon SNS を選択します。
1. **新しい Amazon SNS トピック** – AWS エンドユーザーメッセージング SMS でアカウントにトピックを作成する場合は、このオプションを選択します。トピックは、必要なすべてのパーミッションがあれば、自動的に作成されます。Amazon SNS トピックの詳細については、「Amazon [Simple Notification Service デベロッパーガイド」の「Amazon](https://docs.aws.amazon.com/sns/latest/dg/) [Amazon SNS の設定](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)」を参照してください。
1. **既存の Amazon SNS トピック** – Topic **arn **ドロップダウンに既存の Amazon SNS トピックがある場合は、このオプションを選択します。
1. **イベントタイプ**で、以下を選択します。
+ **すべての SMS イベント (推奨）** – にリストされているすべての SMS イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon SNS に送信するには、このオプションを選択します。
+ **カスタム SMS イベント** – Amazon SNS に送信する特定の SMS イベントを選択します。イベントのリストを編集するには、**「SMS イベント選択の編集**」を選択します。**SMS イベント選択の編集**では、Amazon SNS に送信するイベントのみをチェックします。**選択を保存**を選択します。
+ **すべての音声イベント (推奨）** – にリストされているすべての音声イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon SNS に送信するには、このオプションを選択します。
+ **カスタム音声イベント** – Amazon SNS に送信する特定の音声イベントを選択します。イベントのリストを編集するには、**音声イベント選択の編集**を選択します。**音声イベント選択の編集** で、Amazon SNS に送信するイベントのみをチェックします。**選択を保存**を選択します。
+ **すべての MMS イベント (推奨）** – にリストされているすべての MMS イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon SNS に送信するには、このオプションを選択します。
+ **カスタム MMS イベント** – Amazon SNS に送信する特定の MMS イベントを選択します。イベントのリストを編集するには、**MMS イベント選択の編集**を選択します。**MMS イベント選択の編集**では、Amazon SNS に送信するイベントのみをチェックします。**選択を保存**を選択します。
1. [** イベントの作成 **] を選択します。
------
#### [ Create an Amazon SNS event destination (AWS CLI) ]
[create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html) コマンドを使用して、イベント送信先を作成できます。
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
上のコマンドに、以下の変更を加えます。
+ *eventDestinationName* を、イベント送信先のわかりやすい名前に置き換えます。
+ *configurationSet* を、イベント送信先に関連付ける設定セットの名前に置き換えます。
+ *eventTypes* を、[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md) に列挙されているイベントタイプのいずれかに置き換えます。
+ `TopicArn` の値を、イベントの送信先にする Amazon SNS トピックの Amazon リソースネーム (ARN) に置き換えます。
------
# AWS エンドユーザーメッセージング SMS で Amazon SNS イベント送信先を編集する
AWS エンドユーザーメッセージング SMS コンソールまたは AWS CLI を使用して、Amazon SNS イベント送信先を編集します。
------
#### [ Update an Amazon SNS event destination (Console) ]
AWS End User Messaging SMS コンソールを使用して AWS End User Messaging SMS イベント送信先を更新するには、次の手順に従います。
1. 「https://[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).com で AWS エンドユーザーメッセージング SMS コンソールを開きます。
1. ナビゲーションペインの**「設定**」で、**「設定セット**」を選択します。
1. **設定セット**ページで、イベント送信先を追加する設定セットを選択します。
1. **設定セット**ページで、編集する設定セットを選択します。
1. **設定セットの詳細**ページで、Amazon SNS イベントの送信先を選択し、**編集**します。
1. **送信先タイプの**ドロップダウンから Amazon SNS を選択します。
1. **新しい Amazon SNS トピック** – このオプションを選択すると、 AWS End User Messaging SMS はアカウントにトピックを作成します。トピックは、必要なすべてのパーミッションがあれば、自動的に作成されます。Amazon SNS トピックの詳細については、「Amazon [Simple Notification Service デベロッパーガイド」の「Amazon](https://docs.aws.amazon.com/sns/latest/dg/) [Amazon SNS の設定](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html)」を参照してください。
1. **既存の Amazon SNS トピック** – Topic **arn **ドロップダウンに既存の Amazon SNS トピックがある場合は、このオプションを選択します。
1. **イベントタイプ**で、以下を選択します。
+ **すべての SMS イベント (推奨）** – にリストされているすべての SMS イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon SNS に送信するには、このオプションを選択します。
+ **カスタム SMS イベント** – このオプションを選択すると、Amazon SNS に送信する特定の SMS イベントが選択されます。イベントのリストを編集するには、**「SMS イベント選択の編集**」を選択します。**SMS イベント選択の編集**では、Amazon SNS に送信するイベントのみをチェックします。**選択を保存**を選択します。
+ **すべての音声イベント (推奨）** – にリストされているすべての音声イベントを Amazon SNS に送信する[イベントタイプ](configuration-sets-event-types.md)には、このオプションを選択します。
+ **カスタム音声イベント** – このオプションを選択すると、Amazon SNS に送信する特定の音声イベントが選択されます。イベントのリストを編集するには、**音声イベント選択の編集**を選択します。**音声イベント選択の編集** で、Amazon SNS に送信するイベントのみをチェックします。**選択を保存**を選択します。
+ **すべての MMS イベント (推奨）** – にリストされているすべての MMS イベント[イベントタイプ](configuration-sets-event-types.md)を Amazon SNS に送信するには、このオプションを選択します。
+ **カスタム MMS イベント** – このオプションを選択すると、Amazon SNS に送信する特定の MMS イベントが選択されます。イベントのリストを編集するには、**MMS イベント選択の編集**を選択します。**MMS イベント選択の編集**では、Amazon SNS に送信するイベントのみをチェックします。**選択を保存**を選択します。
1. **イベントの編集** を選択します。
------
#### [ Update an Amazon SNS event destination (AWS CLI) ]
[update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html) コマンドを使用して、イベント送信先を更新できます。
Amazon SNS イベント送信先を更新する手順は、イベント送信先を作成するプロセスと同様です。
**で Amazon SNS イベント送信先を更新するには AWS CLI**
+ コマンドラインから、以下のコマンドを実行します。
```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
上のコマンドに、以下の変更を加えます。
+ *eventDestinationName* を、変更するイベント送信先の名前に置き換えます。
+ *configurationSet* を、イベント送信先に関連付ける設定セットの名前に置き換えます。イベント送信先に、異なる設定セットに関連付けることができます。
+ *eventTypes* を、 にリストされている 1 つ以上のイベントタイプに置き換えます[SMS、MMS、音声のイベントタイプ](configuration-sets-event-types.md)。
+ `TopicArn` の値を、イベントの送信先にする Amazon SNS トピックの Amazon リソースネーム (ARN) に置き換えます。
------
# AWS エンドユーザーメッセージング SMS で Amazon SNS イベント送信先を削除する
AWS エンドユーザーメッセージング SMS コンソールまたは AWS CLI を使用して、Amazon SNS トピックを削除します。
------
#### [ Delete an Amazon SNS event destination (Console) ]
イベント送信先を削除するプロセスは、削除するイベント送信先のタイプにかかわらず、同じです。
**コンソールで Amazon SNS イベント送信先を削除するには**
1. 「https://[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).com で AWS エンドユーザーメッセージング SMS コンソールを開きます。
1. ナビゲーションペインの**「設定**」で、**「設定セット**」を選択します。
1. **設定セット**ページで、イベント送信先を削除する設定セットを選択します。
1. **すべての送信先**セクションで、イベントの送信先を選択し、**削除**を選択します。
------
#### [ Delete an Amazon SNS event destination (AWS CLI) ]
[delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html) コマンドを使用して、イベント送信先を削除できます。
イベント送信先を削除するプロセスは、削除するイベント送信先のタイプにかかわらず、同じです。
**で Amazon SNS イベント送信先を削除するには AWS CLI**
+ コマンドラインから、以下のコマンドを実行します。
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
上のコマンドに、以下の変更を加えます。
+ *eventDestinationName* を、削除するイベント送信先の Amazon リソースネーム (ARN)に置き換えます。
+ *configurationSetName* を、イベント送信先に関連付ける設定セットの名前または ARN に置き換えます。
------