# frozen_string_literal: true # WARNING ABOUT GENERATED CODE # # This file is generated. See the contributing guide for more information: # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md # # WARNING ABOUT GENERATED CODE require 'seahorse/client/plugins/content_length.rb' require 'aws-sdk-core/plugins/credentials_configuration.rb' require 'aws-sdk-core/plugins/logging.rb' require 'aws-sdk-core/plugins/param_converter.rb' require 'aws-sdk-core/plugins/param_validator.rb' require 'aws-sdk-core/plugins/user_agent.rb' require 'aws-sdk-core/plugins/helpful_socket_errors.rb' require 'aws-sdk-core/plugins/retry_errors.rb' require 'aws-sdk-core/plugins/global_configuration.rb' require 'aws-sdk-core/plugins/regional_endpoint.rb' require 'aws-sdk-core/plugins/endpoint_discovery.rb' require 'aws-sdk-core/plugins/endpoint_pattern.rb' require 'aws-sdk-core/plugins/response_paging.rb' require 'aws-sdk-core/plugins/stub_responses.rb' require 'aws-sdk-core/plugins/idempotency_token.rb' require 'aws-sdk-core/plugins/jsonvalue_converter.rb' require 'aws-sdk-core/plugins/client_metrics_plugin.rb' require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb' require 'aws-sdk-core/plugins/transfer_encoding.rb' require 'aws-sdk-core/plugins/http_checksum.rb' require 'aws-sdk-core/plugins/checksum_algorithm.rb' require 'aws-sdk-core/plugins/defaults_mode.rb' require 'aws-sdk-core/plugins/recursion_detection.rb' require 'aws-sdk-core/plugins/sign.rb' require 'aws-sdk-core/plugins/protocols/json_rpc.rb' Aws::Plugins::GlobalConfiguration.add_identifier(:pinpointsmsvoicev2) module Aws::PinpointSMSVoiceV2 # An API client for PinpointSMSVoiceV2. To construct a client, you need to configure a `:region` and `:credentials`. # # client = Aws::PinpointSMSVoiceV2::Client.new( # region: region_name, # credentials: credentials, # # ... # ) # # For details on configuring region and credentials see # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html). # # See {#initialize} for a full list of supported configuration options. class Client < Seahorse::Client::Base include Aws::ClientStubs @identifier = :pinpointsmsvoicev2 set_api(ClientApi::API) add_plugin(Seahorse::Client::Plugins::ContentLength) add_plugin(Aws::Plugins::CredentialsConfiguration) add_plugin(Aws::Plugins::Logging) add_plugin(Aws::Plugins::ParamConverter) add_plugin(Aws::Plugins::ParamValidator) add_plugin(Aws::Plugins::UserAgent) add_plugin(Aws::Plugins::HelpfulSocketErrors) add_plugin(Aws::Plugins::RetryErrors) add_plugin(Aws::Plugins::GlobalConfiguration) add_plugin(Aws::Plugins::RegionalEndpoint) add_plugin(Aws::Plugins::EndpointDiscovery) add_plugin(Aws::Plugins::EndpointPattern) add_plugin(Aws::Plugins::ResponsePaging) add_plugin(Aws::Plugins::StubResponses) add_plugin(Aws::Plugins::IdempotencyToken) add_plugin(Aws::Plugins::JsonvalueConverter) add_plugin(Aws::Plugins::ClientMetricsPlugin) add_plugin(Aws::Plugins::ClientMetricsSendPlugin) add_plugin(Aws::Plugins::TransferEncoding) add_plugin(Aws::Plugins::HttpChecksum) add_plugin(Aws::Plugins::ChecksumAlgorithm) add_plugin(Aws::Plugins::DefaultsMode) add_plugin(Aws::Plugins::RecursionDetection) add_plugin(Aws::Plugins::Sign) add_plugin(Aws::Plugins::Protocols::JsonRpc) add_plugin(Aws::PinpointSMSVoiceV2::Plugins::Endpoints) # @overload initialize(options) # @param [Hash] options # @option options [required, Aws::CredentialProvider] :credentials # Your AWS credentials. This can be an instance of any one of the # following classes: # # * `Aws::Credentials` - Used for configuring static, non-refreshing # credentials. # # * `Aws::SharedCredentials` - Used for loading static credentials from a # shared file, such as `~/.aws/config`. # # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role. # # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to # assume a role after providing credentials via the web. # # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an # access token generated from `aws login`. # # * `Aws::ProcessCredentials` - Used for loading credentials from a # process that outputs to stdout. # # * `Aws::InstanceProfileCredentials` - Used for loading credentials # from an EC2 IMDS on an EC2 instance. # # * `Aws::ECSCredentials` - Used for loading credentials from # instances running in ECS. # # * `Aws::CognitoIdentityCredentials` - Used for loading credentials # from the Cognito Identity service. # # When `:credentials` are not configured directly, the following # locations will be searched for credentials: # # * `Aws.config[:credentials]` # * The `:access_key_id`, `:secret_access_key`, and `:session_token` options. # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY'] # * `~/.aws/credentials` # * `~/.aws/config` # * EC2/ECS IMDS instance profile - When used by default, the timeouts # are very aggressive. Construct and pass an instance of # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to # enable retries and extended timeouts. Instance profile credential # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED'] # to true. # # @option options [required, String] :region # The AWS region to connect to. The configured `:region` is # used to determine the service `:endpoint`. When not passed, # a default `:region` is searched for in the following locations: # # * `Aws.config[:region]` # * `ENV['AWS_REGION']` # * `ENV['AMAZON_REGION']` # * `ENV['AWS_DEFAULT_REGION']` # * `~/.aws/credentials` # * `~/.aws/config` # # @option options [String] :access_key_id # # @option options [Boolean] :active_endpoint_cache (false) # When set to `true`, a thread polling for endpoints will be running in # the background every 60 secs (default). Defaults to `false`. # # @option options [Boolean] :adaptive_retry_wait_to_fill (true) # Used only in `adaptive` retry mode. When true, the request will sleep # until there is sufficent client side capacity to retry the request. # When false, the request will raise a `RetryCapacityNotAvailableError` and will # not retry instead of sleeping. # # @option options [Boolean] :client_side_monitoring (false) # When `true`, client-side metrics will be collected for all API requests from # this client. # # @option options [String] :client_side_monitoring_client_id ("") # Allows you to provide an identifier for this client which will be attached to # all generated client side metrics. Defaults to an empty string. # # @option options [String] :client_side_monitoring_host ("127.0.0.1") # Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client # side monitoring agent is running on, where client metrics will be published via UDP. # # @option options [Integer] :client_side_monitoring_port (31000) # Required for publishing client metrics. The port that the client side monitoring # agent is running on, where client metrics will be published via UDP. # # @option options [Aws::ClientSideMonitoring::Publisher] :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher) # Allows you to provide a custom client-side monitoring publisher class. By default, # will use the Client Side Monitoring Agent Publisher. # # @option options [Boolean] :convert_params (true) # When `true`, an attempt is made to coerce request parameters into # the required types. # # @option options [Boolean] :correct_clock_skew (true) # Used only in `standard` and adaptive retry modes. Specifies whether to apply # a clock skew correction and retry requests with skewed client clocks. # # @option options [String] :defaults_mode ("legacy") # See {Aws::DefaultsModeConfiguration} for a list of the # accepted modes and the configuration defaults that are included. # # @option options [Boolean] :disable_host_prefix_injection (false) # Set to true to disable SDK automatically adding host prefix # to default service endpoint when available. # # @option options [String] :endpoint # The client endpoint is normally constructed from the `:region` # option. You should only configure an `:endpoint` when connecting # to test or custom endpoints. This should be a valid HTTP(S) URI. # # @option options [Integer] :endpoint_cache_max_entries (1000) # Used for the maximum size limit of the LRU cache storing endpoints data # for endpoint discovery enabled operations. Defaults to 1000. # # @option options [Integer] :endpoint_cache_max_threads (10) # Used for the maximum threads in use for polling endpoints to be cached, defaults to 10. # # @option options [Integer] :endpoint_cache_poll_interval (60) # When :endpoint_discovery and :active_endpoint_cache is enabled, # Use this option to config the time interval in seconds for making # requests fetching endpoints information. Defaults to 60 sec. # # @option options [Boolean] :endpoint_discovery (false) # When set to `true`, endpoint discovery will be enabled for operations when available. # # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default) # The log formatter. # # @option options [Symbol] :log_level (:info) # The log level to send messages to the `:logger` at. # # @option options [Logger] :logger # The Logger instance to send log messages to. If this option # is not set, logging will be disabled. # # @option options [Integer] :max_attempts (3) # An integer representing the maximum number attempts that will be made for # a single request, including the initial attempt. For example, # setting this value to 5 will result in a request being retried up to # 4 times. Used in `standard` and `adaptive` retry modes. # # @option options [String] :profile ("default") # Used when loading credentials from the shared credentials file # at HOME/.aws/credentials. When not specified, 'default' is used. # # @option options [Proc] :retry_backoff # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay. # This option is only used in the `legacy` retry mode. # # @option options [Float] :retry_base_delay (0.3) # The base delay in seconds used by the default backoff function. This option # is only used in the `legacy` retry mode. # # @option options [Symbol] :retry_jitter (:none) # A delay randomiser function used by the default backoff function. # Some predefined functions can be referenced by name - :none, :equal, :full, # otherwise a Proc that takes and returns a number. This option is only used # in the `legacy` retry mode. # # @see https://www.awsarchitectureblog.com/2015/03/backoff.html # # @option options [Integer] :retry_limit (3) # The maximum number of times to retry failed requests. Only # ~ 500 level server errors and certain ~ 400 level client errors # are retried. Generally, these are throttling errors, data # checksum errors, networking errors, timeout errors, auth errors, # endpoint discovery, and errors from expired credentials. # This option is only used in the `legacy` retry mode. # # @option options [Integer] :retry_max_delay (0) # The maximum number of seconds to delay between retries (0 for no limit) # used by the default backoff function. This option is only used in the # `legacy` retry mode. # # @option options [String] :retry_mode ("legacy") # Specifies which retry algorithm to use. Values are: # # * `legacy` - The pre-existing retry behavior. This is default value if # no retry mode is provided. # # * `standard` - A standardized set of retry rules across the AWS SDKs. # This includes support for retry quotas, which limit the number of # unsuccessful retries a client can make. # # * `adaptive` - An experimental retry mode that includes all the # functionality of `standard` mode along with automatic client side # throttling. This is a provisional mode that may change behavior # in the future. # # # @option options [String] :secret_access_key # # @option options [String] :session_token # # @option options [Boolean] :simple_json (false) # Disables request parameter conversion, validation, and formatting. # Also disable response data type conversions. This option is useful # when you want to ensure the highest level of performance by # avoiding overhead of walking request parameters and response data # structures. # # When `:simple_json` is enabled, the request parameters hash must # be formatted exactly as the DynamoDB API expects. # # @option options [Boolean] :stub_responses (false) # Causes the client to return stubbed responses. By default # fake responses are generated and returned. You can specify # the response data to return or errors to raise by calling # {ClientStubs#stub_responses}. See {ClientStubs} for more information. # # ** Please note ** When response stubbing is enabled, no HTTP # requests are made, and retries are disabled. # # @option options [Aws::TokenProvider] :token_provider # A Bearer Token Provider. This can be an instance of any one of the # following classes: # # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing # tokens. # # * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an # access token generated from `aws login`. # # When `:token_provider` is not configured directly, the `Aws::TokenProviderChain` # will be used to search for tokens configured for your profile in shared configuration files. # # @option options [Boolean] :use_dualstack_endpoint # When set to `true`, dualstack enabled endpoints (with `.aws` TLD) # will be used if available. # # @option options [Boolean] :use_fips_endpoint # When set to `true`, fips compatible endpoints will be used if available. # When a `fips` region is used, the region is normalized and this config # is set to `true`. # # @option options [Boolean] :validate_params (true) # When `true`, request parameters are validated before # sending the request. # # @option options [Aws::PinpointSMSVoiceV2::EndpointProvider] :endpoint_provider # The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::PinpointSMSVoiceV2::EndpointParameters` # # @option options [URI::HTTP,String] :http_proxy A proxy to send # requests through. Formatted like 'http://proxy.com:123'. # # @option options [Float] :http_open_timeout (15) The number of # seconds to wait when opening a HTTP session before raising a # `Timeout::Error`. # # @option options [Float] :http_read_timeout (60) The default # number of seconds to wait for response data. This value can # safely be set per-request on the session. # # @option options [Float] :http_idle_timeout (5) The number of # seconds a connection is allowed to sit idle before it is # considered stale. Stale connections are closed and removed # from the pool before making a request. # # @option options [Float] :http_continue_timeout (1) The number of # seconds to wait for a 100-continue response before sending the # request body. This option has no effect unless the request has # "Expect" header set to "100-continue". Defaults to `nil` which # disables this behaviour. This value can safely be set per # request on the session. # # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout # in seconds. # # @option options [Boolean] :http_wire_trace (false) When `true`, # HTTP debug output will be sent to the `:logger`. # # @option options [Boolean] :ssl_verify_peer (true) When `true`, # SSL peer certificates are verified when establishing a # connection. # # @option options [String] :ssl_ca_bundle Full path to the SSL # certificate authority bundle file that should be used when # verifying peer certificates. If you do not pass # `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default # will be used if available. # # @option options [String] :ssl_ca_directory Full path of the # directory that contains the unbundled SSL certificate # authority files for verifying peer certificates. If you do # not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the # system default will be used if available. # def initialize(*args) super end # @!group API Operations # Associates the specified origination identity with a pool. # # If the origination identity is a phone number and is already # associated with another pool, an Error is returned. A sender ID can be # associated with multiple pools. # # If the origination identity configuration doesn't match the pool's # configuration, an Error is returned. # # @option params [required, String] :pool_id # The pool to update with the new Identity. This value can be either the # PoolId or PoolArn, and you can find these values using DescribePools. # # @option params [required, String] :origination_identity # The origination identity to use, such as PhoneNumberId, # PhoneNumberArn, SenderId, or SenderIdArn. You can use # DescribePhoneNumbers to find the values for PhoneNumberId and # PhoneNumberArn, while DescribeSenderIds can be used to get the values # for SenderId and SenderIdArn. # # @option params [required, String] :iso_country_code # The new two-character code, in ISO 3166-1 alpha-2 format, for the # country or region of the origination identity. # # @option params [String] :client_token # Unique, case-sensitive identifier that you provide to ensure the # idempotency of the request. If you don't specify a client token, a # randomly generated token is used for the request to ensure # idempotency. # # **A suitable default value is auto-generated.** You should normally # not need to pass this option.** # # @return [Types::AssociateOriginationIdentityResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::AssociateOriginationIdentityResult#pool_arn #pool_arn} => String # * {Types::AssociateOriginationIdentityResult#pool_id #pool_id} => String # * {Types::AssociateOriginationIdentityResult#origination_identity_arn #origination_identity_arn} => String # * {Types::AssociateOriginationIdentityResult#origination_identity #origination_identity} => String # * {Types::AssociateOriginationIdentityResult#iso_country_code #iso_country_code} => String # # @example Request syntax with placeholder values # # resp = client.associate_origination_identity({ # pool_id: "PoolIdOrArn", # required # origination_identity: "PhoneOrSenderIdOrArn", # required # iso_country_code: "IsoCountryCode", # required # client_token: "ClientToken", # }) # # @example Response structure # # resp.pool_arn #=> String # resp.pool_id #=> String # resp.origination_identity_arn #=> String # resp.origination_identity #=> String # resp.iso_country_code #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/AssociateOriginationIdentity AWS API Documentation # # @overload associate_origination_identity(params = {}) # @param [Hash] params ({}) def associate_origination_identity(params = {}, options = {}) req = build_request(:associate_origination_identity, params) req.send_request(options) end # Creates a new configuration set. After you create the configuration # set, you can add one or more event destinations to it. # # A configuration set is a set of rules that you apply to the SMS and # voice messages that you send. # # When you send a message, you can optionally specify a single # configuration set. # # @option params [required, String] :configuration_set_name # The name to use for the new configuration set. # # @option params [Array] :tags # An array of key and value pair tags that's associated with the new # configuration set. # # @option params [String] :client_token # Unique, case-sensitive identifier that you provide to ensure the # idempotency of the request. If you don't specify a client token, a # randomly generated token is used for the request to ensure # idempotency. # # **A suitable default value is auto-generated.** You should normally # not need to pass this option.** # # @return [Types::CreateConfigurationSetResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::CreateConfigurationSetResult#configuration_set_arn #configuration_set_arn} => String # * {Types::CreateConfigurationSetResult#configuration_set_name #configuration_set_name} => String # * {Types::CreateConfigurationSetResult#tags #tags} => Array<Types::Tag> # * {Types::CreateConfigurationSetResult#created_timestamp #created_timestamp} => Time # # @example Request syntax with placeholder values # # resp = client.create_configuration_set({ # configuration_set_name: "ConfigurationSetName", # required # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # client_token: "ClientToken", # }) # # @example Response structure # # resp.configuration_set_arn #=> String # resp.configuration_set_name #=> String # resp.tags #=> Array # resp.tags[0].key #=> String # resp.tags[0].value #=> String # resp.created_timestamp #=> Time # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/CreateConfigurationSet AWS API Documentation # # @overload create_configuration_set(params = {}) # @param [Hash] params ({}) def create_configuration_set(params = {}, options = {}) req = build_request(:create_configuration_set, params) req.send_request(options) end # Creates a new event destination in a configuration set. # # An event destination is a location where you send message events. The # event options are Amazon CloudWatch, Amazon Kinesis Data Firehose, or # Amazon SNS. For example, when a message is delivered successfully, you # can send information about that event to an event destination, or send # notifications to endpoints that are subscribed to an Amazon SNS topic. # # Each configuration set can contain between 0 and 5 event destinations. # Each event destination can contain a reference to a single # destination, such as a CloudWatch or Kinesis Data Firehose # destination. # # @option params [required, String] :configuration_set_name # Either the name of the configuration set or the configuration set ARN # to apply event logging to. The ConfigurateSetName and # ConfigurationSetArn can be found using the DescribeConfigurationSets # action. # # @option params [required, String] :event_destination_name # The name that identifies the event destination. # # @option params [required, Array] :matching_event_types # An array of event types that determine which events to log. If "ALL" # is used, then Amazon Pinpoint logs every event type. # # @option params [Types::CloudWatchLogsDestination] :cloud_watch_logs_destination # An object that contains information about an event destination for # logging to Amazon CloudWatch logs. # # @option params [Types::KinesisFirehoseDestination] :kinesis_firehose_destination # An object that contains information about an event destination for # logging to Amazon Kinesis Data Firehose. # # @option params [Types::SnsDestination] :sns_destination # An object that contains information about an event destination for # logging to Amazon SNS. # # @option params [String] :client_token # Unique, case-sensitive identifier that you provide to ensure the # idempotency of the request. If you don't specify a client token, a # randomly generated token is used for the request to ensure # idempotency. # # **A suitable default value is auto-generated.** You should normally # not need to pass this option.** # # @return [Types::CreateEventDestinationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::CreateEventDestinationResult#configuration_set_arn #configuration_set_arn} => String # * {Types::CreateEventDestinationResult#configuration_set_name #configuration_set_name} => String # * {Types::CreateEventDestinationResult#event_destination #event_destination} => Types::EventDestination # # @example Request syntax with placeholder values # # resp = client.create_event_destination({ # configuration_set_name: "ConfigurationSetNameOrArn", # required # event_destination_name: "EventDestinationName", # required # matching_event_types: ["ALL"], # required, accepts ALL, TEXT_ALL, TEXT_SENT, TEXT_PENDING, TEXT_QUEUED, TEXT_SUCCESSFUL, TEXT_DELIVERED, TEXT_INVALID, TEXT_INVALID_MESSAGE, TEXT_UNREACHABLE, TEXT_CARRIER_UNREACHABLE, TEXT_BLOCKED, TEXT_CARRIER_BLOCKED, TEXT_SPAM, TEXT_UNKNOWN, TEXT_TTL_EXPIRED, VOICE_ALL, VOICE_INITIATED, VOICE_RINGING, VOICE_ANSWERED, VOICE_COMPLETED, VOICE_BUSY, VOICE_NO_ANSWER, VOICE_FAILED, VOICE_TTL_EXPIRED # cloud_watch_logs_destination: { # iam_role_arn: "IamRoleArn", # required # log_group_arn: "LogGroupArn", # required # }, # kinesis_firehose_destination: { # iam_role_arn: "IamRoleArn", # required # delivery_stream_arn: "DeliveryStreamArn", # required # }, # sns_destination: { # topic_arn: "SnsTopicArn", # required # }, # client_token: "ClientToken", # }) # # @example Response structure # # resp.configuration_set_arn #=> String # resp.configuration_set_name #=> String # resp.event_destination.event_destination_name #=> String # resp.event_destination.enabled #=> Boolean # resp.event_destination.matching_event_types #=> Array # resp.event_destination.matching_event_types[0] #=> String, one of "ALL", "TEXT_ALL", "TEXT_SENT", "TEXT_PENDING", "TEXT_QUEUED", "TEXT_SUCCESSFUL", "TEXT_DELIVERED", "TEXT_INVALID", "TEXT_INVALID_MESSAGE", "TEXT_UNREACHABLE", "TEXT_CARRIER_UNREACHABLE", "TEXT_BLOCKED", "TEXT_CARRIER_BLOCKED", "TEXT_SPAM", "TEXT_UNKNOWN", "TEXT_TTL_EXPIRED", "VOICE_ALL", "VOICE_INITIATED", "VOICE_RINGING", "VOICE_ANSWERED", "VOICE_COMPLETED", "VOICE_BUSY", "VOICE_NO_ANSWER", "VOICE_FAILED", "VOICE_TTL_EXPIRED" # resp.event_destination.cloud_watch_logs_destination.iam_role_arn #=> String # resp.event_destination.cloud_watch_logs_destination.log_group_arn #=> String # resp.event_destination.kinesis_firehose_destination.iam_role_arn #=> String # resp.event_destination.kinesis_firehose_destination.delivery_stream_arn #=> String # resp.event_destination.sns_destination.topic_arn #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/CreateEventDestination AWS API Documentation # # @overload create_event_destination(params = {}) # @param [Hash] params ({}) def create_event_destination(params = {}, options = {}) req = build_request(:create_event_destination, params) req.send_request(options) end # Creates a new opt-out list. # # If the opt-out list name already exists, an Error is returned. # # An opt-out list is a list of phone numbers that are opted out, meaning # you can't send SMS or voice messages to them. If end user replies # with the keyword "STOP," an entry for the phone number is added to # the opt-out list. In addition to STOP, your recipients can use any # supported opt-out keyword, such as CANCEL or OPTOUT. For a list of # supported opt-out keywords, see [ SMS opt out ][1] in the *Amazon # Pinpoint User Guide*. # # # # [1]: https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-manage.html#channels-sms-manage-optout # # @option params [required, String] :opt_out_list_name # The name of the new OptOutList. # # @option params [Array] :tags # An array of tags (key and value pairs) to associate with the new # OptOutList. # # @option params [String] :client_token # Unique, case-sensitive identifier that you provide to ensure the # idempotency of the request. If you don't specify a client token, a # randomly generated token is used for the request to ensure # idempotency. # # **A suitable default value is auto-generated.** You should normally # not need to pass this option.** # # @return [Types::CreateOptOutListResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::CreateOptOutListResult#opt_out_list_arn #opt_out_list_arn} => String # * {Types::CreateOptOutListResult#opt_out_list_name #opt_out_list_name} => String # * {Types::CreateOptOutListResult#tags #tags} => Array<Types::Tag> # * {Types::CreateOptOutListResult#created_timestamp #created_timestamp} => Time # # @example Request syntax with placeholder values # # resp = client.create_opt_out_list({ # opt_out_list_name: "OptOutListName", # required # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # client_token: "ClientToken", # }) # # @example Response structure # # resp.opt_out_list_arn #=> String # resp.opt_out_list_name #=> String # resp.tags #=> Array # resp.tags[0].key #=> String # resp.tags[0].value #=> String # resp.created_timestamp #=> Time # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/CreateOptOutList AWS API Documentation # # @overload create_opt_out_list(params = {}) # @param [Hash] params ({}) def create_opt_out_list(params = {}, options = {}) req = build_request(:create_opt_out_list, params) req.send_request(options) end # Creates a new pool and associates the specified origination identity # to the pool. A pool can include one or more phone numbers and # SenderIds that are associated with your Amazon Web Services account. # # The new pool inherits its configuration from the specified origination # identity. This includes keywords, message type, opt-out list, two-way # configuration, and self-managed opt-out configuration. Deletion # protection isn't inherited from the origination identity and defaults # to false. # # If the origination identity is a phone number and is already # associated with another pool, an Error is returned. A sender ID can be # associated with multiple pools. # # @option params [required, String] :origination_identity # The origination identity to use such as a PhoneNumberId, # PhoneNumberArn, SenderId or SenderIdArn. You can use # DescribePhoneNumbers to find the values for PhoneNumberId and # PhoneNumberArn while DescribeSenderIds can be used to get the values # for SenderId and SenderIdArn. # # @option params [required, String] :iso_country_code # The new two-character code, in ISO 3166-1 alpha-2 format, for the # country or region of the new pool. # # @option params [required, String] :message_type # The type of message. Valid values are TRANSACTIONAL for messages that # are critical or time-sensitive and PROMOTIONAL for messages that # aren't critical or time-sensitive. # # @option params [Boolean] :deletion_protection_enabled # By default this is set to false. When set to true the pool can't be # deleted. You can change this value using the UpdatePool action. # # @option params [Array] :tags # An array of tags (key and value pairs) associated with the pool. # # @option params [String] :client_token # Unique, case-sensitive identifier that you provide to ensure the # idempotency of the request. If you don't specify a client token, a # randomly generated token is used for the request to ensure # idempotency. # # **A suitable default value is auto-generated.** You should normally # not need to pass this option.** # # @return [Types::CreatePoolResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::CreatePoolResult#pool_arn #pool_arn} => String # * {Types::CreatePoolResult#pool_id #pool_id} => String # * {Types::CreatePoolResult#status #status} => String # * {Types::CreatePoolResult#message_type #message_type} => String # * {Types::CreatePoolResult#two_way_enabled #two_way_enabled} => Boolean # * {Types::CreatePoolResult#two_way_channel_arn #two_way_channel_arn} => String # * {Types::CreatePoolResult#self_managed_opt_outs_enabled #self_managed_opt_outs_enabled} => Boolean # * {Types::CreatePoolResult#opt_out_list_name #opt_out_list_name} => String # * {Types::CreatePoolResult#shared_routes_enabled #shared_routes_enabled} => Boolean # * {Types::CreatePoolResult#deletion_protection_enabled #deletion_protection_enabled} => Boolean # * {Types::CreatePoolResult#tags #tags} => Array<Types::Tag> # * {Types::CreatePoolResult#created_timestamp #created_timestamp} => Time # # @example Request syntax with placeholder values # # resp = client.create_pool({ # origination_identity: "PhoneOrSenderIdOrArn", # required # iso_country_code: "IsoCountryCode", # required # message_type: "TRANSACTIONAL", # required, accepts TRANSACTIONAL, PROMOTIONAL # deletion_protection_enabled: false, # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # client_token: "ClientToken", # }) # # @example Response structure # # resp.pool_arn #=> String # resp.pool_id #=> String # resp.status #=> String, one of "CREATING", "ACTIVE", "DELETING" # resp.message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.two_way_enabled #=> Boolean # resp.two_way_channel_arn #=> String # resp.self_managed_opt_outs_enabled #=> Boolean # resp.opt_out_list_name #=> String # resp.shared_routes_enabled #=> Boolean # resp.deletion_protection_enabled #=> Boolean # resp.tags #=> Array # resp.tags[0].key #=> String # resp.tags[0].value #=> String # resp.created_timestamp #=> Time # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/CreatePool AWS API Documentation # # @overload create_pool(params = {}) # @param [Hash] params ({}) def create_pool(params = {}, options = {}) req = build_request(:create_pool, params) req.send_request(options) end # Deletes an existing configuration set. # # A configuration set is a set of rules that you apply to voice and SMS # messages that you send. In a configuration set, you can specify a # destination for specific types of events related to voice and SMS # messages. # # @option params [required, String] :configuration_set_name # The name of the configuration set or the configuration set ARN that # you want to delete. The ConfigurationSetName and ConfigurationSetArn # can be found using the DescribeConfigurationSets action. # # @return [Types::DeleteConfigurationSetResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeleteConfigurationSetResult#configuration_set_arn #configuration_set_arn} => String # * {Types::DeleteConfigurationSetResult#configuration_set_name #configuration_set_name} => String # * {Types::DeleteConfigurationSetResult#event_destinations #event_destinations} => Array<Types::EventDestination> # * {Types::DeleteConfigurationSetResult#default_message_type #default_message_type} => String # * {Types::DeleteConfigurationSetResult#default_sender_id #default_sender_id} => String # * {Types::DeleteConfigurationSetResult#created_timestamp #created_timestamp} => Time # # @example Request syntax with placeholder values # # resp = client.delete_configuration_set({ # configuration_set_name: "ConfigurationSetNameOrArn", # required # }) # # @example Response structure # # resp.configuration_set_arn #=> String # resp.configuration_set_name #=> String # resp.event_destinations #=> Array # resp.event_destinations[0].event_destination_name #=> String # resp.event_destinations[0].enabled #=> Boolean # resp.event_destinations[0].matching_event_types #=> Array # resp.event_destinations[0].matching_event_types[0] #=> String, one of "ALL", "TEXT_ALL", "TEXT_SENT", "TEXT_PENDING", "TEXT_QUEUED", "TEXT_SUCCESSFUL", "TEXT_DELIVERED", "TEXT_INVALID", "TEXT_INVALID_MESSAGE", "TEXT_UNREACHABLE", "TEXT_CARRIER_UNREACHABLE", "TEXT_BLOCKED", "TEXT_CARRIER_BLOCKED", "TEXT_SPAM", "TEXT_UNKNOWN", "TEXT_TTL_EXPIRED", "VOICE_ALL", "VOICE_INITIATED", "VOICE_RINGING", "VOICE_ANSWERED", "VOICE_COMPLETED", "VOICE_BUSY", "VOICE_NO_ANSWER", "VOICE_FAILED", "VOICE_TTL_EXPIRED" # resp.event_destinations[0].cloud_watch_logs_destination.iam_role_arn #=> String # resp.event_destinations[0].cloud_watch_logs_destination.log_group_arn #=> String # resp.event_destinations[0].kinesis_firehose_destination.iam_role_arn #=> String # resp.event_destinations[0].kinesis_firehose_destination.delivery_stream_arn #=> String # resp.event_destinations[0].sns_destination.topic_arn #=> String # resp.default_message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.default_sender_id #=> String # resp.created_timestamp #=> Time # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DeleteConfigurationSet AWS API Documentation # # @overload delete_configuration_set(params = {}) # @param [Hash] params ({}) def delete_configuration_set(params = {}, options = {}) req = build_request(:delete_configuration_set, params) req.send_request(options) end # Deletes an existing default message type on a configuration set. # # A message type is a type of messages that you plan to send. If you # send account-related messages or time-sensitive messages such as # one-time passcodes, choose **Transactional**. If you plan to send # messages that contain marketing material or other promotional content, # choose **Promotional**. This setting applies to your entire Amazon Web # Services account. # # @option params [required, String] :configuration_set_name # The name of the configuration set or the configuration set Amazon # Resource Name (ARN) to delete the default message type from. The # ConfigurationSetName and ConfigurationSetArn can be found using the # DescribeConfigurationSets action. # # @return [Types::DeleteDefaultMessageTypeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeleteDefaultMessageTypeResult#configuration_set_arn #configuration_set_arn} => String # * {Types::DeleteDefaultMessageTypeResult#configuration_set_name #configuration_set_name} => String # * {Types::DeleteDefaultMessageTypeResult#message_type #message_type} => String # # @example Request syntax with placeholder values # # resp = client.delete_default_message_type({ # configuration_set_name: "ConfigurationSetNameOrArn", # required # }) # # @example Response structure # # resp.configuration_set_arn #=> String # resp.configuration_set_name #=> String # resp.message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DeleteDefaultMessageType AWS API Documentation # # @overload delete_default_message_type(params = {}) # @param [Hash] params ({}) def delete_default_message_type(params = {}, options = {}) req = build_request(:delete_default_message_type, params) req.send_request(options) end # Deletes an existing default sender ID on a configuration set. # # A default sender ID is the identity that appears on recipients' # devices when they receive SMS messages. Support for sender ID # capabilities varies by country or region. # # @option params [required, String] :configuration_set_name # The name of the configuration set or the configuration set Amazon # Resource Name (ARN) to delete the default sender ID from. The # ConfigurationSetName and ConfigurationSetArn can be found using the # DescribeConfigurationSets action. # # @return [Types::DeleteDefaultSenderIdResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeleteDefaultSenderIdResult#configuration_set_arn #configuration_set_arn} => String # * {Types::DeleteDefaultSenderIdResult#configuration_set_name #configuration_set_name} => String # * {Types::DeleteDefaultSenderIdResult#sender_id #sender_id} => String # # @example Request syntax with placeholder values # # resp = client.delete_default_sender_id({ # configuration_set_name: "ConfigurationSetNameOrArn", # required # }) # # @example Response structure # # resp.configuration_set_arn #=> String # resp.configuration_set_name #=> String # resp.sender_id #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DeleteDefaultSenderId AWS API Documentation # # @overload delete_default_sender_id(params = {}) # @param [Hash] params ({}) def delete_default_sender_id(params = {}, options = {}) req = build_request(:delete_default_sender_id, params) req.send_request(options) end # Deletes an existing event destination. # # An event destination is a location where you send response information # about the messages that you send. For example, when a message is # delivered successfully, you can send information about that event to # an Amazon CloudWatch destination, or send notifications to endpoints # that are subscribed to an Amazon SNS topic. # # @option params [required, String] :configuration_set_name # The name of the configuration set or the configuration set's Amazon # Resource Name (ARN) to remove the event destination from. The # ConfigurateSetName and ConfigurationSetArn can be found using the # DescribeConfigurationSets action. # # @option params [required, String] :event_destination_name # The name of the event destination to delete. # # @return [Types::DeleteEventDestinationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeleteEventDestinationResult#configuration_set_arn #configuration_set_arn} => String # * {Types::DeleteEventDestinationResult#configuration_set_name #configuration_set_name} => String # * {Types::DeleteEventDestinationResult#event_destination #event_destination} => Types::EventDestination # # @example Request syntax with placeholder values # # resp = client.delete_event_destination({ # configuration_set_name: "ConfigurationSetNameOrArn", # required # event_destination_name: "EventDestinationName", # required # }) # # @example Response structure # # resp.configuration_set_arn #=> String # resp.configuration_set_name #=> String # resp.event_destination.event_destination_name #=> String # resp.event_destination.enabled #=> Boolean # resp.event_destination.matching_event_types #=> Array # resp.event_destination.matching_event_types[0] #=> String, one of "ALL", "TEXT_ALL", "TEXT_SENT", "TEXT_PENDING", "TEXT_QUEUED", "TEXT_SUCCESSFUL", "TEXT_DELIVERED", "TEXT_INVALID", "TEXT_INVALID_MESSAGE", "TEXT_UNREACHABLE", "TEXT_CARRIER_UNREACHABLE", "TEXT_BLOCKED", "TEXT_CARRIER_BLOCKED", "TEXT_SPAM", "TEXT_UNKNOWN", "TEXT_TTL_EXPIRED", "VOICE_ALL", "VOICE_INITIATED", "VOICE_RINGING", "VOICE_ANSWERED", "VOICE_COMPLETED", "VOICE_BUSY", "VOICE_NO_ANSWER", "VOICE_FAILED", "VOICE_TTL_EXPIRED" # resp.event_destination.cloud_watch_logs_destination.iam_role_arn #=> String # resp.event_destination.cloud_watch_logs_destination.log_group_arn #=> String # resp.event_destination.kinesis_firehose_destination.iam_role_arn #=> String # resp.event_destination.kinesis_firehose_destination.delivery_stream_arn #=> String # resp.event_destination.sns_destination.topic_arn #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DeleteEventDestination AWS API Documentation # # @overload delete_event_destination(params = {}) # @param [Hash] params ({}) def delete_event_destination(params = {}, options = {}) req = build_request(:delete_event_destination, params) req.send_request(options) end # Deletes an existing keyword from an origination phone number or pool. # # A keyword is a word that you can search for on a particular phone # number or pool. It is also a specific word or phrase that an end user # can send to your number to elicit a response, such as an informational # message or a special offer. When your number receives a message that # begins with a keyword, Amazon Pinpoint responds with a customizable # message. # # Keywords "HELP" and "STOP" can't be deleted or modified. # # @option params [required, String] :origination_identity # The origination identity to use such as a PhoneNumberId, # PhoneNumberArn, PoolId or PoolArn. You can use DescribePhoneNumbers to # find the values for PhoneNumberId and PhoneNumberArn and DescribePools # to find the values of PoolId and PoolArn. # # @option params [required, String] :keyword # The keyword to delete. # # @return [Types::DeleteKeywordResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeleteKeywordResult#origination_identity_arn #origination_identity_arn} => String # * {Types::DeleteKeywordResult#origination_identity #origination_identity} => String # * {Types::DeleteKeywordResult#keyword #keyword} => String # * {Types::DeleteKeywordResult#keyword_message #keyword_message} => String # * {Types::DeleteKeywordResult#keyword_action #keyword_action} => String # # @example Request syntax with placeholder values # # resp = client.delete_keyword({ # origination_identity: "PhoneOrPoolIdOrArn", # required # keyword: "Keyword", # required # }) # # @example Response structure # # resp.origination_identity_arn #=> String # resp.origination_identity #=> String # resp.keyword #=> String # resp.keyword_message #=> String # resp.keyword_action #=> String, one of "AUTOMATIC_RESPONSE", "OPT_OUT", "OPT_IN" # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DeleteKeyword AWS API Documentation # # @overload delete_keyword(params = {}) # @param [Hash] params ({}) def delete_keyword(params = {}, options = {}) req = build_request(:delete_keyword, params) req.send_request(options) end # Deletes an existing opt-out list. All opted out phone numbers in the # opt-out list are deleted. # # If the specified opt-out list name doesn't exist or is in-use by an # origination phone number or pool, an Error is returned. # # @option params [required, String] :opt_out_list_name # The OptOutListName or OptOutListArn of the OptOutList to delete. You # can use DescribeOptOutLists to find the values for OptOutListName and # OptOutListArn. # # @return [Types::DeleteOptOutListResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeleteOptOutListResult#opt_out_list_arn #opt_out_list_arn} => String # * {Types::DeleteOptOutListResult#opt_out_list_name #opt_out_list_name} => String # * {Types::DeleteOptOutListResult#created_timestamp #created_timestamp} => Time # # @example Request syntax with placeholder values # # resp = client.delete_opt_out_list({ # opt_out_list_name: "OptOutListNameOrArn", # required # }) # # @example Response structure # # resp.opt_out_list_arn #=> String # resp.opt_out_list_name #=> String # resp.created_timestamp #=> Time # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DeleteOptOutList AWS API Documentation # # @overload delete_opt_out_list(params = {}) # @param [Hash] params ({}) def delete_opt_out_list(params = {}, options = {}) req = build_request(:delete_opt_out_list, params) req.send_request(options) end # Deletes an existing opted out destination phone number from the # specified opt-out list. # # Each destination phone number can only be deleted once every 30 days. # # If the specified destination phone number doesn't exist or if the # opt-out list doesn't exist, an Error is returned. # # @option params [required, String] :opt_out_list_name # The OptOutListName or OptOutListArn to remove the phone number from. # # @option params [required, String] :opted_out_number # The phone number, in E.164 format, to remove from the OptOutList. # # @return [Types::DeleteOptedOutNumberResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeleteOptedOutNumberResult#opt_out_list_arn #opt_out_list_arn} => String # * {Types::DeleteOptedOutNumberResult#opt_out_list_name #opt_out_list_name} => String # * {Types::DeleteOptedOutNumberResult#opted_out_number #opted_out_number} => String # * {Types::DeleteOptedOutNumberResult#opted_out_timestamp #opted_out_timestamp} => Time # * {Types::DeleteOptedOutNumberResult#end_user_opted_out #end_user_opted_out} => Boolean # # @example Request syntax with placeholder values # # resp = client.delete_opted_out_number({ # opt_out_list_name: "OptOutListNameOrArn", # required # opted_out_number: "PhoneNumber", # required # }) # # @example Response structure # # resp.opt_out_list_arn #=> String # resp.opt_out_list_name #=> String # resp.opted_out_number #=> String # resp.opted_out_timestamp #=> Time # resp.end_user_opted_out #=> Boolean # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DeleteOptedOutNumber AWS API Documentation # # @overload delete_opted_out_number(params = {}) # @param [Hash] params ({}) def delete_opted_out_number(params = {}, options = {}) req = build_request(:delete_opted_out_number, params) req.send_request(options) end # Deletes an existing pool. Deleting a pool disassociates all # origination identities from that pool. # # If the pool status isn't active or if deletion protection is enabled, # an Error is returned. # # A pool is a collection of phone numbers and SenderIds. A pool can # include one or more phone numbers and SenderIds that are associated # with your Amazon Web Services account. # # @option params [required, String] :pool_id # The PoolId or PoolArn of the pool to delete. You can use DescribePools # to find the values for PoolId and PoolArn . # # @return [Types::DeletePoolResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeletePoolResult#pool_arn #pool_arn} => String # * {Types::DeletePoolResult#pool_id #pool_id} => String # * {Types::DeletePoolResult#status #status} => String # * {Types::DeletePoolResult#message_type #message_type} => String # * {Types::DeletePoolResult#two_way_enabled #two_way_enabled} => Boolean # * {Types::DeletePoolResult#two_way_channel_arn #two_way_channel_arn} => String # * {Types::DeletePoolResult#self_managed_opt_outs_enabled #self_managed_opt_outs_enabled} => Boolean # * {Types::DeletePoolResult#opt_out_list_name #opt_out_list_name} => String # * {Types::DeletePoolResult#shared_routes_enabled #shared_routes_enabled} => Boolean # * {Types::DeletePoolResult#created_timestamp #created_timestamp} => Time # # @example Request syntax with placeholder values # # resp = client.delete_pool({ # pool_id: "PoolIdOrArn", # required # }) # # @example Response structure # # resp.pool_arn #=> String # resp.pool_id #=> String # resp.status #=> String, one of "CREATING", "ACTIVE", "DELETING" # resp.message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.two_way_enabled #=> Boolean # resp.two_way_channel_arn #=> String # resp.self_managed_opt_outs_enabled #=> Boolean # resp.opt_out_list_name #=> String # resp.shared_routes_enabled #=> Boolean # resp.created_timestamp #=> Time # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DeletePool AWS API Documentation # # @overload delete_pool(params = {}) # @param [Hash] params ({}) def delete_pool(params = {}, options = {}) req = build_request(:delete_pool, params) req.send_request(options) end # Deletes an account-level monthly spending limit override for sending # text messages. Deleting a spend limit override will set the # `EnforcedLimit` to equal the `MaxLimit`, which is controlled by Amazon # Web Services. For more information on spend limits (quotas) see # [Amazon Pinpoint quotas ][1] in the *Amazon Pinpoint Developer Guide*. # # # # [1]: https://docs.aws.amazon.com/pinpoint/latest/developerguide/quotas.html # # @return [Types::DeleteTextMessageSpendLimitOverrideResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeleteTextMessageSpendLimitOverrideResult#monthly_limit #monthly_limit} => Integer # # @example Response structure # # resp.monthly_limit #=> Integer # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DeleteTextMessageSpendLimitOverride AWS API Documentation # # @overload delete_text_message_spend_limit_override(params = {}) # @param [Hash] params ({}) def delete_text_message_spend_limit_override(params = {}, options = {}) req = build_request(:delete_text_message_spend_limit_override, params) req.send_request(options) end # Deletes an account level monthly spend limit override for sending # voice messages. Deleting a spend limit override sets the # `EnforcedLimit` equal to the `MaxLimit`, which is controlled by Amazon # Web Services. For more information on spending limits (quotas) see # [Amazon Pinpoint quotas][1] in the *Amazon Pinpoint Developer Guide*. # # # # [1]: https://docs.aws.amazon.com/pinpoint/latest/developerguide/quotas.html # # @return [Types::DeleteVoiceMessageSpendLimitOverrideResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DeleteVoiceMessageSpendLimitOverrideResult#monthly_limit #monthly_limit} => Integer # # @example Response structure # # resp.monthly_limit #=> Integer # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DeleteVoiceMessageSpendLimitOverride AWS API Documentation # # @overload delete_voice_message_spend_limit_override(params = {}) # @param [Hash] params ({}) def delete_voice_message_spend_limit_override(params = {}, options = {}) req = build_request(:delete_voice_message_spend_limit_override, params) req.send_request(options) end # Describes attributes of your Amazon Web Services account. The # supported account attributes include account tier, which indicates # whether your account is in the sandbox or production environment. When # you're ready to move your account out of the sandbox, create an # Amazon Web Services Support case for a service limit increase request. # # New Amazon Pinpoint accounts are placed into an SMS or voice sandbox. # The sandbox protects both Amazon Web Services end recipients and SMS # or voice recipients from fraud and abuse. # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::DescribeAccountAttributesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DescribeAccountAttributesResult#account_attributes #account_attributes} => Array<Types::AccountAttribute> # * {Types::DescribeAccountAttributesResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.describe_account_attributes({ # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.account_attributes #=> Array # resp.account_attributes[0].name #=> String, one of "ACCOUNT_TIER" # resp.account_attributes[0].value #=> String # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribeAccountAttributes AWS API Documentation # # @overload describe_account_attributes(params = {}) # @param [Hash] params ({}) def describe_account_attributes(params = {}, options = {}) req = build_request(:describe_account_attributes, params) req.send_request(options) end # Describes the current Amazon Pinpoint SMS Voice V2 resource quotas for # your account. The description for a quota includes the quota name, # current usage toward that quota, and the quota's maximum value. # # When you establish an Amazon Web Services account, the account has # initial quotas on the maximum number of configuration sets, opt-out # lists, phone numbers, and pools that you can create in a given Region. # For more information see [ Amazon Pinpoint quotas ][1] in the *Amazon # Pinpoint Developer Guide*. # # # # [1]: https://docs.aws.amazon.com/pinpoint/latest/developerguide/quotas.html # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::DescribeAccountLimitsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DescribeAccountLimitsResult#account_limits #account_limits} => Array<Types::AccountLimit> # * {Types::DescribeAccountLimitsResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.describe_account_limits({ # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.account_limits #=> Array # resp.account_limits[0].name #=> String, one of "PHONE_NUMBERS", "POOLS", "CONFIGURATION_SETS", "OPT_OUT_LISTS" # resp.account_limits[0].used #=> Integer # resp.account_limits[0].max #=> Integer # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribeAccountLimits AWS API Documentation # # @overload describe_account_limits(params = {}) # @param [Hash] params ({}) def describe_account_limits(params = {}, options = {}) req = build_request(:describe_account_limits, params) req.send_request(options) end # Describes the specified configuration sets or all in your account. # # If you specify configuration set names, the output includes # information for only the specified configuration sets. If you specify # filters, the output includes information for only those configuration # sets that meet the filter criteria. If you don't specify # configuration set names or filters, the output includes information # for all configuration sets. # # If you specify a configuration set name that isn't valid, an error is # returned. # # @option params [Array] :configuration_set_names # An array of strings. Each element can be either a ConfigurationSetName # or ConfigurationSetArn. # # @option params [Array] :filters # An array of filters to apply to the results that are returned. # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::DescribeConfigurationSetsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DescribeConfigurationSetsResult#configuration_sets #configuration_sets} => Array<Types::ConfigurationSetInformation> # * {Types::DescribeConfigurationSetsResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.describe_configuration_sets({ # configuration_set_names: ["ConfigurationSetNameOrArn"], # filters: [ # { # name: "event-destination-name", # required, accepts event-destination-name, matching-event-types, default-message-type, default-sender-id # values: ["FilterValue"], # required # }, # ], # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.configuration_sets #=> Array # resp.configuration_sets[0].configuration_set_arn #=> String # resp.configuration_sets[0].configuration_set_name #=> String # resp.configuration_sets[0].event_destinations #=> Array # resp.configuration_sets[0].event_destinations[0].event_destination_name #=> String # resp.configuration_sets[0].event_destinations[0].enabled #=> Boolean # resp.configuration_sets[0].event_destinations[0].matching_event_types #=> Array # resp.configuration_sets[0].event_destinations[0].matching_event_types[0] #=> String, one of "ALL", "TEXT_ALL", "TEXT_SENT", "TEXT_PENDING", "TEXT_QUEUED", "TEXT_SUCCESSFUL", "TEXT_DELIVERED", "TEXT_INVALID", "TEXT_INVALID_MESSAGE", "TEXT_UNREACHABLE", "TEXT_CARRIER_UNREACHABLE", "TEXT_BLOCKED", "TEXT_CARRIER_BLOCKED", "TEXT_SPAM", "TEXT_UNKNOWN", "TEXT_TTL_EXPIRED", "VOICE_ALL", "VOICE_INITIATED", "VOICE_RINGING", "VOICE_ANSWERED", "VOICE_COMPLETED", "VOICE_BUSY", "VOICE_NO_ANSWER", "VOICE_FAILED", "VOICE_TTL_EXPIRED" # resp.configuration_sets[0].event_destinations[0].cloud_watch_logs_destination.iam_role_arn #=> String # resp.configuration_sets[0].event_destinations[0].cloud_watch_logs_destination.log_group_arn #=> String # resp.configuration_sets[0].event_destinations[0].kinesis_firehose_destination.iam_role_arn #=> String # resp.configuration_sets[0].event_destinations[0].kinesis_firehose_destination.delivery_stream_arn #=> String # resp.configuration_sets[0].event_destinations[0].sns_destination.topic_arn #=> String # resp.configuration_sets[0].default_message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.configuration_sets[0].default_sender_id #=> String # resp.configuration_sets[0].created_timestamp #=> Time # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribeConfigurationSets AWS API Documentation # # @overload describe_configuration_sets(params = {}) # @param [Hash] params ({}) def describe_configuration_sets(params = {}, options = {}) req = build_request(:describe_configuration_sets, params) req.send_request(options) end # Describes the specified keywords or all keywords on your origination # phone number or pool. # # A keyword is a word that you can search for on a particular phone # number or pool. It is also a specific word or phrase that an end user # can send to your number to elicit a response, such as an informational # message or a special offer. When your number receives a message that # begins with a keyword, Amazon Pinpoint responds with a customizable # message. # # If you specify a keyword that isn't valid, an Error is returned. # # @option params [required, String] :origination_identity # The origination identity to use such as a PhoneNumberId, # PhoneNumberArn, SenderId or SenderIdArn. You can use # DescribePhoneNumbers to find the values for PhoneNumberId and # PhoneNumberArn while DescribeSenderIds can be used to get the values # for SenderId and SenderIdArn. # # @option params [Array] :keywords # An array of keywords to search for. # # @option params [Array] :filters # An array of keyword filters to filter the results. # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::DescribeKeywordsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DescribeKeywordsResult#origination_identity_arn #origination_identity_arn} => String # * {Types::DescribeKeywordsResult#origination_identity #origination_identity} => String # * {Types::DescribeKeywordsResult#keywords #keywords} => Array<Types::KeywordInformation> # * {Types::DescribeKeywordsResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.describe_keywords({ # origination_identity: "PhoneOrPoolIdOrArn", # required # keywords: ["Keyword"], # filters: [ # { # name: "keyword-action", # required, accepts keyword-action # values: ["FilterValue"], # required # }, # ], # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.origination_identity_arn #=> String # resp.origination_identity #=> String # resp.keywords #=> Array # resp.keywords[0].keyword #=> String # resp.keywords[0].keyword_message #=> String # resp.keywords[0].keyword_action #=> String, one of "AUTOMATIC_RESPONSE", "OPT_OUT", "OPT_IN" # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribeKeywords AWS API Documentation # # @overload describe_keywords(params = {}) # @param [Hash] params ({}) def describe_keywords(params = {}, options = {}) req = build_request(:describe_keywords, params) req.send_request(options) end # Describes the specified opt-out list or all opt-out lists in your # account. # # If you specify opt-out list names, the output includes information for # only the specified opt-out lists. Opt-out lists include only those # that meet the filter criteria. If you don't specify opt-out list # names or filters, the output includes information for all opt-out # lists. # # If you specify an opt-out list name that isn't valid, an Error is # returned. # # @option params [Array] :opt_out_list_names # The OptOutLists to show the details of. This is an array of strings # that can be either the OptOutListName or OptOutListArn. # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::DescribeOptOutListsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DescribeOptOutListsResult#opt_out_lists #opt_out_lists} => Array<Types::OptOutListInformation> # * {Types::DescribeOptOutListsResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.describe_opt_out_lists({ # opt_out_list_names: ["OptOutListNameOrArn"], # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.opt_out_lists #=> Array # resp.opt_out_lists[0].opt_out_list_arn #=> String # resp.opt_out_lists[0].opt_out_list_name #=> String # resp.opt_out_lists[0].created_timestamp #=> Time # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribeOptOutLists AWS API Documentation # # @overload describe_opt_out_lists(params = {}) # @param [Hash] params ({}) def describe_opt_out_lists(params = {}, options = {}) req = build_request(:describe_opt_out_lists, params) req.send_request(options) end # Describes the specified opted out destination numbers or all opted out # destination numbers in an opt-out list. # # If you specify opted out numbers, the output includes information for # only the specified opted out numbers. If you specify filters, the # output includes information for only those opted out numbers that meet # the filter criteria. If you don't specify opted out numbers or # filters, the output includes information for all opted out destination # numbers in your opt-out list. # # If you specify an opted out number that isn't valid, an Error is # returned. # # @option params [required, String] :opt_out_list_name # The OptOutListName or OptOutListArn of the OptOutList. You can use # DescribeOptOutLists to find the values for OptOutListName and # OptOutListArn. # # @option params [Array] :opted_out_numbers # An array of phone numbers to search for in the OptOutList. # # @option params [Array] :filters # An array of OptedOutFilter objects to filter the results on. # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::DescribeOptedOutNumbersResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DescribeOptedOutNumbersResult#opt_out_list_arn #opt_out_list_arn} => String # * {Types::DescribeOptedOutNumbersResult#opt_out_list_name #opt_out_list_name} => String # * {Types::DescribeOptedOutNumbersResult#opted_out_numbers #opted_out_numbers} => Array<Types::OptedOutNumberInformation> # * {Types::DescribeOptedOutNumbersResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.describe_opted_out_numbers({ # opt_out_list_name: "OptOutListNameOrArn", # required # opted_out_numbers: ["PhoneNumber"], # filters: [ # { # name: "end-user-opted-out", # required, accepts end-user-opted-out # values: ["FilterValue"], # required # }, # ], # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.opt_out_list_arn #=> String # resp.opt_out_list_name #=> String # resp.opted_out_numbers #=> Array # resp.opted_out_numbers[0].opted_out_number #=> String # resp.opted_out_numbers[0].opted_out_timestamp #=> Time # resp.opted_out_numbers[0].end_user_opted_out #=> Boolean # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribeOptedOutNumbers AWS API Documentation # # @overload describe_opted_out_numbers(params = {}) # @param [Hash] params ({}) def describe_opted_out_numbers(params = {}, options = {}) req = build_request(:describe_opted_out_numbers, params) req.send_request(options) end # Describes the specified origination phone number, or all the phone # numbers in your account. # # If you specify phone number IDs, the output includes information for # only the specified phone numbers. If you specify filters, the output # includes information for only those phone numbers that meet the filter # criteria. If you don't specify phone number IDs or filters, the # output includes information for all phone numbers. # # If you specify a phone number ID that isn't valid, an Error is # returned. # # @option params [Array] :phone_number_ids # The unique identifier of phone numbers to find information about. This # is an array of strings that can be either the PhoneNumberId or # PhoneNumberArn. # # @option params [Array] :filters # An array of PhoneNumberFilter objects to filter the results. # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::DescribePhoneNumbersResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DescribePhoneNumbersResult#phone_numbers #phone_numbers} => Array<Types::PhoneNumberInformation> # * {Types::DescribePhoneNumbersResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.describe_phone_numbers({ # phone_number_ids: ["PhoneNumberIdOrArn"], # filters: [ # { # name: "status", # required, accepts status, iso-country-code, message-type, number-capability, number-type, two-way-enabled, self-managed-opt-outs-enabled, opt-out-list-name, deletion-protection-enabled # values: ["FilterValue"], # required # }, # ], # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.phone_numbers #=> Array # resp.phone_numbers[0].phone_number_arn #=> String # resp.phone_numbers[0].phone_number_id #=> String # resp.phone_numbers[0].phone_number #=> String # resp.phone_numbers[0].status #=> String, one of "PENDING", "ACTIVE", "ASSOCIATING", "DISASSOCIATING", "DELETED" # resp.phone_numbers[0].iso_country_code #=> String # resp.phone_numbers[0].message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.phone_numbers[0].number_capabilities #=> Array # resp.phone_numbers[0].number_capabilities[0] #=> String, one of "SMS", "VOICE" # resp.phone_numbers[0].number_type #=> String, one of "SHORT_CODE", "LONG_CODE", "TOLL_FREE", "TEN_DLC" # resp.phone_numbers[0].monthly_leasing_price #=> String # resp.phone_numbers[0].two_way_enabled #=> Boolean # resp.phone_numbers[0].two_way_channel_arn #=> String # resp.phone_numbers[0].self_managed_opt_outs_enabled #=> Boolean # resp.phone_numbers[0].opt_out_list_name #=> String # resp.phone_numbers[0].deletion_protection_enabled #=> Boolean # resp.phone_numbers[0].pool_id #=> String # resp.phone_numbers[0].created_timestamp #=> Time # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribePhoneNumbers AWS API Documentation # # @overload describe_phone_numbers(params = {}) # @param [Hash] params ({}) def describe_phone_numbers(params = {}, options = {}) req = build_request(:describe_phone_numbers, params) req.send_request(options) end # Retrieves the specified pools or all pools associated with your Amazon # Web Services account. # # If you specify pool IDs, the output includes information for only the # specified pools. If you specify filters, the output includes # information for only those pools that meet the filter criteria. If you # don't specify pool IDs or filters, the output includes information # for all pools. # # If you specify a pool ID that isn't valid, an Error is returned. # # A pool is a collection of phone numbers and SenderIds. A pool can # include one or more phone numbers and SenderIds that are associated # with your Amazon Web Services account. # # @option params [Array] :pool_ids # The unique identifier of pools to find. This is an array of strings # that can be either the PoolId or PoolArn. # # @option params [Array] :filters # An array of PoolFilter objects to filter the results. # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::DescribePoolsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DescribePoolsResult#pools #pools} => Array<Types::PoolInformation> # * {Types::DescribePoolsResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.describe_pools({ # pool_ids: ["PoolIdOrArn"], # filters: [ # { # name: "status", # required, accepts status, message-type, two-way-enabled, self-managed-opt-outs-enabled, opt-out-list-name, shared-routes-enabled, deletion-protection-enabled # values: ["FilterValue"], # required # }, # ], # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.pools #=> Array # resp.pools[0].pool_arn #=> String # resp.pools[0].pool_id #=> String # resp.pools[0].status #=> String, one of "CREATING", "ACTIVE", "DELETING" # resp.pools[0].message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.pools[0].two_way_enabled #=> Boolean # resp.pools[0].two_way_channel_arn #=> String # resp.pools[0].self_managed_opt_outs_enabled #=> Boolean # resp.pools[0].opt_out_list_name #=> String # resp.pools[0].shared_routes_enabled #=> Boolean # resp.pools[0].deletion_protection_enabled #=> Boolean # resp.pools[0].created_timestamp #=> Time # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribePools AWS API Documentation # # @overload describe_pools(params = {}) # @param [Hash] params ({}) def describe_pools(params = {}, options = {}) req = build_request(:describe_pools, params) req.send_request(options) end # Describes the specified SenderIds or all SenderIds associated with # your Amazon Web Services account. # # If you specify SenderIds, the output includes information for only the # specified SenderIds. If you specify filters, the output includes # information for only those SenderIds that meet the filter criteria. If # you don't specify SenderIds or filters, the output includes # information for all SenderIds. # # f you specify a sender ID that isn't valid, an Error is returned. # # @option params [Array] :sender_ids # An array of SenderIdAndCountry objects to search for. # # @option params [Array] :filters # An array of SenderIdFilter objects to filter the results. # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::DescribeSenderIdsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DescribeSenderIdsResult#sender_ids #sender_ids} => Array<Types::SenderIdInformation> # * {Types::DescribeSenderIdsResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.describe_sender_ids({ # sender_ids: [ # { # sender_id: "SenderIdOrArn", # required # iso_country_code: "IsoCountryCode", # required # }, # ], # filters: [ # { # name: "sender-id", # required, accepts sender-id, iso-country-code, message-type # values: ["FilterValue"], # required # }, # ], # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.sender_ids #=> Array # resp.sender_ids[0].sender_id_arn #=> String # resp.sender_ids[0].sender_id #=> String # resp.sender_ids[0].iso_country_code #=> String # resp.sender_ids[0].message_types #=> Array # resp.sender_ids[0].message_types[0] #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.sender_ids[0].monthly_leasing_price #=> String # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribeSenderIds AWS API Documentation # # @overload describe_sender_ids(params = {}) # @param [Hash] params ({}) def describe_sender_ids(params = {}, options = {}) req = build_request(:describe_sender_ids, params) req.send_request(options) end # Describes the current Amazon Pinpoint monthly spend limits for sending # voice and text messages. # # When you establish an Amazon Web Services account, the account has # initial monthly spend limit in a given Region. For more information on # increasing your monthly spend limit, see [ Requesting increases to # your monthly SMS spending quota for Amazon Pinpoint ][1] in the # *Amazon Pinpoint User Guide*. # # # # [1]: https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-awssupport-spend-threshold.html # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::DescribeSpendLimitsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DescribeSpendLimitsResult#spend_limits #spend_limits} => Array<Types::SpendLimit> # * {Types::DescribeSpendLimitsResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.describe_spend_limits({ # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.spend_limits #=> Array # resp.spend_limits[0].name #=> String, one of "TEXT_MESSAGE_MONTHLY_SPEND_LIMIT", "VOICE_MESSAGE_MONTHLY_SPEND_LIMIT" # resp.spend_limits[0].enforced_limit #=> Integer # resp.spend_limits[0].max_limit #=> Integer # resp.spend_limits[0].overridden #=> Boolean # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DescribeSpendLimits AWS API Documentation # # @overload describe_spend_limits(params = {}) # @param [Hash] params ({}) def describe_spend_limits(params = {}, options = {}) req = build_request(:describe_spend_limits, params) req.send_request(options) end # Removes the specified origination identity from an existing pool. # # If the origination identity isn't associated with the specified pool, # an Error is returned. # # @option params [required, String] :pool_id # The unique identifier for the pool to disassociate with the # origination identity. This value can be either the PoolId or PoolArn. # # @option params [required, String] :origination_identity # The origination identity to use such as a PhoneNumberId, # PhoneNumberArn, SenderId or SenderIdArn. You can use # DescribePhoneNumbers find the values for PhoneNumberId and # PhoneNumberArn, or use DescribeSenderIds to get the values for # SenderId and SenderIdArn. # # @option params [required, String] :iso_country_code # The two-character code, in ISO 3166-1 alpha-2 format, for the country # or region. # # @option params [String] :client_token # Unique, case-sensitive identifier you provide to ensure the # idempotency of the request. If you don't specify a client token, a # randomly generated token is used for the request to ensure # idempotency. # # **A suitable default value is auto-generated.** You should normally # not need to pass this option.** # # @return [Types::DisassociateOriginationIdentityResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::DisassociateOriginationIdentityResult#pool_arn #pool_arn} => String # * {Types::DisassociateOriginationIdentityResult#pool_id #pool_id} => String # * {Types::DisassociateOriginationIdentityResult#origination_identity_arn #origination_identity_arn} => String # * {Types::DisassociateOriginationIdentityResult#origination_identity #origination_identity} => String # * {Types::DisassociateOriginationIdentityResult#iso_country_code #iso_country_code} => String # # @example Request syntax with placeholder values # # resp = client.disassociate_origination_identity({ # pool_id: "PoolIdOrArn", # required # origination_identity: "PhoneOrSenderIdOrArn", # required # iso_country_code: "IsoCountryCode", # required # client_token: "ClientToken", # }) # # @example Response structure # # resp.pool_arn #=> String # resp.pool_id #=> String # resp.origination_identity_arn #=> String # resp.origination_identity #=> String # resp.iso_country_code #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/DisassociateOriginationIdentity AWS API Documentation # # @overload disassociate_origination_identity(params = {}) # @param [Hash] params ({}) def disassociate_origination_identity(params = {}, options = {}) req = build_request(:disassociate_origination_identity, params) req.send_request(options) end # Lists all associated origination identities in your pool. # # If you specify filters, the output includes information for only those # origination identities that meet the filter criteria. # # @option params [required, String] :pool_id # The unique identifier for the pool. This value can be either the # PoolId or PoolArn. # # @option params [Array] :filters # An array of PoolOriginationIdentitiesFilter objects to filter the # results.. # # @option params [String] :next_token # The token to be used for the next set of paginated results. You don't # need to supply a value for this field in the initial request. # # @option params [Integer] :max_results # The maximum number of results to return per each request. # # @return [Types::ListPoolOriginationIdentitiesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::ListPoolOriginationIdentitiesResult#pool_arn #pool_arn} => String # * {Types::ListPoolOriginationIdentitiesResult#pool_id #pool_id} => String # * {Types::ListPoolOriginationIdentitiesResult#origination_identities #origination_identities} => Array<Types::OriginationIdentityMetadata> # * {Types::ListPoolOriginationIdentitiesResult#next_token #next_token} => String # # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. # # @example Request syntax with placeholder values # # resp = client.list_pool_origination_identities({ # pool_id: "PoolIdOrArn", # required # filters: [ # { # name: "iso-country-code", # required, accepts iso-country-code, number-capability # values: ["FilterValue"], # required # }, # ], # next_token: "NextToken", # max_results: 1, # }) # # @example Response structure # # resp.pool_arn #=> String # resp.pool_id #=> String # resp.origination_identities #=> Array # resp.origination_identities[0].origination_identity_arn #=> String # resp.origination_identities[0].origination_identity #=> String # resp.origination_identities[0].iso_country_code #=> String # resp.origination_identities[0].number_capabilities #=> Array # resp.origination_identities[0].number_capabilities[0] #=> String, one of "SMS", "VOICE" # resp.next_token #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/ListPoolOriginationIdentities AWS API Documentation # # @overload list_pool_origination_identities(params = {}) # @param [Hash] params ({}) def list_pool_origination_identities(params = {}, options = {}) req = build_request(:list_pool_origination_identities, params) req.send_request(options) end # List all tags associated with a resource. # # @option params [required, String] :resource_arn # The Amazon Resource Name (ARN) of the resource to query for. # # @return [Types::ListTagsForResourceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::ListTagsForResourceResult#resource_arn #resource_arn} => String # * {Types::ListTagsForResourceResult#tags #tags} => Array<Types::Tag> # # @example Request syntax with placeholder values # # resp = client.list_tags_for_resource({ # resource_arn: "AmazonResourceName", # required # }) # # @example Response structure # # resp.resource_arn #=> String # resp.tags #=> Array # resp.tags[0].key #=> String # resp.tags[0].value #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/ListTagsForResource AWS API Documentation # # @overload list_tags_for_resource(params = {}) # @param [Hash] params ({}) def list_tags_for_resource(params = {}, options = {}) req = build_request(:list_tags_for_resource, params) req.send_request(options) end # Creates or updates a keyword configuration on an origination phone # number or pool. # # A keyword is a word that you can search for on a particular phone # number or pool. It is also a specific word or phrase that an end user # can send to your number to elicit a response, such as an informational # message or a special offer. When your number receives a message that # begins with a keyword, Amazon Pinpoint responds with a customizable # message. # # If you specify a keyword that isn't valid, an Error is returned. # # @option params [required, String] :origination_identity # The origination identity to use such as a PhoneNumberId, # PhoneNumberArn, SenderId or SenderIdArn. You can use # DescribePhoneNumbers get the values for PhoneNumberId and # PhoneNumberArn while DescribeSenderIds can be used to get the values # for SenderId and SenderIdArn. # # @option params [required, String] :keyword # The new keyword to add. # # @option params [required, String] :keyword_message # The message associated with the keyword. # # * AUTOMATIC\_RESPONSE: A message is sent to the recipient. # # * OPT\_OUT: Keeps the recipient from receiving future messages. # # * OPT\_IN: The recipient wants to receive future messages. # # @option params [String] :keyword_action # The action to perform for the new keyword when it is received. # # @return [Types::PutKeywordResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::PutKeywordResult#origination_identity_arn #origination_identity_arn} => String # * {Types::PutKeywordResult#origination_identity #origination_identity} => String # * {Types::PutKeywordResult#keyword #keyword} => String # * {Types::PutKeywordResult#keyword_message #keyword_message} => String # * {Types::PutKeywordResult#keyword_action #keyword_action} => String # # @example Request syntax with placeholder values # # resp = client.put_keyword({ # origination_identity: "PhoneOrPoolIdOrArn", # required # keyword: "Keyword", # required # keyword_message: "KeywordMessage", # required # keyword_action: "AUTOMATIC_RESPONSE", # accepts AUTOMATIC_RESPONSE, OPT_OUT, OPT_IN # }) # # @example Response structure # # resp.origination_identity_arn #=> String # resp.origination_identity #=> String # resp.keyword #=> String # resp.keyword_message #=> String # resp.keyword_action #=> String, one of "AUTOMATIC_RESPONSE", "OPT_OUT", "OPT_IN" # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/PutKeyword AWS API Documentation # # @overload put_keyword(params = {}) # @param [Hash] params ({}) def put_keyword(params = {}, options = {}) req = build_request(:put_keyword, params) req.send_request(options) end # Creates an opted out destination phone number in the opt-out list. # # If the destination phone number isn't valid or if the specified # opt-out list doesn't exist, an Error is returned. # # @option params [required, String] :opt_out_list_name # The OptOutListName or OptOutListArn to add the phone number to. # # @option params [required, String] :opted_out_number # The phone number to add to the OptOutList in E.164 format. # # @return [Types::PutOptedOutNumberResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::PutOptedOutNumberResult#opt_out_list_arn #opt_out_list_arn} => String # * {Types::PutOptedOutNumberResult#opt_out_list_name #opt_out_list_name} => String # * {Types::PutOptedOutNumberResult#opted_out_number #opted_out_number} => String # * {Types::PutOptedOutNumberResult#opted_out_timestamp #opted_out_timestamp} => Time # * {Types::PutOptedOutNumberResult#end_user_opted_out #end_user_opted_out} => Boolean # # @example Request syntax with placeholder values # # resp = client.put_opted_out_number({ # opt_out_list_name: "OptOutListNameOrArn", # required # opted_out_number: "PhoneNumber", # required # }) # # @example Response structure # # resp.opt_out_list_arn #=> String # resp.opt_out_list_name #=> String # resp.opted_out_number #=> String # resp.opted_out_timestamp #=> Time # resp.end_user_opted_out #=> Boolean # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/PutOptedOutNumber AWS API Documentation # # @overload put_opted_out_number(params = {}) # @param [Hash] params ({}) def put_opted_out_number(params = {}, options = {}) req = build_request(:put_opted_out_number, params) req.send_request(options) end # Releases an existing origination phone number in your account. Once # released, a phone number is no longer available for sending messages. # # If the origination phone number has deletion protection enabled or is # associated with a pool, an Error is returned. # # @option params [required, String] :phone_number_id # The PhoneNumberId or PhoneNumberArn of the phone number to release. # You can use DescribePhoneNumbers to get the values for PhoneNumberId # and PhoneNumberArn. # # @return [Types::ReleasePhoneNumberResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::ReleasePhoneNumberResult#phone_number_arn #phone_number_arn} => String # * {Types::ReleasePhoneNumberResult#phone_number_id #phone_number_id} => String # * {Types::ReleasePhoneNumberResult#phone_number #phone_number} => String # * {Types::ReleasePhoneNumberResult#status #status} => String # * {Types::ReleasePhoneNumberResult#iso_country_code #iso_country_code} => String # * {Types::ReleasePhoneNumberResult#message_type #message_type} => String # * {Types::ReleasePhoneNumberResult#number_capabilities #number_capabilities} => Array<String> # * {Types::ReleasePhoneNumberResult#number_type #number_type} => String # * {Types::ReleasePhoneNumberResult#monthly_leasing_price #monthly_leasing_price} => String # * {Types::ReleasePhoneNumberResult#two_way_enabled #two_way_enabled} => Boolean # * {Types::ReleasePhoneNumberResult#two_way_channel_arn #two_way_channel_arn} => String # * {Types::ReleasePhoneNumberResult#self_managed_opt_outs_enabled #self_managed_opt_outs_enabled} => Boolean # * {Types::ReleasePhoneNumberResult#opt_out_list_name #opt_out_list_name} => String # * {Types::ReleasePhoneNumberResult#created_timestamp #created_timestamp} => Time # # @example Request syntax with placeholder values # # resp = client.release_phone_number({ # phone_number_id: "PhoneNumberIdOrArn", # required # }) # # @example Response structure # # resp.phone_number_arn #=> String # resp.phone_number_id #=> String # resp.phone_number #=> String # resp.status #=> String, one of "PENDING", "ACTIVE", "ASSOCIATING", "DISASSOCIATING", "DELETED" # resp.iso_country_code #=> String # resp.message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.number_capabilities #=> Array # resp.number_capabilities[0] #=> String, one of "SMS", "VOICE" # resp.number_type #=> String, one of "SHORT_CODE", "LONG_CODE", "TOLL_FREE", "TEN_DLC" # resp.monthly_leasing_price #=> String # resp.two_way_enabled #=> Boolean # resp.two_way_channel_arn #=> String # resp.self_managed_opt_outs_enabled #=> Boolean # resp.opt_out_list_name #=> String # resp.created_timestamp #=> Time # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/ReleasePhoneNumber AWS API Documentation # # @overload release_phone_number(params = {}) # @param [Hash] params ({}) def release_phone_number(params = {}, options = {}) req = build_request(:release_phone_number, params) req.send_request(options) end # Request an origination phone number for use in your account. For more # information on phone number request see [ Requesting a number ][1] in # the *Amazon Pinpoint User Guide*. # # # # [1]: https://docs.aws.amazon.com/pinpoint/latest/userguide/settings-sms-request-number.html # # @option params [required, String] :iso_country_code # The two-character code, in ISO 3166-1 alpha-2 format, for the country # or region. # # @option params [required, String] :message_type # The type of message. Valid values are TRANSACTIONAL for messages that # are critical or time-sensitive and PROMOTIONAL for messages that # aren't critical or time-sensitive. # # @option params [required, Array] :number_capabilities # Indicates if the phone number will be used for text messages, voice # messages, or both. # # @option params [required, String] :number_type # The type of phone number to request. # # @option params [String] :opt_out_list_name # The name of the OptOutList to associate with the phone number. You can # use the OutOutListName or OptPutListArn. # # @option params [String] :pool_id # The pool to associated with the phone number. You can use the PoolId # or PoolArn. # # @option params [String] :registration_id # Use this field to attach your phone number for an external # registration process. # # @option params [Boolean] :deletion_protection_enabled # By default this is set to false. When set to true the phone number # can't be deleted. # # @option params [Array] :tags # An array of tags (key and value pairs) associate with the requested # phone number. # # @option params [String] :client_token # Unique, case-sensitive identifier that you provide to ensure the # idempotency of the request. If you don't specify a client token, a # randomly generated token is used for the request to ensure # idempotency. # # **A suitable default value is auto-generated.** You should normally # not need to pass this option.** # # @return [Types::RequestPhoneNumberResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::RequestPhoneNumberResult#phone_number_arn #phone_number_arn} => String # * {Types::RequestPhoneNumberResult#phone_number_id #phone_number_id} => String # * {Types::RequestPhoneNumberResult#phone_number #phone_number} => String # * {Types::RequestPhoneNumberResult#status #status} => String # * {Types::RequestPhoneNumberResult#iso_country_code #iso_country_code} => String # * {Types::RequestPhoneNumberResult#message_type #message_type} => String # * {Types::RequestPhoneNumberResult#number_capabilities #number_capabilities} => Array<String> # * {Types::RequestPhoneNumberResult#number_type #number_type} => String # * {Types::RequestPhoneNumberResult#monthly_leasing_price #monthly_leasing_price} => String # * {Types::RequestPhoneNumberResult#two_way_enabled #two_way_enabled} => Boolean # * {Types::RequestPhoneNumberResult#two_way_channel_arn #two_way_channel_arn} => String # * {Types::RequestPhoneNumberResult#self_managed_opt_outs_enabled #self_managed_opt_outs_enabled} => Boolean # * {Types::RequestPhoneNumberResult#opt_out_list_name #opt_out_list_name} => String # * {Types::RequestPhoneNumberResult#deletion_protection_enabled #deletion_protection_enabled} => Boolean # * {Types::RequestPhoneNumberResult#pool_id #pool_id} => String # * {Types::RequestPhoneNumberResult#tags #tags} => Array<Types::Tag> # * {Types::RequestPhoneNumberResult#created_timestamp #created_timestamp} => Time # # @example Request syntax with placeholder values # # resp = client.request_phone_number({ # iso_country_code: "IsoCountryCode", # required # message_type: "TRANSACTIONAL", # required, accepts TRANSACTIONAL, PROMOTIONAL # number_capabilities: ["SMS"], # required, accepts SMS, VOICE # number_type: "LONG_CODE", # required, accepts LONG_CODE, TOLL_FREE, TEN_DLC # opt_out_list_name: "OptOutListNameOrArn", # pool_id: "PoolIdOrArn", # registration_id: "RegistrationId", # deletion_protection_enabled: false, # tags: [ # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # client_token: "ClientToken", # }) # # @example Response structure # # resp.phone_number_arn #=> String # resp.phone_number_id #=> String # resp.phone_number #=> String # resp.status #=> String, one of "PENDING", "ACTIVE", "ASSOCIATING", "DISASSOCIATING", "DELETED" # resp.iso_country_code #=> String # resp.message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.number_capabilities #=> Array # resp.number_capabilities[0] #=> String, one of "SMS", "VOICE" # resp.number_type #=> String, one of "LONG_CODE", "TOLL_FREE", "TEN_DLC" # resp.monthly_leasing_price #=> String # resp.two_way_enabled #=> Boolean # resp.two_way_channel_arn #=> String # resp.self_managed_opt_outs_enabled #=> Boolean # resp.opt_out_list_name #=> String # resp.deletion_protection_enabled #=> Boolean # resp.pool_id #=> String # resp.tags #=> Array # resp.tags[0].key #=> String # resp.tags[0].value #=> String # resp.created_timestamp #=> Time # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/RequestPhoneNumber AWS API Documentation # # @overload request_phone_number(params = {}) # @param [Hash] params ({}) def request_phone_number(params = {}, options = {}) req = build_request(:request_phone_number, params) req.send_request(options) end # Creates a new text message and sends it to a recipient's phone # number. # # SMS throughput limits are measured in Message Parts per Second (MPS). # Your MPS limit depends on the destination country of your messages, as # well as the type of phone number (origination number) that you use to # send the message. For more information, see [Message Parts per Second # (MPS) limits][1] in the *Amazon Pinpoint User Guide*. # # # # [1]: https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-limitations-mps.html # # @option params [required, String] :destination_phone_number # The destination phone number in E.164 format. # # @option params [String] :origination_identity # The origination identity of the message. This can be either the # PhoneNumber, PhoneNumberId, PhoneNumberArn, SenderId, SenderIdArn, # PoolId, or PoolArn. # # @option params [String] :message_body # The body of the text message. # # @option params [String] :message_type # The type of message. Valid values are TRANSACTIONAL for messages that # are critical or time-sensitive and PROMOTIONAL for messages that # aren't critical or time-sensitive. # # @option params [String] :keyword # When you register a short code in the US, you must specify a program # name. If you don’t have a US short code, omit this attribute. # # @option params [String] :configuration_set_name # The name of the configuration set to use. This can be either the # ConfigurationSetName or ConfigurationSetArn. # # @option params [String] :max_price # The maximum amount that you want to spend, in US dollars, per each # text message part. A text message can contain multiple parts. # # @option params [Integer] :time_to_live # How long the text message is valid for. By default this is 72 hours. # # @option params [Hash] :context # You can specify custom data in this field. If you do, that data is # logged to the event destination. # # @option params [Hash] :destination_country_parameters # This field is used for any country-specific registration requirements. # Currently, this setting is only used when you send messages to # recipients in India using a sender ID. For more information see # [Special requirements for sending SMS messages to recipients in # India][1]. # # # # [1]: https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-senderid-india.html # # @option params [Boolean] :dry_run # When set to true, the message is checked and validated, but isn't # sent to the end recipient. # # @return [Types::SendTextMessageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::SendTextMessageResult#message_id #message_id} => String # # @example Request syntax with placeholder values # # resp = client.send_text_message({ # destination_phone_number: "PhoneNumber", # required # origination_identity: "TextMessageOriginationIdentity", # message_body: "TextMessageBody", # message_type: "TRANSACTIONAL", # accepts TRANSACTIONAL, PROMOTIONAL # keyword: "Keyword", # configuration_set_name: "ConfigurationSetNameOrArn", # max_price: "MaxPrice", # time_to_live: 1, # context: { # "ContextKey" => "ContextValue", # }, # destination_country_parameters: { # "IN_TEMPLATE_ID" => "DestinationCountryParameterValue", # }, # dry_run: false, # }) # # @example Response structure # # resp.message_id #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/SendTextMessage AWS API Documentation # # @overload send_text_message(params = {}) # @param [Hash] params ({}) def send_text_message(params = {}, options = {}) req = build_request(:send_text_message, params) req.send_request(options) end # Allows you to send a request that sends a text message through Amazon # Pinpoint. This operation uses [Amazon Polly][1] to convert a text # script into a voice message. # # # # [1]: http://aws.amazon.com/polly/ # # @option params [required, String] :destination_phone_number # The destination phone number in E.164 format. # # @option params [required, String] :origination_identity # The origination identity to use for the voice call. This can be the # PhoneNumber, PhoneNumberId, PhoneNumberArn, PoolId, or PoolArn. # # @option params [String] :message_body # The text to convert to a voice message. # # @option params [String] :message_body_text_type # Specifies if the MessageBody field contains text or [speech synthesis # markup language (SSML)][1]. # # * TEXT: This is the default value. When used the maximum character # limit is 3000. # # * SSML: When used the maximum character limit is 6000 including SSML # tagging. # # # # [1]: https://docs.aws.amazon.com/polly/latest/dg/what-is.html # # @option params [String] :voice_id # The voice for the [Amazon Polly][1] service to use. By default this is # set to "MATTHEW". # # # # [1]: https://docs.aws.amazon.com/polly/latest/dg/what-is.html # # @option params [String] :configuration_set_name # The name of the configuration set to use. This can be either the # ConfigurationSetName or ConfigurationSetArn. # # @option params [String] :max_price_per_minute # The maximum amount to spend per voice message, in US dollars. # # @option params [Integer] :time_to_live # How long the voice message is valid for. By default this is 72 hours. # # @option params [Hash] :context # You can specify custom data in this field. If you do, that data is # logged to the event destination. # # @option params [Boolean] :dry_run # When set to true, the message is checked and validated, but isn't # sent to the end recipient. # # @return [Types::SendVoiceMessageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::SendVoiceMessageResult#message_id #message_id} => String # # @example Request syntax with placeholder values # # resp = client.send_voice_message({ # destination_phone_number: "PhoneNumber", # required # origination_identity: "VoiceMessageOriginationIdentity", # required # message_body: "VoiceMessageBody", # message_body_text_type: "TEXT", # accepts TEXT, SSML # voice_id: "AMY", # accepts AMY, ASTRID, BIANCA, BRIAN, CAMILA, CARLA, CARMEN, CELINE, CHANTAL, CONCHITA, CRISTIANO, DORA, EMMA, ENRIQUE, EWA, FILIZ, GERAINT, GIORGIO, GWYNETH, HANS, INES, IVY, JACEK, JAN, JOANNA, JOEY, JUSTIN, KARL, KENDRA, KIMBERLY, LEA, LIV, LOTTE, LUCIA, LUPE, MADS, MAJA, MARLENE, MATHIEU, MATTHEW, MAXIM, MIA, MIGUEL, MIZUKI, NAJA, NICOLE, PENELOPE, RAVEENA, RICARDO, RUBEN, RUSSELL, SALLI, SEOYEON, TAKUMI, TATYANA, VICKI, VITORIA, ZEINA, ZHIYU # configuration_set_name: "ConfigurationSetNameOrArn", # max_price_per_minute: "MaxPrice", # time_to_live: 1, # context: { # "ContextKey" => "ContextValue", # }, # dry_run: false, # }) # # @example Response structure # # resp.message_id #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/SendVoiceMessage AWS API Documentation # # @overload send_voice_message(params = {}) # @param [Hash] params ({}) def send_voice_message(params = {}, options = {}) req = build_request(:send_voice_message, params) req.send_request(options) end # Sets the default message type on a configuration set. # # Choose the category of SMS messages that you plan to send from this # account. If you send account-related messages or time-sensitive # messages such as one-time passcodes, choose **Transactional**. If you # plan to send messages that contain marketing material or other # promotional content, choose **Promotional**. This setting applies to # your entire Amazon Web Services account. # # @option params [required, String] :configuration_set_name # The configuration set to update with a new default message type. This # field can be the ConsigurationSetName or ConfigurationSetArn. # # @option params [required, String] :message_type # The type of message. Valid values are TRANSACTIONAL for messages that # are critical or time-sensitive and PROMOTIONAL for messages that # aren't critical or time-sensitive. # # @return [Types::SetDefaultMessageTypeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::SetDefaultMessageTypeResult#configuration_set_arn #configuration_set_arn} => String # * {Types::SetDefaultMessageTypeResult#configuration_set_name #configuration_set_name} => String # * {Types::SetDefaultMessageTypeResult#message_type #message_type} => String # # @example Request syntax with placeholder values # # resp = client.set_default_message_type({ # configuration_set_name: "ConfigurationSetNameOrArn", # required # message_type: "TRANSACTIONAL", # required, accepts TRANSACTIONAL, PROMOTIONAL # }) # # @example Response structure # # resp.configuration_set_arn #=> String # resp.configuration_set_name #=> String # resp.message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/SetDefaultMessageType AWS API Documentation # # @overload set_default_message_type(params = {}) # @param [Hash] params ({}) def set_default_message_type(params = {}, options = {}) req = build_request(:set_default_message_type, params) req.send_request(options) end # Sets default sender ID on a configuration set. # # When sending a text message to a destination country that supports # sender IDs, the default sender ID on the configuration set specified # will be used if no dedicated origination phone numbers or registered # sender IDs are available in your account. # # @option params [required, String] :configuration_set_name # The configuration set to updated with a new default SenderId. This # field can be the ConsigurationSetName or ConfigurationSetArn. # # @option params [required, String] :sender_id # The current sender ID for the configuration set. When sending a text # message to a destination country which supports SenderIds, the default # sender ID on the configuration set specified on SendTextMessage will # be used if no dedicated origination phone numbers or registered # SenderIds are available in your account, instead of a generic sender # ID, such as 'NOTICE'. # # @return [Types::SetDefaultSenderIdResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::SetDefaultSenderIdResult#configuration_set_arn #configuration_set_arn} => String # * {Types::SetDefaultSenderIdResult#configuration_set_name #configuration_set_name} => String # * {Types::SetDefaultSenderIdResult#sender_id #sender_id} => String # # @example Request syntax with placeholder values # # resp = client.set_default_sender_id({ # configuration_set_name: "ConfigurationSetNameOrArn", # required # sender_id: "SenderId", # required # }) # # @example Response structure # # resp.configuration_set_arn #=> String # resp.configuration_set_name #=> String # resp.sender_id #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/SetDefaultSenderId AWS API Documentation # # @overload set_default_sender_id(params = {}) # @param [Hash] params ({}) def set_default_sender_id(params = {}, options = {}) req = build_request(:set_default_sender_id, params) req.send_request(options) end # Sets an account level monthly spend limit override for sending text # messages. The requested spend limit must be less than or equal to the # `MaxLimit`, which is set by Amazon Web Services. # # @option params [required, Integer] :monthly_limit # The new monthly limit to enforce on text messages. # # @return [Types::SetTextMessageSpendLimitOverrideResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::SetTextMessageSpendLimitOverrideResult#monthly_limit #monthly_limit} => Integer # # @example Request syntax with placeholder values # # resp = client.set_text_message_spend_limit_override({ # monthly_limit: 1, # required # }) # # @example Response structure # # resp.monthly_limit #=> Integer # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/SetTextMessageSpendLimitOverride AWS API Documentation # # @overload set_text_message_spend_limit_override(params = {}) # @param [Hash] params ({}) def set_text_message_spend_limit_override(params = {}, options = {}) req = build_request(:set_text_message_spend_limit_override, params) req.send_request(options) end # Sets an account level monthly spend limit override for sending voice # messages. The requested spend limit must be less than or equal to the # `MaxLimit`, which is set by Amazon Web Services. # # @option params [required, Integer] :monthly_limit # The new monthly limit to enforce on voice messages. # # @return [Types::SetVoiceMessageSpendLimitOverrideResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::SetVoiceMessageSpendLimitOverrideResult#monthly_limit #monthly_limit} => Integer # # @example Request syntax with placeholder values # # resp = client.set_voice_message_spend_limit_override({ # monthly_limit: 1, # required # }) # # @example Response structure # # resp.monthly_limit #=> Integer # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/SetVoiceMessageSpendLimitOverride AWS API Documentation # # @overload set_voice_message_spend_limit_override(params = {}) # @param [Hash] params ({}) def set_voice_message_spend_limit_override(params = {}, options = {}) req = build_request(:set_voice_message_spend_limit_override, params) req.send_request(options) end # Adds or overwrites only the specified tags for the specified Amazon # Pinpoint SMS Voice, version 2 resource. When you specify an existing # tag key, the value is overwritten with the new value. Each resource # can have a maximum of 50 tags. Each tag consists of a key and an # optional value. Tag keys must be unique per resource. For more # information about tags, see [ Tagging Amazon Pinpoint resources][1] in # the *Amazon Pinpoint Developer Guide*. # # # # [1]: https://docs.aws.amazon.com/pinpoint/latest/developerguide/tagging-resources.html # # @option params [required, String] :resource_arn # The Amazon Resource Name (ARN) of the resource. # # @option params [required, Array] :tags # An array of key and value pair tags that are associated with the # resource. # # @return [Struct] Returns an empty {Seahorse::Client::Response response}. # # @example Request syntax with placeholder values # # resp = client.tag_resource({ # resource_arn: "AmazonResourceName", # required # tags: [ # required # { # key: "TagKey", # required # value: "TagValue", # required # }, # ], # }) # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/TagResource AWS API Documentation # # @overload tag_resource(params = {}) # @param [Hash] params ({}) def tag_resource(params = {}, options = {}) req = build_request(:tag_resource, params) req.send_request(options) end # Removes the association of the specified tags from an Amazon Pinpoint # SMS Voice V2 resource. For more information on tags see [ Tagging # Amazon Pinpoint resources][1] in the *Amazon Pinpoint Developer # Guide*. # # # # [1]: https://docs.aws.amazon.com/pinpoint/latest/developerguide/tagging-resources.html # # @option params [required, String] :resource_arn # The Amazon Resource Name (ARN) of the resource. # # @option params [required, Array] :tag_keys # An array of tag key values to unassociate with the resource. # # @return [Struct] Returns an empty {Seahorse::Client::Response response}. # # @example Request syntax with placeholder values # # resp = client.untag_resource({ # resource_arn: "AmazonResourceName", # required # tag_keys: ["TagKey"], # required # }) # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/UntagResource AWS API Documentation # # @overload untag_resource(params = {}) # @param [Hash] params ({}) def untag_resource(params = {}, options = {}) req = build_request(:untag_resource, params) req.send_request(options) end # Updates an existing event destination in a configuration set. You can # update the IAM role ARN for CloudWatch Logs and Kinesis Data Firehose. # You can also enable or disable the event destination. # # You may want to update an event destination to change its matching # event types or updating the destination resource ARN. You can't # change an event destination's type between CloudWatch Logs, Kinesis # Data Firehose, and Amazon SNS. # # @option params [required, String] :configuration_set_name # The configuration set to update with the new event destination. Valid # values for this can be the ConfigurationSetName or # ConfigurationSetArn. # # @option params [required, String] :event_destination_name # The name to use for the event destination. # # @option params [Boolean] :enabled # When set to true logging is enabled. # # @option params [Array] :matching_event_types # An array of event types that determine which events to log. # # @option params [Types::CloudWatchLogsDestination] :cloud_watch_logs_destination # An object that contains information about an event destination that # sends data to CloudWatch Logs. # # @option params [Types::KinesisFirehoseDestination] :kinesis_firehose_destination # An object that contains information about an event destination for # logging to Kinesis Data Firehose. # # @option params [Types::SnsDestination] :sns_destination # An object that contains information about an event destination that # sends data to Amazon SNS. # # @return [Types::UpdateEventDestinationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::UpdateEventDestinationResult#configuration_set_arn #configuration_set_arn} => String # * {Types::UpdateEventDestinationResult#configuration_set_name #configuration_set_name} => String # * {Types::UpdateEventDestinationResult#event_destination #event_destination} => Types::EventDestination # # @example Request syntax with placeholder values # # resp = client.update_event_destination({ # configuration_set_name: "ConfigurationSetNameOrArn", # required # event_destination_name: "EventDestinationName", # required # enabled: false, # matching_event_types: ["ALL"], # accepts ALL, TEXT_ALL, TEXT_SENT, TEXT_PENDING, TEXT_QUEUED, TEXT_SUCCESSFUL, TEXT_DELIVERED, TEXT_INVALID, TEXT_INVALID_MESSAGE, TEXT_UNREACHABLE, TEXT_CARRIER_UNREACHABLE, TEXT_BLOCKED, TEXT_CARRIER_BLOCKED, TEXT_SPAM, TEXT_UNKNOWN, TEXT_TTL_EXPIRED, VOICE_ALL, VOICE_INITIATED, VOICE_RINGING, VOICE_ANSWERED, VOICE_COMPLETED, VOICE_BUSY, VOICE_NO_ANSWER, VOICE_FAILED, VOICE_TTL_EXPIRED # cloud_watch_logs_destination: { # iam_role_arn: "IamRoleArn", # required # log_group_arn: "LogGroupArn", # required # }, # kinesis_firehose_destination: { # iam_role_arn: "IamRoleArn", # required # delivery_stream_arn: "DeliveryStreamArn", # required # }, # sns_destination: { # topic_arn: "SnsTopicArn", # required # }, # }) # # @example Response structure # # resp.configuration_set_arn #=> String # resp.configuration_set_name #=> String # resp.event_destination.event_destination_name #=> String # resp.event_destination.enabled #=> Boolean # resp.event_destination.matching_event_types #=> Array # resp.event_destination.matching_event_types[0] #=> String, one of "ALL", "TEXT_ALL", "TEXT_SENT", "TEXT_PENDING", "TEXT_QUEUED", "TEXT_SUCCESSFUL", "TEXT_DELIVERED", "TEXT_INVALID", "TEXT_INVALID_MESSAGE", "TEXT_UNREACHABLE", "TEXT_CARRIER_UNREACHABLE", "TEXT_BLOCKED", "TEXT_CARRIER_BLOCKED", "TEXT_SPAM", "TEXT_UNKNOWN", "TEXT_TTL_EXPIRED", "VOICE_ALL", "VOICE_INITIATED", "VOICE_RINGING", "VOICE_ANSWERED", "VOICE_COMPLETED", "VOICE_BUSY", "VOICE_NO_ANSWER", "VOICE_FAILED", "VOICE_TTL_EXPIRED" # resp.event_destination.cloud_watch_logs_destination.iam_role_arn #=> String # resp.event_destination.cloud_watch_logs_destination.log_group_arn #=> String # resp.event_destination.kinesis_firehose_destination.iam_role_arn #=> String # resp.event_destination.kinesis_firehose_destination.delivery_stream_arn #=> String # resp.event_destination.sns_destination.topic_arn #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/UpdateEventDestination AWS API Documentation # # @overload update_event_destination(params = {}) # @param [Hash] params ({}) def update_event_destination(params = {}, options = {}) req = build_request(:update_event_destination, params) req.send_request(options) end # Updates the configuration of an existing origination phone number. You # can update the opt-out list, enable or disable two-way messaging, # change the TwoWayChannelArn, enable or disable self-managed opt-outs, # and enable or disable deletion protection. # # If the origination phone number is associated with a pool, an Error is # returned. # # @option params [required, String] :phone_number_id # The unique identifier of the phone number. Valid values for this field # can be either the PhoneNumberId or PhoneNumberArn. # # @option params [Boolean] :two_way_enabled # By default this is set to false. When set to true you can receive # incoming text messages from your end recipients. # # @option params [String] :two_way_channel_arn # The Amazon Resource Name (ARN) of the two way channel. # # @option params [Boolean] :self_managed_opt_outs_enabled # By default this is set to false. When an end recipient sends a message # that begins with HELP or STOP to one of your dedicated numbers, Amazon # Pinpoint automatically replies with a customizable message and adds # the end recipient to the OptOutList. When set to true you're # responsible for responding to HELP and STOP requests. You're also # responsible for tracking and honoring opt-out requests. # # @option params [String] :opt_out_list_name # The OptOutList to add the phone number to. Valid values for this field # can be either the OutOutListName or OutOutListArn. # # @option params [Boolean] :deletion_protection_enabled # By default this is set to false. When set to true the phone number # can't be deleted. # # @return [Types::UpdatePhoneNumberResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::UpdatePhoneNumberResult#phone_number_arn #phone_number_arn} => String # * {Types::UpdatePhoneNumberResult#phone_number_id #phone_number_id} => String # * {Types::UpdatePhoneNumberResult#phone_number #phone_number} => String # * {Types::UpdatePhoneNumberResult#status #status} => String # * {Types::UpdatePhoneNumberResult#iso_country_code #iso_country_code} => String # * {Types::UpdatePhoneNumberResult#message_type #message_type} => String # * {Types::UpdatePhoneNumberResult#number_capabilities #number_capabilities} => Array<String> # * {Types::UpdatePhoneNumberResult#number_type #number_type} => String # * {Types::UpdatePhoneNumberResult#monthly_leasing_price #monthly_leasing_price} => String # * {Types::UpdatePhoneNumberResult#two_way_enabled #two_way_enabled} => Boolean # * {Types::UpdatePhoneNumberResult#two_way_channel_arn #two_way_channel_arn} => String # * {Types::UpdatePhoneNumberResult#self_managed_opt_outs_enabled #self_managed_opt_outs_enabled} => Boolean # * {Types::UpdatePhoneNumberResult#opt_out_list_name #opt_out_list_name} => String # * {Types::UpdatePhoneNumberResult#deletion_protection_enabled #deletion_protection_enabled} => Boolean # * {Types::UpdatePhoneNumberResult#created_timestamp #created_timestamp} => Time # # @example Request syntax with placeholder values # # resp = client.update_phone_number({ # phone_number_id: "PhoneNumberIdOrArn", # required # two_way_enabled: false, # two_way_channel_arn: "TwoWayChannelArn", # self_managed_opt_outs_enabled: false, # opt_out_list_name: "OptOutListNameOrArn", # deletion_protection_enabled: false, # }) # # @example Response structure # # resp.phone_number_arn #=> String # resp.phone_number_id #=> String # resp.phone_number #=> String # resp.status #=> String, one of "PENDING", "ACTIVE", "ASSOCIATING", "DISASSOCIATING", "DELETED" # resp.iso_country_code #=> String # resp.message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.number_capabilities #=> Array # resp.number_capabilities[0] #=> String, one of "SMS", "VOICE" # resp.number_type #=> String, one of "SHORT_CODE", "LONG_CODE", "TOLL_FREE", "TEN_DLC" # resp.monthly_leasing_price #=> String # resp.two_way_enabled #=> Boolean # resp.two_way_channel_arn #=> String # resp.self_managed_opt_outs_enabled #=> Boolean # resp.opt_out_list_name #=> String # resp.deletion_protection_enabled #=> Boolean # resp.created_timestamp #=> Time # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/UpdatePhoneNumber AWS API Documentation # # @overload update_phone_number(params = {}) # @param [Hash] params ({}) def update_phone_number(params = {}, options = {}) req = build_request(:update_phone_number, params) req.send_request(options) end # Updates the configuration of an existing pool. You can update the # opt-out list, enable or disable two-way messaging, change the # `TwoWayChannelArn`, enable or disable self-managed opt-outs, enable or # disable deletion protection, and enable or disable shared routes. # # @option params [required, String] :pool_id # The unique identifier of the pool to update. Valid values are either # the PoolId or PoolArn. # # @option params [Boolean] :two_way_enabled # By default this is set to false. When set to true you can receive # incoming text messages from your end recipients. # # @option params [String] :two_way_channel_arn # The Amazon Resource Name (ARN) of the two way channel. # # @option params [Boolean] :self_managed_opt_outs_enabled # By default this is set to false. When an end recipient sends a message # that begins with HELP or STOP to one of your dedicated numbers, Amazon # Pinpoint automatically replies with a customizable message and adds # the end recipient to the OptOutList. When set to true you're # responsible for responding to HELP and STOP requests. You're also # responsible for tracking and honoring opt-out requests. # # @option params [String] :opt_out_list_name # The OptOutList to associate with the pool. Valid values are either # OptOutListName or OptOutListArn. # # @option params [Boolean] :shared_routes_enabled # Indicates whether shared routes are enabled for the pool. # # @option params [Boolean] :deletion_protection_enabled # When set to true the pool can't be deleted. # # @return [Types::UpdatePoolResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # # * {Types::UpdatePoolResult#pool_arn #pool_arn} => String # * {Types::UpdatePoolResult#pool_id #pool_id} => String # * {Types::UpdatePoolResult#status #status} => String # * {Types::UpdatePoolResult#message_type #message_type} => String # * {Types::UpdatePoolResult#two_way_enabled #two_way_enabled} => Boolean # * {Types::UpdatePoolResult#two_way_channel_arn #two_way_channel_arn} => String # * {Types::UpdatePoolResult#self_managed_opt_outs_enabled #self_managed_opt_outs_enabled} => Boolean # * {Types::UpdatePoolResult#opt_out_list_name #opt_out_list_name} => String # * {Types::UpdatePoolResult#shared_routes_enabled #shared_routes_enabled} => Boolean # * {Types::UpdatePoolResult#deletion_protection_enabled #deletion_protection_enabled} => Boolean # * {Types::UpdatePoolResult#created_timestamp #created_timestamp} => Time # # @example Request syntax with placeholder values # # resp = client.update_pool({ # pool_id: "PoolIdOrArn", # required # two_way_enabled: false, # two_way_channel_arn: "TwoWayChannelArn", # self_managed_opt_outs_enabled: false, # opt_out_list_name: "OptOutListNameOrArn", # shared_routes_enabled: false, # deletion_protection_enabled: false, # }) # # @example Response structure # # resp.pool_arn #=> String # resp.pool_id #=> String # resp.status #=> String, one of "CREATING", "ACTIVE", "DELETING" # resp.message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL" # resp.two_way_enabled #=> Boolean # resp.two_way_channel_arn #=> String # resp.self_managed_opt_outs_enabled #=> Boolean # resp.opt_out_list_name #=> String # resp.shared_routes_enabled #=> Boolean # resp.deletion_protection_enabled #=> Boolean # resp.created_timestamp #=> Time # # @see http://docs.aws.amazon.com/goto/WebAPI/pinpoint-sms-voice-v2-2022-03-31/UpdatePool AWS API Documentation # # @overload update_pool(params = {}) # @param [Hash] params ({}) def update_pool(params = {}, options = {}) req = build_request(:update_pool, params) req.send_request(options) end # @!endgroup # @param params ({}) # @api private def build_request(operation_name, params = {}) handlers = @handlers.for(operation_name) context = Seahorse::Client::RequestContext.new( operation_name: operation_name, operation: config.api.operation(operation_name), client: self, params: params, config: config) context[:gem_name] = 'aws-sdk-pinpointsmsvoicev2' context[:gem_version] = '1.2.0' Seahorse::Client::Request.new(handlers, context) end # @api private # @deprecated def waiter_names [] end class << self # @api private attr_reader :identifier # @api private def errors_module Errors end end end end