Class: Aws::PinpointSMSVoiceV2::Client

Inherits:
Seahorse::Client::Base show all
Includes:
ClientStubs
Defined in:
gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb

Overview

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.

See #initialize for a full list of supported configuration options.

Instance Attribute Summary

Attributes inherited from Seahorse::Client::Base

#config, #handlers

API Operations collapse

Instance Method Summary collapse

Methods included from ClientStubs

#api_requests, #stub_data, #stub_responses

Methods inherited from Seahorse::Client::Base

add_plugin, api, clear_plugins, define, new, #operation_names, plugins, remove_plugin, set_api, set_plugins

Methods included from Seahorse::Client::HandlerBuilder

#handle, #handle_request, #handle_response

Constructor Details

#initialize(options) ⇒ Client

Returns a new instance of Client.

Parameters:

  • options (Hash)

Options Hash (options):

  • :credentials (required, Aws::CredentialProvider)

    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.
  • :region (required, String)

    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
  • :access_key_id (String)
  • :active_endpoint_cache (Boolean) — default: false

    When set to true, a thread polling for endpoints will be running in the background every 60 secs (default). Defaults to false.

  • :adaptive_retry_wait_to_fill (Boolean) — default: 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.

  • :client_side_monitoring (Boolean) — default: false

    When true, client-side metrics will be collected for all API requests from this client.

  • :client_side_monitoring_client_id (String) — default: ""

    Allows you to provide an identifier for this client which will be attached to all generated client side metrics. Defaults to an empty string.

  • :client_side_monitoring_host (String) — default: "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.

  • :client_side_monitoring_port (Integer) — default: 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.

  • :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher) — default: Aws::ClientSideMonitoring::Publisher

    Allows you to provide a custom client-side monitoring publisher class. By default, will use the Client Side Monitoring Agent Publisher.

  • :convert_params (Boolean) — default: true

    When true, an attempt is made to coerce request parameters into the required types.

  • :correct_clock_skew (Boolean) — default: true

    Used only in standard and adaptive retry modes. Specifies whether to apply a clock skew correction and retry requests with skewed client clocks.

  • :defaults_mode (String) — default: "legacy"

    See DefaultsModeConfiguration for a list of the accepted modes and the configuration defaults that are included.

  • :disable_host_prefix_injection (Boolean) — default: false

    Set to true to disable SDK automatically adding host prefix to default service endpoint when available.

  • :disable_request_compression (Boolean) — default: false

    When set to 'true' the request body will not be compressed for supported operations.

  • :endpoint (String)

    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.

  • :endpoint_cache_max_entries (Integer) — default: 1000

    Used for the maximum size limit of the LRU cache storing endpoints data for endpoint discovery enabled operations. Defaults to 1000.

  • :endpoint_cache_max_threads (Integer) — default: 10

    Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.

  • :endpoint_cache_poll_interval (Integer) — default: 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.

  • :endpoint_discovery (Boolean) — default: false

    When set to true, endpoint discovery will be enabled for operations when available.

  • :ignore_configured_endpoint_urls (Boolean)

    Setting to true disables use of endpoint URLs provided via environment variables and the shared configuration file.

  • :log_formatter (Aws::Log::Formatter) — default: Aws::Log::Formatter.default

    The log formatter.

  • :log_level (Symbol) — default: :info

    The log level to send messages to the :logger at.

  • :logger (Logger)

    The Logger instance to send log messages to. If this option is not set, logging will be disabled.

  • :max_attempts (Integer) — default: 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.

  • :profile (String) — default: "default"

    Used when loading credentials from the shared credentials file at HOME/.aws/credentials. When not specified, 'default' is used.

  • :request_min_compression_size_bytes (Integer) — default: 10240

    The minimum size in bytes that triggers compression for request bodies. The value must be non-negative integer value between 0 and 10485780 bytes inclusive.

  • :retry_backoff (Proc)

    A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay. This option is only used in the legacy retry mode.

  • :retry_base_delay (Float) — default: 0.3

    The base delay in seconds used by the default backoff function. This option is only used in the legacy retry mode.

  • :retry_jitter (Symbol) — default: :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

  • :retry_limit (Integer) — default: 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.

  • :retry_max_delay (Integer) — default: 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.

  • :retry_mode (String) — default: "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.

  • :sdk_ua_app_id (String)

    A unique and opaque application ID that is appended to the User-Agent header as app/. It should have a maximum length of 50.

  • :secret_access_key (String)
  • :session_token (String)
  • :simple_json (Boolean) — default: 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.

  • :stub_responses (Boolean) — default: 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.

  • :token_provider (Aws::TokenProvider)

    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.

  • :use_dualstack_endpoint (Boolean)

    When set to true, dualstack enabled endpoints (with .aws TLD) will be used if available.

  • :use_fips_endpoint (Boolean)

    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.

  • :validate_params (Boolean) — default: true

    When true, request parameters are validated before sending the request.

  • :endpoint_provider (Aws::PinpointSMSVoiceV2::EndpointProvider)

    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

  • :http_proxy (URI::HTTP, String)

    A proxy to send requests through. Formatted like 'http://proxy.com:123'.

  • :http_open_timeout (Float) — default: 15

    The number of seconds to wait when opening a HTTP session before raising a Timeout::Error.

  • :http_read_timeout (Float) — default: 60

    The default number of seconds to wait for response data. This value can safely be set per-request on the session.

  • :http_idle_timeout (Float) — default: 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.

  • :http_continue_timeout (Float) — default: 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.

  • :ssl_timeout (Float) — default: nil

    Sets the SSL timeout in seconds.

  • :http_wire_trace (Boolean) — default: false

    When true, HTTP debug output will be sent to the :logger.

  • :ssl_verify_peer (Boolean) — default: true

    When true, SSL peer certificates are verified when establishing a connection.

  • :ssl_ca_bundle (String)

    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.

  • :ssl_ca_directory (String)

    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.



395
396
397
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 395

def initialize(*args)
  super
end

Instance Method Details

#associate_origination_identity(params = {}) ⇒ Types::AssociateOriginationIdentityResult

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.

Examples:

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",
})

Response structure


resp.pool_arn #=> String
resp.pool_id #=> String
resp.origination_identity_arn #=> String
resp.origination_identity #=> String
resp.iso_country_code #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :pool_id (required, String)

    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.

  • :origination_identity (required, String)

    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.

  • :iso_country_code (required, String)

    The new two-character code, in ISO 3166-1 alpha-2 format, for the country or region of the origination identity.

  • :client_token (String)

    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.**

Returns:

See Also:



463
464
465
466
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 463

def associate_origination_identity(params = {}, options = {})
  req = build_request(:associate_origination_identity, params)
  req.send_request(options)
end

#create_configuration_set(params = {}) ⇒ Types::CreateConfigurationSetResult

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.

Examples:

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",
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name to use for the new configuration set.

  • :tags (Array<Types::Tag>)

    An array of key and value pair tags that's associated with the new configuration set.

  • :client_token (String)

    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.**

Returns:

See Also:



526
527
528
529
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 526

def create_configuration_set(params = {}, options = {})
  req = build_request(:create_configuration_set, params)
  req.send_request(options)
end

#create_event_destination(params = {}) ⇒ Types::CreateEventDestinationResult

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.

Examples:

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",
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    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.

  • :event_destination_name (required, String)

    The name that identifies the event destination.

  • :matching_event_types (required, Array<String>)

    An array of event types that determine which events to log. If "ALL" is used, then Amazon Pinpoint logs every event type.

    The TEXT_SENT event type is not supported.

  • :cloud_watch_logs_destination (Types::CloudWatchLogsDestination)

    An object that contains information about an event destination for logging to Amazon CloudWatch logs.

  • :kinesis_firehose_destination (Types::KinesisFirehoseDestination)

    An object that contains information about an event destination for logging to Amazon Kinesis Data Firehose.

  • :sns_destination (Types::SnsDestination)

    An object that contains information about an event destination for logging to Amazon SNS.

  • :client_token (String)

    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.**

Returns:

See Also:



626
627
628
629
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 626

def create_event_destination(params = {}, options = {})
  req = build_request(:create_event_destination, params)
  req.send_request(options)
end

#create_opt_out_list(params = {}) ⇒ Types::CreateOptOutListResult

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 in the Amazon Pinpoint User Guide.

Examples:

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",
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :opt_out_list_name (required, String)

    The name of the new OptOutList.

  • :tags (Array<Types::Tag>)

    An array of tags (key and value pairs) to associate with the new OptOutList.

  • :client_token (String)

    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.**

Returns:

See Also:



696
697
698
699
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 696

def create_opt_out_list(params = {}, options = {})
  req = build_request(:create_opt_out_list, params)
  req.send_request(options)
end

#create_pool(params = {}) ⇒ Types::CreatePoolResult

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.

Examples:

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",
})

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.two_way_channel_role #=> 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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :origination_identity (required, String)

    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.

  • :iso_country_code (required, String)

    The new two-character code, in ISO 3166-1 alpha-2 format, for the country or region of the new pool.

  • :message_type (required, String)

    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.

  • :deletion_protection_enabled (Boolean)

    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.

  • :tags (Array<Types::Tag>)

    An array of tags (key and value pairs) associated with the pool.

  • :client_token (String)

    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.**

Returns:

See Also:



801
802
803
804
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 801

def create_pool(params = {}, options = {})
  req = build_request(:create_pool, params)
  req.send_request(options)
end

#create_registration(params = {}) ⇒ Types::CreateRegistrationResult

Creates a new registration based on the RegistrationType field.

Examples:

Request syntax with placeholder values


resp = client.create_registration({
  registration_type: "RegistrationType", # required
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
  client_token: "ClientToken",
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.registration_type #=> String
resp.registration_status #=> String, one of "CREATED", "SUBMITTED", "REVIEWING", "PROVISIONING", "COMPLETE", "REQUIRES_UPDATES", "CLOSED", "DELETED"
resp.current_version_number #=> Integer
resp.additional_attributes #=> Hash
resp.additional_attributes["String"] #=> String
resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_type (required, String)

    The type of registration form to create. The list of RegistrationTypes can be found using the DescribeRegistrationTypeDefinitions action.

  • :tags (Array<Types::Tag>)

    An array of tags (key and value pairs) to associate with the registration.

  • :client_token (String)

    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.**

Returns:

See Also:



868
869
870
871
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 868

def create_registration(params = {}, options = {})
  req = build_request(:create_registration, params)
  req.send_request(options)
end

#create_registration_association(params = {}) ⇒ Types::CreateRegistrationAssociationResult

Associate the registration with an origination identity such as a phone number or sender ID.

Examples:

Request syntax with placeholder values


resp = client.create_registration_association({
  registration_id: "RegistrationIdOrArn", # required
  resource_id: "ResourceIdOrArn", # required
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.registration_type #=> String
resp.resource_arn #=> String
resp.resource_id #=> String
resp.resource_type #=> String
resp.iso_country_code #=> String
resp.phone_number #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_id (required, String)

    The unique identifier for the registration.

  • :resource_id (required, String)

    The unique identifier for the origination identity. For example this could be a PhoneNumberId or SenderId.

Returns:

See Also:



916
917
918
919
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 916

def create_registration_association(params = {}, options = {})
  req = build_request(:create_registration_association, params)
  req.send_request(options)
end

#create_registration_attachment(params = {}) ⇒ Types::CreateRegistrationAttachmentResult

Create a new registration attachment to use for uploading a file or a URL to a file. The maximum file size is 1MiB and valid file extensions are PDF, JPEG and PNG. For example, many sender ID registrations require a signed “letter of authorization” (LOA) to be submitted.

Examples:

Request syntax with placeholder values


resp = client.create_registration_attachment({
  attachment_body: "data",
  attachment_url: "AttachmentUrl",
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
  client_token: "ClientToken",
})

Response structure


resp.registration_attachment_arn #=> String
resp.registration_attachment_id #=> String
resp.attachment_status #=> String, one of "UPLOAD_IN_PROGRESS", "UPLOAD_COMPLETE", "UPLOAD_FAILED", "DELETED"
resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :attachment_body (String, StringIO, File)

    The registration file to upload. The maximum file size is 1MiB and valid file extensions are PDF, JPEG and PNG.

  • :attachment_url (String)

    A URL to the required registration file. For example, you can provide the S3 object URL.

  • :tags (Array<Types::Tag>)

    An array of tags (key and value pairs) to associate with the registration attachment.

  • :client_token (String)

    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.**

Returns:

See Also:



983
984
985
986
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 983

def create_registration_attachment(params = {}, options = {})
  req = build_request(:create_registration_attachment, params)
  req.send_request(options)
end

#create_registration_version(params = {}) ⇒ Types::CreateRegistrationVersionResult

Create a new version of the registration and increase the VersionNumber. The previous version of the registration becomes read-only.

Examples:

Request syntax with placeholder values


resp = client.create_registration_version({
  registration_id: "RegistrationIdOrArn", # required
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.version_number #=> Integer
resp.registration_version_status #=> String, one of "DRAFT", "SUBMITTED", "REVIEWING", "APPROVED", "DISCARDED", "DENIED", "REVOKED", "ARCHIVED"
resp.registration_version_status_history.draft_timestamp #=> Time
resp.registration_version_status_history. #=> Time
resp.registration_version_status_history.reviewing_timestamp #=> Time
resp.registration_version_status_history.approved_timestamp #=> Time
resp.registration_version_status_history.discarded_timestamp #=> Time
resp.registration_version_status_history.denied_timestamp #=> Time
resp.registration_version_status_history.revoked_timestamp #=> Time
resp.registration_version_status_history.archived_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_id (required, String)

    The unique identifier for the registration.

Returns:

See Also:



1028
1029
1030
1031
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1028

def create_registration_version(params = {}, options = {})
  req = build_request(:create_registration_version, params)
  req.send_request(options)
end

#create_verified_destination_number(params = {}) ⇒ Types::CreateVerifiedDestinationNumberResult

You can only send messages to verified destination numbers when your account is in the sandbox. You can add up to 10 verified destination numbers.

Examples:

Request syntax with placeholder values


resp = client.create_verified_destination_number({
  destination_phone_number: "PhoneNumber", # required
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
  client_token: "ClientToken",
})

Response structure


resp.verified_destination_number_arn #=> String
resp.verified_destination_number_id #=> String
resp.destination_phone_number #=> String
resp.status #=> String, one of "PENDING", "VERIFIED"
resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :destination_phone_number (required, String)

    The verified destination phone number, in E.164 format.

  • :tags (Array<Types::Tag>)

    An array of tags (key and value pairs) to associate with the destination number.

  • :client_token (String)

    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.**

Returns:

See Also:



1090
1091
1092
1093
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1090

def create_verified_destination_number(params = {}, options = {})
  req = build_request(:create_verified_destination_number, params)
  req.send_request(options)
end

#delete_configuration_set(params = {}) ⇒ Types::DeleteConfigurationSetResult

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.

Examples:

Request syntax with placeholder values


resp = client.delete_configuration_set({
  configuration_set_name: "ConfigurationSetNameOrArn", # required
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    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.

Returns:

See Also:



1144
1145
1146
1147
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1144

def delete_configuration_set(params = {}, options = {})
  req = build_request(:delete_configuration_set, params)
  req.send_request(options)
end

#delete_default_message_type(params = {}) ⇒ Types::DeleteDefaultMessageTypeResult

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.

Examples:

Request syntax with placeholder values


resp = client.delete_default_message_type({
  configuration_set_name: "ConfigurationSetNameOrArn", # required
})

Response structure


resp.configuration_set_arn #=> String
resp.configuration_set_name #=> String
resp.message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    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.

Returns:

See Also:



1186
1187
1188
1189
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1186

def delete_default_message_type(params = {}, options = {})
  req = build_request(:delete_default_message_type, params)
  req.send_request(options)
end

#delete_default_sender_id(params = {}) ⇒ Types::DeleteDefaultSenderIdResult

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.

Examples:

Request syntax with placeholder values


resp = client.delete_default_sender_id({
  configuration_set_name: "ConfigurationSetNameOrArn", # required
})

Response structure


resp.configuration_set_arn #=> String
resp.configuration_set_name #=> String
resp.sender_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    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.

Returns:

See Also:



1225
1226
1227
1228
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1225

def delete_default_sender_id(params = {}, options = {})
  req = build_request(:delete_default_sender_id, params)
  req.send_request(options)
end

#delete_event_destination(params = {}) ⇒ Types::DeleteEventDestinationResult

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.

Examples:

Request syntax with placeholder values


resp = client.delete_event_destination({
  configuration_set_name: "ConfigurationSetNameOrArn", # required
  event_destination_name: "EventDestinationName", # required
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    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.

  • :event_destination_name (required, String)

    The name of the event destination to delete.

Returns:

See Also:



1278
1279
1280
1281
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1278

def delete_event_destination(params = {}, options = {})
  req = build_request(:delete_event_destination, params)
  req.send_request(options)
end

#delete_keyword(params = {}) ⇒ Types::DeleteKeywordResult

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.

Examples:

Request syntax with placeholder values


resp = client.delete_keyword({
  origination_identity: "PhoneOrPoolIdOrArn", # required
  keyword: "Keyword", # required
})

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"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :origination_identity (required, String)

    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.

  • :keyword (required, String)

    The keyword to delete.

Returns:

See Also:



1330
1331
1332
1333
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1330

def delete_keyword(params = {}, options = {})
  req = build_request(:delete_keyword, params)
  req.send_request(options)
end

#delete_opt_out_list(params = {}) ⇒ Types::DeleteOptOutListResult

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.

Examples:

Request syntax with placeholder values


resp = client.delete_opt_out_list({
  opt_out_list_name: "OptOutListNameOrArn", # required
})

Response structure


resp.opt_out_list_arn #=> String
resp.opt_out_list_name #=> String
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :opt_out_list_name (required, String)

    The OptOutListName or OptOutListArn of the OptOutList to delete. You can use DescribeOptOutLists to find the values for OptOutListName and OptOutListArn.

Returns:

See Also:



1368
1369
1370
1371
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1368

def delete_opt_out_list(params = {}, options = {})
  req = build_request(:delete_opt_out_list, params)
  req.send_request(options)
end

#delete_opted_out_number(params = {}) ⇒ Types::DeleteOptedOutNumberResult

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.

Examples:

Request syntax with placeholder values


resp = client.delete_opted_out_number({
  opt_out_list_name: "OptOutListNameOrArn", # required
  opted_out_number: "PhoneNumber", # required
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :opt_out_list_name (required, String)

    The OptOutListName or OptOutListArn to remove the phone number from.

  • :opted_out_number (required, String)

    The phone number, in E.164 format, to remove from the OptOutList.

Returns:

See Also:



1414
1415
1416
1417
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1414

def delete_opted_out_number(params = {}, options = {})
  req = build_request(:delete_opted_out_number, params)
  req.send_request(options)
end

#delete_pool(params = {}) ⇒ Types::DeletePoolResult

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.

Examples:

Request syntax with placeholder values


resp = client.delete_pool({
  pool_id: "PoolIdOrArn", # required
})

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.two_way_channel_role #=> String
resp.self_managed_opt_outs_enabled #=> Boolean
resp.opt_out_list_name #=> String
resp.shared_routes_enabled #=> Boolean
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :pool_id (required, String)

    The PoolId or PoolArn of the pool to delete. You can use DescribePools to find the values for PoolId and PoolArn .

Returns:

See Also:



1471
1472
1473
1474
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1471

def delete_pool(params = {}, options = {})
  req = build_request(:delete_pool, params)
  req.send_request(options)
end

#delete_registration(params = {}) ⇒ Types::DeleteRegistrationResult

Permanently delete an existing registration from your account.

Examples:

Request syntax with placeholder values


resp = client.delete_registration({
  registration_id: "RegistrationIdOrArn", # required
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.registration_type #=> String
resp.registration_status #=> String, one of "CREATED", "SUBMITTED", "REVIEWING", "PROVISIONING", "COMPLETE", "REQUIRES_UPDATES", "CLOSED", "DELETED"
resp.current_version_number #=> Integer
resp.approved_version_number #=> Integer
resp.latest_denied_version_number #=> Integer
resp.additional_attributes #=> Hash
resp.additional_attributes["String"] #=> String
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_id (required, String)

    The unique identifier for the registration.

Returns:

See Also:



1516
1517
1518
1519
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1516

def delete_registration(params = {}, options = {})
  req = build_request(:delete_registration, params)
  req.send_request(options)
end

#delete_registration_attachment(params = {}) ⇒ Types::DeleteRegistrationAttachmentResult

Permanently delete the specified registration attachment.

Examples:

Request syntax with placeholder values


resp = client.delete_registration_attachment({
  registration_attachment_id: "RegistrationAttachmentIdOrArn", # required
})

Response structure


resp.registration_attachment_arn #=> String
resp.registration_attachment_id #=> String
resp.attachment_status #=> String, one of "UPLOAD_IN_PROGRESS", "UPLOAD_COMPLETE", "UPLOAD_FAILED", "DELETED"
resp.attachment_upload_error_reason #=> String, one of "INTERNAL_ERROR"
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_attachment_id (required, String)

    The unique identifier for the registration attachment.

Returns:

See Also:



1552
1553
1554
1555
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1552

def delete_registration_attachment(params = {}, options = {})
  req = build_request(:delete_registration_attachment, params)
  req.send_request(options)
end

#delete_registration_field_value(params = {}) ⇒ Types::DeleteRegistrationFieldValueResult

Delete the value in a registration form field.

Examples:

Request syntax with placeholder values


resp = client.delete_registration_field_value({
  registration_id: "RegistrationIdOrArn", # required
  field_path: "FieldPath", # required
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.version_number #=> Integer
resp.field_path #=> String
resp.select_choices #=> Array
resp.select_choices[0] #=> String
resp.text_value #=> String
resp.registration_attachment_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_id (required, String)

    The unique identifier for the registration.

  • :field_path (required, String)

    The path to the registration form field. You can use DescribeRegistrationFieldDefinitions for a list of FieldPaths.

Returns:

See Also:



1598
1599
1600
1601
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1598

def delete_registration_field_value(params = {}, options = {})
  req = build_request(:delete_registration_field_value, params)
  req.send_request(options)
end

#delete_text_message_spend_limit_override(params = {}) ⇒ Types::DeleteTextMessageSpendLimitOverrideResult

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 in the Amazon Pinpoint Developer Guide.

Examples:

Response structure


resp.monthly_limit #=> Integer

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Returns:

See Also:



1625
1626
1627
1628
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1625

def delete_text_message_spend_limit_override(params = {}, options = {})
  req = build_request(:delete_text_message_spend_limit_override, params)
  req.send_request(options)
end

#delete_verified_destination_number(params = {}) ⇒ Types::DeleteVerifiedDestinationNumberResult

Delete a verified destination phone number.

Examples:

Request syntax with placeholder values


resp = client.delete_verified_destination_number({
  verified_destination_number_id: "VerifiedDestinationNumberIdOrArn", # required
})

Response structure


resp.verified_destination_number_arn #=> String
resp.verified_destination_number_id #=> String
resp.destination_phone_number #=> String
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :verified_destination_number_id (required, String)

    The unique identifier for the verified destination phone number.

Returns:

See Also:



1659
1660
1661
1662
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1659

def delete_verified_destination_number(params = {}, options = {})
  req = build_request(:delete_verified_destination_number, params)
  req.send_request(options)
end

#delete_voice_message_spend_limit_override(params = {}) ⇒ Types::DeleteVoiceMessageSpendLimitOverrideResult

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 in the Amazon Pinpoint Developer Guide.

Examples:

Response structure


resp.monthly_limit #=> Integer

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Returns:

See Also:



1686
1687
1688
1689
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1686

def delete_voice_message_spend_limit_override(params = {}, options = {})
  req = build_request(:delete_voice_message_spend_limit_override, params)
  req.send_request(options)
end

#describe_account_attributes(params = {}) ⇒ Types::DescribeAccountAttributesResult

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.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.({
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp. #=> Array
resp.[0].name #=> String, one of "ACCOUNT_TIER"
resp.[0].value #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



1733
1734
1735
1736
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1733

def (params = {}, options = {})
  req = build_request(:describe_account_attributes, params)
  req.send_request(options)
end

#describe_account_limits(params = {}) ⇒ Types::DescribeAccountLimitsResult

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 in the Amazon Pinpoint Developer Guide.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.({
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp. #=> Array
resp.[0].name #=> String, one of "PHONE_NUMBERS", "POOLS", "CONFIGURATION_SETS", "OPT_OUT_LISTS", "SENDER_IDS", "REGISTRATIONS", "REGISTRATION_ATTACHMENTS", "VERIFIED_DESTINATION_NUMBERS"
resp.[0].used #=> Integer
resp.[0].max #=> Integer
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



1785
1786
1787
1788
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1785

def (params = {}, options = {})
  req = build_request(:describe_account_limits, params)
  req.send_request(options)
end

#describe_configuration_sets(params = {}) ⇒ Types::DescribeConfigurationSetsResult

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.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

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,
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_names (Array<String>)

    An array of strings. Each element can be either a ConfigurationSetName or ConfigurationSetArn.

  • :filters (Array<Types::ConfigurationSetFilter>)

    An array of filters to apply to the results that are returned.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



1861
1862
1863
1864
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1861

def describe_configuration_sets(params = {}, options = {})
  req = build_request(:describe_configuration_sets, params)
  req.send_request(options)
end

#describe_keywords(params = {}) ⇒ Types::DescribeKeywordsResult

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.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

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,
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :origination_identity (required, String)

    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.

  • :keywords (Array<String>)

    An array of keywords to search for.

  • :filters (Array<Types::KeywordFilter>)

    An array of keyword filters to filter the results.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



1936
1937
1938
1939
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1936

def describe_keywords(params = {}, options = {})
  req = build_request(:describe_keywords, params)
  req.send_request(options)
end

#describe_opt_out_lists(params = {}) ⇒ Types::DescribeOptOutListsResult

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.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.describe_opt_out_lists({
  opt_out_list_names: ["OptOutListNameOrArn"],
  next_token: "NextToken",
  max_results: 1,
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :opt_out_list_names (Array<String>)

    The OptOutLists to show the details of. This is an array of strings that can be either the OptOutListName or OptOutListArn.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



1991
1992
1993
1994
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 1991

def describe_opt_out_lists(params = {}, options = {})
  req = build_request(:describe_opt_out_lists, params)
  req.send_request(options)
end

#describe_opted_out_numbers(params = {}) ⇒ Types::DescribeOptedOutNumbersResult

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.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

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,
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :opt_out_list_name (required, String)

    The OptOutListName or OptOutListArn of the OptOutList. You can use DescribeOptOutLists to find the values for OptOutListName and OptOutListArn.

  • :opted_out_numbers (Array<String>)

    An array of phone numbers to search for in the OptOutList.

  • :filters (Array<Types::OptedOutFilter>)

    An array of OptedOutFilter objects to filter the results on.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2065
2066
2067
2068
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2065

def describe_opted_out_numbers(params = {}, options = {})
  req = build_request(:describe_opted_out_numbers, params)
  req.send_request(options)
end

#describe_phone_numbers(params = {}) ⇒ Types::DescribePhoneNumbersResult

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.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

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, two-way-channel-arn
      values: ["FilterValue"], # required
    },
  ],
  next_token: "NextToken",
  max_results: 1,
})

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", "SIMULATOR"
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].two_way_channel_role #=> 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].registration_id #=> String
resp.phone_numbers[0].created_timestamp #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :phone_number_ids (Array<String>)

    The unique identifier of phone numbers to find information about. This is an array of strings that can be either the PhoneNumberId or PhoneNumberArn.

  • :filters (Array<Types::PhoneNumberFilter>)

    An array of PhoneNumberFilter objects to filter the results.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2146
2147
2148
2149
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2146

def describe_phone_numbers(params = {}, options = {})
  req = build_request(:describe_phone_numbers, params)
  req.send_request(options)
end

#describe_pools(params = {}) ⇒ Types::DescribePoolsResult

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.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

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, two-way-channel-arn
      values: ["FilterValue"], # required
    },
  ],
  next_token: "NextToken",
  max_results: 1,
})

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].two_way_channel_role #=> 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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :pool_ids (Array<String>)

    The unique identifier of pools to find. This is an array of strings that can be either the PoolId or PoolArn.

  • :filters (Array<Types::PoolFilter>)

    An array of PoolFilter objects to filter the results.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2222
2223
2224
2225
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2222

def describe_pools(params = {}, options = {})
  req = build_request(:describe_pools, params)
  req.send_request(options)
end

#describe_registration_attachments(params = {}) ⇒ Types::DescribeRegistrationAttachmentsResult

Retrieves the specified registration attachments or all registration attachments associated with your Amazon Web Services account.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.describe_registration_attachments({
  registration_attachment_ids: ["RegistrationIdOrArn"],
  filters: [
    {
      name: "attachment-status", # required, accepts attachment-status
      values: ["FilterValue"], # required
    },
  ],
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.registration_attachments #=> Array
resp.registration_attachments[0].registration_attachment_arn #=> String
resp.registration_attachments[0].registration_attachment_id #=> String
resp.registration_attachments[0].attachment_status #=> String, one of "UPLOAD_IN_PROGRESS", "UPLOAD_COMPLETE", "UPLOAD_FAILED", "DELETED"
resp.registration_attachments[0].attachment_upload_error_reason #=> String, one of "INTERNAL_ERROR"
resp.registration_attachments[0].created_timestamp #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_attachment_ids (Array<String>)

    The unique identifier of registration attachments to find. This is an array of RegistrationAttachmentId.

  • :filters (Array<Types::RegistrationAttachmentFilter>)

    An array of RegistrationAttachmentFilter objects to filter the results.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2280
2281
2282
2283
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2280

def describe_registration_attachments(params = {}, options = {})
  req = build_request(:describe_registration_attachments, params)
  req.send_request(options)
end

#describe_registration_field_definitions(params = {}) ⇒ Types::DescribeRegistrationFieldDefinitionsResult

Retrieves the specified registration type field definitions. You can use DescribeRegistrationFieldDefinitions to view the requirements for creating, filling out, and submitting each registration type.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.describe_registration_field_definitions({
  registration_type: "RegistrationType", # required
  section_path: "SectionPath",
  field_paths: ["FieldPath"],
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.registration_type #=> String
resp.registration_field_definitions #=> Array
resp.registration_field_definitions[0].section_path #=> String
resp.registration_field_definitions[0].field_path #=> String
resp.registration_field_definitions[0].field_type #=> String, one of "SELECT", "TEXT", "ATTACHMENT"
resp.registration_field_definitions[0].field_requirement #=> String, one of "REQUIRED", "CONDITIONAL", "OPTIONAL"
resp.registration_field_definitions[0].select_validation.min_choices #=> Integer
resp.registration_field_definitions[0].select_validation.max_choices #=> Integer
resp.registration_field_definitions[0].select_validation.options #=> Array
resp.registration_field_definitions[0].select_validation.options[0] #=> String
resp.registration_field_definitions[0].text_validation.min_length #=> Integer
resp.registration_field_definitions[0].text_validation.max_length #=> Integer
resp.registration_field_definitions[0].text_validation.pattern #=> String
resp.registration_field_definitions[0].display_hints.title #=> String
resp.registration_field_definitions[0].display_hints.short_description #=> String
resp.registration_field_definitions[0].display_hints.long_description #=> String
resp.registration_field_definitions[0].display_hints.documentation_title #=> String
resp.registration_field_definitions[0].display_hints.documentation_link #=> String
resp.registration_field_definitions[0].display_hints.select_option_descriptions #=> Array
resp.registration_field_definitions[0].display_hints.select_option_descriptions[0].option #=> String
resp.registration_field_definitions[0].display_hints.select_option_descriptions[0].title #=> String
resp.registration_field_definitions[0].display_hints.select_option_descriptions[0].description #=> String
resp.registration_field_definitions[0].display_hints.text_validation_description #=> String
resp.registration_field_definitions[0].display_hints.example_text_value #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_type (required, String)

    The type of registration form. The list of RegistrationTypes can be found using the DescribeRegistrationTypeDefinitions action.

  • :section_path (String)

    The path to the section of the registration.

  • :field_paths (Array<String>)

    An array of paths to the registration form field.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2356
2357
2358
2359
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2356

def describe_registration_field_definitions(params = {}, options = {})
  req = build_request(:describe_registration_field_definitions, params)
  req.send_request(options)
end

#describe_registration_field_values(params = {}) ⇒ Types::DescribeRegistrationFieldValuesResult

Retrieves the specified registration field values.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.describe_registration_field_values({
  registration_id: "RegistrationIdOrArn", # required
  version_number: 1,
  section_path: "SectionPath",
  field_paths: ["FieldPath"],
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.version_number #=> Integer
resp.registration_field_values #=> Array
resp.registration_field_values[0].field_path #=> String
resp.registration_field_values[0].select_choices #=> Array
resp.registration_field_values[0].select_choices[0] #=> String
resp.registration_field_values[0].text_value #=> String
resp.registration_field_values[0].registration_attachment_id #=> String
resp.registration_field_values[0].denied_reason #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_id (required, String)

    The unique identifier for the registration.

  • :version_number (Integer)

    The version number of the registration.

  • :section_path (String)

    The path to the section of the registration.

  • :field_paths (Array<String>)

    An array of paths to the registration form field.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2421
2422
2423
2424
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2421

def describe_registration_field_values(params = {}, options = {})
  req = build_request(:describe_registration_field_values, params)
  req.send_request(options)
end

#describe_registration_section_definitions(params = {}) ⇒ Types::DescribeRegistrationSectionDefinitionsResult

Retrieves the specified registration section definitions. You can use DescribeRegistrationSectionDefinitions to view the requirements for creating, filling out, and submitting each registration type.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.describe_registration_section_definitions({
  registration_type: "RegistrationType", # required
  section_paths: ["SectionPath"],
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.registration_type #=> String
resp.registration_section_definitions #=> Array
resp.registration_section_definitions[0].section_path #=> String
resp.registration_section_definitions[0].display_hints.title #=> String
resp.registration_section_definitions[0].display_hints.short_description #=> String
resp.registration_section_definitions[0].display_hints.long_description #=> String
resp.registration_section_definitions[0].display_hints.documentation_title #=> String
resp.registration_section_definitions[0].display_hints.documentation_link #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_type (required, String)

    The type of registration form. The list of RegistrationTypes can be found using the DescribeRegistrationTypeDefinitions action.

  • :section_paths (Array<String>)

    An array of paths for the registration form section.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2477
2478
2479
2480
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2477

def describe_registration_section_definitions(params = {}, options = {})
  req = build_request(:describe_registration_section_definitions, params)
  req.send_request(options)
end

#describe_registration_type_definitions(params = {}) ⇒ Types::DescribeRegistrationTypeDefinitionsResult

Retrieves the specified registration type definitions. You can use DescribeRegistrationTypeDefinitions to view the requirements for creating, filling out, and submitting each registration type.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.describe_registration_type_definitions({
  registration_types: ["RegistrationType"],
  filters: [
    {
      name: "supported-association-resource-type", # required, accepts supported-association-resource-type, supported-association-iso-country-code
      values: ["FilterValue"], # required
    },
  ],
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.registration_type_definitions #=> Array
resp.registration_type_definitions[0].registration_type #=> String
resp.registration_type_definitions[0].supported_associations #=> Array
resp.registration_type_definitions[0].supported_associations[0].resource_type #=> String
resp.registration_type_definitions[0].supported_associations[0].iso_country_code #=> String
resp.registration_type_definitions[0].supported_associations[0].association_behavior #=> String, one of "ASSOCIATE_BEFORE_SUBMIT", "ASSOCIATE_ON_APPROVAL", "ASSOCIATE_AFTER_COMPLETE"
resp.registration_type_definitions[0].supported_associations[0].disassociation_behavior #=> String, one of "DISASSOCIATE_ALL_CLOSES_REGISTRATION", "DISASSOCIATE_ALL_ALLOWS_DELETE_REGISTRATION", "DELETE_REGISTRATION_DISASSOCIATES"
resp.registration_type_definitions[0].display_hints.title #=> String
resp.registration_type_definitions[0].display_hints.short_description #=> String
resp.registration_type_definitions[0].display_hints.long_description #=> String
resp.registration_type_definitions[0].display_hints.documentation_title #=> String
resp.registration_type_definitions[0].display_hints.documentation_link #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_types (Array<String>)

    The type of registration form. The list of RegistrationTypes can be found using the DescribeRegistrationTypeDefinitions action.

  • :filters (Array<Types::RegistrationTypeFilter>)

    An array of RegistrationFilter objects to filter the results.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2541
2542
2543
2544
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2541

def describe_registration_type_definitions(params = {}, options = {})
  req = build_request(:describe_registration_type_definitions, params)
  req.send_request(options)
end

#describe_registration_versions(params = {}) ⇒ Types::DescribeRegistrationVersionsResult

Retrieves the specified registration version.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.describe_registration_versions({
  registration_id: "RegistrationIdOrArn", # required
  version_numbers: [1],
  filters: [
    {
      name: "registration-version-status", # required, accepts registration-version-status
      values: ["FilterValue"], # required
    },
  ],
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.registration_versions #=> Array
resp.registration_versions[0].version_number #=> Integer
resp.registration_versions[0].registration_version_status #=> String, one of "DRAFT", "SUBMITTED", "REVIEWING", "APPROVED", "DISCARDED", "DENIED", "REVOKED", "ARCHIVED"
resp.registration_versions[0].registration_version_status_history.draft_timestamp #=> Time
resp.registration_versions[0].registration_version_status_history. #=> Time
resp.registration_versions[0].registration_version_status_history.reviewing_timestamp #=> Time
resp.registration_versions[0].registration_version_status_history.approved_timestamp #=> Time
resp.registration_versions[0].registration_version_status_history.discarded_timestamp #=> Time
resp.registration_versions[0].registration_version_status_history.denied_timestamp #=> Time
resp.registration_versions[0].registration_version_status_history.revoked_timestamp #=> Time
resp.registration_versions[0].registration_version_status_history.archived_timestamp #=> Time
resp.registration_versions[0].denied_reasons #=> Array
resp.registration_versions[0].denied_reasons[0].reason #=> String
resp.registration_versions[0].denied_reasons[0].short_description #=> String
resp.registration_versions[0].denied_reasons[0].long_description #=> String
resp.registration_versions[0].denied_reasons[0].documentation_title #=> String
resp.registration_versions[0].denied_reasons[0].documentation_link #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_id (required, String)

    The unique identifier for the registration.

  • :version_numbers (Array<Integer>)

    An array of registration version numbers.

  • :filters (Array<Types::RegistrationVersionFilter>)

    An array of RegistrationVersionFilter objects to filter the results.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2615
2616
2617
2618
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2615

def describe_registration_versions(params = {}, options = {})
  req = build_request(:describe_registration_versions, params)
  req.send_request(options)
end

#describe_registrations(params = {}) ⇒ Types::DescribeRegistrationsResult

Retrieves the specified registrations.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.describe_registrations({
  registration_ids: ["RegistrationIdOrArn"],
  filters: [
    {
      name: "registration-type", # required, accepts registration-type, registration-status
      values: ["FilterValue"], # required
    },
  ],
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.registrations #=> Array
resp.registrations[0].registration_arn #=> String
resp.registrations[0].registration_id #=> String
resp.registrations[0].registration_type #=> String
resp.registrations[0].registration_status #=> String, one of "CREATED", "SUBMITTED", "REVIEWING", "PROVISIONING", "COMPLETE", "REQUIRES_UPDATES", "CLOSED", "DELETED"
resp.registrations[0].current_version_number #=> Integer
resp.registrations[0].approved_version_number #=> Integer
resp.registrations[0].latest_denied_version_number #=> Integer
resp.registrations[0].additional_attributes #=> Hash
resp.registrations[0].additional_attributes["String"] #=> String
resp.registrations[0].created_timestamp #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_ids (Array<String>)

    An array of unique identifiers for each registration.

  • :filters (Array<Types::RegistrationFilter>)

    An array of RegistrationFilter objects to filter the results.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2675
2676
2677
2678
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2675

def describe_registrations(params = {}, options = {})
  req = build_request(:describe_registrations, params)
  req.send_request(options)
end

#describe_sender_ids(params = {}) ⇒ Types::DescribeSenderIdsResult

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.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

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, deletion-protection-enabled, registered
      values: ["FilterValue"], # required
    },
  ],
  next_token: "NextToken",
  max_results: 1,
})

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.sender_ids[0].deletion_protection_enabled #=> Boolean
resp.sender_ids[0].registered #=> Boolean
resp.sender_ids[0].registration_id #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :sender_ids (Array<Types::SenderIdAndCountry>)

    An array of SenderIdAndCountry objects to search for.

  • :filters (Array<Types::SenderIdFilter>)

    An array of SenderIdFilter objects to filter the results.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2748
2749
2750
2751
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2748

def describe_sender_ids(params = {}, options = {})
  req = build_request(:describe_sender_ids, params)
  req.send_request(options)
end

#describe_spend_limits(params = {}) ⇒ Types::DescribeSpendLimitsResult

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 in the Amazon Pinpoint User Guide.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.describe_spend_limits({
  next_token: "NextToken",
  max_results: 1,
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2800
2801
2802
2803
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2800

def describe_spend_limits(params = {}, options = {})
  req = build_request(:describe_spend_limits, params)
  req.send_request(options)
end

#describe_verified_destination_numbers(params = {}) ⇒ Types::DescribeVerifiedDestinationNumbersResult

Retrieves the specified verified destiona numbers.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.describe_verified_destination_numbers({
  verified_destination_number_ids: ["VerifiedDestinationNumberIdOrArn"],
  destination_phone_numbers: ["PhoneNumber"],
  filters: [
    {
      name: "status", # required, accepts status
      values: ["FilterValue"], # required
    },
  ],
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.verified_destination_numbers #=> Array
resp.verified_destination_numbers[0].verified_destination_number_arn #=> String
resp.verified_destination_numbers[0].verified_destination_number_id #=> String
resp.verified_destination_numbers[0].destination_phone_number #=> String
resp.verified_destination_numbers[0].status #=> String, one of "PENDING", "VERIFIED"
resp.verified_destination_numbers[0].created_timestamp #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :verified_destination_number_ids (Array<String>)

    An array of VerifiedDestinationNumberid to retreive.

  • :destination_phone_numbers (Array<String>)

    An array of verified destination phone number, in E.164 format.

  • :filters (Array<Types::VerifiedDestinationNumberFilter>)

    An array of VerifiedDestinationNumberFilter objects to filter the results.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



2860
2861
2862
2863
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2860

def describe_verified_destination_numbers(params = {}, options = {})
  req = build_request(:describe_verified_destination_numbers, params)
  req.send_request(options)
end

#disassociate_origination_identity(params = {}) ⇒ Types::DisassociateOriginationIdentityResult

Removes the specified origination identity from an existing pool.

If the origination identity isn't associated with the specified pool, an error is returned.

Examples:

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",
})

Response structure


resp.pool_arn #=> String
resp.pool_id #=> String
resp.origination_identity_arn #=> String
resp.origination_identity #=> String
resp.iso_country_code #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :pool_id (required, String)

    The unique identifier for the pool to disassociate with the origination identity. This value can be either the PoolId or PoolArn.

  • :origination_identity (required, String)

    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.

  • :iso_country_code (required, String)

    The two-character code, in ISO 3166-1 alpha-2 format, for the country or region.

  • :client_token (String)

    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.**

Returns:

See Also:



2923
2924
2925
2926
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2923

def disassociate_origination_identity(params = {}, options = {})
  req = build_request(:disassociate_origination_identity, params)
  req.send_request(options)
end

#discard_registration_version(params = {}) ⇒ Types::DiscardRegistrationVersionResult

Discard the current version of the registration.

Examples:

Request syntax with placeholder values


resp = client.discard_registration_version({
  registration_id: "RegistrationIdOrArn", # required
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.version_number #=> Integer
resp.registration_version_status #=> String, one of "DRAFT", "SUBMITTED", "REVIEWING", "APPROVED", "DISCARDED", "DENIED", "REVOKED", "ARCHIVED"
resp.registration_version_status_history.draft_timestamp #=> Time
resp.registration_version_status_history. #=> Time
resp.registration_version_status_history.reviewing_timestamp #=> Time
resp.registration_version_status_history.approved_timestamp #=> Time
resp.registration_version_status_history.discarded_timestamp #=> Time
resp.registration_version_status_history.denied_timestamp #=> Time
resp.registration_version_status_history.revoked_timestamp #=> Time
resp.registration_version_status_history.archived_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_id (required, String)

    The unique identifier for the registration.

Returns:

See Also:



2966
2967
2968
2969
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 2966

def discard_registration_version(params = {}, options = {})
  req = build_request(:discard_registration_version, params)
  req.send_request(options)
end

#list_pool_origination_identities(params = {}) ⇒ Types::ListPoolOriginationIdentitiesResult

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.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

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,
})

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.origination_identities[0].phone_number #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :pool_id (required, String)

    The unique identifier for the pool. This value can be either the PoolId or PoolArn.

  • :filters (Array<Types::PoolOriginationIdentitiesFilter>)

    An array of PoolOriginationIdentitiesFilter objects to filter the results..

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



3031
3032
3033
3034
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3031

def list_pool_origination_identities(params = {}, options = {})
  req = build_request(:list_pool_origination_identities, params)
  req.send_request(options)
end

#list_registration_associations(params = {}) ⇒ Types::ListRegistrationAssociationsResult

Retreive all of the origination identies that are associated with a registration.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_registration_associations({
  registration_id: "RegistrationIdOrArn", # required
  filters: [
    {
      name: "resource-type", # required, accepts resource-type, iso-country-code
      values: ["FilterValue"], # required
    },
  ],
  next_token: "NextToken",
  max_results: 1,
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.registration_type #=> String
resp.registration_associations #=> Array
resp.registration_associations[0].resource_arn #=> String
resp.registration_associations[0].resource_id #=> String
resp.registration_associations[0].resource_type #=> String
resp.registration_associations[0].iso_country_code #=> String
resp.registration_associations[0].phone_number #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_id (required, String)

    The unique identifier for the registration.

  • :filters (Array<Types::RegistrationAssociationFilter>)

    An array of RegistrationAssociationFilter to apply to the results that are returned.

  • :next_token (String)

    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.

  • :max_results (Integer)

    The maximum number of results to return per each request.

Returns:

See Also:



3094
3095
3096
3097
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3094

def list_registration_associations(params = {}, options = {})
  req = build_request(:list_registration_associations, params)
  req.send_request(options)
end

#list_tags_for_resource(params = {}) ⇒ Types::ListTagsForResourceResult

List all tags associated with a resource.

Examples:

Request syntax with placeholder values


resp = client.list_tags_for_resource({
  resource_arn: "AmazonResourceName", # required
})

Response structure


resp.resource_arn #=> String
resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the resource to query for.

Returns:

See Also:



3126
3127
3128
3129
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3126

def list_tags_for_resource(params = {}, options = {})
  req = build_request(:list_tags_for_resource, params)
  req.send_request(options)
end

#put_keyword(params = {}) ⇒ Types::PutKeywordResult

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.

Examples:

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
})

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"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :origination_identity (required, String)

    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.

  • :keyword (required, String)

    The new keyword to add.

  • :keyword_message (required, String)

    The message associated with the keyword.

  • :keyword_action (String)

    The action to perform for the new keyword when it is received.

    • 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.

Returns:

See Also:



3194
3195
3196
3197
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3194

def put_keyword(params = {}, options = {})
  req = build_request(:put_keyword, params)
  req.send_request(options)
end

#put_opted_out_number(params = {}) ⇒ Types::PutOptedOutNumberResult

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.

Examples:

Request syntax with placeholder values


resp = client.put_opted_out_number({
  opt_out_list_name: "OptOutListNameOrArn", # required
  opted_out_number: "PhoneNumber", # required
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :opt_out_list_name (required, String)

    The OptOutListName or OptOutListArn to add the phone number to.

  • :opted_out_number (required, String)

    The phone number to add to the OptOutList in E.164 format.

Returns:

See Also:



3237
3238
3239
3240
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3237

def put_opted_out_number(params = {}, options = {})
  req = build_request(:put_opted_out_number, params)
  req.send_request(options)
end

#put_registration_field_value(params = {}) ⇒ Types::PutRegistrationFieldValueResult

Creates or updates a field value for a registration.

Examples:

Request syntax with placeholder values


resp = client.put_registration_field_value({
  registration_id: "RegistrationIdOrArn", # required
  field_path: "FieldPath", # required
  select_choices: ["SelectChoice"],
  text_value: "TextValue",
  registration_attachment_id: "RegistrationAttachmentIdOrArn",
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.version_number #=> Integer
resp.field_path #=> String
resp.select_choices #=> Array
resp.select_choices[0] #=> String
resp.text_value #=> String
resp.registration_attachment_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_id (required, String)

    The unique identifier for the registration.

  • :field_path (required, String)

    The path to the registration form field. You can use DescribeRegistrationFieldDefinitions for a list of FieldPaths.

  • :select_choices (Array<String>)

    An array of values for the form field.

  • :text_value (String)

    The text data for a free form field.

  • :registration_attachment_id (String)

    The unique identifier for the registration attachment.

Returns:

See Also:



3295
3296
3297
3298
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3295

def put_registration_field_value(params = {}, options = {})
  req = build_request(:put_registration_field_value, params)
  req.send_request(options)
end

#release_phone_number(params = {}) ⇒ Types::ReleasePhoneNumberResult

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.

Examples:

Request syntax with placeholder values


resp = client.release_phone_number({
  phone_number_id: "PhoneNumberIdOrArn", # required
})

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", "SIMULATOR"
resp.monthly_leasing_price #=> String
resp.two_way_enabled #=> Boolean
resp.two_way_channel_arn #=> String
resp.two_way_channel_role #=> String
resp.self_managed_opt_outs_enabled #=> Boolean
resp.opt_out_list_name #=> String
resp.registration_id #=> String
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :phone_number_id (required, String)

    The PhoneNumberId or PhoneNumberArn of the phone number to release. You can use DescribePhoneNumbers to get the values for PhoneNumberId and PhoneNumberArn.

Returns:

See Also:



3360
3361
3362
3363
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3360

def release_phone_number(params = {}, options = {})
  req = build_request(:release_phone_number, params)
  req.send_request(options)
end

#release_sender_id(params = {}) ⇒ Types::ReleaseSenderIdResult

Releases an existing sender ID in your account.

Examples:

Request syntax with placeholder values


resp = client.release_sender_id({
  sender_id: "SenderIdOrArn", # required
  iso_country_code: "IsoCountryCode", # required
})

Response structure


resp.sender_id_arn #=> String
resp.sender_id #=> String
resp.iso_country_code #=> String
resp.message_types #=> Array
resp.message_types[0] #=> String, one of "TRANSACTIONAL", "PROMOTIONAL"
resp.monthly_leasing_price #=> String
resp.registered #=> Boolean
resp.registration_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :sender_id (required, String)

    The sender ID to release.

  • :iso_country_code (required, String)

    The two-character code, in ISO 3166-1 alpha-2 format, for the country or region.

Returns:

See Also:



3406
3407
3408
3409
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3406

def release_sender_id(params = {}, options = {})
  req = build_request(:release_sender_id, params)
  req.send_request(options)
end

#request_phone_number(params = {}) ⇒ Types::RequestPhoneNumberResult

Request an origination phone number for use in your account. For more information on phone number request see Requesting a number in the Amazon Pinpoint User Guide.

Examples:

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, SIMULATOR
  opt_out_list_name: "OptOutListNameOrArn",
  pool_id: "PoolIdOrArn",
  registration_id: "RegistrationIdOrArn",
  deletion_protection_enabled: false,
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
  client_token: "ClientToken",
})

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", "SIMULATOR"
resp.monthly_leasing_price #=> String
resp.two_way_enabled #=> Boolean
resp.two_way_channel_arn #=> String
resp.two_way_channel_role #=> String
resp.self_managed_opt_outs_enabled #=> Boolean
resp.opt_out_list_name #=> String
resp.deletion_protection_enabled #=> Boolean
resp.pool_id #=> String
resp.registration_id #=> String
resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :iso_country_code (required, String)

    The two-character code, in ISO 3166-1 alpha-2 format, for the country or region.

  • :message_type (required, String)

    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.

  • :number_capabilities (required, Array<String>)

    Indicates if the phone number will be used for text messages, voice messages, or both.

  • :number_type (required, String)

    The type of phone number to request.

  • :opt_out_list_name (String)

    The name of the OptOutList to associate with the phone number. You can use the OptOutListName or OptOutListArn.

  • :pool_id (String)

    The pool to associated with the phone number. You can use the PoolId or PoolArn.

  • :registration_id (String)

    Use this field to attach your phone number for an external registration process.

  • :deletion_protection_enabled (Boolean)

    By default this is set to false. When set to true the phone number can't be deleted.

  • :tags (Array<Types::Tag>)

    An array of tags (key and value pairs) associate with the requested phone number.

  • :client_token (String)

    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.**

Returns:

See Also:



3535
3536
3537
3538
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3535

def request_phone_number(params = {}, options = {})
  req = build_request(:request_phone_number, params)
  req.send_request(options)
end

#request_sender_id(params = {}) ⇒ Types::RequestSenderIdResult

Request a new sender ID that doesn't require registration.

Examples:

Request syntax with placeholder values


resp = client.request_sender_id({
  sender_id: "SenderId", # required
  iso_country_code: "IsoCountryCode", # required
  message_types: ["TRANSACTIONAL"], # accepts TRANSACTIONAL, PROMOTIONAL
  deletion_protection_enabled: false,
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
  client_token: "ClientToken",
})

Response structure


resp.sender_id_arn #=> String
resp.sender_id #=> String
resp.iso_country_code #=> String
resp.message_types #=> Array
resp.message_types[0] #=> String, one of "TRANSACTIONAL", "PROMOTIONAL"
resp.monthly_leasing_price #=> String
resp.deletion_protection_enabled #=> Boolean
resp.registered #=> Boolean
resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :sender_id (required, String)

    The sender ID string to request.

  • :iso_country_code (required, String)

    The two-character code, in ISO 3166-1 alpha-2 format, for the country or region.

  • :message_types (Array<String>)

    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.

  • :deletion_protection_enabled (Boolean)

    By default this is set to false. When set to true the sender ID can't be deleted.

  • :tags (Array<Types::Tag>)

    An array of tags (key and value pairs) to associate with the sender ID.

  • :client_token (String)

    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.**

Returns:

See Also:



3616
3617
3618
3619
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3616

def request_sender_id(params = {}, options = {})
  req = build_request(:request_sender_id, params)
  req.send_request(options)
end

#send_destination_number_verification_code(params = {}) ⇒ Types::SendDestinationNumberVerificationCodeResult

Before you can send test messages to a verified destination phone number you need to opt-in the verified destination phone number. Creates a new text message with a verification code and send it to a verified destination phone number. Once you have the verification code use VerifyDestinationNumber to opt-in the verified destination phone number to receive messages.

Examples:

Request syntax with placeholder values


resp = client.send_destination_number_verification_code({
  verified_destination_number_id: "VerifiedDestinationNumberIdOrArn", # required
  verification_channel: "TEXT", # required, accepts TEXT, VOICE
  language_code: "DE_DE", # accepts DE_DE, EN_GB, EN_US, ES_419, ES_ES, FR_CA, FR_FR, IT_IT, JA_JP, KO_KR, PT_BR, ZH_CN, ZH_TW
  origination_identity: "VerificationMessageOriginationIdentity",
  configuration_set_name: "ConfigurationSetNameOrArn",
  context: {
    "ContextKey" => "ContextValue",
  },
  destination_country_parameters: {
    "IN_TEMPLATE_ID" => "DestinationCountryParameterValue",
  },
})

Response structure


resp.message_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :verified_destination_number_id (required, String)

    The unique identifier for the verified destination phone number.

  • :verification_channel (required, String)

    Choose to send the verification code as an SMS or voice message.

  • :language_code (String)

    Choose the language to use for the message.

  • :origination_identity (String)

    The origination identity of the message. This can be either the PhoneNumber, PhoneNumberId, PhoneNumberArn, SenderId, SenderIdArn, PoolId, or PoolArn.

  • :configuration_set_name (String)

    The name of the configuration set to use. This can be either the ConfigurationSetName or ConfigurationSetArn.

  • :context (Hash<String,String>)

    You can specify custom data in this field. If you do, that data is logged to the event destination.

  • :destination_country_parameters (Hash<String,String>)

    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.

Returns:

See Also:



3689
3690
3691
3692
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3689

def send_destination_number_verification_code(params = {}, options = {})
  req = build_request(:send_destination_number_verification_code, params)
  req.send_request(options)
end

#send_text_message(params = {}) ⇒ Types::SendTextMessageResult

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 in the Amazon Pinpoint User Guide.

Examples:

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,
})

Response structure


resp.message_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :destination_phone_number (required, String)

    The destination phone number in E.164 format.

  • :origination_identity (String)

    The origination identity of the message. This can be either the PhoneNumber, PhoneNumberId, PhoneNumberArn, SenderId, SenderIdArn, PoolId, or PoolArn.

  • :message_body (String)

    The body of the text message.

  • :message_type (String)

    The type of message. Valid values are for messages that are critical or time-sensitive and PROMOTIONAL for messages that aren't critical or time-sensitive.

  • :keyword (String)

    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.

  • :configuration_set_name (String)

    The name of the configuration set to use. This can be either the ConfigurationSetName or ConfigurationSetArn.

  • :max_price (String)

    The maximum amount that you want to spend, in US dollars, per each text message part. A text message can contain multiple parts.

  • :time_to_live (Integer)

    How long the text message is valid for. By default this is 72 hours.

  • :context (Hash<String,String>)

    You can specify custom data in this field. If you do, that data is logged to the event destination.

  • :destination_country_parameters (Hash<String,String>)

    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.

  • :dry_run (Boolean)

    When set to true, the message is checked and validated, but isn't sent to the end recipient.

Returns:

See Also:



3789
3790
3791
3792
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3789

def send_text_message(params = {}, options = {})
  req = build_request(:send_text_message, params)
  req.send_request(options)
end

#send_voice_message(params = {}) ⇒ Types::SendVoiceMessageResult

Allows you to send a request that sends a voice message through Amazon Pinpoint. This operation uses Amazon Polly to convert a text script into a voice message.

Examples:

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,
})

Response structure


resp.message_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :destination_phone_number (required, String)

    The destination phone number in E.164 format.

  • :origination_identity (required, String)

    The origination identity to use for the voice call. This can be the PhoneNumber, PhoneNumberId, PhoneNumberArn, PoolId, or PoolArn.

  • :message_body (String)

    The text to convert to a voice message.

  • :message_body_text_type (String)

    Specifies if the MessageBody field contains text or speech synthesis markup language (SSML).

    • 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.

  • :voice_id (String)

    The voice for the Amazon Polly service to use. By default this is set to "MATTHEW".

  • :configuration_set_name (String)

    The name of the configuration set to use. This can be either the ConfigurationSetName or ConfigurationSetArn.

  • :max_price_per_minute (String)

    The maximum amount to spend per voice message, in US dollars.

  • :time_to_live (Integer)

    How long the voice message is valid for. By default this is 72 hours.

  • :context (Hash<String,String>)

    You can specify custom data in this field. If you do, that data is logged to the event destination.

  • :dry_run (Boolean)

    When set to true, the message is checked and validated, but isn't sent to the end recipient.

Returns:

See Also:



3881
3882
3883
3884
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3881

def send_voice_message(params = {}, options = {})
  req = build_request(:send_voice_message, params)
  req.send_request(options)
end

#set_default_message_type(params = {}) ⇒ Types::SetDefaultMessageTypeResult

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.

Examples:

Request syntax with placeholder values


resp = client.set_default_message_type({
  configuration_set_name: "ConfigurationSetNameOrArn", # required
  message_type: "TRANSACTIONAL", # required, accepts TRANSACTIONAL, PROMOTIONAL
})

Response structure


resp.configuration_set_arn #=> String
resp.configuration_set_name #=> String
resp.message_type #=> String, one of "TRANSACTIONAL", "PROMOTIONAL"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The configuration set to update with a new default message type. This field can be the ConsigurationSetName or ConfigurationSetArn.

  • :message_type (required, String)

    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.

Returns:

See Also:



3927
3928
3929
3930
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3927

def set_default_message_type(params = {}, options = {})
  req = build_request(:set_default_message_type, params)
  req.send_request(options)
end

#set_default_sender_id(params = {}) ⇒ Types::SetDefaultSenderIdResult

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.

Examples:

Request syntax with placeholder values


resp = client.set_default_sender_id({
  configuration_set_name: "ConfigurationSetNameOrArn", # required
  sender_id: "SenderId", # required
})

Response structure


resp.configuration_set_arn #=> String
resp.configuration_set_name #=> String
resp.sender_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The configuration set to updated with a new default SenderId. This field can be the ConsigurationSetName or ConfigurationSetArn.

  • :sender_id (required, String)

    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'.

Returns:

See Also:



3974
3975
3976
3977
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 3974

def set_default_sender_id(params = {}, options = {})
  req = build_request(:set_default_sender_id, params)
  req.send_request(options)
end

#set_text_message_spend_limit_override(params = {}) ⇒ Types::SetTextMessageSpendLimitOverrideResult

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.

Examples:

Request syntax with placeholder values


resp = client.set_text_message_spend_limit_override({
  monthly_limit: 1, # required
})

Response structure


resp.monthly_limit #=> Integer

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :monthly_limit (required, Integer)

    The new monthly limit to enforce on text messages.

Returns:

See Also:



4004
4005
4006
4007
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 4004

def set_text_message_spend_limit_override(params = {}, options = {})
  req = build_request(:set_text_message_spend_limit_override, params)
  req.send_request(options)
end

#set_voice_message_spend_limit_override(params = {}) ⇒ Types::SetVoiceMessageSpendLimitOverrideResult

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.

Examples:

Request syntax with placeholder values


resp = client.set_voice_message_spend_limit_override({
  monthly_limit: 1, # required
})

Response structure


resp.monthly_limit #=> Integer

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :monthly_limit (required, Integer)

    The new monthly limit to enforce on voice messages.

Returns:

See Also:



4034
4035
4036
4037
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 4034

def set_voice_message_spend_limit_override(params = {}, options = {})
  req = build_request(:set_voice_message_spend_limit_override, params)
  req.send_request(options)
end

#submit_registration_version(params = {}) ⇒ Types::SubmitRegistrationVersionResult

Submit the specified registration for review and approval.

Examples:

Request syntax with placeholder values


resp = client.submit_registration_version({
  registration_id: "RegistrationIdOrArn", # required
})

Response structure


resp.registration_arn #=> String
resp.registration_id #=> String
resp.version_number #=> Integer
resp.registration_version_status #=> String, one of "DRAFT", "SUBMITTED", "REVIEWING", "APPROVED", "DISCARDED", "DENIED", "REVOKED", "ARCHIVED"
resp.registration_version_status_history.draft_timestamp #=> Time
resp.registration_version_status_history. #=> Time
resp.registration_version_status_history.reviewing_timestamp #=> Time
resp.registration_version_status_history.approved_timestamp #=> Time
resp.registration_version_status_history.discarded_timestamp #=> Time
resp.registration_version_status_history.denied_timestamp #=> Time
resp.registration_version_status_history.revoked_timestamp #=> Time
resp.registration_version_status_history.archived_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :registration_id (required, String)

    The unique identifier for the registration.

Returns:

See Also:



4077
4078
4079
4080
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 4077

def submit_registration_version(params = {}, options = {})
  req = build_request(:submit_registration_version, params)
  req.send_request(options)
end

#tag_resource(params = {}) ⇒ Struct

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 in the Amazon Pinpoint Developer Guide.

Examples:

Request syntax with placeholder values


resp = client.tag_resource({
  resource_arn: "AmazonResourceName", # required
  tags: [ # required
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the resource.

  • :tags (required, Array<Types::Tag>)

    An array of key and value pair tags that are associated with the resource.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



4119
4120
4121
4122
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 4119

def tag_resource(params = {}, options = {})
  req = build_request(:tag_resource, params)
  req.send_request(options)
end

#untag_resource(params = {}) ⇒ Struct

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 in the Amazon Pinpoint Developer Guide.

Examples:

Request syntax with placeholder values


resp = client.untag_resource({
  resource_arn: "AmazonResourceName", # required
  tag_keys: ["TagKey"], # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the resource.

  • :tag_keys (required, Array<String>)

    An array of tag key values to unassociate with the resource.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



4152
4153
4154
4155
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 4152

def untag_resource(params = {}, options = {})
  req = build_request(:untag_resource, params)
  req.send_request(options)
end

#update_event_destination(params = {}) ⇒ Types::UpdateEventDestinationResult

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.

Examples:

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
  },
})

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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The configuration set to update with the new event destination. Valid values for this can be the ConfigurationSetName or ConfigurationSetArn.

  • :event_destination_name (required, String)

    The name to use for the event destination.

  • :enabled (Boolean)

    When set to true logging is enabled.

  • :matching_event_types (Array<String>)

    An array of event types that determine which events to log.

    The TEXT_SENT event type is not supported.

  • :cloud_watch_logs_destination (Types::CloudWatchLogsDestination)

    An object that contains information about an event destination that sends data to CloudWatch Logs.

  • :kinesis_firehose_destination (Types::KinesisFirehoseDestination)

    An object that contains information about an event destination for logging to Kinesis Data Firehose.

  • :sns_destination (Types::SnsDestination)

    An object that contains information about an event destination that sends data to Amazon SNS.

Returns:

See Also:



4240
4241
4242
4243
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 4240

def update_event_destination(params = {}, options = {})
  req = build_request(:update_event_destination, params)
  req.send_request(options)
end

#update_phone_number(params = {}) ⇒ Types::UpdatePhoneNumberResult

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.

Examples:

Request syntax with placeholder values


resp = client.update_phone_number({
  phone_number_id: "PhoneNumberIdOrArn", # required
  two_way_enabled: false,
  two_way_channel_arn: "TwoWayChannelArn",
  two_way_channel_role: "IamRoleArn",
  self_managed_opt_outs_enabled: false,
  opt_out_list_name: "OptOutListNameOrArn",
  deletion_protection_enabled: false,
})

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", "SIMULATOR"
resp.monthly_leasing_price #=> String
resp.two_way_enabled #=> Boolean
resp.two_way_channel_arn #=> String
resp.two_way_channel_role #=> String
resp.self_managed_opt_outs_enabled #=> Boolean
resp.opt_out_list_name #=> String
resp.deletion_protection_enabled #=> Boolean
resp.registration_id #=> String
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :phone_number_id (required, String)

    The unique identifier of the phone number. Valid values for this field can be either the PhoneNumberId or PhoneNumberArn.

  • :two_way_enabled (Boolean)

    By default this is set to false. When set to true you can receive incoming text messages from your end recipients.

  • :two_way_channel_arn (String)

    The Amazon Resource Name (ARN) of the two way channel.

  • :two_way_channel_role (String)

    An optional IAM Role Arn for a service to assume, to be able to post inbound SMS messages.

  • :self_managed_opt_outs_enabled (Boolean)

    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.

  • :opt_out_list_name (String)

    The OptOutList to add the phone number to. Valid values for this field can be either the OutOutListName or OutOutListArn.

  • :deletion_protection_enabled (Boolean)

    By default this is set to false. When set to true the phone number can't be deleted.

Returns:

See Also:



4341
4342
4343
4344
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 4341

def update_phone_number(params = {}, options = {})
  req = build_request(:update_phone_number, params)
  req.send_request(options)
end

#update_pool(params = {}) ⇒ Types::UpdatePoolResult

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.

Examples:

Request syntax with placeholder values


resp = client.update_pool({
  pool_id: "PoolIdOrArn", # required
  two_way_enabled: false,
  two_way_channel_arn: "TwoWayChannelArn",
  two_way_channel_role: "IamRoleArn",
  self_managed_opt_outs_enabled: false,
  opt_out_list_name: "OptOutListNameOrArn",
  shared_routes_enabled: false,
  deletion_protection_enabled: false,
})

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.two_way_channel_role #=> 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

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :pool_id (required, String)

    The unique identifier of the pool to update. Valid values are either the PoolId or PoolArn.

  • :two_way_enabled (Boolean)

    By default this is set to false. When set to true you can receive incoming text messages from your end recipients.

  • :two_way_channel_arn (String)

    The Amazon Resource Name (ARN) of the two way channel.

  • :two_way_channel_role (String)

    An optional IAM Role Arn for a service to assume, to be able to post inbound SMS messages.

  • :self_managed_opt_outs_enabled (Boolean)

    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.

  • :opt_out_list_name (String)

    The OptOutList to associate with the pool. Valid values are either OptOutListName or OptOutListArn.

  • :shared_routes_enabled (Boolean)

    Indicates whether shared routes are enabled for the pool.

  • :deletion_protection_enabled (Boolean)

    When set to true the pool can't be deleted.

Returns:

See Also:



4431
4432
4433
4434
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 4431

def update_pool(params = {}, options = {})
  req = build_request(:update_pool, params)
  req.send_request(options)
end

#update_sender_id(params = {}) ⇒ Types::UpdateSenderIdResult

Updates the configuration of an existing sender ID.

Examples:

Request syntax with placeholder values


resp = client.update_sender_id({
  sender_id: "SenderIdOrArn", # required
  iso_country_code: "IsoCountryCode", # required
  deletion_protection_enabled: false,
})

Response structure


resp.sender_id_arn #=> String
resp.sender_id #=> String
resp.iso_country_code #=> String
resp.message_types #=> Array
resp.message_types[0] #=> String, one of "TRANSACTIONAL", "PROMOTIONAL"
resp.monthly_leasing_price #=> String
resp.deletion_protection_enabled #=> Boolean
resp.registered #=> Boolean
resp.registration_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :sender_id (required, String)

    The sender ID to update.

  • :iso_country_code (required, String)

    The two-character code, in ISO 3166-1 alpha-2 format, for the country or region.

  • :deletion_protection_enabled (Boolean)

    By default this is set to false. When set to true the sender ID can't be deleted.

Returns:

See Also:



4484
4485
4486
4487
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 4484

def update_sender_id(params = {}, options = {})
  req = build_request(:update_sender_id, params)
  req.send_request(options)
end

#verify_destination_number(params = {}) ⇒ Types::VerifyDestinationNumberResult

Use the verification code that was received by the verified destination phone number to opt-in the verified destination phone number to receive more messages.

Examples:

Request syntax with placeholder values


resp = client.verify_destination_number({
  verified_destination_number_id: "VerifiedDestinationNumberIdOrArn", # required
  verification_code: "VerificationCode", # required
})

Response structure


resp.verified_destination_number_arn #=> String
resp.verified_destination_number_id #=> String
resp.destination_phone_number #=> String
resp.status #=> String, one of "PENDING", "VERIFIED"
resp.created_timestamp #=> Time

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :verified_destination_number_id (required, String)

    The unique identifier for the verififed destination phone number.

  • :verification_code (required, String)

    The verification code that was received by the verified destination phone number.

Returns:

See Also:



4527
4528
4529
4530
# File 'gems/aws-sdk-pinpointsmsvoicev2/lib/aws-sdk-pinpointsmsvoicev2/client.rb', line 4527

def verify_destination_number(params = {}, options = {})
  req = build_request(:verify_destination_number, params)
  req.send_request(options)
end