AWS End User Messaging SMS AWS CLI 에서를 사용하여 등록 생성

create-registration 명령을 사용하여 새 빈 등록을 생성합니다. RegistrationType 파라미터는 생성할 등록 유형을 결정합니다. 생성하려는 등록 유형의 값을 모르는 경우 describe-registration-type-definitions 명령을 사용하여 모든 등록 유형의 목록을 가져옵니다.

다음 예시는 수신자 부담 전화번호 등록 양식을 생성하는 방법을 보여줍니다.

$ aws pinpoint-sms-voice-v2 create-registration --registration-type US_TOLL_FREE_REGISTRATION --tags "Key=Name,Value=MyTFNRegistration"

정상적으로 완료되면 RegistrationId 값을 저장해야 하며 다른 명령에서 필요합니다.

다음 예시는 describe-registration-type-definitions 명령의 일부 출력입니다. AssociationBehavior가 ASSOCIATE_BEFORE_SUBMIT으로 설정되어 있으므로 등록 승인이 제출되기 전에 수신자 부담 전화번호를 구매하여 등록에 연결해야 합니다. AssociationBehavior 및 DisassociationBehavior에 대한 자세한 내용은 SupportedAssociation을 참조하세요.

{
    "RegistrationTypeDefinitions": [
        {
            "RegistrationType": "US_TOLL_FREE_REGISTRATION",
            "SupportedAssociations": [
                {
                    "ResourceType": "TOLL_FREE",
                    "IsoCountryCode": "US",
                    "AssociationBehavior": "ASSOCIATE_BEFORE_SUBMIT",
                    "DisassociationBehavior": "DISASSOCIATE_ALL_CLOSES_REGISTRATION"
                }
            ],
            "DisplayHints": {
                "Title": "US toll-free number registration"
            }
        },
...

다음 단계에서는 필드의 최대 문자 수와 같은 각 필드의 요구 사항을 확인하기 위해 필드 정의를 가져와야 합니다.

각 등록은 섹션으로 구분되며 각 섹션에는 하나 이상의 필드가 있습니다. describe-registration-field-definitions 명령을 사용하여 등록에 대한 모든 섹션 및 필드 정의를 가져옵니다. 나중에 값을 설정하려면 각 필드의 FieldPath가 필요합니다. 또한 FieldRequirement는 필드가 필수인지 아니면 선택 사항인지 결정하는 데 사용됩니다.

다음 예시는 수신자 부담 등록 양식의 필드 정의를 가져오는 방법을 보여줍니다.

$ aws pinpoint-sms-voice-v2 describe-registration-field-definitions --registration-type  US_TOLL_FREE_REGISTRATION

다음은 명령의 일부 출력입니다.

{
    "RegistrationFieldDefinitions": [
        {
            "SectionPath": "companyInfo",
            "FieldPath": "companyInfo.companyName",
            "FieldType": "TEXT",
            "FieldRequirement": "REQUIRED",
            "TextValidation": {
                "MinLength": 1,
                "MaxLength": 100,
                "Pattern": "^(?=\\s*\\S)[\\s\\S]+$"
            },
            "DisplayHints": {
                "Title": "Company name",
                "ShortDescription": "Legal name which your company is registered under.",
                "ExampleTextValue": "Example Corp"
            }
        },
...

등록 유형에 따라 위임장(LOA), 옵트인 워크플로 또는 기타 유형의 필요한 문서를 작성하여 첨부해야 할 수 있습니다. 개별 등록에서 세부 정보를 확인하고 양식을 다운로드합니다.

create-registration-attachment 명령을 사용하여 등록 첨부 파일을 생성합니다. 파일을 Amazon S3 버킷에 업로드하여 URL을 사용하거나 명령에 문서를 직접 첨부할 수 있습니다. AttachmentUrl 또는 AttachmentBody 중 하나를 사용합니다. 둘 다 지정된 경우 예외가 반환됩니다. 최대 파일 크기는 500KB이며 허용되는 파일 확장자는 PDF, JPEG, PNG입니다.

다음 예시는 등록 첨부 파일을 생성하고 AttachmentUrl 파라미터를 사용하는 방법을 보여줍니다.

$ aws pinpoint-sms-voice-v2 create-registration-attachment --attachment-url s3://BucketName/FileName

정상적으로 완료되면 명령은 다른 명령에서 필요한 RegistrationAttachmentID를 반환합니다.

Amazon S3 버킷 생성 또는 파일 업로드와 같은 명령에 대한 자세한 내용은 AWS CLI에서 상위 수준(s3) 명령 사용을 참조하세요.

다음으로 필드 정의 가져오기 단계에서 반환된 모든 필드에 값을 추가해야 하며 여기에는 생성한 첨부 파일도 포함됩니다. 사용 사례에 따라 선택 가능한 필드도 완료하는 것이 좋습니다. 필드는 FieldRequirement 값에 따라 필수 또는 선택 사항으로 결정됩니다. put-registration-field-value 명령을 사용하여 필드 값을 설정합니다.

이제 등록과 나중에 연결될 발신 자격 증명을 요청해야 합니다. 이 예시는 request-phone-number 명령을 사용하여 AWS CLI를 통해 수신자 부담 전화번호를 요청하는 방법을 보여줍니다. request-sender-id를 사용하여 발신자 ID를 요청합니다.

$ aws pinpoint-sms-voice-v2 request-phone-number --iso-country-code US --message-type TRANSACTIONAL --number-capabilities SMS --number-type TOLL_FREE

정상적으로 완료되면 명령은 전화번호를 등록과 연결하는 데 필요한 전화번호 고유 식별자를 반환합니다.

등록에 발신 자격 증명을 연결하려면 create-registration-association AWS CLI 명령을 사용합니다.

$ aws pinpoint-sms-voice-v2 create-registration-association --registration-id RegID --resource-id PhoneNumberID

이전 명령에서 다음 값을 바꿉니다.

등록을 제출한 후에는 더 이상 변경할 수 없습니다. 제출하기 전에 등록 정보를 검토하여 모든 데이터가 올바른지 확인합니다.

를 사용하여 등록을 제출하려면 submit-registration-version 명령을 AWS CLI 사용합니다.

$ aws pinpoint-sms-voice-v2 submit-registration-version --registration-id RegID

이전 명령에서 다음 값을 바꿉니다.

등록이 제출되면 describe-registrations 명령 또는 콘솔을 사용하여 등록 상태를 확인할 수 있습니다.

등록의 AssociationBehavior가 ASSOCIATE_AFTER_COMPLETE인 경우 등록 상태가 완료로 설정되면 발신 자격 증명을 구매하여 등록과 연결할 수 있습니다.

등록 상태가 REQUIRES_UPDATES로 변경되면 플래그가 지정된 필드를 찾아 편집하고 등록을 다시 제출할 수 있습니다. 등록 거부 사유 목록은 등록에 대한 Gen-AI 피드백 섹션을 참조하세요. 등록 거부와 지원 관련하여의 도움이 필요한 경우 티켓을 열 수 있습니다.