SMS メッセージプリファレンスの設定

を使用して、SMS メッセージングの設定を指定します。Amazon SNSたとえば、コストと信頼性、毎月の使用量の上限、配信のログ記録方法、SMS の毎日の使用状況レポートにサブスクライブするかどうかを指定できます。

これらの設定は、アカウントから送信するすべての SMS メッセージに対して有効になりますが、個々のメッセージの送信時に上書きすることができます。詳細については、「携帯電話への発行」を参照してください。

AWS マネジメントコンソール を使用した SMS メッセージプリファレンスの設定

1. Amazon SNS コンソールにサインインします。

2. SMS メッセージングをサポートしているリージョンを選択します。

3. ナビゲーションパネルで、[Mobile (モバイル)]、[Text messaging (SMS) (テキストメッセージ (SMS))] を選択します。

4. [Mobile text messaging (SMS) (モバイルテキストメッセージ (SMS))] ページの [Text messaging preferences (テキストメッセージプリファレンス)] セクションで、[Edit (編集)] を選択します。

5. [テキストメッセージングの優先設定の編集] ページの [詳細] セクションで、以下の操作を実行します。

   1. [Default message type (デフォルトメッセージタイプ)] で、次のいずれかを選択します。

      • [Promotional (プロモーション)] (デフォルト) – 重要度が低いメッセージ (広告など)。Amazon SNS はメッセージの配信を最適化してコストを最小に抑えます。

      • [トランザクション] – 顧客のトランザクションをサポートする重要なメッセージ (たとえば、多要素認証のためのワンタイムパスコードなど)。Amazon SNS によってメッセージの配信が最適化され、最高の信頼性が実現されます。

      プロモーションおよびトランザクションメッセージの料金表の詳細については、「グローバル SMS 料金表」を参照してください。

   2. [Account spend limit (アカウントの使用料制限)] に、各暦月で SMS メッセージに使用する額 (USD) を入力します。

      重要

      • デフォルトでは、使用限度は 1.00 USD に設定されます。サービス限度を引き上げるには、リクエストを送信します。

      • コンソールに設定した量がサービス限度を超える場合、Amazon SNS は SMS メッセージの発行を停止します。

      • Amazon SNS は分散システムであるため、使用限度を超えると数分以内に SMS メッセージの送信を停止します。その間に SMS メッセージを送信し続けると、限度を超えるコストが発生する可能性があります。

6. (オプション) [Default sender ID (デフォルトの送信者 ID)] にカスタム ID (企業名など) を入力します。これは、受信デバイスに送信者として表示されます。

   注記

   送信者 IDs のサポートについては、国によって異なります。

7. (オプション) 使用状況レポートの バケット名Amazon S3を入力します。

   注記

   S3 バケットポリシーによって Amazon SNS への書き込みアクセスが付与される必要があります。

8. [Save changes] を選択します。

プリファレンスの設定 (AWS SDKs)

AWS のいずれかを使用して SMS プリファレンスを設定するには、SDKs API の SetSMSAttributes リクエストに対応する SDK のアクションを使用します。Amazon SNSこのリクエストによって、月ごとの使用限度およびデフォルトの SMS 型 (プロモーションまたはトランザクション) などの、異なる SMS の属性に値を割り当てます。すべての SMS 属性については、SetSMSAttributes の「」を参照してください。Amazon Simple Notification Service API Reference

以下の例では、Amazon SNS AWS で提供されている SDKs クライアントを使用して SMS プリファレンスを設定する方法について説明します。

注記

SDK を使用する前に、必ず AWS の認証情報を設定してください。詳細については、AWS SDK for .NET 開発者ガイドまたは AWS SDK for Java V2 開発者ガイドを参照してください。

AWS SDK for Java

以下の例では、AWS SDK for Java の AmazonSNSClient クラスの setSMSAttributes メソッドを使用します。この例では、異なる属性名の値を設定します。

public static void main(String[] args) {
	AmazonSNSClient snsClient = new AmazonSNSClient();
	setDefaultSmsAttributes(snsClient);
}

public static void setDefaultSmsAttributes(AmazonSNSClient snsClient) {
	SetSMSAttributesRequest setRequest = new SetSMSAttributesRequest()
			.addAttributesEntry("DefaultSenderID", "mySenderID")
			.addAttributesEntry("MonthlySpendLimit", "1")
			.addAttributesEntry("DeliveryStatusIAMRole", 
					"arn:aws:iam::123456789012:role/mySnsRole")
			.addAttributesEntry("DeliveryStatusSuccessSamplingRate", "10")
			.addAttributesEntry("DefaultSMSType", "Transactional")
			.addAttributesEntry("UsageReportS3Bucket", "sns-sms-daily-usage");
	snsClient.setSMSAttributes(setRequest);
	Map<String, String> myAttributes = snsClient.getSMSAttributes(new GetSMSAttributesRequest())
		.getAttributes();
	System.out.println("My SMS attributes:");
	for (String key : myAttributes.keySet()) {
		System.out.println(key + " = " + myAttributes.get(key));
	}
}

この例では、MonthlySpendLimit 属性の値を 1.00 USD に設定します。デフォルトでは、これは Amazon SNS で許可される最大額です。限度を引き上げる場合は 、リクエストを送信します。[New limit value (新しい制限値)] に、必要な月ごとの使用限度を入力します。[Use Case Description (申請理由の説明)] フィールドで、月ごとの SMS 使用限度の引き上げをリクエストしていることを説明します。AWS サポートチームは、お客様のリクエストに対して、24 時間以内に一次回答を行います。

属性が正しく設定されたことを確認するために、この例では、getSMSAttributes メソッドの結果を表示します。この例を実行すると、IDE のコンソール出力ウィンドウに属性が表示されます。

My SMS attributes:
DeliveryStatusSuccessSamplingRate = 10
UsageReportS3Bucket = sns-sms-daily-usage
DefaultSMSType = Transactional
DeliveryStatusIAMRole = arn:aws:iam::123456789012:role/mySnsRole
MonthlySpendLimit = 1
DefaultSenderID = mySenderID

AWS SDK for .NET

以下の例では、AWS SDK for .NET の AmazonSimpleNotificationServiceClient クラスの SetSMSAttributes メソッドを使用します。この例では、異なる属性名の値を設定します。

static void Main(string[] args)
{
    AmazonSimpleNotificationServiceClient snsClient = new AmazonSimpleNotificationServiceClient(Amazon.RegionEndpoint.USWest2);
    SetDefaultSmsAttributes(snsClient);            
}

public static void SetDefaultSmsAttributes(AmazonSimpleNotificationServiceClient snsClient)
{
    SetSMSAttributesRequest setRequest = new SetSMSAttributesRequest();
    setRequest.Attributes["DefaultSenderID"] = "mySenderID";
    setRequest.Attributes["MonthlySpendLimit"] =  "1";
    setRequest.Attributes["DeliveryStatusIAMRole"] = "arn:aws:iam::123456789012:role/mySnsRole";
    setRequest.Attributes["DeliveryStatusSuccessSamplingRate"] =  "10";
    setRequest.Attributes["DefaultSMSType"] = "Transactional";
    setRequest.Attributes["UsageReportS3Bucket"] = "sns-sms-daily-usage";
    SetSMSAttributesResponse setResponse = snsClient.SetSMSAttributes(setRequest);
    GetSMSAttributesRequest getRequest = new GetSMSAttributesRequest();
    GetSMSAttributesResponse getResponse = snsClient.GetSMSAttributes(getRequest);
    Console.WriteLine("My SMS attributes:");
    foreach (var item in getResponse.Attributes)
    {
        Console.WriteLine(item.Key + " = " + item.Value);
    }
}

この例では、MonthlySpendLimit 属性の値を 1.00 USD に設定します。デフォルトでは、これは Amazon SNS で許可される最大額です。限度を引き上げる場合は、ケースを送信します。[New limit value (新しい制限値)] に、必要な月ごとの使用限度を入力します。[Use Case Description (申請理由の説明)] フィールドで、月ごとの SMS 使用限度の引き上げをリクエストしていることを説明します。AWS サポートチームは、お客様のリクエストに対して、24 時間以内に一次回答を行います。

属性が正しく設定されたことを確認するために、この例では、GetSMSAttributes メソッドの結果を表示します。この例を実行すると、IDE のコンソール出力ウィンドウに属性が表示されます。

My SMS attributes:
DeliveryStatusSuccessSamplingRate = 10
UsageReportS3Bucket = sns-sms-daily-usage
DefaultSMSType = Transactional
DeliveryStatusIAMRole = arn:aws:iam::123456789012:role/mySnsRole
MonthlySpendLimit = 1
DefaultSenderID = mySenderID