기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS End User Messaging SMS를 사용하여 MMS 메시지를 전송하는 예제
공유 리소스를 사용하는 경우 해당 리소스의 전체 Amazon 리소스 이름(ARN)을 사용해야 합니다. AWS CLI 또는 AWS End User Messaging SMS 및 음성 v2 API를 사용하여 고객에게 MMS 메시지를 보낼 수 있습니다.
[send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) AWS CLI 명령을 사용하여 MMS 메시지를 전송합니다. 구성에 대한 자세한 내용은 [AWS Command Line Interface 사용 설명서](https://docs.aws.amazon.com/cli/latest/userguide/)[의 AWS CLI 구성을](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) AWS CLI참조하세요.
**중요**
MMS 기능은 일부 국가에서만 사용할 수 있습니다. SMS 및 MMS가 지원되는 국가에 대한 자세한 내용은 [AWS End User Messaging SMS를 사용한 SMS 메시징이 지원되는 국가 및 리전](phone-numbers-sms-by-country.md) 및 [AWS 최종 사용자 메시징 SMS에서 MMS 메시징이 지원되는 국가 및 리전](phone-numbers-mms-by-country.md) 섹션을 참조하세요.
발신 자격 증명이 MMS를 지원하는지 확인하려면 [AWS End User Messaging SMS에서 전화번호 상태 및 기능 보기](phone-numbers-status.md) 섹션을 참조하세요.
공유 리소스를 사용하려면 전체 Amazon 리소스 이름(ARN)을 사용해야 합니다.
## 사전 조건
시작하기 전에 다음 사전 요구 사항이 충족되어야 합니다.
+ [MMS 메시지 전송을 지원하는](phone-numbers-mms-by-country.md#phone-numbers-mms-by-country.title) 발신 자격 증명이 있어야 합니다.
+ 미디어 파일을 MMS 지원 발신 자격 증명 AWS 리전 과 동일한에 있는 Amazon S3 버킷에 업로드해야 합니다. 섹션을 참조하세요[MMS 파일용 Amazon S3 버킷 설정](#send-mms-message-bucket).
지원되는 파일 형식과 크기 목록은 [ MMS 파일 형식, 크기 및 문자 제한 MMS 파일 크기, 파일 형식 제한, mms에 포함될 수 있는 최대 문자 수에 대해 알아봅니다. MMS 파일 유형MMS 파일 크기mms 문자 수 한도 단일 MMS 미디어 파일은 모든 이미지 유형(gif, jpeg, png)의 경우 최대 2MB까지 가능하며 모든 오디오 및 비디오 미디어 파일 유형은 600KB까지 가능합니다. MMS의 텍스트 메시지 본문은 모든 문자 집합에 관계없이 1,600자를 포함할 수 있습니다. SMS와 달리 MMS 메시지는 전송할 때 여러 파트로 분할되지 않습니다. 대용량 텍스트 메시지를 전송하는 경우 MMS 메시지는 여러 파트로 분할되지 않기 때문에 MMS로 전송하면 처리량이 향상될 수 있습니다.
****
| 파일 유형 | MIME 유형 | 최대 파일 크기 |
| --- | --- | --- |
| Graphics Interchange Format | `image/gif` | 2MB |
| Joint Photographic Experts Group | `image/jpeg` | 2MB |
| Portable Network Graphics | `image/png` | 2MB |
| Tag image file format | `image/tiff` | 600KB |
| Third generation partnership project | `audio/3gpp`, `video/3gpp` | 600KB |
| Third generation partnership project 2 | `audio/3gpp2`, `video/3gpp2` | 600KB |
| Adaptive Multi-Rate | `audio/amr` | 600KB |
| MPEG-4 | `audio/mp4`, `video/mp4` | 600KB |
| Moving picture experts group | `audio/mpeg` `audio/mpeg`에는 MP3 파일만 지원됩니다. | 600KB |
| Ogg | `audio/ogg` | 600KB |
| QuickTime | `video/quicktime` | 600KB |
| WebM | `video/webm` | 600KB |
| iCalendar | `text/calendar` | 600KB |
| vCard | `text/vcard`, `text/x-vcard` | 600KB |
| Portable Document Format | `application/pdf` | 600KB | ](mms-limitations-character.md#mms-limitations-character.title) 섹션을 참조하세요.
+ 각 MMS 파일의 S3 URI입니다.
+ `send-media-message`를 호출하는 데 사용되는 자격 증명은 미디어 파일이 포함된 Amazon S3 버킷에 대한 읽기 액세스 권한이 있어야 합니다. 자세한 내용은 [Amazon S3 사용 설명서](https://docs.aws.amazon.com/AmazonS3/latest/userguide/)의 [Amazon S3의 ID 기반 정책 예시](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html)를 참조하세요.
## 를 사용하여 MMS 전송 AWS CLI
[send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html)에 필요한 유일한 파라미터는 `destination-phone-number` 및 `origination-identity`입니다. `media-urls` 파라미터를 생략하여 텍스트만 포함된 메시지를 보낼 수 있습니다. `message-body` 파라미터를 생략하면 미디어 파일만 포함된 메시지도 보낼 수도 있습니다.
**MMS 메시지를 전송하려면**
+ 명령줄에 다음 명령을 입력합니다.
```
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'
```
위의 명령에서 다음과 같이 변경하세요.
+ *us-east-1* AWS 리전 을 발신 자격 증명이 저장된 로 바꿉니다.
+ *\$112065550150*을 대상 전화번호로 바꿉니다.
+ *\$114255550120*을 발신 자격 증명으로 바꿉니다. 발신 자격 증명은 `ACTIVE`여야 하며 대상 전화번호로 전송할 수 있어야 합니다.
+ *텍스트 본문*을 텍스트 메시지로 바꿉니다.
+ *s3://s3-bucket/media\$1file.jpg*를 MMS 파일의 S3 URI로 바꿉니다. 지원되는 미디어 파일 형식은 [MMS 파일 형식, 크기 및 문자 제한](mms-limitations-character.md)에 나열되어 있습니다. S3 버킷 생성 및 객체 관리에 대한 자세한 내용은 [Amazon S3 사용 설명서](https://docs.aws.amazon.com/AmazonS3/latest/userguide/)의 [MMS 파일용 Amazon S3 버킷 설정](#send-mms-message-bucket) 또는 [버킷 생성](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) 및 [객체 업로드](https://docs.aws.amazon.com//AmazonS3/latest/userguide/upload-objects.html)를 참조하세요.
AWS End User Messaging SMS가 명령을 수락하면가 수신됩니다`MessageID`. 이는 명령이 성공적으로 수신되었으며 대상 기기가 아직 메시지를 수신하지 않았음을 의미합니다. 오류 코드 목록은 [SendMediaMessage 오류](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SendMediaMessage.html#API_SendMediaMessage_Errors)를 참조하세요.
```
{
"MessageId": "string"
}
```
## MMS 파일용 Amazon S3 버킷 설정
MMS 파일은 Amazon S3 버킷에 저장해야 합니다. Amazon S3 버킷은 MMS 지원 발신 자격 증명 AWS 리전 과 동일한 AWS 계정 및에 있어야 합니다. 이 지침은 Amazon S3 버킷을 생성하고 파일을 업로드한 다음 해당 파일의 URI를 구성하는 방법을 보여줍니다. Amazon S3 명령에 대한 자세한 내용은 [AWS CLI에서 상위 수준(s3) 명령 사용](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html)을 참조하세요. 구성에 대한 자세한 내용은 [AWS Command Line Interface 사용 설명서](https://docs.aws.amazon.com/cli/latest/userguide/)[의 AWS CLI 구성을](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) AWS CLI참조하세요.
Amazon S3 버킷을 생성하려면 [create-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html) AWS CLI 명령을 사용합니다. 명령줄에 다음 명령을 입력합니다.
```
aws s3api create-bucket --region 'us-east-1' --bucket BucketName
```
앞의 명령에서:
+ *us-east-1* AWS 리전 을 MMS 지원 발신 자격 증명이 있는 로 바꿉니다.
+ *BucketName*을 새 버킷 이름으로 바꿉니다.
파일을 Amazon S3 버킷에 복사하려면 [cp](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy) AWS CLI 명령을 사용합니다. 명령줄에 다음 명령을 입력합니다.
```
aws s3 cp SourceFilePathAndName s3://BucketName/FileName
```
앞의 명령에서:
+ *SourceFilePathAndName*을 복사할 파일의 파일 경로 및 이름으로 바꿉니다.
+ *BucketName*을 버킷 이름으로 바꿉니다.
+ *FileName*을 파일에 사용할 이름으로 바꿉니다.
전송할 때 사용할 URI는 다음과 같습니다.
```
s3://BucketName/FileName
```