本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
下一節提供如何使用 建立、填入和提交註冊的範例 AWS CLI。如需如何使用 python 或 shell 指令碼建立和提交免付費電話註冊的範例，請參閱自動化 AWS 最終使用者傳訊美國免付費電話註冊
背景介紹
有些國家/地區會要求您註冊公司的身分，才能購買原始身分，並檢閱您傳送給其國家/地區收件人的訊息。
-
您提供的註冊資訊可能會由第三方檢閱。第三方因國家/地區而異，但可能是執行審核的政府監管機構或行動電信業者。
-
第三方公司檢閱註冊所需的時間，會因註冊類型而有所不同。
必要條件
開始之前，您必須：
-
安裝並設定 AWS CLI，請參閱 AWS Command Line Interface 使用者指南AWS中的設定 CLI 。
-
AWS 帳戶 具有在目標區域中使用 AWS 最終使用者傳訊之許可SMS的 。
-
註冊會AssociationBehavior指定註冊何時可以與原始身分建立關聯，以及與原始身分取消關聯的順序，請參閱 SupportedAssociation。
ASSOCIATE_BEFORE_SUBMIT提交註冊時必須提供原始身分。ASSOCIATE_ON_APPROVAL這適用於所有寄件者 ID 註冊。註冊核准後，寄件者 ID 將自動佈建。ASSOCIATE_AFTER_COMPLETE當您必須先完成註冊，然後建立一個或多個電話號碼的關聯時，這適用於電話號碼註冊。
重要
購買原始身分後，無論註冊狀態為何，都會變更原始身分，請參閱AWS 最終使用者訊息定價
。 提交註冊後，您將無法對註冊進行任何變更，也無法取消任何資源與註冊的關聯，直到第三方已檢閱並傳回給您為止。
以下是用於註冊的其他資源。
使用 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因為其他 命令會需要此值。
注意
若要將易記名稱新增至您的註冊，您必須新增金鑰設為 的標籤，Name並將值設為易記名稱以供使用。
您也可以將標籤新增至資源以進行計費，請參閱標籤資源以進行計費。
下列範例是 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，如果指定兩者，則會傳回例外狀況。檔案大小上限為 500KBJPEG，有效的副檔名為 PDF、 和 PNG。
下列範例示範如何建立註冊附件並使用 AttachmentUrl 參數。
$ aws pinpoint-sms-voice-v2 create-registration-attachment --attachment-url s3://BucketName/FileName成功完成時，命令會傳回其他命令所需的 RegistrationAttachmentID。
如需建立儲存貯體或上傳檔案等 Amazon S3 命令的詳細資訊，請參閱搭配 使用高階 (s3) AWS 命令CLI。
接下來，您需要為從取得欄位定義步驟傳回的所有必要欄位新增值，這包含您建立的任何附件。我們建議您也填寫適用於您的使用案例的任何選用欄位。欄位為必要或選用，視FieldRequirement值而定。使用 put-registration-field-value命令來設定欄位值。
下列範例顯示為公司名稱或文字值新增值。
$aws pinpoint-sms-voice-v2 put-registration-field-value --registration-idRegID--field-pathcompanyInfo.companyName--text-valueAnyCompany在上述命令中，取代下列項目：
-
RegID以建立註冊步驟傳回的註冊 ID 取代 。 -
AnyCompany將 取代為您公司名稱。
-
下列範例顯示為選取欄位新增值。
$aws pinpoint-sms-voice-v2 put-registration-field-value --registration-idRegID--field-pathmessagingUseCase.monthlyMessageVolume--text-choicesSelectValue在上述命令中，取代下列項目：
-
RegID以建立註冊步驟傳回的註冊 ID 取代 。 -
SelectValue將 取代為 欄位的其中一個選項值。使用 describe-registration-field-definitions命令來取得僅一個欄位的選項：
aws pinpoint-sms-voice-v2 describe-registration-field-definitions --registration-type US_TOLL_FREE_REGISTRATION --field-pathsmessagingUseCase.monthlyMessageVolume{ "RegistrationFieldDefinitions": [ { "SectionPath": "messagingUseCase", "FieldPath": "messagingUseCase.monthlyMessageVolume", "FieldType": "SELECT", "FieldRequirement": "REQUIRED", "SelectValidation": { "MinChoices": 1, "MaxChoices": 1, "Options": [ "10", "100", "1,000", "10,000", "100,000", "250,000", "500,000", "750,000", "1,000,000", "5,000,000", "10,000,000+" ] }, "DisplayHints": { "Title": "Monthly SMS volume", "ShortDescription": "Estimated number of SMS messages which will be sent from this toll-free number each month." } } ], "RegistrationType": "US_TOLL_FREE_REGISTRATION" }
-
-
下列範例示範如何新增附件。
$aws pinpoint-sms-voice-v2 put-registration-field-value --registration-idRegID--field-pathmessagingUseCase.optInImage--registration-attachment-idRegistrationAttachmentID在上述命令中，取代下列項目：
-
RegID以建立註冊步驟傳回的註冊 ID 取代 。 -
RegistrationAttachmentID以建立附件步驟傳回的註冊附件 ID 取代 。
-
注意
購買原始身分後，無論註冊狀態為何，都會向您收取費用，請參閱AWS 最終使用者訊息定價
如果註冊的 AssociationBehavior 是 ASSOCIATE_AFTER_COMPLETE，則在註冊提交並核准之前，您不需要購買或建立原始身分的關聯。
現在，您需要請求建立身分，該身分稍後將與註冊相關聯。此範例示範如何使用 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成功完成時， 命令會傳回電話號碼唯一識別符，這是將電話號碼與註冊建立關聯所需的識別符。
注意
如果註冊AssociationBehavior是 ASSOCIATE_AFTER_COMPLETE，則在註冊提交並核准之前，您不需要購買或建立原始身分的關聯。
若要將原始身分與註冊建立關聯，請使用 create-registration-association AWS CLI 命令。
$ aws pinpoint-sms-voice-v2 create-registration-association --registration-id RegID --resource-id PhoneNumberID在上述命令中，取代下列項目：
-
RegID以建立註冊步驟傳回的註冊 ID 取代 。 -
PhoneNumberID將 取代為請求原始身分步驟傳回的電話號碼 ID。
注意
此命令用於將任何適用的資源與註冊建立關聯。例如，它可用來將 10DLC 個行銷活動註冊與 10DLC 個品牌註冊建立關聯。
提交註冊後，您將無法對其進行任何變更。檢閱您的註冊，以確保提交所有資料之前都正確。
重要
提交註冊後，您將無法對註冊進行任何變更，也無法取消與註冊的任何資源的關聯，直到第三方已檢閱並傳回給您為止。
若要 AWS CLI 使用 submit-registration-version命令提交註冊。
$ aws pinpoint-sms-voice-v2 submit-registration-version --registration-id RegID在上述命令中，取代下列項目：
-
RegID以建立註冊步驟傳回的註冊 ID 取代 。
提交註冊後，您可以使用 describe-registrations 命令或主控台來檢查其狀態。
如果註冊的 AssociationBehavior 是ASSOCIATE_AFTER_COMPLETE您可以購買原始身分，並將其與註冊建立關聯，一旦註冊的狀態設定為 COMPLETE。
如果您的註冊狀態變更為 REQUIRES_UPDATES，您可以尋找和編輯標記的欄位，並重新提交註冊。如需註冊拒絕原因的清單，請參閱 註冊拒絕的說明。如果您需要來自 的協助 Support 來拒絕註冊，您可以開啟票證。
