使用 AWS CLI 在 AWS 终端用户消息发送 SMS 服务中创建注册

使用 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"
            }
        },
...

根据注册要求，您可能需要填写并附上授权书、用户选择加入工作流程证明或其他类型的必要文档。请查看具体的注册说明，以了解详情并下载相关表单。

使用 create-registration-attachment 命令创建注册附件。您可以将文件上传到 Amazon S3 存储桶并使用 URL，也可以将文档作为命令的一部分附上。请仅使用 AttachmentUrl 或 AttachmentBody；如果同时指定两者，则会返回异常。最大文件大小为 500 KB，有效的文件扩展名包括.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

在上述命令中，请替换以下内容：

提交注册后，您将无法对其进行任何更改。提交前，请务必仔细检查您的注册信息，确保所有数据均正确无误。

要使用 AWS CLI 提交注册，请使用 submit-registration-version 命令。

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

在上述命令中，请替换以下内容：

提交注册后，您可以使用 describe-registrations 命令或控制台检查其状态。

如果注册的 AssociationBehavior 为 ASSOCIATE_AFTER_COMPLETE，在注册状态设置为 COMPLETE 后，您可以购买发起身份并将其与该注册相关联。

如果注册状态更改为 REQUIRES_UPDATES，则可以查找并编辑标记的字段，然后重新提交注册。有关注册被拒原因的列表，请参阅有关注册被拒的帮助。如果您需要 支持 的帮助来解决注册被拒的问题，可以创建支持单。