This release adds support for the CarrierLookup API, which returns information about a destination phone number including if the number is valid, the carrier, and more.

Author: aws-sdk-dotnet-automation

docgenerator/AWSSDKDocSamples/PinpointSMSVoiceV2.GeneratedSamples.extra.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<docs>
+    <doc>
+        <members>
+            <member name="M:Amazon.PinpointSMSVoiceV2.IAmazonPinpointSMSVoiceV2.CarrierLookup(Amazon.PinpointSMSVoiceV2.Model.CarrierLookupRequest)" />
+            <member name="M:Amazon.PinpointSMSVoiceV2.AmazonPinpointSMSVoiceV2Client.CarrierLookup(Amazon.PinpointSMSVoiceV2.Model.CarrierLookupRequest)" />
+            <member name="T:Amazon.PinpointSMSVoiceV2.Model.CarrierLookupRequest" />
+            <member name="T:Amazon.PinpointSMSVoiceV2.Model.CarrierLookupResponse" />
+        </members>
+        <value>
+            <example>
+                <para>
+                    Call the CarrierLookup operation to get information about a customer provided phone number, including if the number is valid. The service accepts phone numbers with various formatting characters and returns the number in E164 format.
+                </para>
+                <code
+                    title="Use CarrierLookup"
+                    source=".\AWSSDKDocSamples\PinpointSMSVoiceV2\PinpointSMSVoiceV2.GeneratedSamples.cs"
+                    region="example-1" />
+            </example>
+        </value>
+    </doc>
+</docs>

docgenerator/AWSSDKDocSamples/PinpointSMSVoiceV2/PinpointSMSVoiceV2.GeneratedSamples.cs

@@ -0,0 +1,45 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+using Amazon.PinpointSMSVoiceV2;
+using Amazon.PinpointSMSVoiceV2.Model;
+
+namespace AWSSDKDocSamples.Amazon.PinpointSMSVoiceV2.Generated
+{
+    class PinpointSMSVoiceV2Samples : ISample
+    {
+        public void PinpointSMSVoiceV2CarrierLookup()
+        {
+            #region example-1
+
+            var client = new AmazonPinpointSMSVoiceV2Client();
+            var response = client.CarrierLookup(new CarrierLookupRequest 
+            {
+                PhoneNumber = "+1 (555) 555-5333"
+            });
+
+            string carrier = response.Carrier;
+            string country = response.Country;
+            string dialingCountryCode = response.DialingCountryCode;
+            string e164PhoneNumber = response.E164PhoneNumber;
+            string isoCountryCode = response.IsoCountryCode;
+            string mcc = response.MCC;
+            string mnc = response.MNC;
+            string phoneNumberType = response.PhoneNumberType;
+
+            #endregion
+        }
+
+        
+        # region ISample Members
+        public virtual void Run()
+        {
+
+        }
+        # endregion
+
+    }
+}

generator/ServiceModels/pinpoint-sms-voice-v2/pinpoint-sms-voice-v2-2022-03-31.api.json

@@ -50,6 +50,22 @@
         {"shape":"InternalServerException"}
       ]
     },
+    "CarrierLookup":{
+      "name":"CarrierLookup",
+      "http":{
+        "method":"POST",
+        "requestUri":"/"
+      },
+      "input":{"shape":"CarrierLookupRequest"},
+      "output":{"shape":"CarrierLookupResult"},
+      "errors":[
+        {"shape":"ServiceQuotaExceededException"},
+        {"shape":"ThrottlingException"},
+        {"shape":"AccessDeniedException"},
+        {"shape":"ValidationException"},
+        {"shape":"InternalServerException"}
+      ]
+    },
     "CreateConfigurationSet":{
       "name":"CreateConfigurationSet",
       "http":{
@@ -1651,6 +1667,36 @@
       "type":"boolean",
       "box":true
     },
+    "CarrierLookupInputPhoneNumberType":{
+      "type":"string",
+      "max":40,
+      "min":1,
+      "pattern":"\\+[({\\s\\[]?[1-9][0-9(){}\\s\\[\\],.-]{1,38}"
+    },
+    "CarrierLookupRequest":{
+      "type":"structure",
+      "required":["PhoneNumber"],
+      "members":{
+        "PhoneNumber":{"shape":"CarrierLookupInputPhoneNumberType"}
+      }
+    },
+    "CarrierLookupResult":{
+      "type":"structure",
+      "required":[
+        "E164PhoneNumber",
+        "PhoneNumberType"
+      ],
+      "members":{
+        "E164PhoneNumber":{"shape":"E164PhoneNumberType"},
+        "DialingCountryCode":{"shape":"DialingCountryCodeType"},
+        "IsoCountryCode":{"shape":"IsoCountryCode"},
+        "Country":{"shape":"String"},
+        "MCC":{"shape":"MCCType"},
+        "MNC":{"shape":"MNCType"},
+        "Carrier":{"shape":"String"},
+        "PhoneNumberType":{"shape":"PhoneNumberType"}
+      }
+    },
     "ClientToken":{
       "type":"string",
       "max":64,
@@ -2835,6 +2881,12 @@
       "max":5,
       "min":0
     },
+    "DialingCountryCodeType":{
+      "type":"string",
+      "max":3,
+      "min":1,
+      "pattern":"[\\d]+"
+    },
     "DisassociateOriginationIdentityRequest":{
       "type":"structure",
       "required":[
@@ -2912,6 +2964,12 @@
         "RegistrationVersionStatusHistory":{"shape":"RegistrationVersionStatusHistory"}
       }
     },
+    "E164PhoneNumberType":{
+      "type":"string",
+      "max":20,
+      "min":1,
+      "pattern":"\\+[1-9][0-9]{1,18}"
+    },
     "EventDestination":{
       "type":"structure",
       "required":[
@@ -3286,6 +3344,18 @@
       "min":20,
       "pattern":"arn:\\S+"
     },
+    "MCCType":{
+      "type":"string",
+      "max":3,
+      "min":3,
+      "pattern":"[\\d]+"
+    },
+    "MNCType":{
+      "type":"string",
+      "max":3,
+      "min":2,
+      "pattern":"[\\d]+"
+    },
     "MaxPrice":{
       "type":"string",
       "max":8,
@@ -3593,6 +3663,15 @@
       "type":"list",
       "member":{"shape":"PhoneNumberInformation"}
     },
+    "PhoneNumberType":{
+      "type":"string",
+      "enum":[
+        "MOBILE",
+        "LANDLINE",
+        "OTHER",
+        "INVALID"
+      ]
+    },
     "PhoneOrPoolIdOrArn":{
       "type":"string",
       "max":256,