Festlegen von SMS-Messaging-Einstellungen - Amazon Simple Notification Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Festlegen von SMS-Messaging-Einstellungen

Verwenden Sie Amazon SNS, um Einstellungen für SMS-Messaging anzugeben. Sie können beispielsweise festlegen, ob Zustellung zu Kosten oder zur Zuverlässigkeit optimiert werden, Ihr monatliches Ausgabelimit, wie Zustellungen protokolliert werden und ob Sie tägliche SMS-Nutzungsberichte erhalten möchten.

Diese Einstellungen gelten für jede SMS-Nachricht, die Sie von Ihrem Konto senden. Sie können jedoch auch beim Senden einer einzelnen Nachricht überschrieben werden. Weitere Informationen finden Sie unter Veröffentlichen auf einem Mobiltelefon.

Einstellung der SMS-Nachrichteneinstellungen mit dem AWS Management Console

  1. Melden Sie sich bei der Amazon SNS-Konsole an.

  2. Wählen Sie eine Region aus, die SMS-Messaging unterstützt.

  3. Wählen Sie im Navigationsbereich Mobile (Mobil) und dann Text messaging (SMS) (Textnachrichten (SMS)) aus.

  4. Wählen Sie auf der Seite Mobile text messaging (SMS) (Mobile Texttnachrichten (SMS)) im Abschnitt Text messaging preferences (Textnachrichteneinstellungen) die Option Edit (Bearbeiten) aus.

  5. Führen Sie auf der Seite Edit text messaging preferences (SMS-Einstellungen bearbeiten) im Abschnitt Details Folgendes durch:

    1. Wählen Sie für Default message type (Standardnachrichtentyp) eine der folgenden Optionen aus:

      • Werbenachrichten – Nicht kritische Nachrichten (zum Beispiel Marketing). Amazon SNS optimiert die Übertragung von Nachrichten im Hinblick auf möglichst niedrige Kosten.

      • Transaktionsnachrichten (Standard) – Kritische Nachrichten, die Kundentransaktionen unterstützen, wie beispielsweise One-Time-Passcodes für eine Multi-Faktor-Authentifizierung (MFA). Amazon SNS optimiert die Übertragung von Nachrichten im Hinblick auf höchste Zuverlässigkeit.

      Informationen zu den Gebühren für Aktions- und Transaktionsnachrichten finden Sie unter Global SMS Pricing.

    2. (Optional) Geben Sie für Account spend limit (Kontoausgabenlimit) den Betrag in US-Dollar ein, den Sie pro Kalendermonat für SMS-Nachrichten ausgeben möchten.

      Wichtig
      • Standardmäßig ist das Ausgabenkontingent auf 1,00 US-Dollar festgelegt. Wenn Sie das Service-Kontingent erhöhen möchten, senden Sie eine Anfrage.

      • Wenn die in der Konsole festgelegte Menge Ihr Service-Kontingent überschreitet, stoppt Amazon SNS die Veröffentlichung von SMS-Nachrichten.

      • Da Amazon SNS ein verteiltes System ist, beendet es das Senden von SMS-Nachrichten innerhalb von einigen Minuten nach der Überschreitung des Ausgabenkontingents. Wenn Sie während dieses Zeitraums weiter SMS-Nachrichten senden, können Kosten entstehen, die Ihr Kontingent überschreiten.

  6. (Optional) Geben Sie im Feld Default sender ID (Standard-Sender-ID) eine benutzerdefinierte ID ein, wie z. B. Ihr Unternehmen, die als Sender des Empfängergeräts angezeigt wird.

    Anmerkung

    Der Support für Sender-IDs variiert je nach Land.

  7. (Optional) Geben Sie den Namen des Amazon S3 Bucket Namen für Nutzungsberichte ein.

    Anmerkung

    Die S3-Bucket-Richtlinie muss Schreibzugriff auf Amazon SNS erteilen.

  8. Wählen Sie Änderungen speichern aus.

Einstellung von Einstellungen (AWS SDKs)

Um Ihre SMS-Einstellungen mithilfe eines der AWS SDKs festzulegen, verwenden Sie die Aktion in diesem SDK, die der SetSMSAttributes Anfrage in der Amazon SNS SNS-API entspricht. Mit dieser Anforderung können Sie Werte zu den verschiedenen SMS-Attributen zuweisen – beispielsweise das monatliche Ausgabenkontingent und Ihren Standard-SMS-Typ (Werbung oder Transaktionen). Für alle SMS-Attribute siehe SetSMSAttributes in der Amazon Simple Notification Service API-Referenz.

Die folgenden Codebeispiele zeigen, wie Sie es verwenden. SetSMSAttributes

C++
SDK für C++
Anmerkung

Es gibt noch mehr dazu GitHub. Sie sehen das vollständige Beispiel und erfahren, wie Sie das AWS -Code-Beispiel-Repository einrichten und ausführen.

So verwenden Sie Amazon SNS zum Festlegen des DefaultSMSType-Attributs.

//! Set the default settings for sending SMS messages. /*! \param smsType: The type of SMS message that you will send by default. \param clientConfiguration: AWS client configuration. \return bool: Function succeeded. */ bool AwsDoc::SNS::setSMSType(const Aws::String &smsType, const Aws::Client::ClientConfiguration &clientConfiguration) { Aws::SNS::SNSClient snsClient(clientConfiguration); Aws::SNS::Model::SetSMSAttributesRequest request; request.AddAttributes("DefaultSMSType", smsType); const Aws::SNS::Model::SetSMSAttributesOutcome outcome = snsClient.SetSMSAttributes( request); if (outcome.IsSuccess()) { std::cout << "SMS Type set successfully " << std::endl; } else { std::cerr << "Error while setting SMS Type: '" << outcome.GetError().GetMessage() << "'" << std::endl; } return outcome.IsSuccess(); }
  • Details zu API finden Sie unter SetSMSAttributes in der AWS SDK for C++ -API-Referenz.

CLI
AWS CLI

So legen Sie SMS-Nachrichtenattribute fest

Im folgenden set-sms-attributes-Beispiel wird die standardmäßige Absender-ID für SMS-Nachrichten auf MyName festgelegt.

aws sns set-sms-attributes \ --attributes DefaultSenderID=MyName

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

  • API-Details finden Sie unter SetSMSAttributes in der AWS CLI -Befehlsreferenz.

Java
SDK für Java 2.x
Anmerkung

Es gibt noch mehr GitHub. Sie sehen das vollständige Beispiel und erfahren, wie Sie das AWS -Code-Beispiel-Repository einrichten und ausführen.

import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.sns.SnsClient; import software.amazon.awssdk.services.sns.model.SetSmsAttributesRequest; import software.amazon.awssdk.services.sns.model.SetSmsAttributesResponse; import software.amazon.awssdk.services.sns.model.SnsException; import java.util.HashMap; /** * Before running this Java V2 code example, set up your development * environment, including your credentials. * * For more information, see the following documentation topic: * * https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html */ public class SetSMSAttributes { public static void main(String[] args) { HashMap<String, String> attributes = new HashMap<>(1); attributes.put("DefaultSMSType", "Transactional"); attributes.put("UsageReportS3Bucket", "janbucket"); SnsClient snsClient = SnsClient.builder() .region(Region.US_EAST_1) .build(); setSNSAttributes(snsClient, attributes); snsClient.close(); } public static void setSNSAttributes(SnsClient snsClient, HashMap<String, String> attributes) { try { SetSmsAttributesRequest request = SetSmsAttributesRequest.builder() .attributes(attributes) .build(); SetSmsAttributesResponse result = snsClient.setSMSAttributes(request); System.out.println("Set default Attributes to " + attributes + ". Status was " + result.sdkHttpResponse().statusCode()); } catch (SnsException e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } } }
  • Details zu API finden Sie unter SetSMSAttributes in der AWS SDK for Java 2.x -API-Referenz.

JavaScript
SDK für JavaScript (v3)
Anmerkung

Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das AWS -Code-Beispiel- einrichten und ausführen.

Erstellen Sie den Client in einem separaten Modul und exportieren Sie ihn.

import { SNSClient } from "@aws-sdk/client-sns"; // The AWS Region can be provided here using the `region` property. If you leave it blank // the SDK will default to the region set in your AWS config. export const snsClient = new SNSClient({});

Importieren Sie das SDK- und Client-Module und rufen Sie die API auf.

import { SetSMSAttributesCommand } from "@aws-sdk/client-sns"; import { snsClient } from "../libs/snsClient.js"; /** * @param {"Transactional" | "Promotional"} defaultSmsType */ export const setSmsType = async (defaultSmsType = "Transactional") => { const response = await snsClient.send( new SetSMSAttributesCommand({ attributes: { // Promotional – (Default) Noncritical messages, such as marketing messages. // Transactional – Critical messages that support customer transactions, // such as one-time passcodes for multi-factor authentication. DefaultSMSType: defaultSmsType, }, }), ); console.log(response); // { // '$metadata': { // httpStatusCode: 200, // requestId: '1885b977-2d7e-535e-8214-e44be727e265', // extendedRequestId: undefined, // cfId: undefined, // attempts: 1, // totalRetryDelay: 0 // } // } return response; };
PHP
SDK für PHP
Anmerkung

Es gibt noch mehr GitHub. Sie sehen das vollständige Beispiel und erfahren, wie Sie das AWS -Code-Beispiel-Repository einrichten und ausführen.

$SnSclient = new SnsClient([ 'profile' => 'default', 'region' => 'us-east-1', 'version' => '2010-03-31' ]); try { $result = $SnSclient->SetSMSAttributes([ 'attributes' => [ 'DefaultSMSType' => 'Transactional', ], ]); var_dump($result); } catch (AwsException $e) { // output error message if fails error_log($e->getMessage()); }