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-cpp-automation

VERSION

@@ -1 +1 @@
-1.11.682
+1.11.683

generated/src/aws-cpp-sdk-pinpoint-sms-voice-v2/include/aws/pinpoint-sms-voice-v2/PinpointSMSVoiceV2Client.h

@@ -21,6 +21,7 @@
 /* Service model headers required in PinpointSMSVoiceV2Client header */
 #include <aws/pinpoint-sms-voice-v2/model/AssociateOriginationIdentityResult.h>
 #include <aws/pinpoint-sms-voice-v2/model/AssociateProtectConfigurationResult.h>
+#include <aws/pinpoint-sms-voice-v2/model/CarrierLookupResult.h>
 #include <aws/pinpoint-sms-voice-v2/model/CreateConfigurationSetResult.h>
 #include <aws/pinpoint-sms-voice-v2/model/CreateEventDestinationResult.h>
 #include <aws/pinpoint-sms-voice-v2/model/CreateOptOutListResult.h>
@@ -163,6 +164,7 @@ namespace Model {
 /* Service model forward declarations required in PinpointSMSVoiceV2Client header */
 class AssociateOriginationIdentityRequest;
 class AssociateProtectConfigurationRequest;
+class CarrierLookupRequest;
 class CreateConfigurationSetRequest;
 class CreateEventDestinationRequest;
 class CreateOptOutListRequest;
@@ -256,6 +258,7 @@ class VerifyDestinationNumberRequest;
 /* Service model Outcome class definitions */
 typedef Aws::Utils::Outcome<AssociateOriginationIdentityResult, PinpointSMSVoiceV2Error> AssociateOriginationIdentityOutcome;
 typedef Aws::Utils::Outcome<AssociateProtectConfigurationResult, PinpointSMSVoiceV2Error> AssociateProtectConfigurationOutcome;
+typedef Aws::Utils::Outcome<CarrierLookupResult, PinpointSMSVoiceV2Error> CarrierLookupOutcome;
 typedef Aws::Utils::Outcome<CreateConfigurationSetResult, PinpointSMSVoiceV2Error> CreateConfigurationSetOutcome;
 typedef Aws::Utils::Outcome<CreateEventDestinationResult, PinpointSMSVoiceV2Error> CreateEventDestinationOutcome;
 typedef Aws::Utils::Outcome<CreateOptOutListResult, PinpointSMSVoiceV2Error> CreateOptOutListOutcome;
@@ -361,6 +364,7 @@ typedef Aws::Utils::Outcome<VerifyDestinationNumberResult, PinpointSMSVoiceV2Err
 /* Service model Outcome callable definitions */
 typedef std::future<AssociateOriginationIdentityOutcome> AssociateOriginationIdentityOutcomeCallable;
 typedef std::future<AssociateProtectConfigurationOutcome> AssociateProtectConfigurationOutcomeCallable;
+typedef std::future<CarrierLookupOutcome> CarrierLookupOutcomeCallable;
 typedef std::future<CreateConfigurationSetOutcome> CreateConfigurationSetOutcomeCallable;
 typedef std::future<CreateEventDestinationOutcome> CreateEventDestinationOutcomeCallable;
 typedef std::future<CreateOptOutListOutcome> CreateOptOutListOutcomeCallable;
@@ -463,6 +467,9 @@ typedef std::function<void(const PinpointSMSVoiceV2Client*, const Model::Associa
                            const Model::AssociateProtectConfigurationOutcome&,
                            const std::shared_ptr<const Aws::Client::AsyncCallerContext>&)>
     AssociateProtectConfigurationResponseReceivedHandler;
+typedef std::function<void(const PinpointSMSVoiceV2Client*, const Model::CarrierLookupRequest&, const Model::CarrierLookupOutcome&,
+                           const std::shared_ptr<const Aws::Client::AsyncCallerContext>&)>
+    CarrierLookupResponseReceivedHandler;
 typedef std::function<void(const PinpointSMSVoiceV2Client*, const Model::CreateConfigurationSetRequest&,
                            const Model::CreateConfigurationSetOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&)>
     CreateConfigurationSetResponseReceivedHandler;

generated/src/aws-cpp-sdk-pinpoint-sms-voice-v2/include/aws/pinpoint-sms-voice-v2/PinpointSMSVoiceV2ServiceClientModel.h

@@ -34,9 +34,10 @@ class AssociateOriginationIdentityRequest : public PinpointSMSVoiceV2Request {
   ///@{
   /**
    * <p>The pool to update with the new Identity. This value can be either the PoolId
-   * or PoolArn, and you can find these values using <a>DescribePools</a>.</p>
-   *  <p>If you are using a shared AWS End User Messaging SMS and Voice
-   * resource then you must use the full Amazon Resource Name(ARN).</p>
+   * or PoolArn, and you can find these values using <a
+   * href="https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_DescribePools.html">DescribePools</a>.</p>
+   *  <p>If you are using a shared End User MessagingSMS; resource then
+   * you must use the full Amazon Resource Name(ARN).</p>
    */
   inline const Aws::String& GetPoolId() const { return m_poolId; }
   inline bool PoolIdHasBeenSet() const { return m_poolIdHasBeenSet; }
@@ -58,8 +59,8 @@ class AssociateOriginationIdentityRequest : public PinpointSMSVoiceV2Request {
    * SenderId, or SenderIdArn. You can use <a>DescribePhoneNumbers</a> to find the
    * values for PhoneNumberId and PhoneNumberArn, while <a>DescribeSenderIds</a> can
    * be used to get the values for SenderId and SenderIdArn.</p>  <p>If
-   * you are using a shared AWS End User Messaging SMS and Voice resource then you
-   * must use the full Amazon Resource Name(ARN).</p>
+   * you are using a shared End User MessagingSMS resource then you must use the full
+   * Amazon Resource Name(ARN).</p>
    */
   inline const Aws::String& GetOriginationIdentity() const { return m_originationIdentity; }
   inline bool OriginationIdentityHasBeenSet() const { return m_originationIdentityHasBeenSet; }

generated/src/aws-cpp-sdk-pinpoint-sms-voice-v2/include/aws/pinpoint-sms-voice-v2/model/AssociateOriginationIdentityRequest.h

@@ -0,0 +1,60 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0.
+ */
+
+#pragma once
+#include <aws/core/utils/memory/stl/AWSString.h>
+#include <aws/pinpoint-sms-voice-v2/PinpointSMSVoiceV2Request.h>
+#include <aws/pinpoint-sms-voice-v2/PinpointSMSVoiceV2_EXPORTS.h>
+
+#include <utility>
+
+namespace Aws {
+namespace PinpointSMSVoiceV2 {
+namespace Model {
+
+/**
+ */
+class CarrierLookupRequest : public PinpointSMSVoiceV2Request {
+ public:
+  AWS_PINPOINTSMSVOICEV2_API CarrierLookupRequest() = default;
+
+  // Service request name is the Operation name which will send this request out,
+  // each operation should has unique request name, so that we can get operation's name from this request.
+  // Note: this is not true for response, multiple operations may have the same response name,
+  // so we can not get operation's name from response.
+  inline virtual const char* GetServiceRequestName() const override { return "CarrierLookup"; }
+
+  AWS_PINPOINTSMSVOICEV2_API Aws::String SerializePayload() const override;
+
+  AWS_PINPOINTSMSVOICEV2_API Aws::Http::HeaderValueCollection GetRequestSpecificHeaders() const override;
+
+  ///@{
+  /**
+   * <p>The phone number that you want to retrieve information about. You can provide
+   * the phone number in various formats including special characters such as
+   * parentheses, brackets, spaces, hyphens, periods, and commas. The service
+   * automatically converts the input to E164 format for processing.</p>
+   */
+  inline const Aws::String& GetPhoneNumber() const { return m_phoneNumber; }
+  inline bool PhoneNumberHasBeenSet() const { return m_phoneNumberHasBeenSet; }
+  template <typename PhoneNumberT = Aws::String>
+  void SetPhoneNumber(PhoneNumberT&& value) {
+    m_phoneNumberHasBeenSet = true;
+    m_phoneNumber = std::forward<PhoneNumberT>(value);
+  }
+  template <typename PhoneNumberT = Aws::String>
+  CarrierLookupRequest& WithPhoneNumber(PhoneNumberT&& value) {
+    SetPhoneNumber(std::forward<PhoneNumberT>(value));
+    return *this;
+  }
+  ///@}
+ private:
+  Aws::String m_phoneNumber;
+  bool m_phoneNumberHasBeenSet = false;
+};
+
+}  // namespace Model
+}  // namespace PinpointSMSVoiceV2
+}  // namespace Aws

generated/src/aws-cpp-sdk-pinpoint-sms-voice-v2/include/aws/pinpoint-sms-voice-v2/model/CarrierLookupRequest.h

@@ -0,0 +1,216 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0.
+ */
+
+#pragma once
+#include <aws/core/utils/memory/stl/AWSString.h>
+#include <aws/pinpoint-sms-voice-v2/PinpointSMSVoiceV2_EXPORTS.h>
+#include <aws/pinpoint-sms-voice-v2/model/PhoneNumberType.h>
+
+#include <utility>
+
+namespace Aws {
+template <typename RESULT_TYPE>
+class AmazonWebServiceResult;
+
+namespace Utils {
+namespace Json {
+class JsonValue;
+}  // namespace Json
+}  // namespace Utils
+namespace PinpointSMSVoiceV2 {
+namespace Model {
+class CarrierLookupResult {
+ public:
+  AWS_PINPOINTSMSVOICEV2_API CarrierLookupResult() = default;
+  AWS_PINPOINTSMSVOICEV2_API CarrierLookupResult(const Aws::AmazonWebServiceResult<Aws::Utils::Json::JsonValue>& result);
+  AWS_PINPOINTSMSVOICEV2_API CarrierLookupResult& operator=(const Aws::AmazonWebServiceResult<Aws::Utils::Json::JsonValue>& result);
+
+  ///@{
+  /**
+   * <p>The phone number in E164 format, sanitized from the original input by
+   * removing any formatting characters.</p>
+   */
+  inline const Aws::String& GetE164PhoneNumber() const { return m_e164PhoneNumber; }
+  template <typename E164PhoneNumberT = Aws::String>
+  void SetE164PhoneNumber(E164PhoneNumberT&& value) {
+    m_e164PhoneNumberHasBeenSet = true;
+    m_e164PhoneNumber = std::forward<E164PhoneNumberT>(value);
+  }
+  template <typename E164PhoneNumberT = Aws::String>
+  CarrierLookupResult& WithE164PhoneNumber(E164PhoneNumberT&& value) {
+    SetE164PhoneNumber(std::forward<E164PhoneNumberT>(value));
+    return *this;
+  }
+  ///@}
+
+  ///@{
+  /**
+   * <p>The numeric dialing code for the country or region where the phone number was
+   * originally registered.</p>
+   */
+  inline const Aws::String& GetDialingCountryCode() const { return m_dialingCountryCode; }
+  template <typename DialingCountryCodeT = Aws::String>
+  void SetDialingCountryCode(DialingCountryCodeT&& value) {
+    m_dialingCountryCodeHasBeenSet = true;
+    m_dialingCountryCode = std::forward<DialingCountryCodeT>(value);
+  }
+  template <typename DialingCountryCodeT = Aws::String>
+  CarrierLookupResult& WithDialingCountryCode(DialingCountryCodeT&& value) {
+    SetDialingCountryCode(std::forward<DialingCountryCodeT>(value));
+    return *this;
+  }
+  ///@}
+
+  ///@{
+  /**
+   * <p>The two-character code, in ISO 3166-1 alpha-2 format, for the country or
+   * region where the phone number was originally registered.</p>
+   */
+  inline const Aws::String& GetIsoCountryCode() const { return m_isoCountryCode; }
+  template <typename IsoCountryCodeT = Aws::String>
+  void SetIsoCountryCode(IsoCountryCodeT&& value) {
+    m_isoCountryCodeHasBeenSet = true;
+    m_isoCountryCode = std::forward<IsoCountryCodeT>(value);
+  }
+  template <typename IsoCountryCodeT = Aws::String>
+  CarrierLookupResult& WithIsoCountryCode(IsoCountryCodeT&& value) {
+    SetIsoCountryCode(std::forward<IsoCountryCodeT>(value));
+    return *this;
+  }
+  ///@}
+
+  ///@{
+  /**
+   * <p>The name of the country where the phone number was originally registered.</p>
+   */
+  inline const Aws::String& GetCountry() const { return m_country; }
+  template <typename CountryT = Aws::String>
+  void SetCountry(CountryT&& value) {
+    m_countryHasBeenSet = true;
+    m_country = std::forward<CountryT>(value);
+  }
+  template <typename CountryT = Aws::String>
+  CarrierLookupResult& WithCountry(CountryT&& value) {
+    SetCountry(std::forward<CountryT>(value));
+    return *this;
+  }
+  ///@}
+
+  ///@{
+  /**
+   * <p>The phone number's mobile country code, for mobile phone number types</p>
+   */
+  inline const Aws::String& GetMCC() const { return m_mCC; }
+  template <typename MCCT = Aws::String>
+  void SetMCC(MCCT&& value) {
+    m_mCCHasBeenSet = true;
+    m_mCC = std::forward<MCCT>(value);
+  }
+  template <typename MCCT = Aws::String>
+  CarrierLookupResult& WithMCC(MCCT&& value) {
+    SetMCC(std::forward<MCCT>(value));
+    return *this;
+  }
+  ///@}
+
+  ///@{
+  /**
+   * <p>The phone number's mobile network code, for mobile phone number types.</p>
+   */
+  inline const Aws::String& GetMNC() const { return m_mNC; }
+  template <typename MNCT = Aws::String>
+  void SetMNC(MNCT&& value) {
+    m_mNCHasBeenSet = true;
+    m_mNC = std::forward<MNCT>(value);
+  }
+  template <typename MNCT = Aws::String>
+  CarrierLookupResult& WithMNC(MNCT&& value) {
+    SetMNC(std::forward<MNCT>(value));
+    return *this;
+  }
+  ///@}
+
+  ///@{
+  /**
+   * <p>The carrier or service provider that the phone number is currently registered
+   * with. In some countries and regions, this value may be the carrier or service
+   * provider that the phone number was originally registered with.</p>
+   */
+  inline const Aws::String& GetCarrier() const { return m_carrier; }
+  template <typename CarrierT = Aws::String>
+  void SetCarrier(CarrierT&& value) {
+    m_carrierHasBeenSet = true;
+    m_carrier = std::forward<CarrierT>(value);
+  }
+  template <typename CarrierT = Aws::String>
+  CarrierLookupResult& WithCarrier(CarrierT&& value) {
+    SetCarrier(std::forward<CarrierT>(value));
+    return *this;
+  }
+  ///@}
+
+  ///@{
+  /**
+   * <p>Describes the type of phone number. Valid values are: MOBILE, LANDLINE,
+   * OTHER, and INVALID. Avoid sending SMS or voice messages to INVALID phone
+   * numbers, as these numbers are unlikely to belong to actual recipients.</p>
+   */
+  inline PhoneNumberType GetPhoneNumberType() const { return m_phoneNumberType; }
+  inline void SetPhoneNumberType(PhoneNumberType value) {
+    m_phoneNumberTypeHasBeenSet = true;
+    m_phoneNumberType = value;
+  }
+  inline CarrierLookupResult& WithPhoneNumberType(PhoneNumberType value) {
+    SetPhoneNumberType(value);
+    return *this;
+  }
+  ///@}
+
+  ///@{
+
+  inline const Aws::String& GetRequestId() const { return m_requestId; }
+  template <typename RequestIdT = Aws::String>
+  void SetRequestId(RequestIdT&& value) {
+    m_requestIdHasBeenSet = true;
+    m_requestId = std::forward<RequestIdT>(value);
+  }
+  template <typename RequestIdT = Aws::String>
+  CarrierLookupResult& WithRequestId(RequestIdT&& value) {
+    SetRequestId(std::forward<RequestIdT>(value));
+    return *this;
+  }
+  ///@}
+ private:
+  Aws::String m_e164PhoneNumber;
+  bool m_e164PhoneNumberHasBeenSet = false;
+
+  Aws::String m_dialingCountryCode;
+  bool m_dialingCountryCodeHasBeenSet = false;
+
+  Aws::String m_isoCountryCode;
+  bool m_isoCountryCodeHasBeenSet = false;
+
+  Aws::String m_country;
+  bool m_countryHasBeenSet = false;
+
+  Aws::String m_mCC;
+  bool m_mCCHasBeenSet = false;
+
+  Aws::String m_mNC;
+  bool m_mNCHasBeenSet = false;
+
+  Aws::String m_carrier;
+  bool m_carrierHasBeenSet = false;
+
+  PhoneNumberType m_phoneNumberType{PhoneNumberType::NOT_SET};
+  bool m_phoneNumberTypeHasBeenSet = false;
+
+  Aws::String m_requestId;
+  bool m_requestIdHasBeenSet = false;
+};
+
+}  // namespace Model
+}  // namespace PinpointSMSVoiceV2
+}  // namespace Aws

generated/src/aws-cpp-sdk-pinpoint-sms-voice-v2/include/aws/pinpoint-sms-voice-v2/model/CarrierLookupResult.h

@@ -77,8 +77,8 @@ class CreateEventDestinationRequest : public PinpointSMSVoiceV2Request {
   ///@{
   /**
    * <p>An array of event types that determine which events to log. If "ALL" is used,
-   * then AWS End User Messaging SMS and Voice logs every event type.</p>
-   * <p>The <code>TEXT_SENT</code> event type is not supported.</p>
+   * then End User MessagingSMS logs every event type.</p>  <p>The
+   * <code>TEXT_SENT</code> event type is not supported.</p>
    */
   inline const Aws::Vector<EventType>& GetMatchingEventTypes() const { return m_matchingEventTypes; }
   inline bool MatchingEventTypesHasBeenSet() const { return m_matchingEventTypesHasBeenSet; }

generated/src/aws-cpp-sdk-pinpoint-sms-voice-v2/include/aws/pinpoint-sms-voice-v2/model/CreateEventDestinationRequest.h

@@ -37,13 +37,15 @@ class CreatePoolRequest : public PinpointSMSVoiceV2Request {
   ///@{
   /**
    * <p>The origination identity to use such as a PhoneNumberId, PhoneNumberArn,
-   * SenderId or SenderIdArn. You can use <a>DescribePhoneNumbers</a> to find the
-   * values for PhoneNumberId and PhoneNumberArn while <a>DescribeSenderIds</a> can
-   * be used to get the values for SenderId and SenderIdArn.</p> <p>After the pool is
-   * created you can add more origination identities to the pool by using <a
+   * SenderId or SenderIdArn. You can use <a
+   * href="https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_DescribePhoneNumbers.html">DescribePhoneNumbers</a>
+   * to find the values for PhoneNumberId and PhoneNumberArn, and use <a
+   * href="https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_DescribeSenderIds.html">DescribeSenderIds</a>
+   * can be used to get the values for SenderId and SenderIdArn.</p> <p>After the
+   * pool is created you can add more origination identities to the pool by using <a
    * href="https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_AssociateOriginationIdentity.html">AssociateOriginationIdentity</a>.</p>
-   *  <p>If you are using a shared AWS End User Messaging SMS and Voice
-   * resource then you must use the full Amazon Resource Name(ARN).</p>
+   *  <p>If you are using a shared End User MessagingSMS resource then you
+   * must use the full Amazon Resource Name(ARN).</p>
    */
   inline const Aws::String& GetOriginationIdentity() const { return m_originationIdentity; }
   inline bool OriginationIdentityHasBeenSet() const { return m_originationIdentityHasBeenSet; }
@@ -99,7 +101,9 @@ class CreatePoolRequest : public PinpointSMSVoiceV2Request {
   ///@{
   /**
    * <p>By default this is set to false. When set to true the pool can't be deleted.
-   * You can change this value using the <a>UpdatePool</a> action.</p>
+   * You can change this value using the <a
+   * href="https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_UpdatePool.html">UpdatePool</a>
+   * action.</p>
    */
   inline bool GetDeletionProtectionEnabled() const { return m_deletionProtectionEnabled; }
   inline bool DeletionProtectionEnabledHasBeenSet() const { return m_deletionProtectionEnabledHasBeenSet; }