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.
# Beispiel für das Senden einer MMS-Nachricht mithilfe von AWS End User Messaging SMS
Wenn Sie eine gemeinsam genutzte Ressource verwenden, müssen Sie den vollständigen Amazon-Ressourcennamen (ARN) der Ressource verwenden. Sie können die AWS CLI oder AWS End User Messaging SMS and Voice v2 API verwenden, um MMS-Nachrichten an Ihre Kunden zu senden.
Verwenden Sie den [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) AWS CLI Befehl, um eine MMS-Nachricht zu senden. Weitere Informationen zur Konfiguration von finden [Sie unter Configure the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/). AWS CLI
**Wichtig**
MMS-Funktionen sind nur in einigen Ländern verfügbar. Weitere Informationen zu den Ländern, in denen SMS und MMS unterstützt werden, finden Sie unter [Unterstützte Länder und Regionen für SMS-Nachrichten mit AWS Endbenutzer-Nachrichten-SMS](phone-numbers-sms-by-country.md) und. [Unterstützte Länder und Regionen für MMS-Nachrichten in End User Messaging SMS AWS](phone-numbers-mms-by-country.md)
Informationen darüber, ob Ihre Auskunftsidentität MMS-fähig ist, finden Sie unter. [Sehen Sie sich den Status und die Funktionen einer Telefonnummer in AWS End User Messaging SMS an](phone-numbers-status.md)
Um eine gemeinsam genutzte Ressource zu verwenden, müssen Sie den vollständigen Amazon-Ressourcennamen (ARN) verwenden.
## Voraussetzungen
Bevor Sie beginnen, müssen die folgenden Voraussetzungen erfüllt sein:
+ Sie müssen über eine Absenderidentität verfügen, die das [Senden einer MMS-Nachricht unterstützt](phone-numbers-mms-by-country.md#phone-numbers-mms-by-country.title).
+ Sie müssen Ihre Mediendateien in einen Amazon S3 S3-Bucket hochladen, der sich in derselben Identität AWS-Region wie Ihre MMS-fähige Originationsidentität befindet, siehe. [Einen Amazon S3 S3-Bucket für MMS-Dateien einrichten](#send-mms-message-bucket)
Eine Liste der unterstützten Dateitypen und -größen finden Sie unter [ MMS-Dateitypen, Größen- und Zeichenbeschränkungen Erfahren Sie mehr über die MMS-Dateigröße, die Beschränkungen des Dateityps und die maximale Anzahl von Zeichen, die eine MMS enthalten kann. MMS-DateitypenGröße der MMS-DateiMMS-Zeichenlimit Eine einzelne MMS-Mediendatei kann bis zu 2 MB für alle Bildtypen (GIF, JPEG, PNG) und 600 KB für alle Audio- und Video-Mediendateitypen groß sein. Der Textnachrichtentext einer MMS kann 1600 Zeichen aus einem beliebigen Zeichensatz enthalten. Im Gegensatz zu SMS werden MMS-Nachrichten beim Senden nicht in mehrere Teile aufgeteilt. Wenn Sie umfangreiche Textnachrichten senden, erzielen Sie möglicherweise einen besseren Durchsatz beim Senden einer MMS-Nachricht, da sie nicht in mehrere Teile aufgeteilt sind.
****
| Dateityp | MIME-Typen | Maximale Dateigröße |
| --- | --- | --- |
| Format für den Austausch von Grafiken | `image/gif` | 2 MB |
| Gemeinsame Expertengruppe für Fotografie | `image/jpeg` | 2 MB |
| Tragbare Netzwerkgrafiken | `image/png` | 2 MB |
| Tag-Bild-Dateiformat | `image/tiff` | 600 KB |
| Partnerschaftsprojekt der dritten Generation | `audio/3gpp`, `video/3gpp` | 600 KB |
| Partnerschaftsprojekt 2 der dritten Generation | `audio/3gpp2`, `video/3gpp2` | 600 KB |
| Adaptive Multi-Rate | `audio/amr` | 600 KB |
| MPEG-4 | `audio/mp4`, `video/mp4` | 600 KB |
| Expertengruppe für bewegte Bilder | `audio/mpeg`
Es werden nur MP3 Dateien unterstützt für `audio/mpeg` | 600 KB |
| ogg | `audio/ogg` | 600 KB |
| QuickTime | `video/quicktime` | 600 KB |
| WebM | `video/webm` | 600 KB |
| iCalendar | `text/calendar` | 600 KB |
| vKarte | `text/vcard`, `text/x-vcard` | 600 KB |
| Portable Document Format | `application/pdf` | 600 KB | ](mms-limitations-character.md#mms-limitations-character.title)
+ Das S3 URIs jeder MMS-Datei.
+ Die für den Aufruf verwendete Identität `send-media-message` muss Lesezugriff auf den Amazon S3 S3-Bucket haben, der Ihre Mediendateien enthält. Weitere Informationen zur Einrichtung des Lesezugriffs finden Sie unter [Beispiele für identitätsbasierte Richtlinien für Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html) im [Amazon S3 S3-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).
## Senden Sie eine MMS mit dem AWS CLI
Die einzigen erforderlichen Parameter für [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html)sind `destination-phone-number` und`origination-identity`. Sie können eine Nachricht senden, die nur aus Text besteht, indem Sie den `media-urls` Parameter weglassen. Sie können auch eine Nachricht senden, die nur Mediendateien enthält, indem Sie den Parameter weglassen. `message-body`
**Um eine MMS-Nachricht zu senden**
+ Geben Sie in der Befehlszeile folgenden Befehl ein:
```
aws pinpoint-sms-voice-v2 --region '{{us-east-1}}' send-media-message --destination-phone-number {{+12065550150}} --origination-identity {{+14255550120}} --message-body '{{text body}}' --media-urls '{{s3://s3-bucket/media_file.jpg}}'
```
Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:
+ {{us-east-1}}Ersetzen Sie es durch AWS-Region das, in dem Ihre ursprüngliche Identität gespeichert ist.
+ Ersetzen Sie es {{\+12065550150}} durch die Ziel-Telefonnummer.
+ {{\+14255550120}}Ersetzen Sie es durch Ihre ursprüngliche Identität. Die Absenderidentität muss die Zieltelefonnummer senden können `ACTIVE` und können.
+ Ersetze es {{text body}} durch deine Textnachricht.
+ {{s3://s3-bucket/media\_file.jpg}}Ersetzen Sie es durch den S3-URI der MMS-Datei. Die unterstützten Mediendateiformate sind unter aufgeführt[MMS-Dateitypen, Größen- und Zeichenbeschränkungen](mms-limitations-character.md). Weitere Informationen zum Erstellen eines S3-Buckets und zum Verwalten von Objekten finden Sie unter [Einen Amazon S3 S3-Bucket für MMS-Dateien einrichten](#send-mms-message-bucket) [Erstellen eines Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) und [Hochladen von Objekten](https://docs.aws.amazon.com//AmazonS3/latest/userguide/upload-objects.html) im [Amazon S3 S3-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).
Wenn AWS End User Messaging SMS den Befehl akzeptiert, erhalten Sie den`MessageID`. Dies bedeutet nur, dass der Befehl erfolgreich empfangen wurde und nicht, dass das Zielgerät die Nachricht bereits empfangen hat. Eine Liste der Fehlercodes finden Sie unter [SendMediaMessage Fehler](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SendMediaMessage.html#API_SendMediaMessage_Errors).
```
{
"MessageId": "string"
}
```
## Einen Amazon S3 S3-Bucket für MMS-Dateien einrichten
Ihre MMS-Dateien müssen in einem Amazon S3 S3-Bucket gespeichert werden. Der Amazon S3 S3-Bucket muss sich in derselben AWS-Konto und AWS-Region wie Ihre MMS-fähige Originationsidentität befinden. Diese Anweisungen zeigen, wie Sie einen Amazon S3 S3-Bucket erstellen, eine Datei hochladen und den URI für die Datei erstellen. Weitere Informationen zu Amazon S3 S3-Befehlen finden Sie unter [Verwenden von High-Level-Befehlen (s3) mit der AWS-CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html). Weitere Informationen zur Konfiguration von finden [Sie unter Configure the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) im [AWS Command Line Interface Benutzerhandbuch](https://docs.aws.amazon.com/cli/latest/userguide/). AWS CLI
Verwenden Sie den Befehl [create-bucket, um einen Amazon S3 S3-Bucket zu erstellen](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html) AWS CLI . Geben Sie in der Befehlszeile folgenden Befehl ein:
```
aws s3api create-bucket --region '{{us-east-1}}' --bucket {{BucketName}}
```
Beim vorhergehenden Befehl:
+ Ersetzen Sie es {{us-east-1}} durch die Identität, in der AWS-Region Ihre MMS-fähige Originationsidentität steht.
+ {{BucketName}}Ersetzen Sie es durch den Namen des neuen Buckets.
Verwenden Sie den AWS CLI Befehl [cp](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy), um eine Datei in den Amazon S3 S3-Bucket zu kopieren. Geben Sie in der Befehlszeile folgenden Befehl ein:
```
aws s3 cp {{SourceFilePathAndName}} s3://{{BucketName}}/{{FileName}}
```
Beim vorhergehenden Befehl:
+ {{SourceFilePathAndName}}Ersetzen Sie durch den Dateipfad und den Namen der zu kopierenden Datei.
+ Ersetzen Sie {{BucketName}} durch den Namen Ihres Buckets.
+ {{FileName}}Ersetzen Sie durch den Namen, der für die Datei verwendet werden soll.
Der URI, der beim Senden verwendet werden soll, lautet:
```
s3://{{BucketName}}/{{FileName}}
```