# frozen_string_literal: true

# WARNING ABOUT GENERATED CODE
#
# This file is generated. See the contributing guide for more information:
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
#
# WARNING ABOUT GENERATED CODE

require 'seahorse/client/plugins/content_length'
require 'aws-sdk-core/plugins/credentials_configuration'
require 'aws-sdk-core/plugins/logging'
require 'aws-sdk-core/plugins/param_converter'
require 'aws-sdk-core/plugins/param_validator'
require 'aws-sdk-core/plugins/user_agent'
require 'aws-sdk-core/plugins/helpful_socket_errors'
require 'aws-sdk-core/plugins/retry_errors'
require 'aws-sdk-core/plugins/global_configuration'
require 'aws-sdk-core/plugins/regional_endpoint'
require 'aws-sdk-core/plugins/endpoint_discovery'
require 'aws-sdk-core/plugins/endpoint_pattern'
require 'aws-sdk-core/plugins/response_paging'
require 'aws-sdk-core/plugins/stub_responses'
require 'aws-sdk-core/plugins/idempotency_token'
require 'aws-sdk-core/plugins/invocation_id'
require 'aws-sdk-core/plugins/jsonvalue_converter'
require 'aws-sdk-core/plugins/client_metrics_plugin'
require 'aws-sdk-core/plugins/client_metrics_send_plugin'
require 'aws-sdk-core/plugins/transfer_encoding'
require 'aws-sdk-core/plugins/http_checksum'
require 'aws-sdk-core/plugins/checksum_algorithm'
require 'aws-sdk-core/plugins/request_compression'
require 'aws-sdk-core/plugins/defaults_mode'
require 'aws-sdk-core/plugins/recursion_detection'
require 'aws-sdk-core/plugins/telemetry'
require 'aws-sdk-core/plugins/sign'
require 'aws-sdk-core/plugins/protocols/rest_xml'
require 'aws-sdk-route53/plugins/id_fix'

module Aws::Route53
  # An API client for Route53.  To construct a client, you need to configure a `:region` and `:credentials`.
  #
  #     client = Aws::Route53::Client.new(
  #       region: region_name,
  #       credentials: credentials,
  #       # ...
  #     )
  #
  # For details on configuring region and credentials see
  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
  #
  # See {#initialize} for a full list of supported configuration options.
  class Client < Seahorse::Client::Base

    include Aws::ClientStubs

    @identifier = :route53

    set_api(ClientApi::API)

    add_plugin(Seahorse::Client::Plugins::ContentLength)
    add_plugin(Aws::Plugins::CredentialsConfiguration)
    add_plugin(Aws::Plugins::Logging)
    add_plugin(Aws::Plugins::ParamConverter)
    add_plugin(Aws::Plugins::ParamValidator)
    add_plugin(Aws::Plugins::UserAgent)
    add_plugin(Aws::Plugins::HelpfulSocketErrors)
    add_plugin(Aws::Plugins::RetryErrors)
    add_plugin(Aws::Plugins::GlobalConfiguration)
    add_plugin(Aws::Plugins::RegionalEndpoint)
    add_plugin(Aws::Plugins::EndpointDiscovery)
    add_plugin(Aws::Plugins::EndpointPattern)
    add_plugin(Aws::Plugins::ResponsePaging)
    add_plugin(Aws::Plugins::StubResponses)
    add_plugin(Aws::Plugins::IdempotencyToken)
    add_plugin(Aws::Plugins::InvocationId)
    add_plugin(Aws::Plugins::JsonvalueConverter)
    add_plugin(Aws::Plugins::ClientMetricsPlugin)
    add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
    add_plugin(Aws::Plugins::TransferEncoding)
    add_plugin(Aws::Plugins::HttpChecksum)
    add_plugin(Aws::Plugins::ChecksumAlgorithm)
    add_plugin(Aws::Plugins::RequestCompression)
    add_plugin(Aws::Plugins::DefaultsMode)
    add_plugin(Aws::Plugins::RecursionDetection)
    add_plugin(Aws::Plugins::Telemetry)
    add_plugin(Aws::Plugins::Sign)
    add_plugin(Aws::Plugins::Protocols::RestXml)
    add_plugin(Aws::Route53::Plugins::IdFix)
    add_plugin(Aws::Route53::Plugins::Endpoints)

    # @overload initialize(options)
    #   @param [Hash] options
    #
    #   @option options [Array<Seahorse::Client::Plugin>] :plugins ([]])
    #     A list of plugins to apply to the client. Each plugin is either a
    #     class name or an instance of a plugin class.
    #
    #   @option options [required, Aws::CredentialProvider] :credentials
    #     Your AWS credentials used for authentication. This can be any class that includes and implements
    #     `Aws::CredentialProvider`, or 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`, `:session_token`, and
    #       `:account_id` options.
    #
    #     * `ENV['AWS_ACCESS_KEY_ID']`, `ENV['AWS_SECRET_ACCESS_KEY']`,
    #       `ENV['AWS_SESSION_TOKEN']`, and `ENV['AWS_ACCOUNT_ID']`.
    #
    #     * `~/.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::InstanceProfileCredentials` or `Aws::ECSCredentials` to
    #       enable retries and extended timeouts. Instance profile credential fetching can be disabled by
    #       setting `ENV['AWS_EC2_METADATA_DISABLED']` to `true`.
    #
    #   @option options [required, String] :region
    #     The AWS region to connect to.  The configured `:region` is
    #     used to determine the service `:endpoint`. When not passed,
    #     a default `:region` is searched for in the following locations:
    #
    #     * `Aws.config[:region]`
    #     * `ENV['AWS_REGION']`
    #     * `ENV['AMAZON_REGION']`
    #     * `ENV['AWS_DEFAULT_REGION']`
    #     * `~/.aws/credentials`
    #     * `~/.aws/config`
    #
    #   @option options [String] :access_key_id
    #
    #   @option options [String] :account_id
    #
    #   @option options [Boolean] :active_endpoint_cache (false)
    #     When set to `true`, a thread polling for endpoints will be running in
    #     the background every 60 secs (default). Defaults to `false`.
    #
    #   @option options [Boolean] :adaptive_retry_wait_to_fill (true)
    #     Used only in `adaptive` retry mode.  When true, the request will sleep
    #     until there is sufficent client side capacity to retry the request.
    #     When false, the request will raise a `RetryCapacityNotAvailableError` and will
    #     not retry instead of sleeping.
    #
    #   @option options [Array<String>] :auth_scheme_preference
    #     A list of preferred authentication schemes to use when making a request. Supported values are:
    #     `sigv4`, `sigv4a`, `httpBearerAuth`, and `noAuth`. When set using `ENV['AWS_AUTH_SCHEME_PREFERENCE']` or in
    #     shared config as `auth_scheme_preference`, the value should be a comma-separated list.
    #
    #   @option options [Boolean] :client_side_monitoring (false)
    #     When `true`, client-side metrics will be collected for all API requests from
    #     this client.
    #
    #   @option options [String] :client_side_monitoring_client_id ("")
    #     Allows you to provide an identifier for this client which will be attached to
    #     all generated client side metrics. Defaults to an empty string.
    #
    #   @option options [String] :client_side_monitoring_host ("127.0.0.1")
    #     Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client
    #     side monitoring agent is running on, where client metrics will be published via UDP.
    #
    #   @option options [Integer] :client_side_monitoring_port (31000)
    #     Required for publishing client metrics. The port that the client side monitoring
    #     agent is running on, where client metrics will be published via UDP.
    #
    #   @option options [Aws::ClientSideMonitoring::Publisher] :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher)
    #     Allows you to provide a custom client-side monitoring publisher class. By default,
    #     will use the Client Side Monitoring Agent Publisher.
    #
    #   @option options [Boolean] :convert_params (true)
    #     When `true`, an attempt is made to coerce request parameters into
    #     the required types.
    #
    #   @option options [Boolean] :correct_clock_skew (true)
    #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
    #     a clock skew correction and retry requests with skewed client clocks.
    #
    #   @option options [String] :defaults_mode ("legacy")
    #     See {Aws::DefaultsModeConfiguration} for a list of the
    #     accepted modes and the configuration defaults that are included.
    #
    #   @option options [Boolean] :disable_host_prefix_injection (false)
    #     When `true`, the SDK will not prepend the modeled host prefix to the endpoint.
    #
    #   @option options [Boolean] :disable_request_compression (false)
    #     When set to 'true' the request body will not be compressed
    #     for supported operations.
    #
    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
    #     Normally you should not configure the `:endpoint` option
    #     directly. This is normally constructed from the `:region`
    #     option. Configuring `:endpoint` is normally reserved for
    #     connecting to test or custom endpoints. The endpoint should
    #     be a URI formatted like:
    #
    #         'http://example.com'
    #         'https://example.com'
    #         'http://example.com:123'
    #
    #   @option options [Integer] :endpoint_cache_max_entries (1000)
    #     Used for the maximum size limit of the LRU cache storing endpoints data
    #     for endpoint discovery enabled operations. Defaults to 1000.
    #
    #   @option options [Integer] :endpoint_cache_max_threads (10)
    #     Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.
    #
    #   @option options [Integer] :endpoint_cache_poll_interval (60)
    #     When :endpoint_discovery and :active_endpoint_cache is enabled,
    #     Use this option to config the time interval in seconds for making
    #     requests fetching endpoints information. Defaults to 60 sec.
    #
    #   @option options [Boolean] :endpoint_discovery (false)
    #     When set to `true`, endpoint discovery will be enabled for operations when available.
    #
    #   @option options [Boolean] :ignore_configured_endpoint_urls
    #     Setting to true disables use of endpoint URLs provided via environment
    #     variables and the shared configuration file.
    #
    #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
    #     The log formatter.
    #
    #   @option options [Symbol] :log_level (:info)
    #     The log level to send messages to the `:logger` at.
    #
    #   @option options [Logger] :logger
    #     The Logger instance to send log messages to.  If this option
    #     is not set, logging will be disabled.
    #
    #   @option options [Integer] :max_attempts (3)
    #     An integer representing the maximum number attempts that will be made for
    #     a single request, including the initial attempt.  For example,
    #     setting this value to 5 will result in a request being retried up to
    #     4 times. Used in `standard` and `adaptive` retry modes.
    #
    #   @option options [String] :profile ("default")
    #     Used when loading credentials from the shared credentials file at `HOME/.aws/credentials`.
    #     When not specified, 'default' is used.
    #
    #   @option options [String] :request_checksum_calculation ("when_supported")
    #     Determines when a checksum will be calculated for request payloads. Values are:
    #
    #     * `when_supported` - (default) When set, a checksum will be
    #       calculated for all request payloads of operations modeled with the
    #       `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
    #       `requestAlgorithmMember` is modeled.
    #     * `when_required` - When set, a checksum will only be calculated for
    #       request payloads of operations modeled with the  `httpChecksum` trait where
    #       `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
    #       is modeled and supplied.
    #
    #   @option options [Integer] :request_min_compression_size_bytes (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.
    #
    #   @option options [String] :response_checksum_validation ("when_supported")
    #     Determines when checksum validation will be performed on response payloads. Values are:
    #
    #     * `when_supported` - (default) When set, checksum validation is performed on all
    #       response payloads of operations modeled with the `httpChecksum` trait where
    #       `responseAlgorithms` is modeled, except when no modeled checksum algorithms
    #       are supported.
    #     * `when_required` - When set, checksum validation is not performed on
    #       response payloads of operations unless the checksum algorithm is supported and
    #       the `requestValidationModeMember` member is set to `ENABLED`.
    #
    #   @option options [Proc] :retry_backoff
    #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
    #     This option is only used in the `legacy` retry mode.
    #
    #   @option options [Float] :retry_base_delay (0.3)
    #     The base delay in seconds used by the default backoff function. This option
    #     is only used in the `legacy` retry mode.
    #
    #   @option options [Symbol] :retry_jitter (:none)
    #     A delay randomiser function used by the default backoff function.
    #     Some predefined functions can be referenced by name - :none, :equal, :full,
    #     otherwise a Proc that takes and returns a number. This option is only used
    #     in the `legacy` retry mode.
    #
    #     @see https://www.awsarchitectureblog.com/2015/03/backoff.html
    #
    #   @option options [Integer] :retry_limit (3)
    #     The maximum number of times to retry failed requests.  Only
    #     ~ 500 level server errors and certain ~ 400 level client errors
    #     are retried.  Generally, these are throttling errors, data
    #     checksum errors, networking errors, timeout errors, auth errors,
    #     endpoint discovery, and errors from expired credentials.
    #     This option is only used in the `legacy` retry mode.
    #
    #   @option options [Integer] :retry_max_delay (0)
    #     The maximum number of seconds to delay between retries (0 for no limit)
    #     used by the default backoff function. This option is only used in the
    #     `legacy` retry mode.
    #
    #   @option options [String] :retry_mode ("legacy")
    #     Specifies which retry algorithm to use. Values are:
    #
    #     * `legacy` - The pre-existing retry behavior.  This is default value if
    #       no retry mode is provided.
    #
    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
    #       This includes support for retry quotas, which limit the number of
    #       unsuccessful retries a client can make.
    #
    #     * `adaptive` - An experimental retry mode that includes all the
    #       functionality of `standard` mode along with automatic client side
    #       throttling.  This is a provisional mode that may change behavior
    #       in the future.
    #
    #   @option options [String] :sdk_ua_app_id
    #     A unique and opaque application ID that is appended to the
    #     User-Agent header as app/sdk_ua_app_id. It should have a
    #     maximum length of 50. This variable is sourced from environment
    #     variable AWS_SDK_UA_APP_ID or the shared config profile attribute sdk_ua_app_id.
    #
    #   @option options [String] :secret_access_key
    #
    #   @option options [String] :session_token
    #
    #   @option options [Array] :sigv4a_signing_region_set
    #     A list of regions that should be signed with SigV4a signing. When
    #     not passed, a default `:sigv4a_signing_region_set` is searched for
    #     in the following locations:
    #
    #     * `Aws.config[:sigv4a_signing_region_set]`
    #     * `ENV['AWS_SIGV4A_SIGNING_REGION_SET']`
    #     * `~/.aws/config`
    #
    #   @option options [Boolean] :stub_responses (false)
    #     Causes the client to return stubbed responses. By default
    #     fake responses are generated and returned. You can specify
    #     the response data to return or errors to raise by calling
    #     {ClientStubs#stub_responses}. See {ClientStubs} for more information.
    #
    #     ** Please note ** When response stubbing is enabled, no HTTP
    #     requests are made, and retries are disabled.
    #
    #   @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
    #     Allows you to provide a telemetry provider, which is used to
    #     emit telemetry data. By default, uses `NoOpTelemetryProvider` which
    #     will not record or emit any telemetry data. The SDK supports the
    #     following telemetry providers:
    #
    #     * OpenTelemetry (OTel) - To use the OTel provider, install and require the
    #     `opentelemetry-sdk` gem and then, pass in an instance of a
    #     `Aws::Telemetry::OTelProvider` for telemetry provider.
    #
    #   @option options [Aws::TokenProvider] :token_provider
    #     Your Bearer token used for authentication. This can be any class that includes and implements
    #     `Aws::TokenProvider`, or instance of any one of the following classes:
    #
    #     * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
    #       tokens.
    #
    #     * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
    #       access token generated from `aws login`.
    #
    #     When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
    #     will be used to search for tokens configured for your profile in shared configuration files.
    #
    #   @option options [Boolean] :use_dualstack_endpoint
    #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
    #     will be used if available.
    #
    #   @option options [Boolean] :use_fips_endpoint
    #     When set to `true`, fips compatible endpoints will be used if available.
    #     When a `fips` region is used, the region is normalized and this config
    #     is set to `true`.
    #
    #   @option options [Boolean] :validate_params (true)
    #     When `true`, request parameters are validated before
    #     sending the request.
    #
    #   @option options [Aws::Route53::EndpointProvider] :endpoint_provider
    #     The endpoint provider used to resolve endpoints. Any object that responds to
    #     `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to
    #     `Aws::Route53::EndpointParameters`.
    #
    #   @option options [Float] :http_continue_timeout (1)
    #     The number of seconds to wait for a 100-continue response before sending the
    #     request body.  This option has no effect unless the request has "Expect"
    #     header set to "100-continue".  Defaults to `nil` which  disables this
    #     behaviour.  This value can safely be set per request on the session.
    #
    #   @option options [Float] :http_idle_timeout (5)
    #     The number of seconds a connection is allowed to sit idle before it
    #     is considered stale.  Stale connections are closed and removed from the
    #     pool before making a request.
    #
    #   @option options [Float] :http_open_timeout (15)
    #     The default number of seconds to wait for response data.
    #     This value can safely be set per-request on the session.
    #
    #   @option options [URI::HTTP,String] :http_proxy
    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
    #
    #   @option options [Float] :http_read_timeout (60)
    #     The default number of seconds to wait for response data.
    #     This value can safely be set per-request on the session.
    #
    #   @option options [Boolean] :http_wire_trace (false)
    #     When `true`,  HTTP debug output will be sent to the `:logger`.
    #
    #   @option options [Proc] :on_chunk_received
    #     When a Proc object is provided, it will be used as callback when each chunk
    #     of the response body is received. It provides three arguments: the chunk,
    #     the number of bytes received, and the total number of
    #     bytes in the response (or nil if the server did not send a `content-length`).
    #
    #   @option options [Proc] :on_chunk_sent
    #     When a Proc object is provided, it will be used as callback when each chunk
    #     of the request body is sent. It provides three arguments: the chunk,
    #     the number of bytes read from the body, and the total number of
    #     bytes in the body.
    #
    #   @option options [Boolean] :raise_response_errors (true)
    #     When `true`, response errors are raised.
    #
    #   @option options [String] :ssl_ca_bundle
    #     Full path to the SSL certificate authority bundle file that should be used when
    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
    #     `:ssl_ca_directory` the the system default will be used if available.
    #
    #   @option options [String] :ssl_ca_directory
    #     Full path of the directory that contains the unbundled SSL certificate
    #     authority files for verifying peer certificates.  If you do
    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
    #     default will be used if available.
    #
    #   @option options [String] :ssl_ca_store
    #     Sets the X509::Store to verify peer certificate.
    #
    #   @option options [OpenSSL::X509::Certificate] :ssl_cert
    #     Sets a client certificate when creating http connections.
    #
    #   @option options [OpenSSL::PKey] :ssl_key
    #     Sets a client key when creating http connections.
    #
    #   @option options [Float] :ssl_timeout
    #     Sets the SSL timeout in seconds
    #
    #   @option options [Boolean] :ssl_verify_peer (true)
    #     When `true`, SSL peer certificates are verified when establishing a connection.
    #
    def initialize(*args)
      super
    end

    # @!group API Operations

    # Activates a key-signing key (KSK) so that it can be used for signing
    # by DNSSEC. This operation changes the KSK status to `ACTIVE`.
    #
    # @option params [required, String] :hosted_zone_id
    #   A unique string used to identify a hosted zone.
    #
    # @option params [required, String] :name
    #   A string used to identify a key-signing key (KSK). `Name` can include
    #   numbers, letters, and underscores (\_). `Name` must be unique for each
    #   key-signing key in the same hosted zone.
    #
    # @return [Types::ActivateKeySigningKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ActivateKeySigningKeyResponse#change_info #change_info} => Types::ChangeInfo
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.activate_key_signing_key({
    #     hosted_zone_id: "ResourceId", # required
    #     name: "SigningKeyName", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ActivateKeySigningKey AWS API Documentation
    #
    # @overload activate_key_signing_key(params = {})
    # @param [Hash] params ({})
    def activate_key_signing_key(params = {}, options = {})
      req = build_request(:activate_key_signing_key, params)
      req.send_request(options)
    end

    # Associates an Amazon VPC with a private hosted zone.
    #
    # To perform the association, the VPC and the private hosted zone must
    # already exist. You can't convert a public hosted zone into a private
    # hosted zone.
    #
    # <note markdown="1"> If you want to associate a VPC that was created by using one Amazon
    # Web Services account with a private hosted zone that was created by
    # using a different account, the Amazon Web Services account that
    # created the private hosted zone must first submit a
    # `CreateVPCAssociationAuthorization` request. Then the account that
    # created the VPC must submit an `AssociateVPCWithHostedZone` request.
    #
    #  </note>
    #
    # <note markdown="1"> When granting access, the hosted zone and the Amazon VPC must belong
    # to the same partition. A partition is a group of Amazon Web Services
    # Regions. Each Amazon Web Services account is scoped to one partition.
    #
    #  The following are the supported partitions:
    #
    #  * `aws` - Amazon Web Services Regions
    #
    # * `aws-cn` - China Regions
    #
    # * `aws-us-gov` - Amazon Web Services GovCloud (US) Region
    #
    #  For more information, see [Access Management][1] in the *Amazon Web
    # Services General Reference*.
    #
    #  </note>
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the private hosted zone that you want to associate an Amazon
    #   VPC with.
    #
    #   Note that you can't associate a VPC with a hosted zone that doesn't
    #   have an existing VPC association.
    #
    # @option params [required, Types::VPC] :vpc
    #   A complex type that contains information about the VPC that you want
    #   to associate with a private hosted zone.
    #
    # @option params [String] :comment
    #   *Optional:* A comment about the association request.
    #
    # @return [Types::AssociateVPCWithHostedZoneResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::AssociateVPCWithHostedZoneResponse#change_info #change_info} => Types::ChangeInfo
    #
    #
    # @example Example: To associate a VPC with a hosted zone
    #
    #   # The following example associates the VPC with ID vpc-1a2b3c4d with the hosted zone with ID Z3M3LMPEXAMPLE.
    #
    #   resp = client.associate_vpc_with_hosted_zone({
    #     comment: "", 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", 
    #     vpc: {
    #       vpc_id: "vpc-1a2b3c4d", 
    #       vpc_region: "us-east-2", 
    #     }, 
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "", 
    #       id: "/change/C3HC6WDB2UANE2", 
    #       status: "INSYNC", 
    #       submitted_at: Time.parse("2017-01-31T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.associate_vpc_with_hosted_zone({
    #     hosted_zone_id: "ResourceId", # required
    #     vpc: { # required
    #       vpc_region: "us-east-1", # accepts us-east-1, us-east-2, us-west-1, us-west-2, eu-west-1, eu-west-2, eu-west-3, eu-central-1, eu-central-2, ap-east-1, me-south-1, us-gov-west-1, us-gov-east-1, us-iso-east-1, us-iso-west-1, us-isob-east-1, me-central-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-south-1, ap-south-2, ap-northeast-1, ap-northeast-2, ap-northeast-3, eu-north-1, sa-east-1, ca-central-1, cn-north-1, cn-northwest-1, af-south-1, eu-south-1, eu-south-2, ap-southeast-4, il-central-1, ca-west-1, ap-southeast-5, mx-central-1, us-isof-south-1, us-isof-east-1, ap-southeast-7, ap-east-2, eu-isoe-west-1, ap-southeast-6
    #       vpc_id: "VPCId",
    #     },
    #     comment: "AssociateVPCComment",
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/AssociateVPCWithHostedZone AWS API Documentation
    #
    # @overload associate_vpc_with_hosted_zone(params = {})
    # @param [Hash] params ({})
    def associate_vpc_with_hosted_zone(params = {}, options = {})
      req = build_request(:associate_vpc_with_hosted_zone, params)
      req.send_request(options)
    end

    # Creates, changes, or deletes CIDR blocks within a collection. Contains
    # authoritative IP information mapping blocks to one or multiple
    # locations.
    #
    # A change request can update multiple locations in a collection at a
    # time, which is helpful if you want to move one or more CIDR blocks
    # from one location to another in one transaction, without downtime.
    #
    # **Limits**
    #
    # The max number of CIDR blocks included in the request is 1000. As a
    # result, big updates require multiple API calls.
    #
    # <b> PUT and DELETE_IF_EXISTS</b>
    #
    # Use `ChangeCidrCollection` to perform the following actions:
    #
    # * `PUT`: Create a CIDR block within the specified collection.
    #
    # * ` DELETE_IF_EXISTS`: Delete an existing CIDR block from the
    #   collection.
    #
    # @option params [required, String] :id
    #   The UUID of the CIDR collection to update.
    #
    # @option params [Integer] :collection_version
    #   A sequential counter that Amazon Route 53 sets to 1 when you create a
    #   collection and increments it by 1 each time you update the collection.
    #
    #   We recommend that you use `ListCidrCollection` to get the current
    #   value of `CollectionVersion` for the collection that you want to
    #   update, and then include that value with the change request. This
    #   prevents Route 53 from overwriting an intervening update:
    #
    #   * If the value in the request matches the value of `CollectionVersion`
    #     in the collection, Route 53 updates the collection.
    #
    #   * If the value of `CollectionVersion` in the collection is greater
    #     than the value in the request, the collection was changed after you
    #     got the version number. Route 53 does not update the collection, and
    #     it returns a `CidrCollectionVersionMismatch` error.
    #
    # @option params [required, Array<Types::CidrCollectionChange>] :changes
    #   Information about changes to a CIDR collection.
    #
    # @return [Types::ChangeCidrCollectionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ChangeCidrCollectionResponse#id #id} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.change_cidr_collection({
    #     id: "UUID", # required
    #     collection_version: 1,
    #     changes: [ # required
    #       {
    #         location_name: "CidrLocationNameDefaultNotAllowed", # required
    #         action: "PUT", # required, accepts PUT, DELETE_IF_EXISTS
    #         cidr_list: ["Cidr"], # required
    #       },
    #     ],
    #   })
    #
    # @example Response structure
    #
    #   resp.id #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ChangeCidrCollection AWS API Documentation
    #
    # @overload change_cidr_collection(params = {})
    # @param [Hash] params ({})
    def change_cidr_collection(params = {}, options = {})
      req = build_request(:change_cidr_collection, params)
      req.send_request(options)
    end

    # Creates, changes, or deletes a resource record set, which contains
    # authoritative DNS information for a specified domain name or subdomain
    # name. For example, you can use `ChangeResourceRecordSets` to create a
    # resource record set that routes traffic for test.example.com to a web
    # server that has an IP address of 192.0.2.44.
    #
    # **Deleting Resource Record Sets**
    #
    # To delete a resource record set, you must specify all the same values
    # that you specified when you created it.
    #
    # **Change Batches and Transactional Changes**
    #
    # The request body must include a document with a
    # `ChangeResourceRecordSetsRequest` element. The request body contains a
    # list of change items, known as a change batch. Change batches are
    # considered transactional changes. Route 53 validates the changes in
    # the request and then either makes all or none of the changes in the
    # change batch request. This ensures that DNS routing isn't adversely
    # affected by partial changes to the resource record sets in a hosted
    # zone.
    #
    # For example, suppose a change batch request contains two changes: it
    # deletes the `CNAME` resource record set for www.example.com and
    # creates an alias resource record set for www.example.com. If
    # validation for both records succeeds, Route 53 deletes the first
    # resource record set and creates the second resource record set in a
    # single operation. If validation for either the `DELETE` or the
    # `CREATE` action fails, then the request is canceled, and the original
    # `CNAME` record continues to exist.
    #
    # <note markdown="1"> If you try to delete the same resource record set more than once in a
    # single change batch, Route 53 returns an `InvalidChangeBatch` error.
    #
    #  </note>
    #
    # **Traffic Flow**
    #
    # To create resource record sets for complex routing configurations, use
    # either the traffic flow visual editor in the Route 53 console or the
    # API actions for traffic policies and traffic policy instances. Save
    # the configuration as a traffic policy, then associate the traffic
    # policy with one or more domain names (such as example.com) or
    # subdomain names (such as www.example.com), in the same hosted zone or
    # in multiple hosted zones. You can roll back the updates if the new
    # configuration isn't performing as expected. For more information, see
    # [Using Traffic Flow to Route DNS Traffic][1] in the *Amazon Route 53
    # Developer Guide*.
    #
    # **Create, Delete, and Upsert**
    #
    # Use `ChangeResourceRecordsSetsRequest` to perform the following
    # actions:
    #
    # * `CREATE`: Creates a resource record set that has the specified
    #   values.
    #
    # * `DELETE`: Deletes an existing resource record set that has the
    #   specified values.
    #
    # * `UPSERT`: If a resource set doesn't exist, Route 53 creates it. If
    #   a resource set exists Route 53 updates it with the values in the
    #   request.
    #
    # **Syntaxes for Creating, Updating, and Deleting Resource Record Sets**
    #
    # The syntax for a request depends on the type of resource record set
    # that you want to create, delete, or update, such as weighted, alias,
    # or failover. The XML elements in your request must appear in the order
    # listed in the syntax.
    #
    # For an example for each type of resource record set, see "Examples."
    #
    # Don't refer to the syntax in the "Parameter Syntax" section, which
    # includes all of the elements for every kind of resource record set
    # that you can create, delete, or update by using
    # `ChangeResourceRecordSets`.
    #
    # **Change Propagation to Route 53 DNS Servers**
    #
    # When you submit a `ChangeResourceRecordSets` request, Route 53
    # propagates your changes to all of the Route 53 authoritative DNS
    # servers managing the hosted zone. While your changes are propagating,
    # `GetChange` returns a status of `PENDING`. When propagation is
    # complete, `GetChange` returns a status of `INSYNC`. Changes generally
    # propagate to all Route 53 name servers managing the hosted zone within
    # 60 seconds. For more information, see [GetChange][2].
    #
    # **Limits on ChangeResourceRecordSets Requests**
    #
    # For information about the limits on a `ChangeResourceRecordSets`
    # request, see [Limits][3] in the *Amazon Route 53 Developer Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/traffic-flow.html
    # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_GetChange.html
    # [3]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the hosted zone that contains the resource record sets that
    #   you want to change.
    #
    # @option params [required, Types::ChangeBatch] :change_batch
    #   A complex type that contains an optional comment and the `Changes`
    #   element.
    #
    # @return [Types::ChangeResourceRecordSetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ChangeResourceRecordSetsResponse#change_info #change_info} => Types::ChangeInfo
    #
    #
    # @example Example: To create a basic resource record set
    #
    #   # The following example creates a resource record set that routes Internet traffic to a resource with an IP address of
    #   # 192.0.2.44.
    #
    #   resp = client.change_resource_record_sets({
    #     change_batch: {
    #       changes: [
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             name: "example.com", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.44", 
    #               }, 
    #             ], 
    #             ttl: 60, 
    #             type: "A", 
    #           }, 
    #         }, 
    #       ], 
    #       comment: "Web server for example.com", 
    #     }, 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", 
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "Web server for example.com", 
    #       id: "/change/C2682N5HXP0BZ4", 
    #       status: "PENDING", 
    #       submitted_at: Time.parse("2017-02-10T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Example: To create weighted resource record sets
    #
    #   # The following example creates two weighted resource record sets. The resource with a Weight of 100 will get 1/3rd of
    #   # traffic (100/100+200), and the other resource will get the rest of the traffic for example.com.
    #
    #   resp = client.change_resource_record_sets({
    #     change_batch: {
    #       changes: [
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             health_check_id: "abcdef11-2222-3333-4444-555555fedcba", 
    #             name: "example.com", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.44", 
    #               }, 
    #             ], 
    #             set_identifier: "Seattle data center", 
    #             ttl: 60, 
    #             type: "A", 
    #             weight: 100, 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             health_check_id: "abcdef66-7777-8888-9999-000000fedcba", 
    #             name: "example.com", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.45", 
    #               }, 
    #             ], 
    #             set_identifier: "Portland data center", 
    #             ttl: 60, 
    #             type: "A", 
    #             weight: 200, 
    #           }, 
    #         }, 
    #       ], 
    #       comment: "Web servers for example.com", 
    #     }, 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", 
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "Web servers for example.com", 
    #       id: "/change/C2682N5HXP0BZ4", 
    #       status: "PENDING", 
    #       submitted_at: Time.parse("2017-02-10T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Example: To create an alias resource record set
    #
    #   # The following example creates an alias resource record set that routes traffic to a CloudFront distribution.
    #
    #   resp = client.change_resource_record_sets({
    #     change_batch: {
    #       changes: [
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "d123rk29d0stfj.cloudfront.net", 
    #               evaluate_target_health: false, 
    #               hosted_zone_id: "Z2FDTNDATAQYW2", 
    #             }, 
    #             name: "example.com", 
    #             type: "A", 
    #           }, 
    #         }, 
    #       ], 
    #       comment: "CloudFront distribution for example.com", 
    #     }, 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", # Depends on the type of resource that you want to route traffic to
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "CloudFront distribution for example.com", 
    #       id: "/change/C2682N5HXP0BZ4", 
    #       status: "PENDING", 
    #       submitted_at: Time.parse("2017-02-10T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Example: To create weighted alias resource record sets
    #
    #   # The following example creates two weighted alias resource record sets that route traffic to ELB load balancers. The
    #   # resource with a Weight of 100 will get 1/3rd of traffic (100/100+200), and the other resource will get the rest of the
    #   # traffic for example.com.
    #
    #   resp = client.change_resource_record_sets({
    #     change_batch: {
    #       changes: [
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "example-com-123456789.us-east-2.elb.amazonaws.com ", 
    #               evaluate_target_health: true, 
    #               hosted_zone_id: "Z3AADJGX6KTTL2", 
    #             }, 
    #             name: "example.com", 
    #             set_identifier: "Ohio region", 
    #             type: "A", 
    #             weight: 100, 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "example-com-987654321.us-west-2.elb.amazonaws.com ", 
    #               evaluate_target_health: true, 
    #               hosted_zone_id: "Z1H1FL5HABSF5", 
    #             }, 
    #             name: "example.com", 
    #             set_identifier: "Oregon region", 
    #             type: "A", 
    #             weight: 200, 
    #           }, 
    #         }, 
    #       ], 
    #       comment: "ELB load balancers for example.com", 
    #     }, 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", # Depends on the type of resource that you want to route traffic to
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "ELB load balancers for example.com", 
    #       id: "/change/C2682N5HXP0BZ4", 
    #       status: "PENDING", 
    #       submitted_at: Time.parse("2017-02-10T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Example: To create latency resource record sets
    #
    #   # The following example creates two latency resource record sets that route traffic to EC2 instances. Traffic for
    #   # example.com is routed either to the Ohio region or the Oregon region, depending on the latency between the user and
    #   # those regions.
    #
    #   resp = client.change_resource_record_sets({
    #     change_batch: {
    #       changes: [
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             health_check_id: "abcdef11-2222-3333-4444-555555fedcba", 
    #             name: "example.com", 
    #             region: "us-east-2", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.44", 
    #               }, 
    #             ], 
    #             set_identifier: "Ohio region", 
    #             ttl: 60, 
    #             type: "A", 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             health_check_id: "abcdef66-7777-8888-9999-000000fedcba", 
    #             name: "example.com", 
    #             region: "us-west-2", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.45", 
    #               }, 
    #             ], 
    #             set_identifier: "Oregon region", 
    #             ttl: 60, 
    #             type: "A", 
    #           }, 
    #         }, 
    #       ], 
    #       comment: "EC2 instances for example.com", 
    #     }, 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", 
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "EC2 instances for example.com", 
    #       id: "/change/C2682N5HXP0BZ4", 
    #       status: "PENDING", 
    #       submitted_at: Time.parse("2017-02-10T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Example: To create latency alias resource record sets
    #
    #   # The following example creates two latency alias resource record sets that route traffic for example.com to ELB load
    #   # balancers. Requests are routed either to the Ohio region or the Oregon region, depending on the latency between the user
    #   # and those regions.
    #
    #   resp = client.change_resource_record_sets({
    #     change_batch: {
    #       changes: [
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "example-com-123456789.us-east-2.elb.amazonaws.com ", 
    #               evaluate_target_health: true, 
    #               hosted_zone_id: "Z3AADJGX6KTTL2", 
    #             }, 
    #             name: "example.com", 
    #             region: "us-east-2", 
    #             set_identifier: "Ohio region", 
    #             type: "A", 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "example-com-987654321.us-west-2.elb.amazonaws.com ", 
    #               evaluate_target_health: true, 
    #               hosted_zone_id: "Z1H1FL5HABSF5", 
    #             }, 
    #             name: "example.com", 
    #             region: "us-west-2", 
    #             set_identifier: "Oregon region", 
    #             type: "A", 
    #           }, 
    #         }, 
    #       ], 
    #       comment: "ELB load balancers for example.com", 
    #     }, 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", # Depends on the type of resource that you want to route traffic to
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "ELB load balancers for example.com", 
    #       id: "/change/C2682N5HXP0BZ4", 
    #       status: "PENDING", 
    #       submitted_at: Time.parse("2017-02-10T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Example: To create failover resource record sets
    #
    #   # The following example creates primary and secondary failover resource record sets that route traffic to EC2 instances.
    #   # Traffic is generally routed to the primary resource, in the Ohio region. If that resource is unavailable, traffic is
    #   # routed to the secondary resource, in the Oregon region.
    #
    #   resp = client.change_resource_record_sets({
    #     change_batch: {
    #       changes: [
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             failover: "PRIMARY", 
    #             health_check_id: "abcdef11-2222-3333-4444-555555fedcba", 
    #             name: "example.com", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.44", 
    #               }, 
    #             ], 
    #             set_identifier: "Ohio region", 
    #             ttl: 60, 
    #             type: "A", 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             failover: "SECONDARY", 
    #             health_check_id: "abcdef66-7777-8888-9999-000000fedcba", 
    #             name: "example.com", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.45", 
    #               }, 
    #             ], 
    #             set_identifier: "Oregon region", 
    #             ttl: 60, 
    #             type: "A", 
    #           }, 
    #         }, 
    #       ], 
    #       comment: "Failover configuration for example.com", 
    #     }, 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", 
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "Failover configuration for example.com", 
    #       id: "/change/C2682N5HXP0BZ4", 
    #       status: "PENDING", 
    #       submitted_at: Time.parse("2017-02-10T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Example: To create failover alias resource record sets
    #
    #   # The following example creates primary and secondary failover alias resource record sets that route traffic to ELB load
    #   # balancers. Traffic is generally routed to the primary resource, in the Ohio region. If that resource is unavailable,
    #   # traffic is routed to the secondary resource, in the Oregon region.
    #
    #   resp = client.change_resource_record_sets({
    #     change_batch: {
    #       changes: [
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "example-com-123456789.us-east-2.elb.amazonaws.com ", 
    #               evaluate_target_health: true, 
    #               hosted_zone_id: "Z3AADJGX6KTTL2", 
    #             }, 
    #             failover: "PRIMARY", 
    #             name: "example.com", 
    #             set_identifier: "Ohio region", 
    #             type: "A", 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "example-com-987654321.us-west-2.elb.amazonaws.com ", 
    #               evaluate_target_health: true, 
    #               hosted_zone_id: "Z1H1FL5HABSF5", 
    #             }, 
    #             failover: "SECONDARY", 
    #             name: "example.com", 
    #             set_identifier: "Oregon region", 
    #             type: "A", 
    #           }, 
    #         }, 
    #       ], 
    #       comment: "Failover alias configuration for example.com", 
    #     }, 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", # Depends on the type of resource that you want to route traffic to
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "Failover alias configuration for example.com", 
    #       id: "/change/C2682N5HXP0BZ4", 
    #       status: "PENDING", 
    #       submitted_at: Time.parse("2017-02-10T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Example: To create geolocation resource record sets
    #
    #   # The following example creates four geolocation resource record sets that use IPv4 addresses to route traffic to
    #   # resources such as web servers running on EC2 instances. Traffic is routed to one of four IP addresses, for North America
    #   # (NA), for South America (SA), for Europe (EU), and for all other locations (*).
    #
    #   resp = client.change_resource_record_sets({
    #     change_batch: {
    #       changes: [
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             geo_location: {
    #               continent_code: "NA", 
    #             }, 
    #             name: "example.com", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.44", 
    #               }, 
    #             ], 
    #             set_identifier: "North America", 
    #             ttl: 60, 
    #             type: "A", 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             geo_location: {
    #               continent_code: "SA", 
    #             }, 
    #             name: "example.com", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.45", 
    #               }, 
    #             ], 
    #             set_identifier: "South America", 
    #             ttl: 60, 
    #             type: "A", 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             geo_location: {
    #               continent_code: "EU", 
    #             }, 
    #             name: "example.com", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.46", 
    #               }, 
    #             ], 
    #             set_identifier: "Europe", 
    #             ttl: 60, 
    #             type: "A", 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             geo_location: {
    #               country_code: "*", 
    #             }, 
    #             name: "example.com", 
    #             resource_records: [
    #               {
    #                 value: "192.0.2.47", 
    #               }, 
    #             ], 
    #             set_identifier: "Other locations", 
    #             ttl: 60, 
    #             type: "A", 
    #           }, 
    #         }, 
    #       ], 
    #       comment: "Geolocation configuration for example.com", 
    #     }, 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", 
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "Geolocation configuration for example.com", 
    #       id: "/change/C2682N5HXP0BZ4", 
    #       status: "PENDING", 
    #       submitted_at: Time.parse("2017-02-10T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Example: To create geolocation alias resource record sets
    #
    #   # The following example creates four geolocation alias resource record sets that route traffic to ELB load balancers.
    #   # Traffic is routed to one of four IP addresses, for North America (NA), for South America (SA), for Europe (EU), and for
    #   # all other locations (*).
    #
    #   resp = client.change_resource_record_sets({
    #     change_batch: {
    #       changes: [
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "example-com-123456789.us-east-2.elb.amazonaws.com ", 
    #               evaluate_target_health: true, 
    #               hosted_zone_id: "Z3AADJGX6KTTL2", 
    #             }, 
    #             geo_location: {
    #               continent_code: "NA", 
    #             }, 
    #             name: "example.com", 
    #             set_identifier: "North America", 
    #             type: "A", 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "example-com-234567890.sa-east-1.elb.amazonaws.com ", 
    #               evaluate_target_health: true, 
    #               hosted_zone_id: "Z2P70J7HTTTPLU", 
    #             }, 
    #             geo_location: {
    #               continent_code: "SA", 
    #             }, 
    #             name: "example.com", 
    #             set_identifier: "South America", 
    #             type: "A", 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "example-com-234567890.eu-central-1.elb.amazonaws.com ", 
    #               evaluate_target_health: true, 
    #               hosted_zone_id: "Z215JYRZR1TBD5", 
    #             }, 
    #             geo_location: {
    #               continent_code: "EU", 
    #             }, 
    #             name: "example.com", 
    #             set_identifier: "Europe", 
    #             type: "A", 
    #           }, 
    #         }, 
    #         {
    #           action: "CREATE", 
    #           resource_record_set: {
    #             alias_target: {
    #               dns_name: "example-com-234567890.ap-southeast-1.elb.amazonaws.com ", 
    #               evaluate_target_health: true, 
    #               hosted_zone_id: "Z1LMS91P8CMLE5", 
    #             }, 
    #             geo_location: {
    #               country_code: "*", 
    #             }, 
    #             name: "example.com", 
    #             set_identifier: "Other locations", 
    #             type: "A", 
    #           }, 
    #         }, 
    #       ], 
    #       comment: "Geolocation alias configuration for example.com", 
    #     }, 
    #     hosted_zone_id: "Z3M3LMPEXAMPLE", # Depends on the type of resource that you want to route traffic to
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     change_info: {
    #       comment: "Geolocation alias configuration for example.com", 
    #       id: "/change/C2682N5HXP0BZ4", 
    #       status: "PENDING", 
    #       submitted_at: Time.parse("2017-02-10T01:36:41.958Z"), 
    #     }, 
    #   }
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.change_resource_record_sets({
    #     hosted_zone_id: "ResourceId", # required
    #     change_batch: { # required
    #       comment: "ResourceDescription",
    #       changes: [ # required
    #         {
    #           action: "CREATE", # required, accepts CREATE, DELETE, UPSERT
    #           resource_record_set: { # required
    #             name: "DNSName", # required
    #             type: "SOA", # required, accepts SOA, A, TXT, NS, CNAME, MX, NAPTR, PTR, SRV, SPF, AAAA, CAA, DS, TLSA, SSHFP, SVCB, HTTPS
    #             set_identifier: "ResourceRecordSetIdentifier",
    #             weight: 1,
    #             region: "us-east-1", # accepts us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-west-2, eu-west-3, eu-central-1, eu-central-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-northeast-1, ap-northeast-2, ap-northeast-3, eu-north-1, sa-east-1, cn-north-1, cn-northwest-1, ap-east-1, me-south-1, me-central-1, ap-south-1, ap-south-2, af-south-1, eu-south-1, eu-south-2, ap-southeast-4, il-central-1, ca-west-1, ap-southeast-5, mx-central-1, ap-southeast-7, us-gov-east-1, us-gov-west-1, ap-east-2, ap-southeast-6
    #             geo_location: {
    #               continent_code: "GeoLocationContinentCode",
    #               country_code: "GeoLocationCountryCode",
    #               subdivision_code: "GeoLocationSubdivisionCode",
    #             },
    #             failover: "PRIMARY", # accepts PRIMARY, SECONDARY
    #             multi_value_answer: false,
    #             ttl: 1,
    #             resource_records: [
    #               {
    #                 value: "RData", # required
    #               },
    #             ],
    #             alias_target: {
    #               hosted_zone_id: "ResourceId", # required
    #               dns_name: "DNSName", # required
    #               evaluate_target_health: false, # required
    #             },
    #             health_check_id: "HealthCheckId",
    #             traffic_policy_instance_id: "TrafficPolicyInstanceId",
    #             cidr_routing_config: {
    #               collection_id: "UUID", # required
    #               location_name: "CidrLocationNameDefaultAllowed", # required
    #             },
    #             geo_proximity_location: {
    #               aws_region: "AWSRegion",
    #               local_zone_group: "LocalZoneGroup",
    #               coordinates: {
    #                 latitude: "Latitude", # required
    #                 longitude: "Longitude", # required
    #               },
    #               bias: 1,
    #             },
    #           },
    #         },
    #       ],
    #     },
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ChangeResourceRecordSets AWS API Documentation
    #
    # @overload change_resource_record_sets(params = {})
    # @param [Hash] params ({})
    def change_resource_record_sets(params = {}, options = {})
      req = build_request(:change_resource_record_sets, params)
      req.send_request(options)
    end

    # Adds, edits, or deletes tags for a health check or a hosted zone.
    #
    # For information about using tags for cost allocation, see [Using Cost
    # Allocation Tags][1] in the *Billing and Cost Management User Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
    #
    # @option params [required, String] :resource_type
    #   The type of the resource.
    #
    #   * The resource type for health checks is `healthcheck`.
    #
    #   * The resource type for hosted zones is `hostedzone`.
    #
    # @option params [required, String] :resource_id
    #   The ID of the resource for which you want to add, change, or delete
    #   tags.
    #
    # @option params [Array<Types::Tag>] :add_tags
    #   A complex type that contains a list of the tags that you want to add
    #   to the specified health check or hosted zone and/or the tags that you
    #   want to edit `Value` for.
    #
    #   You can add a maximum of 10 tags to a health check or a hosted zone.
    #
    # @option params [Array<String>] :remove_tag_keys
    #   A complex type that contains a list of the tags that you want to
    #   delete from the specified health check or hosted zone. You can specify
    #   up to 10 keys.
    #
    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
    #
    #
    # @example Example: To add or remove tags from a hosted zone or health check
    #
    #   # The following example adds two tags and removes one tag from the hosted zone with ID Z3M3LMPEXAMPLE.
    #
    #   resp = client.change_tags_for_resource({
    #     add_tags: [
    #       {
    #         key: "apex", 
    #         value: "3874", 
    #       }, 
    #       {
    #         key: "acme", 
    #         value: "4938", 
    #       }, 
    #     ], 
    #     remove_tag_keys: [
    #       "Nadir", 
    #     ], 
    #     resource_id: "Z3M3LMPEXAMPLE", 
    #     resource_type: "hostedzone", # Valid values are healthcheck and hostedzone.
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #   }
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.change_tags_for_resource({
    #     resource_type: "healthcheck", # required, accepts healthcheck, hostedzone
    #     resource_id: "TagResourceId", # required
    #     add_tags: [
    #       {
    #         key: "TagKey",
    #         value: "TagValue",
    #       },
    #     ],
    #     remove_tag_keys: ["TagKey"],
    #   })
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ChangeTagsForResource AWS API Documentation
    #
    # @overload change_tags_for_resource(params = {})
    # @param [Hash] params ({})
    def change_tags_for_resource(params = {}, options = {})
      req = build_request(:change_tags_for_resource, params)
      req.send_request(options)
    end

    # Creates a CIDR collection in the current Amazon Web Services account.
    #
    # @option params [required, String] :name
    #   A unique identifier for the account that can be used to reference the
    #   collection from other API calls.
    #
    # @option params [required, String] :caller_reference
    #   A client-specific token that allows requests to be securely retried so
    #   that the intended outcome will only occur once, retries receive a
    #   similar response, and there are no additional edge cases to handle.
    #
    # @return [Types::CreateCidrCollectionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateCidrCollectionResponse#collection #collection} => Types::CidrCollection
    #   * {Types::CreateCidrCollectionResponse#location #location} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_cidr_collection({
    #     name: "CollectionName", # required
    #     caller_reference: "CidrNonce", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.collection.arn #=> String
    #   resp.collection.id #=> String
    #   resp.collection.name #=> String
    #   resp.collection.version #=> Integer
    #   resp.location #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateCidrCollection AWS API Documentation
    #
    # @overload create_cidr_collection(params = {})
    # @param [Hash] params ({})
    def create_cidr_collection(params = {}, options = {})
      req = build_request(:create_cidr_collection, params)
      req.send_request(options)
    end

    # Creates a new health check.
    #
    # For information about adding health checks to resource record sets,
    # see [HealthCheckId][1] in [ChangeResourceRecordSets][2].
    #
    # **ELB Load Balancers**
    #
    # If you're registering EC2 instances with an Elastic Load Balancing
    # (ELB) load balancer, do not create Amazon Route 53 health checks for
    # the EC2 instances. When you register an EC2 instance with a load
    # balancer, you configure settings for an ELB health check, which
    # performs a similar function to a Route 53 health check.
    #
    # **Private Hosted Zones**
    #
    # You can associate health checks with failover resource record sets in
    # a private hosted zone. Note the following:
    #
    # * Route 53 health checkers are outside the VPC. To check the health of
    #   an endpoint within a VPC by IP address, you must assign a public IP
    #   address to the instance in the VPC.
    #
    # * You can configure a health checker to check the health of an
    #   external resource that the instance relies on, such as a database
    #   server.
    #
    # * You can create a CloudWatch metric, associate an alarm with the
    #   metric, and then create a health check that is based on the state of
    #   the alarm. For example, you might create a CloudWatch metric that
    #   checks the status of the Amazon EC2 `StatusCheckFailed` metric, add
    #   an alarm to the metric, and then create a health check that is based
    #   on the state of the alarm. For information about creating CloudWatch
    #   metrics and alarms by using the CloudWatch console, see the [Amazon
    #   CloudWatch User Guide][3].
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_ResourceRecordSet.html#Route53-Type-ResourceRecordSet-HealthCheckId
    # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html
    # [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html
    #
    # @option params [required, String] :caller_reference
    #   A unique string that identifies the request and that allows you to
    #   retry a failed `CreateHealthCheck` request without the risk of
    #   creating two identical health checks:
    #
    #   * If you send a `CreateHealthCheck` request with the same
    #     `CallerReference` and settings as a previous request, and if the
    #     health check doesn't exist, Amazon Route 53 creates the health
    #     check. If the health check does exist, Route 53 returns the settings
    #     for the existing health check.
    #
    #   * If you send a `CreateHealthCheck` request with the same
    #     `CallerReference` as a deleted health check, regardless of the
    #     settings, Route 53 returns a `HealthCheckAlreadyExists` error.
    #
    #   * If you send a `CreateHealthCheck` request with the same
    #     `CallerReference` as an existing health check but with different
    #     settings, Route 53 returns a `HealthCheckAlreadyExists` error.
    #
    #   * If you send a `CreateHealthCheck` request with a unique
    #     `CallerReference` but settings identical to an existing health
    #     check, Route 53 creates the health check.
    #
    #   Route 53 does not store the `CallerReference` for a deleted health
    #   check indefinitely. The `CallerReference` for a deleted health check
    #   will be deleted after a number of days.
    #
    # @option params [required, Types::HealthCheckConfig] :health_check_config
    #   A complex type that contains settings for a new health check.
    #
    # @return [Types::CreateHealthCheckResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateHealthCheckResponse#health_check #health_check} => Types::HealthCheck
    #   * {Types::CreateHealthCheckResponse#location #location} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_health_check({
    #     caller_reference: "HealthCheckNonce", # required
    #     health_check_config: { # required
    #       ip_address: "IPAddress",
    #       port: 1,
    #       type: "HTTP", # required, accepts HTTP, HTTPS, HTTP_STR_MATCH, HTTPS_STR_MATCH, TCP, CALCULATED, CLOUDWATCH_METRIC, RECOVERY_CONTROL
    #       resource_path: "ResourcePath",
    #       fully_qualified_domain_name: "FullyQualifiedDomainName",
    #       search_string: "SearchString",
    #       request_interval: 1,
    #       failure_threshold: 1,
    #       measure_latency: false,
    #       inverted: false,
    #       disabled: false,
    #       health_threshold: 1,
    #       child_health_checks: ["HealthCheckId"],
    #       enable_sni: false,
    #       regions: ["us-east-1"], # accepts us-east-1, us-west-1, us-west-2, eu-west-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, sa-east-1
    #       alarm_identifier: {
    #         region: "us-east-1", # required, accepts us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-central-1, eu-central-2, eu-west-1, eu-west-2, eu-west-3, ap-east-1, me-south-1, me-central-1, ap-south-1, ap-south-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-northeast-1, ap-northeast-2, ap-northeast-3, eu-north-1, sa-east-1, cn-northwest-1, cn-north-1, af-south-1, eu-south-1, eu-south-2, us-gov-west-1, us-gov-east-1, us-iso-east-1, us-iso-west-1, us-isob-east-1, ap-southeast-4, il-central-1, ca-west-1, ap-southeast-5, mx-central-1, us-isof-south-1, us-isof-east-1, ap-southeast-7, ap-east-2, eu-isoe-west-1, ap-southeast-6
    #         name: "AlarmName", # required
    #       },
    #       insufficient_data_health_status: "Healthy", # accepts Healthy, Unhealthy, LastKnownStatus
    #       routing_control_arn: "RoutingControlArn",
    #     },
    #   })
    #
    # @example Response structure
    #
    #   resp.health_check.id #=> String
    #   resp.health_check.caller_reference #=> String
    #   resp.health_check.linked_service.service_principal #=> String
    #   resp.health_check.linked_service.description #=> String
    #   resp.health_check.health_check_config.ip_address #=> String
    #   resp.health_check.health_check_config.port #=> Integer
    #   resp.health_check.health_check_config.type #=> String, one of "HTTP", "HTTPS", "HTTP_STR_MATCH", "HTTPS_STR_MATCH", "TCP", "CALCULATED", "CLOUDWATCH_METRIC", "RECOVERY_CONTROL"
    #   resp.health_check.health_check_config.resource_path #=> String
    #   resp.health_check.health_check_config.fully_qualified_domain_name #=> String
    #   resp.health_check.health_check_config.search_string #=> String
    #   resp.health_check.health_check_config.request_interval #=> Integer
    #   resp.health_check.health_check_config.failure_threshold #=> Integer
    #   resp.health_check.health_check_config.measure_latency #=> Boolean
    #   resp.health_check.health_check_config.inverted #=> Boolean
    #   resp.health_check.health_check_config.disabled #=> Boolean
    #   resp.health_check.health_check_config.health_threshold #=> Integer
    #   resp.health_check.health_check_config.child_health_checks #=> Array
    #   resp.health_check.health_check_config.child_health_checks[0] #=> String
    #   resp.health_check.health_check_config.enable_sni #=> Boolean
    #   resp.health_check.health_check_config.regions #=> Array
    #   resp.health_check.health_check_config.regions[0] #=> String, one of "us-east-1", "us-west-1", "us-west-2", "eu-west-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "sa-east-1"
    #   resp.health_check.health_check_config.alarm_identifier.region #=> String, one of "us-east-1", "us-east-2", "us-west-1", "us-west-2", "ca-central-1", "eu-central-1", "eu-central-2", "eu-west-1", "eu-west-2", "eu-west-3", "ap-east-1", "me-south-1", "me-central-1", "ap-south-1", "ap-south-2", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "eu-north-1", "sa-east-1", "cn-northwest-1", "cn-north-1", "af-south-1", "eu-south-1", "eu-south-2", "us-gov-west-1", "us-gov-east-1", "us-iso-east-1", "us-iso-west-1", "us-isob-east-1", "ap-southeast-4", "il-central-1", "ca-west-1", "ap-southeast-5", "mx-central-1", "us-isof-south-1", "us-isof-east-1", "ap-southeast-7", "ap-east-2", "eu-isoe-west-1", "ap-southeast-6"
    #   resp.health_check.health_check_config.alarm_identifier.name #=> String
    #   resp.health_check.health_check_config.insufficient_data_health_status #=> String, one of "Healthy", "Unhealthy", "LastKnownStatus"
    #   resp.health_check.health_check_config.routing_control_arn #=> String
    #   resp.health_check.health_check_version #=> Integer
    #   resp.health_check.cloud_watch_alarm_configuration.evaluation_periods #=> Integer
    #   resp.health_check.cloud_watch_alarm_configuration.threshold #=> Float
    #   resp.health_check.cloud_watch_alarm_configuration.comparison_operator #=> String, one of "GreaterThanOrEqualToThreshold", "GreaterThanThreshold", "LessThanThreshold", "LessThanOrEqualToThreshold"
    #   resp.health_check.cloud_watch_alarm_configuration.period #=> Integer
    #   resp.health_check.cloud_watch_alarm_configuration.metric_name #=> String
    #   resp.health_check.cloud_watch_alarm_configuration.namespace #=> String
    #   resp.health_check.cloud_watch_alarm_configuration.statistic #=> String, one of "Average", "Sum", "SampleCount", "Maximum", "Minimum"
    #   resp.health_check.cloud_watch_alarm_configuration.dimensions #=> Array
    #   resp.health_check.cloud_watch_alarm_configuration.dimensions[0].name #=> String
    #   resp.health_check.cloud_watch_alarm_configuration.dimensions[0].value #=> String
    #   resp.location #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateHealthCheck AWS API Documentation
    #
    # @overload create_health_check(params = {})
    # @param [Hash] params ({})
    def create_health_check(params = {}, options = {})
      req = build_request(:create_health_check, params)
      req.send_request(options)
    end

    # Creates a new public or private hosted zone. You create records in a
    # public hosted zone to define how you want to route traffic on the
    # internet for a domain, such as example.com, and its subdomains
    # (apex.example.com, acme.example.com). You create records in a private
    # hosted zone to define how you want to route traffic for a domain and
    # its subdomains within one or more Amazon Virtual Private Clouds
    # (Amazon VPCs).
    #
    # You can't convert a public hosted zone to a private hosted zone or
    # vice versa. Instead, you must create a new hosted zone with the same
    # name and create new resource record sets.
    #
    # For more information about charges for hosted zones, see [Amazon
    # Route 53 Pricing][1].
    #
    # Note the following:
    #
    # * You can't create a hosted zone for a top-level domain (TLD) such as
    #   .com.
    #
    # * For public hosted zones, Route 53 automatically creates a default
    #   SOA record and four NS records for the zone. For more information
    #   about SOA and NS records, see [NS and SOA Records that Route 53
    #   Creates for a Hosted Zone][2] in the *Amazon Route 53 Developer
    #   Guide*.
    #
    #   If you want to use the same name servers for multiple public hosted
    #   zones, you can optionally associate a reusable delegation set with
    #   the hosted zone. See the `DelegationSetId` element.
    #
    # * If your domain is registered with a registrar other than Route 53,
    #   you must update the name servers with your registrar to make Route
    #   53 the DNS service for the domain. For more information, see
    #   [Migrating DNS Service for an Existing Domain to Amazon Route 53][3]
    #   in the *Amazon Route 53 Developer Guide*.
    #
    # When you submit a `CreateHostedZone` request, the initial status of
    # the hosted zone is `PENDING`. For public hosted zones, this means that
    # the NS and SOA records are not yet available on all Route 53 DNS
    # servers. When the NS and SOA records are available, the status of the
    # zone changes to `INSYNC`.
    #
    # The `CreateHostedZone` request requires the caller to have an
    # `ec2:DescribeVpcs` permission.
    #
    # <note markdown="1"> When creating private hosted zones, the Amazon VPC must belong to the
    # same partition where the hosted zone is created. A partition is a
    # group of Amazon Web Services Regions. Each Amazon Web Services account
    # is scoped to one partition.
    #
    #  The following are the supported partitions:
    #
    #  * `aws` - Amazon Web Services Regions
    #
    # * `aws-cn` - China Regions
    #
    # * `aws-us-gov` - Amazon Web Services GovCloud (US) Region
    #
    #  For more information, see [Access Management][4] in the *Amazon Web
    # Services General Reference*.
    #
    #  </note>
    #
    #
    #
    # [1]: http://aws.amazon.com/route53/pricing/
    # [2]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/SOA-NSrecords.html
    # [3]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/MigratingDNS.html
    # [4]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
    #
    # @option params [required, String] :name
    #   The name of the domain. Specify a fully qualified domain name, for
    #   example, *www.example.com*. The trailing dot is optional; Amazon
    #   Route 53 assumes that the domain name is fully qualified. This means
    #   that Route 53 treats *www.example.com* (without a trailing dot) and
    #   *www.example.com.* (with a trailing dot) as identical.
    #
    #   If you're creating a public hosted zone, this is the name you have
    #   registered with your DNS registrar. If your domain name is registered
    #   with a registrar other than Route 53, change the name servers for your
    #   domain to the set of `NameServers` that `CreateHostedZone` returns in
    #   `DelegationSet`.
    #
    # @option params [Types::VPC] :vpc
    #   (Private hosted zones only) A complex type that contains information
    #   about the Amazon VPC that you're associating with this hosted zone.
    #
    #   You can specify only one Amazon VPC when you create a private hosted
    #   zone. If you are associating a VPC with a hosted zone with this
    #   request, the paramaters `VPCId` and `VPCRegion` are also required.
    #
    #   To associate additional Amazon VPCs with the hosted zone, use
    #   [AssociateVPCWithHostedZone][1] after you create a hosted zone.
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_AssociateVPCWithHostedZone.html
    #
    # @option params [required, String] :caller_reference
    #   A unique string that identifies the request and that allows failed
    #   `CreateHostedZone` requests to be retried without the risk of
    #   executing the operation twice. You must use a unique `CallerReference`
    #   string every time you submit a `CreateHostedZone` request.
    #   `CallerReference` can be any unique string, for example, a date/time
    #   stamp.
    #
    # @option params [Types::HostedZoneConfig] :hosted_zone_config
    #   (Optional) A complex type that contains the following optional values:
    #
    #   * For public and private hosted zones, an optional comment
    #
    #   * For private hosted zones, an optional `PrivateZone` element
    #
    #   If you don't specify a comment or the `PrivateZone` element, omit
    #   `HostedZoneConfig` and the other elements.
    #
    # @option params [String] :delegation_set_id
    #   If you want to associate a reusable delegation set with this hosted
    #   zone, the ID that Amazon Route 53 assigned to the reusable delegation
    #   set when you created it. For more information about reusable
    #   delegation sets, see [CreateReusableDelegationSet][1].
    #
    #   If you are using a reusable delegation set to create a public hosted
    #   zone for a subdomain, make sure that the parent hosted zone doesn't
    #   use one or more of the same name servers. If you have overlapping
    #   nameservers, the operation will cause a `ConflictingDomainsExist`
    #   error.
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateReusableDelegationSet.html
    #
    # @return [Types::CreateHostedZoneResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateHostedZoneResponse#hosted_zone #hosted_zone} => Types::HostedZone
    #   * {Types::CreateHostedZoneResponse#change_info #change_info} => Types::ChangeInfo
    #   * {Types::CreateHostedZoneResponse#delegation_set #delegation_set} => Types::DelegationSet
    #   * {Types::CreateHostedZoneResponse#vpc #vpc} => Types::VPC
    #   * {Types::CreateHostedZoneResponse#location #location} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_hosted_zone({
    #     name: "DNSName", # required
    #     vpc: {
    #       vpc_region: "us-east-1", # accepts us-east-1, us-east-2, us-west-1, us-west-2, eu-west-1, eu-west-2, eu-west-3, eu-central-1, eu-central-2, ap-east-1, me-south-1, us-gov-west-1, us-gov-east-1, us-iso-east-1, us-iso-west-1, us-isob-east-1, me-central-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-south-1, ap-south-2, ap-northeast-1, ap-northeast-2, ap-northeast-3, eu-north-1, sa-east-1, ca-central-1, cn-north-1, cn-northwest-1, af-south-1, eu-south-1, eu-south-2, ap-southeast-4, il-central-1, ca-west-1, ap-southeast-5, mx-central-1, us-isof-south-1, us-isof-east-1, ap-southeast-7, ap-east-2, eu-isoe-west-1, ap-southeast-6
    #       vpc_id: "VPCId",
    #     },
    #     caller_reference: "Nonce", # required
    #     hosted_zone_config: {
    #       comment: "ResourceDescription",
    #       private_zone: false,
    #     },
    #     delegation_set_id: "ResourceId",
    #   })
    #
    # @example Response structure
    #
    #   resp.hosted_zone.id #=> String
    #   resp.hosted_zone.name #=> String
    #   resp.hosted_zone.caller_reference #=> String
    #   resp.hosted_zone.config.comment #=> String
    #   resp.hosted_zone.config.private_zone #=> Boolean
    #   resp.hosted_zone.resource_record_set_count #=> Integer
    #   resp.hosted_zone.linked_service.service_principal #=> String
    #   resp.hosted_zone.linked_service.description #=> String
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #   resp.delegation_set.id #=> String
    #   resp.delegation_set.caller_reference #=> String
    #   resp.delegation_set.name_servers #=> Array
    #   resp.delegation_set.name_servers[0] #=> String
    #   resp.vpc.vpc_region #=> String, one of "us-east-1", "us-east-2", "us-west-1", "us-west-2", "eu-west-1", "eu-west-2", "eu-west-3", "eu-central-1", "eu-central-2", "ap-east-1", "me-south-1", "us-gov-west-1", "us-gov-east-1", "us-iso-east-1", "us-iso-west-1", "us-isob-east-1", "me-central-1", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ap-south-1", "ap-south-2", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "eu-north-1", "sa-east-1", "ca-central-1", "cn-north-1", "cn-northwest-1", "af-south-1", "eu-south-1", "eu-south-2", "ap-southeast-4", "il-central-1", "ca-west-1", "ap-southeast-5", "mx-central-1", "us-isof-south-1", "us-isof-east-1", "ap-southeast-7", "ap-east-2", "eu-isoe-west-1", "ap-southeast-6"
    #   resp.vpc.vpc_id #=> String
    #   resp.location #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateHostedZone AWS API Documentation
    #
    # @overload create_hosted_zone(params = {})
    # @param [Hash] params ({})
    def create_hosted_zone(params = {}, options = {})
      req = build_request(:create_hosted_zone, params)
      req.send_request(options)
    end

    # Creates a new key-signing key (KSK) associated with a hosted zone. You
    # can only have two KSKs per hosted zone.
    #
    # @option params [required, String] :caller_reference
    #   A unique string that identifies the request.
    #
    # @option params [required, String] :hosted_zone_id
    #   The unique string (ID) used to identify a hosted zone.
    #
    # @option params [required, String] :key_management_service_arn
    #   The Amazon resource name (ARN) for a customer managed key in Key
    #   Management Service (KMS). The `KeyManagementServiceArn` must be unique
    #   for each key-signing key (KSK) in a single hosted zone. To see an
    #   example of `KeyManagementServiceArn` that grants the correct
    #   permissions for DNSSEC, scroll down to **Example**.
    #
    #   You must configure the customer managed customer managed key as
    #   follows:
    #
    #   Status
    #
    #   : Enabled
    #
    #   Key spec
    #
    #   : ECC\_NIST\_P256
    #
    #   Key usage
    #
    #   : Sign and verify
    #
    #   Key policy
    #
    #   : The key policy must give permission for the following actions:
    #
    #     * DescribeKey
    #
    #     * GetPublicKey
    #
    #     * Sign
    #
    #     The key policy must also include the Amazon Route 53 service in the
    #     principal for your account. Specify the following:
    #
    #     * `"Service": "dnssec-route53.amazonaws.com"`
    #
    #     ^
    #
    #   For more information about working with a customer managed key in KMS,
    #   see [Key Management Service concepts][1].
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html
    #
    # @option params [required, String] :name
    #   A string used to identify a key-signing key (KSK). `Name` can include
    #   numbers, letters, and underscores (\_). `Name` must be unique for each
    #   key-signing key in the same hosted zone.
    #
    # @option params [required, String] :status
    #   A string specifying the initial status of the key-signing key (KSK).
    #   You can set the value to `ACTIVE` or `INACTIVE`.
    #
    # @return [Types::CreateKeySigningKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateKeySigningKeyResponse#change_info #change_info} => Types::ChangeInfo
    #   * {Types::CreateKeySigningKeyResponse#key_signing_key #key_signing_key} => Types::KeySigningKey
    #   * {Types::CreateKeySigningKeyResponse#location #location} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_key_signing_key({
    #     caller_reference: "Nonce", # required
    #     hosted_zone_id: "ResourceId", # required
    #     key_management_service_arn: "SigningKeyString", # required
    #     name: "SigningKeyName", # required
    #     status: "SigningKeyStatus", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #   resp.key_signing_key.name #=> String
    #   resp.key_signing_key.kms_arn #=> String
    #   resp.key_signing_key.flag #=> Integer
    #   resp.key_signing_key.signing_algorithm_mnemonic #=> String
    #   resp.key_signing_key.signing_algorithm_type #=> Integer
    #   resp.key_signing_key.digest_algorithm_mnemonic #=> String
    #   resp.key_signing_key.digest_algorithm_type #=> Integer
    #   resp.key_signing_key.key_tag #=> Integer
    #   resp.key_signing_key.digest_value #=> String
    #   resp.key_signing_key.public_key #=> String
    #   resp.key_signing_key.ds_record #=> String
    #   resp.key_signing_key.dnskey_record #=> String
    #   resp.key_signing_key.status #=> String
    #   resp.key_signing_key.status_message #=> String
    #   resp.key_signing_key.created_date #=> Time
    #   resp.key_signing_key.last_modified_date #=> Time
    #   resp.location #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateKeySigningKey AWS API Documentation
    #
    # @overload create_key_signing_key(params = {})
    # @param [Hash] params ({})
    def create_key_signing_key(params = {}, options = {})
      req = build_request(:create_key_signing_key, params)
      req.send_request(options)
    end

    # Creates a configuration for DNS query logging. After you create a
    # query logging configuration, Amazon Route 53 begins to publish log
    # data to an Amazon CloudWatch Logs log group.
    #
    # DNS query logs contain information about the queries that Route 53
    # receives for a specified public hosted zone, such as the following:
    #
    # * Route 53 edge location that responded to the DNS query
    #
    # * Domain or subdomain that was requested
    #
    # * DNS record type, such as A or AAAA
    #
    # * DNS response code, such as `NoError` or `ServFail`
    #
    # Log Group and Resource Policy
    #
    # : Before you create a query logging configuration, perform the
    #   following operations.
    #
    #   <note markdown="1"> If you create a query logging configuration using the Route 53
    #   console, Route 53 performs these operations automatically.
    #
    #    </note>
    #
    #   1.  Create a CloudWatch Logs log group, and make note of the ARN,
    #       which you specify when you create a query logging configuration.
    #       Note the following:
    #
    #       * You must create the log group in the us-east-1 region.
    #
    #       * You must use the same Amazon Web Services account to create
    #         the log group and the hosted zone that you want to configure
    #         query logging for.
    #
    #       * When you create log groups for query logging, we recommend
    #         that you use a consistent prefix, for example:
    #
    #         `/aws/route53/hosted zone name `
    #
    #         In the next step, you'll create a resource policy, which
    #         controls access to one or more log groups and the associated
    #         Amazon Web Services resources, such as Route 53 hosted zones.
    #         There's a limit on the number of resource policies that you
    #         can create, so we recommend that you use a consistent prefix
    #         so you can use the same resource policy for all the log groups
    #         that you create for query logging.
    #   2.  Create a CloudWatch Logs resource policy, and give it the
    #       permissions that Route 53 needs to create log streams and to
    #       send query logs to log streams. You must create the CloudWatch
    #       Logs resource policy in the us-east-1 region. For the value of
    #       `Resource`, specify the ARN for the log group that you created
    #       in the previous step. To use the same resource policy for all
    #       the CloudWatch Logs log groups that you created for query
    #       logging configurations, replace the hosted zone name with `*`,
    #       for example:
    #
    #       `arn:aws:logs:us-east-1:123412341234:log-group:/aws/route53/*`
    #
    #       To avoid the confused deputy problem, a security issue where an
    #       entity without a permission for an action can coerce a
    #       more-privileged entity to perform it, you can optionally limit
    #       the permissions that a service has to a resource in a
    #       resource-based policy by supplying the following values:
    #
    #       * For `aws:SourceArn`, supply the hosted zone ARN used in
    #         creating the query logging configuration. For example,
    #         `aws:SourceArn: arn:aws:route53:::hostedzone/hosted zone ID`.
    #
    #       * For `aws:SourceAccount`, supply the account ID for the account
    #         that creates the query logging configuration. For example,
    #         `aws:SourceAccount:111111111111`.
    #       For more information, see [The confused deputy problem][1] in
    #       the *Amazon Web Services IAM User Guide*.
    #
    #       <note markdown="1"> You can't use the CloudWatch console to create or edit a
    #       resource policy. You must use the CloudWatch API, one of the
    #       Amazon Web Services SDKs, or the CLI.
    #
    #        </note>
    #
    # Log Streams and Edge Locations
    #
    # : When Route 53 finishes creating the configuration for DNS query
    #   logging, it does the following:
    #
    #   * Creates a log stream for an edge location the first time that the
    #     edge location responds to DNS queries for the specified hosted
    #     zone. That log stream is used to log all queries that Route 53
    #     responds to for that edge location.
    #
    #   * Begins to send query logs to the applicable log stream.
    #
    #   The name of each log stream is in the following format:
    #
    #   ` hosted zone ID/edge location code `
    #
    #   The edge location code is a three-letter code and an arbitrarily
    #   assigned number, for example, DFW3. The three-letter code typically
    #   corresponds with the International Air Transport Association airport
    #   code for an airport near the edge location. (These abbreviations
    #   might change in the future.) For a list of edge locations, see "The
    #   Route 53 Global Network" on the [Route 53 Product Details][2] page.
    #
    # Queries That Are Logged
    #
    # : Query logs contain only the queries that DNS resolvers forward to
    #   Route 53. If a DNS resolver has already cached the response to a
    #   query (such as the IP address for a load balancer for example.com),
    #   the resolver will continue to return the cached response. It
    #   doesn't forward another query to Route 53 until the TTL for the
    #   corresponding resource record set expires. Depending on how many DNS
    #   queries are submitted for a resource record set, and depending on
    #   the TTL for that resource record set, query logs might contain
    #   information about only one query out of every several thousand
    #   queries that are submitted to DNS. For more information about how
    #   DNS works, see [Routing Internet Traffic to Your Website or Web
    #   Application][3] in the *Amazon Route 53 Developer Guide*.
    #
    # Log File Format
    #
    # : For a list of the values in each query log and the format of each
    #   value, see [Logging DNS Queries][4] in the *Amazon Route 53
    #   Developer Guide*.
    #
    # Pricing
    #
    # : For information about charges for query logs, see [Amazon CloudWatch
    #   Pricing][5].
    #
    # How to Stop Logging
    #
    # : If you want Route 53 to stop sending query logs to CloudWatch Logs,
    #   delete the query logging configuration. For more information, see
    #   [DeleteQueryLoggingConfig][6].
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html
    # [2]: http://aws.amazon.com/route53/details/
    # [3]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/welcome-dns-service.html
    # [4]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html
    # [5]: http://aws.amazon.com/cloudwatch/pricing/
    # [6]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_DeleteQueryLoggingConfig.html
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the hosted zone that you want to log queries for. You can
    #   log queries only for public hosted zones.
    #
    # @option params [required, String] :cloud_watch_logs_log_group_arn
    #   The Amazon Resource Name (ARN) for the log group that you want to
    #   Amazon Route 53 to send query logs to. This is the format of the ARN:
    #
    #   arn:aws:logs:*region*:*account-id*:log-group:*log\_group\_name*
    #
    #   To get the ARN for a log group, you can use the CloudWatch console,
    #   the [DescribeLogGroups][1] API action, the [describe-log-groups][2]
    #   command, or the applicable command in one of the Amazon Web Services
    #   SDKs.
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLogGroups.html
    #   [2]: https://docs.aws.amazon.com/cli/latest/reference/logs/describe-log-groups.html
    #
    # @return [Types::CreateQueryLoggingConfigResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateQueryLoggingConfigResponse#query_logging_config #query_logging_config} => Types::QueryLoggingConfig
    #   * {Types::CreateQueryLoggingConfigResponse#location #location} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_query_logging_config({
    #     hosted_zone_id: "ResourceId", # required
    #     cloud_watch_logs_log_group_arn: "CloudWatchLogsLogGroupArn", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.query_logging_config.id #=> String
    #   resp.query_logging_config.hosted_zone_id #=> String
    #   resp.query_logging_config.cloud_watch_logs_log_group_arn #=> String
    #   resp.location #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateQueryLoggingConfig AWS API Documentation
    #
    # @overload create_query_logging_config(params = {})
    # @param [Hash] params ({})
    def create_query_logging_config(params = {}, options = {})
      req = build_request(:create_query_logging_config, params)
      req.send_request(options)
    end

    # Creates a delegation set (a group of four name servers) that can be
    # reused by multiple hosted zones that were created by the same Amazon
    # Web Services account.
    #
    # You can also create a reusable delegation set that uses the four name
    # servers that are associated with an existing hosted zone. Specify the
    # hosted zone ID in the `CreateReusableDelegationSet` request.
    #
    # <note markdown="1"> You can't associate a reusable delegation set with a private hosted
    # zone.
    #
    #  </note>
    #
    # For information about using a reusable delegation set to configure
    # white label name servers, see [Configuring White Label Name
    # Servers][1].
    #
    # The process for migrating existing hosted zones to use a reusable
    # delegation set is comparable to the process for configuring white
    # label name servers. You need to perform the following steps:
    #
    # 1.  Create a reusable delegation set.
    #
    # 2.  Recreate hosted zones, and reduce the TTL to 60 seconds or less.
    #
    # 3.  Recreate resource record sets in the new hosted zones.
    #
    # 4.  Change the registrar's name servers to use the name servers for
    #     the new hosted zones.
    #
    # 5.  Monitor traffic for the website or application.
    #
    # 6.  Change TTLs back to their original values.
    #
    # If you want to migrate existing hosted zones to use a reusable
    # delegation set, the existing hosted zones can't use any of the name
    # servers that are assigned to the reusable delegation set. If one or
    # more hosted zones do use one or more name servers that are assigned to
    # the reusable delegation set, you can do one of the following:
    #
    # * For small numbers of hosted zones—up to a few hundred—it's
    #   relatively easy to create reusable delegation sets until you get one
    #   that has four name servers that don't overlap with any of the name
    #   servers in your hosted zones.
    #
    # * For larger numbers of hosted zones, the easiest solution is to use
    #   more than one reusable delegation set.
    #
    # * For larger numbers of hosted zones, you can also migrate hosted
    #   zones that have overlapping name servers to hosted zones that don't
    #   have overlapping name servers, then migrate the hosted zones again
    #   to use the reusable delegation set.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/white-label-name-servers.html
    #
    # @option params [required, String] :caller_reference
    #   A unique string that identifies the request, and that allows you to
    #   retry failed `CreateReusableDelegationSet` requests without the risk
    #   of executing the operation twice. You must use a unique
    #   `CallerReference` string every time you submit a
    #   `CreateReusableDelegationSet` request. `CallerReference` can be any
    #   unique string, for example a date/time stamp.
    #
    # @option params [String] :hosted_zone_id
    #   If you want to mark the delegation set for an existing hosted zone as
    #   reusable, the ID for that hosted zone.
    #
    # @return [Types::CreateReusableDelegationSetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateReusableDelegationSetResponse#delegation_set #delegation_set} => Types::DelegationSet
    #   * {Types::CreateReusableDelegationSetResponse#location #location} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_reusable_delegation_set({
    #     caller_reference: "Nonce", # required
    #     hosted_zone_id: "ResourceId",
    #   })
    #
    # @example Response structure
    #
    #   resp.delegation_set.id #=> String
    #   resp.delegation_set.caller_reference #=> String
    #   resp.delegation_set.name_servers #=> Array
    #   resp.delegation_set.name_servers[0] #=> String
    #   resp.location #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateReusableDelegationSet AWS API Documentation
    #
    # @overload create_reusable_delegation_set(params = {})
    # @param [Hash] params ({})
    def create_reusable_delegation_set(params = {}, options = {})
      req = build_request(:create_reusable_delegation_set, params)
      req.send_request(options)
    end

    # Creates a traffic policy, which you use to create multiple DNS
    # resource record sets for one domain name (such as example.com) or one
    # subdomain name (such as www.example.com).
    #
    # @option params [required, String] :name
    #   The name of the traffic policy.
    #
    # @option params [required, String] :document
    #   The definition of this traffic policy in JSON format. For more
    #   information, see [Traffic Policy Document Format][1].
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/api-policies-traffic-policy-document-format.html
    #
    # @option params [String] :comment
    #   (Optional) Any comments that you want to include about the traffic
    #   policy.
    #
    # @return [Types::CreateTrafficPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateTrafficPolicyResponse#traffic_policy #traffic_policy} => Types::TrafficPolicy
    #   * {Types::CreateTrafficPolicyResponse#location #location} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_traffic_policy({
    #     name: "TrafficPolicyName", # required
    #     document: "TrafficPolicyDocument", # required
    #     comment: "TrafficPolicyComment",
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy.id #=> String
    #   resp.traffic_policy.version #=> Integer
    #   resp.traffic_policy.name #=> String
    #   resp.traffic_policy.type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.traffic_policy.document #=> String
    #   resp.traffic_policy.comment #=> String
    #   resp.location #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateTrafficPolicy AWS API Documentation
    #
    # @overload create_traffic_policy(params = {})
    # @param [Hash] params ({})
    def create_traffic_policy(params = {}, options = {})
      req = build_request(:create_traffic_policy, params)
      req.send_request(options)
    end

    # Creates resource record sets in a specified hosted zone based on the
    # settings in a specified traffic policy version. In addition,
    # `CreateTrafficPolicyInstance` associates the resource record sets with
    # a specified domain name (such as example.com) or subdomain name (such
    # as www.example.com). Amazon Route 53 responds to DNS queries for the
    # domain or subdomain name by using the resource record sets that
    # `CreateTrafficPolicyInstance` created.
    #
    # <note markdown="1"> After you submit an `CreateTrafficPolicyInstance` request, there's a
    # brief delay while Amazon Route 53 creates the resource record sets
    # that are specified in the traffic policy definition. Use
    # `GetTrafficPolicyInstance` with the `id` of new traffic policy
    # instance to confirm that the `CreateTrafficPolicyInstance` request
    # completed successfully. For more information, see the `State` response
    # element.
    #
    #  </note>
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the hosted zone that you want Amazon Route 53 to create
    #   resource record sets in by using the configuration in a traffic
    #   policy.
    #
    # @option params [required, String] :name
    #   The domain name (such as example.com) or subdomain name (such as
    #   www.example.com) for which Amazon Route 53 responds to DNS queries by
    #   using the resource record sets that Route 53 creates for this traffic
    #   policy instance.
    #
    # @option params [required, Integer] :ttl
    #   (Optional) The TTL that you want Amazon Route 53 to assign to all of
    #   the resource record sets that it creates in the specified hosted zone.
    #
    # @option params [required, String] :traffic_policy_id
    #   The ID of the traffic policy that you want to use to create resource
    #   record sets in the specified hosted zone.
    #
    # @option params [required, Integer] :traffic_policy_version
    #   The version of the traffic policy that you want to use to create
    #   resource record sets in the specified hosted zone.
    #
    # @return [Types::CreateTrafficPolicyInstanceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateTrafficPolicyInstanceResponse#traffic_policy_instance #traffic_policy_instance} => Types::TrafficPolicyInstance
    #   * {Types::CreateTrafficPolicyInstanceResponse#location #location} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_traffic_policy_instance({
    #     hosted_zone_id: "ResourceId", # required
    #     name: "DNSName", # required
    #     ttl: 1, # required
    #     traffic_policy_id: "TrafficPolicyId", # required
    #     traffic_policy_version: 1, # required
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy_instance.id #=> String
    #   resp.traffic_policy_instance.hosted_zone_id #=> String
    #   resp.traffic_policy_instance.name #=> String
    #   resp.traffic_policy_instance.ttl #=> Integer
    #   resp.traffic_policy_instance.state #=> String
    #   resp.traffic_policy_instance.message #=> String
    #   resp.traffic_policy_instance.traffic_policy_id #=> String
    #   resp.traffic_policy_instance.traffic_policy_version #=> Integer
    #   resp.traffic_policy_instance.traffic_policy_type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.location #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateTrafficPolicyInstance AWS API Documentation
    #
    # @overload create_traffic_policy_instance(params = {})
    # @param [Hash] params ({})
    def create_traffic_policy_instance(params = {}, options = {})
      req = build_request(:create_traffic_policy_instance, params)
      req.send_request(options)
    end

    # Creates a new version of an existing traffic policy. When you create a
    # new version of a traffic policy, you specify the ID of the traffic
    # policy that you want to update and a JSON-formatted document that
    # describes the new version. You use traffic policies to create multiple
    # DNS resource record sets for one domain name (such as example.com) or
    # one subdomain name (such as www.example.com). You can create a maximum
    # of 1000 versions of a traffic policy. If you reach the limit and need
    # to create another version, you'll need to start a new traffic policy.
    #
    # @option params [required, String] :id
    #   The ID of the traffic policy for which you want to create a new
    #   version.
    #
    # @option params [required, String] :document
    #   The definition of this version of the traffic policy, in JSON format.
    #   You specified the JSON in the `CreateTrafficPolicyVersion` request.
    #   For more information about the JSON format, see
    #   [CreateTrafficPolicy][1].
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateTrafficPolicy.html
    #
    # @option params [String] :comment
    #   The comment that you specified in the `CreateTrafficPolicyVersion`
    #   request, if any.
    #
    # @return [Types::CreateTrafficPolicyVersionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateTrafficPolicyVersionResponse#traffic_policy #traffic_policy} => Types::TrafficPolicy
    #   * {Types::CreateTrafficPolicyVersionResponse#location #location} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_traffic_policy_version({
    #     id: "TrafficPolicyId", # required
    #     document: "TrafficPolicyDocument", # required
    #     comment: "TrafficPolicyComment",
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy.id #=> String
    #   resp.traffic_policy.version #=> Integer
    #   resp.traffic_policy.name #=> String
    #   resp.traffic_policy.type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.traffic_policy.document #=> String
    #   resp.traffic_policy.comment #=> String
    #   resp.location #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateTrafficPolicyVersion AWS API Documentation
    #
    # @overload create_traffic_policy_version(params = {})
    # @param [Hash] params ({})
    def create_traffic_policy_version(params = {}, options = {})
      req = build_request(:create_traffic_policy_version, params)
      req.send_request(options)
    end

    # Authorizes the Amazon Web Services account that created a specified
    # VPC to submit an `AssociateVPCWithHostedZone` request to associate the
    # VPC with a specified hosted zone that was created by a different
    # account. To submit a `CreateVPCAssociationAuthorization` request, you
    # must use the account that created the hosted zone. After you authorize
    # the association, use the account that created the VPC to submit an
    # `AssociateVPCWithHostedZone` request.
    #
    # <note markdown="1"> If you want to associate multiple VPCs that you created by using one
    # account with a hosted zone that you created by using a different
    # account, you must submit one authorization request for each VPC.
    #
    #  </note>
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the private hosted zone that you want to authorize
    #   associating a VPC with.
    #
    # @option params [required, Types::VPC] :vpc
    #   A complex type that contains the VPC ID and region for the VPC that
    #   you want to authorize associating with your hosted zone.
    #
    # @return [Types::CreateVPCAssociationAuthorizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateVPCAssociationAuthorizationResponse#hosted_zone_id #hosted_zone_id} => String
    #   * {Types::CreateVPCAssociationAuthorizationResponse#vpc #vpc} => Types::VPC
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_vpc_association_authorization({
    #     hosted_zone_id: "ResourceId", # required
    #     vpc: { # required
    #       vpc_region: "us-east-1", # accepts us-east-1, us-east-2, us-west-1, us-west-2, eu-west-1, eu-west-2, eu-west-3, eu-central-1, eu-central-2, ap-east-1, me-south-1, us-gov-west-1, us-gov-east-1, us-iso-east-1, us-iso-west-1, us-isob-east-1, me-central-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-south-1, ap-south-2, ap-northeast-1, ap-northeast-2, ap-northeast-3, eu-north-1, sa-east-1, ca-central-1, cn-north-1, cn-northwest-1, af-south-1, eu-south-1, eu-south-2, ap-southeast-4, il-central-1, ca-west-1, ap-southeast-5, mx-central-1, us-isof-south-1, us-isof-east-1, ap-southeast-7, ap-east-2, eu-isoe-west-1, ap-southeast-6
    #       vpc_id: "VPCId",
    #     },
    #   })
    #
    # @example Response structure
    #
    #   resp.hosted_zone_id #=> String
    #   resp.vpc.vpc_region #=> String, one of "us-east-1", "us-east-2", "us-west-1", "us-west-2", "eu-west-1", "eu-west-2", "eu-west-3", "eu-central-1", "eu-central-2", "ap-east-1", "me-south-1", "us-gov-west-1", "us-gov-east-1", "us-iso-east-1", "us-iso-west-1", "us-isob-east-1", "me-central-1", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ap-south-1", "ap-south-2", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "eu-north-1", "sa-east-1", "ca-central-1", "cn-north-1", "cn-northwest-1", "af-south-1", "eu-south-1", "eu-south-2", "ap-southeast-4", "il-central-1", "ca-west-1", "ap-southeast-5", "mx-central-1", "us-isof-south-1", "us-isof-east-1", "ap-southeast-7", "ap-east-2", "eu-isoe-west-1", "ap-southeast-6"
    #   resp.vpc.vpc_id #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/CreateVPCAssociationAuthorization AWS API Documentation
    #
    # @overload create_vpc_association_authorization(params = {})
    # @param [Hash] params ({})
    def create_vpc_association_authorization(params = {}, options = {})
      req = build_request(:create_vpc_association_authorization, params)
      req.send_request(options)
    end

    # Deactivates a key-signing key (KSK) so that it will not be used for
    # signing by DNSSEC. This operation changes the KSK status to
    # `INACTIVE`.
    #
    # @option params [required, String] :hosted_zone_id
    #   A unique string used to identify a hosted zone.
    #
    # @option params [required, String] :name
    #   A string used to identify a key-signing key (KSK).
    #
    # @return [Types::DeactivateKeySigningKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DeactivateKeySigningKeyResponse#change_info #change_info} => Types::ChangeInfo
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.deactivate_key_signing_key({
    #     hosted_zone_id: "ResourceId", # required
    #     name: "SigningKeyName", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeactivateKeySigningKey AWS API Documentation
    #
    # @overload deactivate_key_signing_key(params = {})
    # @param [Hash] params ({})
    def deactivate_key_signing_key(params = {}, options = {})
      req = build_request(:deactivate_key_signing_key, params)
      req.send_request(options)
    end

    # Deletes a CIDR collection in the current Amazon Web Services account.
    # The collection must be empty before it can be deleted.
    #
    # @option params [required, String] :id
    #   The UUID of the collection to delete.
    #
    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_cidr_collection({
    #     id: "UUID", # required
    #   })
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteCidrCollection AWS API Documentation
    #
    # @overload delete_cidr_collection(params = {})
    # @param [Hash] params ({})
    def delete_cidr_collection(params = {}, options = {})
      req = build_request(:delete_cidr_collection, params)
      req.send_request(options)
    end

    # Deletes a health check.
    #
    # Amazon Route 53 does not prevent you from deleting a health check even
    # if the health check is associated with one or more resource record
    # sets. If you delete a health check and you don't update the
    # associated resource record sets, the future status of the health check
    # can't be predicted and may change. This will affect the routing of
    # DNS queries for your DNS failover configuration. For more information,
    # see [Replacing and Deleting Health Checks][1] in the *Amazon Route 53
    # Developer Guide*.
    #
    # If you're using Cloud Map and you configured Cloud Map to create a
    # Route 53 health check when you register an instance, you can't use
    # the Route 53 `DeleteHealthCheck` command to delete the health check.
    # The health check is deleted automatically when you deregister the
    # instance; there can be a delay of several hours before the health
    # check is deleted from Route 53.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/health-checks-creating-deleting.html#health-checks-deleting.html
    #
    # @option params [required, String] :health_check_id
    #   The ID of the health check that you want to delete.
    #
    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_health_check({
    #     health_check_id: "HealthCheckId", # required
    #   })
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteHealthCheck AWS API Documentation
    #
    # @overload delete_health_check(params = {})
    # @param [Hash] params ({})
    def delete_health_check(params = {}, options = {})
      req = build_request(:delete_health_check, params)
      req.send_request(options)
    end

    # Deletes a hosted zone.
    #
    # If the hosted zone was created by another service, such as Cloud Map,
    # see [Deleting Public Hosted Zones That Were Created by Another
    # Service][1] in the *Amazon Route 53 Developer Guide* for information
    # about how to delete it. (The process is the same for public and
    # private hosted zones that were created by another service.)
    #
    # If you want to keep your domain registration but you want to stop
    # routing internet traffic to your website or web application, we
    # recommend that you delete resource record sets in the hosted zone
    # instead of deleting the hosted zone.
    #
    # If you delete a hosted zone, you can't undelete it. You must create a
    # new hosted zone and update the name servers for your domain
    # registration, which can require up to 48 hours to take effect. (If you
    # delegated responsibility for a subdomain to a hosted zone and you
    # delete the child hosted zone, you must update the name servers in the
    # parent hosted zone.) In addition, if you delete a hosted zone, someone
    # could hijack the domain and route traffic to their own resources using
    # your domain name.
    #
    # If you want to avoid the monthly charge for the hosted zone, you can
    # transfer DNS service for the domain to a free DNS service. When you
    # transfer DNS service, you have to update the name servers for the
    # domain registration. If the domain is registered with Route 53, see
    # [UpdateDomainNameservers][2] for information about how to replace
    # Route 53 name servers with name servers for the new DNS service. If
    # the domain is registered with another registrar, use the method
    # provided by the registrar to update name servers for the domain
    # registration. For more information, perform an internet search on
    # "free DNS service."
    #
    # You can delete a hosted zone only if it contains only the default SOA
    # record and NS resource record sets. If the hosted zone contains other
    # resource record sets, you must delete them before you can delete the
    # hosted zone. If you try to delete a hosted zone that contains other
    # resource record sets, the request fails, and Route 53 returns a
    # `HostedZoneNotEmpty` error. For information about deleting records
    # from your hosted zone, see [ChangeResourceRecordSets][3].
    #
    # To verify that the hosted zone has been deleted, do one of the
    # following:
    #
    # * Use the `GetHostedZone` action to request information about the
    #   hosted zone.
    #
    # * Use the `ListHostedZones` action to get a list of the hosted zones
    #   associated with the current Amazon Web Services account.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DeleteHostedZone.html#delete-public-hosted-zone-created-by-another-service
    # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_UpdateDomainNameservers.html
    # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html
    #
    # @option params [required, String] :id
    #   The ID of the hosted zone you want to delete.
    #
    # @return [Types::DeleteHostedZoneResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DeleteHostedZoneResponse#change_info #change_info} => Types::ChangeInfo
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_hosted_zone({
    #     id: "ResourceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteHostedZone AWS API Documentation
    #
    # @overload delete_hosted_zone(params = {})
    # @param [Hash] params ({})
    def delete_hosted_zone(params = {}, options = {})
      req = build_request(:delete_hosted_zone, params)
      req.send_request(options)
    end

    # Deletes a key-signing key (KSK). Before you can delete a KSK, you must
    # deactivate it. The KSK must be deactivated before you can delete it
    # regardless of whether the hosted zone is enabled for DNSSEC signing.
    #
    # You can use [DeactivateKeySigningKey][1] to deactivate the key before
    # you delete it.
    #
    # Use [GetDNSSEC][2] to verify that the KSK is in an `INACTIVE` status.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_DeactivateKeySigningKey.html
    # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_GetDNSSEC.html
    #
    # @option params [required, String] :hosted_zone_id
    #   A unique string used to identify a hosted zone.
    #
    # @option params [required, String] :name
    #   A string used to identify a key-signing key (KSK).
    #
    # @return [Types::DeleteKeySigningKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DeleteKeySigningKeyResponse#change_info #change_info} => Types::ChangeInfo
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_key_signing_key({
    #     hosted_zone_id: "ResourceId", # required
    #     name: "SigningKeyName", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteKeySigningKey AWS API Documentation
    #
    # @overload delete_key_signing_key(params = {})
    # @param [Hash] params ({})
    def delete_key_signing_key(params = {}, options = {})
      req = build_request(:delete_key_signing_key, params)
      req.send_request(options)
    end

    # Deletes a configuration for DNS query logging. If you delete a
    # configuration, Amazon Route 53 stops sending query logs to CloudWatch
    # Logs. Route 53 doesn't delete any logs that are already in CloudWatch
    # Logs.
    #
    # For more information about DNS query logs, see
    # [CreateQueryLoggingConfig][1].
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateQueryLoggingConfig.html
    #
    # @option params [required, String] :id
    #   The ID of the configuration that you want to delete.
    #
    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_query_logging_config({
    #     id: "QueryLoggingConfigId", # required
    #   })
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteQueryLoggingConfig AWS API Documentation
    #
    # @overload delete_query_logging_config(params = {})
    # @param [Hash] params ({})
    def delete_query_logging_config(params = {}, options = {})
      req = build_request(:delete_query_logging_config, params)
      req.send_request(options)
    end

    # Deletes a reusable delegation set.
    #
    # You can delete a reusable delegation set only if it isn't associated
    # with any hosted zones.
    #
    # To verify that the reusable delegation set is not associated with any
    # hosted zones, submit a [GetReusableDelegationSet][1] request and
    # specify the ID of the reusable delegation set that you want to delete.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_GetReusableDelegationSet.html
    #
    # @option params [required, String] :id
    #   The ID of the reusable delegation set that you want to delete.
    #
    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_reusable_delegation_set({
    #     id: "ResourceId", # required
    #   })
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteReusableDelegationSet AWS API Documentation
    #
    # @overload delete_reusable_delegation_set(params = {})
    # @param [Hash] params ({})
    def delete_reusable_delegation_set(params = {}, options = {})
      req = build_request(:delete_reusable_delegation_set, params)
      req.send_request(options)
    end

    # Deletes a traffic policy.
    #
    # When you delete a traffic policy, Route 53 sets a flag on the policy
    # to indicate that it has been deleted. However, Route 53 never fully
    # deletes the traffic policy. Note the following:
    #
    # * Deleted traffic policies aren't listed if you run
    #   [ListTrafficPolicies][1].
    #
    # * There's no way to get a list of deleted policies.
    #
    # * If you retain the ID of the policy, you can get information about
    #   the policy, including the traffic policy document, by running
    #   [GetTrafficPolicy][2].
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_ListTrafficPolicies.html
    # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_GetTrafficPolicy.html
    #
    # @option params [required, String] :id
    #   The ID of the traffic policy that you want to delete.
    #
    # @option params [required, Integer] :version
    #   The version number of the traffic policy that you want to delete.
    #
    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_traffic_policy({
    #     id: "TrafficPolicyId", # required
    #     version: 1, # required
    #   })
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteTrafficPolicy AWS API Documentation
    #
    # @overload delete_traffic_policy(params = {})
    # @param [Hash] params ({})
    def delete_traffic_policy(params = {}, options = {})
      req = build_request(:delete_traffic_policy, params)
      req.send_request(options)
    end

    # Deletes a traffic policy instance and all of the resource record sets
    # that Amazon Route 53 created when you created the instance.
    #
    # <note markdown="1"> In the Route 53 console, traffic policy instances are known as policy
    # records.
    #
    #  </note>
    #
    # @option params [required, String] :id
    #   The ID of the traffic policy instance that you want to delete.
    #
    #   When you delete a traffic policy instance, Amazon Route 53 also
    #   deletes all of the resource record sets that were created when you
    #   created the traffic policy instance.
    #
    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_traffic_policy_instance({
    #     id: "TrafficPolicyInstanceId", # required
    #   })
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteTrafficPolicyInstance AWS API Documentation
    #
    # @overload delete_traffic_policy_instance(params = {})
    # @param [Hash] params ({})
    def delete_traffic_policy_instance(params = {}, options = {})
      req = build_request(:delete_traffic_policy_instance, params)
      req.send_request(options)
    end

    # Removes authorization to submit an `AssociateVPCWithHostedZone`
    # request to associate a specified VPC with a hosted zone that was
    # created by a different account. You must use the account that created
    # the hosted zone to submit a `DeleteVPCAssociationAuthorization`
    # request.
    #
    # Sending this request only prevents the Amazon Web Services account
    # that created the VPC from associating the VPC with the Amazon Route 53
    # hosted zone in the future. If the VPC is already associated with the
    # hosted zone, `DeleteVPCAssociationAuthorization` won't disassociate
    # the VPC from the hosted zone. If you want to delete an existing
    # association, use `DisassociateVPCFromHostedZone`.
    #
    # @option params [required, String] :hosted_zone_id
    #   When removing authorization to associate a VPC that was created by one
    #   Amazon Web Services account with a hosted zone that was created with a
    #   different Amazon Web Services account, the ID of the hosted zone.
    #
    # @option params [required, Types::VPC] :vpc
    #   When removing authorization to associate a VPC that was created by one
    #   Amazon Web Services account with a hosted zone that was created with a
    #   different Amazon Web Services account, a complex type that includes
    #   the ID and region of the VPC.
    #
    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_vpc_association_authorization({
    #     hosted_zone_id: "ResourceId", # required
    #     vpc: { # required
    #       vpc_region: "us-east-1", # accepts us-east-1, us-east-2, us-west-1, us-west-2, eu-west-1, eu-west-2, eu-west-3, eu-central-1, eu-central-2, ap-east-1, me-south-1, us-gov-west-1, us-gov-east-1, us-iso-east-1, us-iso-west-1, us-isob-east-1, me-central-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-south-1, ap-south-2, ap-northeast-1, ap-northeast-2, ap-northeast-3, eu-north-1, sa-east-1, ca-central-1, cn-north-1, cn-northwest-1, af-south-1, eu-south-1, eu-south-2, ap-southeast-4, il-central-1, ca-west-1, ap-southeast-5, mx-central-1, us-isof-south-1, us-isof-east-1, ap-southeast-7, ap-east-2, eu-isoe-west-1, ap-southeast-6
    #       vpc_id: "VPCId",
    #     },
    #   })
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DeleteVPCAssociationAuthorization AWS API Documentation
    #
    # @overload delete_vpc_association_authorization(params = {})
    # @param [Hash] params ({})
    def delete_vpc_association_authorization(params = {}, options = {})
      req = build_request(:delete_vpc_association_authorization, params)
      req.send_request(options)
    end

    # Disables DNSSEC signing in a specific hosted zone. This action does
    # not deactivate any key-signing keys (KSKs) that are active in the
    # hosted zone.
    #
    # @option params [required, String] :hosted_zone_id
    #   A unique string used to identify a hosted zone.
    #
    # @return [Types::DisableHostedZoneDNSSECResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DisableHostedZoneDNSSECResponse#change_info #change_info} => Types::ChangeInfo
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.disable_hosted_zone_dnssec({
    #     hosted_zone_id: "ResourceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DisableHostedZoneDNSSEC AWS API Documentation
    #
    # @overload disable_hosted_zone_dnssec(params = {})
    # @param [Hash] params ({})
    def disable_hosted_zone_dnssec(params = {}, options = {})
      req = build_request(:disable_hosted_zone_dnssec, params)
      req.send_request(options)
    end

    # Disassociates an Amazon Virtual Private Cloud (Amazon VPC) from an
    # Amazon Route 53 private hosted zone. Note the following:
    #
    # * You can't disassociate the last Amazon VPC from a private hosted
    #   zone.
    #
    # * You can't convert a private hosted zone into a public hosted zone.
    #
    # * You can submit a `DisassociateVPCFromHostedZone` request using
    #   either the account that created the hosted zone or the account that
    #   created the Amazon VPC.
    #
    # * Some services, such as Cloud Map and Amazon Elastic File System
    #   (Amazon EFS) automatically create hosted zones and associate VPCs
    #   with the hosted zones. A service can create a hosted zone using your
    #   account or using its own account. You can disassociate a VPC from a
    #   hosted zone only if the service created the hosted zone using your
    #   account.
    #
    #   When you run [DisassociateVPCFromHostedZone][1], if the hosted zone
    #   has a value for `OwningAccount`, you can use
    #   `DisassociateVPCFromHostedZone`. If the hosted zone has a value for
    #   `OwningService`, you can't use `DisassociateVPCFromHostedZone`.
    #
    # <note markdown="1"> When revoking access, the hosted zone and the Amazon VPC must belong
    # to the same partition. A partition is a group of Amazon Web Services
    # Regions. Each Amazon Web Services account is scoped to one partition.
    #
    #  The following are the supported partitions:
    #
    #  * `aws` - Amazon Web Services Regions
    #
    # * `aws-cn` - China Regions
    #
    # * `aws-us-gov` - Amazon Web Services GovCloud (US) Region
    #
    #  For more information, see [Access Management][2] in the *Amazon Web
    # Services General Reference*.
    #
    #  </note>
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_ListHostedZonesByVPC.html
    # [2]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the private hosted zone that you want to disassociate a VPC
    #   from.
    #
    # @option params [required, Types::VPC] :vpc
    #   A complex type that contains information about the VPC that you're
    #   disassociating from the specified hosted zone.
    #
    # @option params [String] :comment
    #   *Optional:* A comment about the disassociation request.
    #
    # @return [Types::DisassociateVPCFromHostedZoneResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DisassociateVPCFromHostedZoneResponse#change_info #change_info} => Types::ChangeInfo
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.disassociate_vpc_from_hosted_zone({
    #     hosted_zone_id: "ResourceId", # required
    #     vpc: { # required
    #       vpc_region: "us-east-1", # accepts us-east-1, us-east-2, us-west-1, us-west-2, eu-west-1, eu-west-2, eu-west-3, eu-central-1, eu-central-2, ap-east-1, me-south-1, us-gov-west-1, us-gov-east-1, us-iso-east-1, us-iso-west-1, us-isob-east-1, me-central-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-south-1, ap-south-2, ap-northeast-1, ap-northeast-2, ap-northeast-3, eu-north-1, sa-east-1, ca-central-1, cn-north-1, cn-northwest-1, af-south-1, eu-south-1, eu-south-2, ap-southeast-4, il-central-1, ca-west-1, ap-southeast-5, mx-central-1, us-isof-south-1, us-isof-east-1, ap-southeast-7, ap-east-2, eu-isoe-west-1, ap-southeast-6
    #       vpc_id: "VPCId",
    #     },
    #     comment: "DisassociateVPCComment",
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/DisassociateVPCFromHostedZone AWS API Documentation
    #
    # @overload disassociate_vpc_from_hosted_zone(params = {})
    # @param [Hash] params ({})
    def disassociate_vpc_from_hosted_zone(params = {}, options = {})
      req = build_request(:disassociate_vpc_from_hosted_zone, params)
      req.send_request(options)
    end

    # Enables DNSSEC signing in a specific hosted zone.
    #
    # @option params [required, String] :hosted_zone_id
    #   A unique string used to identify a hosted zone.
    #
    # @return [Types::EnableHostedZoneDNSSECResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::EnableHostedZoneDNSSECResponse#change_info #change_info} => Types::ChangeInfo
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.enable_hosted_zone_dnssec({
    #     hosted_zone_id: "ResourceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/EnableHostedZoneDNSSEC AWS API Documentation
    #
    # @overload enable_hosted_zone_dnssec(params = {})
    # @param [Hash] params ({})
    def enable_hosted_zone_dnssec(params = {}, options = {})
      req = build_request(:enable_hosted_zone_dnssec, params)
      req.send_request(options)
    end

    # Gets the specified limit for the current account, for example, the
    # maximum number of health checks that you can create using the account.
    #
    # For the default limit, see [Limits][1] in the *Amazon Route 53
    # Developer Guide*. To request a higher limit, [open a case][2].
    #
    # <note markdown="1"> You can also view account limits in Amazon Web Services Trusted
    # Advisor. Sign in to the Amazon Web Services Management Console and
    # open the Trusted Advisor console at
    # [https://console.aws.amazon.com/trustedadvisor/][3]. Then choose
    # **Service limits** in the navigation pane.
    #
    #  </note>
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html
    # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&amp;limitType=service-code-route53
    # [3]: https://console.aws.amazon.com/trustedadvisor
    #
    # @option params [required, String] :type
    #   The limit that you want to get. Valid values include the following:
    #
    #   * **MAX\_HEALTH\_CHECKS\_BY\_OWNER**: The maximum number of health
    #     checks that you can create using the current account.
    #
    #   * **MAX\_HOSTED\_ZONES\_BY\_OWNER**: The maximum number of hosted
    #     zones that you can create using the current account.
    #
    #   * **MAX\_REUSABLE\_DELEGATION\_SETS\_BY\_OWNER**: The maximum number
    #     of reusable delegation sets that you can create using the current
    #     account.
    #
    #   * **MAX\_TRAFFIC\_POLICIES\_BY\_OWNER**: The maximum number of traffic
    #     policies that you can create using the current account.
    #
    #   * **MAX\_TRAFFIC\_POLICY\_INSTANCES\_BY\_OWNER**: The maximum number
    #     of traffic policy instances that you can create using the current
    #     account. (Traffic policy instances are referred to as traffic flow
    #     policy records in the Amazon Route 53 console.)
    #
    # @return [Types::GetAccountLimitResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetAccountLimitResponse#limit #limit} => Types::AccountLimit
    #   * {Types::GetAccountLimitResponse#count #count} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_account_limit({
    #     type: "MAX_HEALTH_CHECKS_BY_OWNER", # required, accepts MAX_HEALTH_CHECKS_BY_OWNER, MAX_HOSTED_ZONES_BY_OWNER, MAX_TRAFFIC_POLICY_INSTANCES_BY_OWNER, MAX_REUSABLE_DELEGATION_SETS_BY_OWNER, MAX_TRAFFIC_POLICIES_BY_OWNER
    #   })
    #
    # @example Response structure
    #
    #   resp.limit.type #=> String, one of "MAX_HEALTH_CHECKS_BY_OWNER", "MAX_HOSTED_ZONES_BY_OWNER", "MAX_TRAFFIC_POLICY_INSTANCES_BY_OWNER", "MAX_REUSABLE_DELEGATION_SETS_BY_OWNER", "MAX_TRAFFIC_POLICIES_BY_OWNER"
    #   resp.limit.value #=> Integer
    #   resp.count #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetAccountLimit AWS API Documentation
    #
    # @overload get_account_limit(params = {})
    # @param [Hash] params ({})
    def get_account_limit(params = {}, options = {})
      req = build_request(:get_account_limit, params)
      req.send_request(options)
    end

    # Returns the current status of a change batch request. The status is
    # one of the following values:
    #
    # * `PENDING` indicates that the changes in this request have not
    #   propagated to all Amazon Route 53 DNS servers managing the hosted
    #   zone. This is the initial status of all change batch requests.
    #
    # * `INSYNC` indicates that the changes have propagated to all Route 53
    #   DNS servers managing the hosted zone.
    #
    # @option params [required, String] :id
    #   The ID of the change batch request. The value that you specify here is
    #   the value that `ChangeResourceRecordSets` returned in the `Id` element
    #   when you submitted the request.
    #
    # @return [Types::GetChangeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetChangeResponse#change_info #change_info} => Types::ChangeInfo
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_change({
    #     id: "ChangeId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.change_info.id #=> String
    #   resp.change_info.status #=> String, one of "PENDING", "INSYNC"
    #   resp.change_info.submitted_at #=> Time
    #   resp.change_info.comment #=> String
    #
    #
    # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
    #
    #   * resource_record_sets_changed
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetChange AWS API Documentation
    #
    # @overload get_change(params = {})
    # @param [Hash] params ({})
    def get_change(params = {}, options = {})
      req = build_request(:get_change, params)
      req.send_request(options)
    end

    # Route 53 does not perform authorization for this API because it
    # retrieves information that is already available to the public.
    #
    # `GetCheckerIpRanges` still works, but we recommend that you download
    # ip-ranges.json, which includes IP address ranges for all Amazon Web
    # Services services. For more information, see [IP Address Ranges of
    # Amazon Route 53 Servers][1] in the *Amazon Route 53 Developer Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/route-53-ip-addresses.html
    #
    # @return [Types::GetCheckerIpRangesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetCheckerIpRangesResponse#checker_ip_ranges #checker_ip_ranges} => Array&lt;String&gt;
    #
    # @example Response structure
    #
    #   resp.checker_ip_ranges #=> Array
    #   resp.checker_ip_ranges[0] #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetCheckerIpRanges AWS API Documentation
    #
    # @overload get_checker_ip_ranges(params = {})
    # @param [Hash] params ({})
    def get_checker_ip_ranges(params = {}, options = {})
      req = build_request(:get_checker_ip_ranges, params)
      req.send_request(options)
    end

    # Returns information about DNSSEC for a specific hosted zone, including
    # the key-signing keys (KSKs) in the hosted zone.
    #
    # @option params [required, String] :hosted_zone_id
    #   A unique string used to identify a hosted zone.
    #
    # @return [Types::GetDNSSECResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetDNSSECResponse#status #status} => Types::DNSSECStatus
    #   * {Types::GetDNSSECResponse#key_signing_keys #key_signing_keys} => Array&lt;Types::KeySigningKey&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_dnssec({
    #     hosted_zone_id: "ResourceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.status.serve_signature #=> String
    #   resp.status.status_message #=> String
    #   resp.key_signing_keys #=> Array
    #   resp.key_signing_keys[0].name #=> String
    #   resp.key_signing_keys[0].kms_arn #=> String
    #   resp.key_signing_keys[0].flag #=> Integer
    #   resp.key_signing_keys[0].signing_algorithm_mnemonic #=> String
    #   resp.key_signing_keys[0].signing_algorithm_type #=> Integer
    #   resp.key_signing_keys[0].digest_algorithm_mnemonic #=> String
    #   resp.key_signing_keys[0].digest_algorithm_type #=> Integer
    #   resp.key_signing_keys[0].key_tag #=> Integer
    #   resp.key_signing_keys[0].digest_value #=> String
    #   resp.key_signing_keys[0].public_key #=> String
    #   resp.key_signing_keys[0].ds_record #=> String
    #   resp.key_signing_keys[0].dnskey_record #=> String
    #   resp.key_signing_keys[0].status #=> String
    #   resp.key_signing_keys[0].status_message #=> String
    #   resp.key_signing_keys[0].created_date #=> Time
    #   resp.key_signing_keys[0].last_modified_date #=> Time
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetDNSSEC AWS API Documentation
    #
    # @overload get_dnssec(params = {})
    # @param [Hash] params ({})
    def get_dnssec(params = {}, options = {})
      req = build_request(:get_dnssec, params)
      req.send_request(options)
    end

    # Gets information about whether a specified geographic location is
    # supported for Amazon Route 53 geolocation resource record sets.
    #
    # Route 53 does not perform authorization for this API because it
    # retrieves information that is already available to the public.
    #
    # Use the following syntax to determine whether a continent is supported
    # for geolocation:
    #
    # `GET /2013-04-01/geolocation?continentcode=two-letter abbreviation for
    # a continent `
    #
    # Use the following syntax to determine whether a country is supported
    # for geolocation:
    #
    # `GET /2013-04-01/geolocation?countrycode=two-character country code `
    #
    # Use the following syntax to determine whether a subdivision of a
    # country is supported for geolocation:
    #
    # `GET /2013-04-01/geolocation?countrycode=two-character country
    # code&subdivisioncode=subdivision code `
    #
    # @option params [String] :continent_code
    #   For geolocation resource record sets, a two-letter abbreviation that
    #   identifies a continent. Amazon Route 53 supports the following
    #   continent codes:
    #
    #   * **AF**: Africa
    #
    #   * **AN**: Antarctica
    #
    #   * **AS**: Asia
    #
    #   * **EU**: Europe
    #
    #   * **OC**: Oceania
    #
    #   * **NA**: North America
    #
    #   * **SA**: South America
    #
    # @option params [String] :country_code
    #   Amazon Route 53 uses the two-letter country codes that are specified
    #   in [ISO standard 3166-1 alpha-2][1].
    #
    #   Route 53 also supports the country code **UA** for Ukraine.
    #
    #
    #
    #   [1]: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
    #
    # @option params [String] :subdivision_code
    #   The code for the subdivision, such as a particular state within the
    #   United States. For a list of US state abbreviations, see [Appendix B:
    #   Two–Letter State and Possession Abbreviations][1] on the United States
    #   Postal Service website. For a list of all supported subdivision codes,
    #   use the [ListGeoLocations][2] API.
    #
    #
    #
    #   [1]: https://pe.usps.com/text/pub28/28apb.htm
    #   [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_ListGeoLocations.html
    #
    # @return [Types::GetGeoLocationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetGeoLocationResponse#geo_location_details #geo_location_details} => Types::GeoLocationDetails
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_geo_location({
    #     continent_code: "GeoLocationContinentCode",
    #     country_code: "GeoLocationCountryCode",
    #     subdivision_code: "GeoLocationSubdivisionCode",
    #   })
    #
    # @example Response structure
    #
    #   resp.geo_location_details.continent_code #=> String
    #   resp.geo_location_details.continent_name #=> String
    #   resp.geo_location_details.country_code #=> String
    #   resp.geo_location_details.country_name #=> String
    #   resp.geo_location_details.subdivision_code #=> String
    #   resp.geo_location_details.subdivision_name #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetGeoLocation AWS API Documentation
    #
    # @overload get_geo_location(params = {})
    # @param [Hash] params ({})
    def get_geo_location(params = {}, options = {})
      req = build_request(:get_geo_location, params)
      req.send_request(options)
    end

    # Gets information about a specified health check.
    #
    # @option params [required, String] :health_check_id
    #   The identifier that Amazon Route 53 assigned to the health check when
    #   you created it. When you add or update a resource record set, you use
    #   this value to specify which health check to use. The value can be up
    #   to 64 characters long.
    #
    # @return [Types::GetHealthCheckResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetHealthCheckResponse#health_check #health_check} => Types::HealthCheck
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_health_check({
    #     health_check_id: "HealthCheckId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.health_check.id #=> String
    #   resp.health_check.caller_reference #=> String
    #   resp.health_check.linked_service.service_principal #=> String
    #   resp.health_check.linked_service.description #=> String
    #   resp.health_check.health_check_config.ip_address #=> String
    #   resp.health_check.health_check_config.port #=> Integer
    #   resp.health_check.health_check_config.type #=> String, one of "HTTP", "HTTPS", "HTTP_STR_MATCH", "HTTPS_STR_MATCH", "TCP", "CALCULATED", "CLOUDWATCH_METRIC", "RECOVERY_CONTROL"
    #   resp.health_check.health_check_config.resource_path #=> String
    #   resp.health_check.health_check_config.fully_qualified_domain_name #=> String
    #   resp.health_check.health_check_config.search_string #=> String
    #   resp.health_check.health_check_config.request_interval #=> Integer
    #   resp.health_check.health_check_config.failure_threshold #=> Integer
    #   resp.health_check.health_check_config.measure_latency #=> Boolean
    #   resp.health_check.health_check_config.inverted #=> Boolean
    #   resp.health_check.health_check_config.disabled #=> Boolean
    #   resp.health_check.health_check_config.health_threshold #=> Integer
    #   resp.health_check.health_check_config.child_health_checks #=> Array
    #   resp.health_check.health_check_config.child_health_checks[0] #=> String
    #   resp.health_check.health_check_config.enable_sni #=> Boolean
    #   resp.health_check.health_check_config.regions #=> Array
    #   resp.health_check.health_check_config.regions[0] #=> String, one of "us-east-1", "us-west-1", "us-west-2", "eu-west-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "sa-east-1"
    #   resp.health_check.health_check_config.alarm_identifier.region #=> String, one of "us-east-1", "us-east-2", "us-west-1", "us-west-2", "ca-central-1", "eu-central-1", "eu-central-2", "eu-west-1", "eu-west-2", "eu-west-3", "ap-east-1", "me-south-1", "me-central-1", "ap-south-1", "ap-south-2", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "eu-north-1", "sa-east-1", "cn-northwest-1", "cn-north-1", "af-south-1", "eu-south-1", "eu-south-2", "us-gov-west-1", "us-gov-east-1", "us-iso-east-1", "us-iso-west-1", "us-isob-east-1", "ap-southeast-4", "il-central-1", "ca-west-1", "ap-southeast-5", "mx-central-1", "us-isof-south-1", "us-isof-east-1", "ap-southeast-7", "ap-east-2", "eu-isoe-west-1", "ap-southeast-6"
    #   resp.health_check.health_check_config.alarm_identifier.name #=> String
    #   resp.health_check.health_check_config.insufficient_data_health_status #=> String, one of "Healthy", "Unhealthy", "LastKnownStatus"
    #   resp.health_check.health_check_config.routing_control_arn #=> String
    #   resp.health_check.health_check_version #=> Integer
    #   resp.health_check.cloud_watch_alarm_configuration.evaluation_periods #=> Integer
    #   resp.health_check.cloud_watch_alarm_configuration.threshold #=> Float
    #   resp.health_check.cloud_watch_alarm_configuration.comparison_operator #=> String, one of "GreaterThanOrEqualToThreshold", "GreaterThanThreshold", "LessThanThreshold", "LessThanOrEqualToThreshold"
    #   resp.health_check.cloud_watch_alarm_configuration.period #=> Integer
    #   resp.health_check.cloud_watch_alarm_configuration.metric_name #=> String
    #   resp.health_check.cloud_watch_alarm_configuration.namespace #=> String
    #   resp.health_check.cloud_watch_alarm_configuration.statistic #=> String, one of "Average", "Sum", "SampleCount", "Maximum", "Minimum"
    #   resp.health_check.cloud_watch_alarm_configuration.dimensions #=> Array
    #   resp.health_check.cloud_watch_alarm_configuration.dimensions[0].name #=> String
    #   resp.health_check.cloud_watch_alarm_configuration.dimensions[0].value #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheck AWS API Documentation
    #
    # @overload get_health_check(params = {})
    # @param [Hash] params ({})
    def get_health_check(params = {}, options = {})
      req = build_request(:get_health_check, params)
      req.send_request(options)
    end

    # Retrieves the number of health checks that are associated with the
    # current Amazon Web Services account.
    #
    # @return [Types::GetHealthCheckCountResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetHealthCheckCountResponse#health_check_count #health_check_count} => Integer
    #
    # @example Response structure
    #
    #   resp.health_check_count #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheckCount AWS API Documentation
    #
    # @overload get_health_check_count(params = {})
    # @param [Hash] params ({})
    def get_health_check_count(params = {}, options = {})
      req = build_request(:get_health_check_count, params)
      req.send_request(options)
    end

    # Gets the reason that a specified health check failed most recently.
    #
    # @option params [required, String] :health_check_id
    #   The ID for the health check for which you want the last failure
    #   reason. When you created the health check, `CreateHealthCheck`
    #   returned the ID in the response, in the `HealthCheckId` element.
    #
    #   <note markdown="1"> If you want to get the last failure reason for a calculated health
    #   check, you must use the Amazon Route 53 console or the CloudWatch
    #   console. You can't use `GetHealthCheckLastFailureReason` for a
    #   calculated health check.
    #
    #    </note>
    #
    # @return [Types::GetHealthCheckLastFailureReasonResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetHealthCheckLastFailureReasonResponse#health_check_observations #health_check_observations} => Array&lt;Types::HealthCheckObservation&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_health_check_last_failure_reason({
    #     health_check_id: "HealthCheckId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.health_check_observations #=> Array
    #   resp.health_check_observations[0].region #=> String, one of "us-east-1", "us-west-1", "us-west-2", "eu-west-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "sa-east-1"
    #   resp.health_check_observations[0].ip_address #=> String
    #   resp.health_check_observations[0].status_report.status #=> String
    #   resp.health_check_observations[0].status_report.checked_time #=> Time
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheckLastFailureReason AWS API Documentation
    #
    # @overload get_health_check_last_failure_reason(params = {})
    # @param [Hash] params ({})
    def get_health_check_last_failure_reason(params = {}, options = {})
      req = build_request(:get_health_check_last_failure_reason, params)
      req.send_request(options)
    end

    # Gets status of a specified health check.
    #
    # This API is intended for use during development to diagnose behavior.
    # It doesn’t support production use-cases with high query rates that
    # require immediate and actionable responses.
    #
    # @option params [required, String] :health_check_id
    #   The ID for the health check that you want the current status for. When
    #   you created the health check, `CreateHealthCheck` returned the ID in
    #   the response, in the `HealthCheckId` element.
    #
    #   <note markdown="1"> If you want to check the status of a calculated health check, you must
    #   use the Amazon Route 53 console or the CloudWatch console. You can't
    #   use `GetHealthCheckStatus` to get the status of a calculated health
    #   check.
    #
    #    </note>
    #
    # @return [Types::GetHealthCheckStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetHealthCheckStatusResponse#health_check_observations #health_check_observations} => Array&lt;Types::HealthCheckObservation&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_health_check_status({
    #     health_check_id: "HealthCheckId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.health_check_observations #=> Array
    #   resp.health_check_observations[0].region #=> String, one of "us-east-1", "us-west-1", "us-west-2", "eu-west-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "sa-east-1"
    #   resp.health_check_observations[0].ip_address #=> String
    #   resp.health_check_observations[0].status_report.status #=> String
    #   resp.health_check_observations[0].status_report.checked_time #=> Time
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHealthCheckStatus AWS API Documentation
    #
    # @overload get_health_check_status(params = {})
    # @param [Hash] params ({})
    def get_health_check_status(params = {}, options = {})
      req = build_request(:get_health_check_status, params)
      req.send_request(options)
    end

    # Gets information about a specified hosted zone including the four name
    # servers assigned to the hosted zone.
    #
    # `` returns the VPCs associated with the specified hosted zone and does
    # not reflect the VPC associations by Route 53 Profiles. To get the
    # associations to a Profile, call the [ListProfileAssociations][1] API.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53profiles_ListProfileAssociations.html
    #
    # @option params [required, String] :id
    #   The ID of the hosted zone that you want to get information about.
    #
    # @return [Types::GetHostedZoneResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetHostedZoneResponse#hosted_zone #hosted_zone} => Types::HostedZone
    #   * {Types::GetHostedZoneResponse#delegation_set #delegation_set} => Types::DelegationSet
    #   * {Types::GetHostedZoneResponse#vp_cs #vp_cs} => Array&lt;Types::VPC&gt;
    #
    #
    # @example Example: To get information about a hosted zone
    #
    #   # The following example gets information about the Z3M3LMPEXAMPLE hosted zone.
    #
    #   resp = client.get_hosted_zone({
    #     id: "Z3M3LMPEXAMPLE", 
    #   })
    #
    #   resp.to_h outputs the following:
    #   {
    #     delegation_set: {
    #       name_servers: [
    #         "ns-2048.awsdns-64.com", 
    #         "ns-2049.awsdns-65.net", 
    #         "ns-2050.awsdns-66.org", 
    #         "ns-2051.awsdns-67.co.uk", 
    #       ], 
    #     }, 
    #     hosted_zone: {
    #       caller_reference: "C741617D-04E4-F8DE-B9D7-0D150FC61C2E", 
    #       config: {
    #         private_zone: false, 
    #       }, 
    #       id: "/hostedzone/Z3M3LMPEXAMPLE", 
    #       name: "myawsbucket.com.", 
    #       resource_record_set_count: 8, 
    #     }, 
    #   }
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_hosted_zone({
    #     id: "ResourceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.hosted_zone.id #=> String
    #   resp.hosted_zone.name #=> String
    #   resp.hosted_zone.caller_reference #=> String
    #   resp.hosted_zone.config.comment #=> String
    #   resp.hosted_zone.config.private_zone #=> Boolean
    #   resp.hosted_zone.resource_record_set_count #=> Integer
    #   resp.hosted_zone.linked_service.service_principal #=> String
    #   resp.hosted_zone.linked_service.description #=> String
    #   resp.delegation_set.id #=> String
    #   resp.delegation_set.caller_reference #=> String
    #   resp.delegation_set.name_servers #=> Array
    #   resp.delegation_set.name_servers[0] #=> String
    #   resp.vp_cs #=> Array
    #   resp.vp_cs[0].vpc_region #=> String, one of "us-east-1", "us-east-2", "us-west-1", "us-west-2", "eu-west-1", "eu-west-2", "eu-west-3", "eu-central-1", "eu-central-2", "ap-east-1", "me-south-1", "us-gov-west-1", "us-gov-east-1", "us-iso-east-1", "us-iso-west-1", "us-isob-east-1", "me-central-1", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ap-south-1", "ap-south-2", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "eu-north-1", "sa-east-1", "ca-central-1", "cn-north-1", "cn-northwest-1", "af-south-1", "eu-south-1", "eu-south-2", "ap-southeast-4", "il-central-1", "ca-west-1", "ap-southeast-5", "mx-central-1", "us-isof-south-1", "us-isof-east-1", "ap-southeast-7", "ap-east-2", "eu-isoe-west-1", "ap-southeast-6"
    #   resp.vp_cs[0].vpc_id #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHostedZone AWS API Documentation
    #
    # @overload get_hosted_zone(params = {})
    # @param [Hash] params ({})
    def get_hosted_zone(params = {}, options = {})
      req = build_request(:get_hosted_zone, params)
      req.send_request(options)
    end

    # Retrieves the number of hosted zones that are associated with the
    # current Amazon Web Services account.
    #
    # @return [Types::GetHostedZoneCountResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetHostedZoneCountResponse#hosted_zone_count #hosted_zone_count} => Integer
    #
    # @example Response structure
    #
    #   resp.hosted_zone_count #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHostedZoneCount AWS API Documentation
    #
    # @overload get_hosted_zone_count(params = {})
    # @param [Hash] params ({})
    def get_hosted_zone_count(params = {}, options = {})
      req = build_request(:get_hosted_zone_count, params)
      req.send_request(options)
    end

    # Gets the specified limit for a specified hosted zone, for example, the
    # maximum number of records that you can create in the hosted zone.
    #
    # For the default limit, see [Limits][1] in the *Amazon Route 53
    # Developer Guide*. To request a higher limit, [open a case][2].
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html
    # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&amp;limitType=service-code-route53
    #
    # @option params [required, String] :type
    #   The limit that you want to get. Valid values include the following:
    #
    #   * **MAX\_RRSETS\_BY\_ZONE**: The maximum number of records that you
    #     can create in the specified hosted zone.
    #
    #   * **MAX\_VPCS\_ASSOCIATED\_BY\_ZONE**: The maximum number of Amazon
    #     VPCs that you can associate with the specified private hosted zone.
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the hosted zone that you want to get a limit for.
    #
    # @return [Types::GetHostedZoneLimitResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetHostedZoneLimitResponse#limit #limit} => Types::HostedZoneLimit
    #   * {Types::GetHostedZoneLimitResponse#count #count} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_hosted_zone_limit({
    #     type: "MAX_RRSETS_BY_ZONE", # required, accepts MAX_RRSETS_BY_ZONE, MAX_VPCS_ASSOCIATED_BY_ZONE
    #     hosted_zone_id: "ResourceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.limit.type #=> String, one of "MAX_RRSETS_BY_ZONE", "MAX_VPCS_ASSOCIATED_BY_ZONE"
    #   resp.limit.value #=> Integer
    #   resp.count #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHostedZoneLimit AWS API Documentation
    #
    # @overload get_hosted_zone_limit(params = {})
    # @param [Hash] params ({})
    def get_hosted_zone_limit(params = {}, options = {})
      req = build_request(:get_hosted_zone_limit, params)
      req.send_request(options)
    end

    # Gets information about a specified configuration for DNS query
    # logging.
    #
    # For more information about DNS query logs, see
    # [CreateQueryLoggingConfig][1] and [Logging DNS Queries][2].
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateQueryLoggingConfig.html
    # [2]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html
    #
    # @option params [required, String] :id
    #   The ID of the configuration for DNS query logging that you want to get
    #   information about.
    #
    # @return [Types::GetQueryLoggingConfigResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetQueryLoggingConfigResponse#query_logging_config #query_logging_config} => Types::QueryLoggingConfig
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_query_logging_config({
    #     id: "QueryLoggingConfigId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.query_logging_config.id #=> String
    #   resp.query_logging_config.hosted_zone_id #=> String
    #   resp.query_logging_config.cloud_watch_logs_log_group_arn #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetQueryLoggingConfig AWS API Documentation
    #
    # @overload get_query_logging_config(params = {})
    # @param [Hash] params ({})
    def get_query_logging_config(params = {}, options = {})
      req = build_request(:get_query_logging_config, params)
      req.send_request(options)
    end

    # Retrieves information about a specified reusable delegation set,
    # including the four name servers that are assigned to the delegation
    # set.
    #
    # @option params [required, String] :id
    #   The ID of the reusable delegation set that you want to get a list of
    #   name servers for.
    #
    # @return [Types::GetReusableDelegationSetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetReusableDelegationSetResponse#delegation_set #delegation_set} => Types::DelegationSet
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_reusable_delegation_set({
    #     id: "ResourceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.delegation_set.id #=> String
    #   resp.delegation_set.caller_reference #=> String
    #   resp.delegation_set.name_servers #=> Array
    #   resp.delegation_set.name_servers[0] #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetReusableDelegationSet AWS API Documentation
    #
    # @overload get_reusable_delegation_set(params = {})
    # @param [Hash] params ({})
    def get_reusable_delegation_set(params = {}, options = {})
      req = build_request(:get_reusable_delegation_set, params)
      req.send_request(options)
    end

    # Gets the maximum number of hosted zones that you can associate with
    # the specified reusable delegation set.
    #
    # For the default limit, see [Limits][1] in the *Amazon Route 53
    # Developer Guide*. To request a higher limit, [open a case][2].
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html
    # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&amp;limitType=service-code-route53
    #
    # @option params [required, String] :type
    #   Specify `MAX_ZONES_BY_REUSABLE_DELEGATION_SET` to get the maximum
    #   number of hosted zones that you can associate with the specified
    #   reusable delegation set.
    #
    # @option params [required, String] :delegation_set_id
    #   The ID of the delegation set that you want to get the limit for.
    #
    # @return [Types::GetReusableDelegationSetLimitResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetReusableDelegationSetLimitResponse#limit #limit} => Types::ReusableDelegationSetLimit
    #   * {Types::GetReusableDelegationSetLimitResponse#count #count} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_reusable_delegation_set_limit({
    #     type: "MAX_ZONES_BY_REUSABLE_DELEGATION_SET", # required, accepts MAX_ZONES_BY_REUSABLE_DELEGATION_SET
    #     delegation_set_id: "ResourceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.limit.type #=> String, one of "MAX_ZONES_BY_REUSABLE_DELEGATION_SET"
    #   resp.limit.value #=> Integer
    #   resp.count #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetReusableDelegationSetLimit AWS API Documentation
    #
    # @overload get_reusable_delegation_set_limit(params = {})
    # @param [Hash] params ({})
    def get_reusable_delegation_set_limit(params = {}, options = {})
      req = build_request(:get_reusable_delegation_set_limit, params)
      req.send_request(options)
    end

    # Gets information about a specific traffic policy version.
    #
    # For information about how of deleting a traffic policy affects the
    # response from `GetTrafficPolicy`, see [DeleteTrafficPolicy][1].
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_DeleteTrafficPolicy.html
    #
    # @option params [required, String] :id
    #   The ID of the traffic policy that you want to get information about.
    #
    # @option params [required, Integer] :version
    #   The version number of the traffic policy that you want to get
    #   information about.
    #
    # @return [Types::GetTrafficPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetTrafficPolicyResponse#traffic_policy #traffic_policy} => Types::TrafficPolicy
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_traffic_policy({
    #     id: "TrafficPolicyId", # required
    #     version: 1, # required
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy.id #=> String
    #   resp.traffic_policy.version #=> Integer
    #   resp.traffic_policy.name #=> String
    #   resp.traffic_policy.type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.traffic_policy.document #=> String
    #   resp.traffic_policy.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetTrafficPolicy AWS API Documentation
    #
    # @overload get_traffic_policy(params = {})
    # @param [Hash] params ({})
    def get_traffic_policy(params = {}, options = {})
      req = build_request(:get_traffic_policy, params)
      req.send_request(options)
    end

    # Gets information about a specified traffic policy instance.
    #
    # <note markdown="1"> Use `GetTrafficPolicyInstance` with the `id` of new traffic policy
    # instance to confirm that the `CreateTrafficPolicyInstance` or an
    # `UpdateTrafficPolicyInstance` request completed successfully. For more
    # information, see the `State` response element.
    #
    #  </note>
    #
    # <note markdown="1"> In the Route 53 console, traffic policy instances are known as policy
    # records.
    #
    #  </note>
    #
    # @option params [required, String] :id
    #   The ID of the traffic policy instance that you want to get information
    #   about.
    #
    # @return [Types::GetTrafficPolicyInstanceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetTrafficPolicyInstanceResponse#traffic_policy_instance #traffic_policy_instance} => Types::TrafficPolicyInstance
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.get_traffic_policy_instance({
    #     id: "TrafficPolicyInstanceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy_instance.id #=> String
    #   resp.traffic_policy_instance.hosted_zone_id #=> String
    #   resp.traffic_policy_instance.name #=> String
    #   resp.traffic_policy_instance.ttl #=> Integer
    #   resp.traffic_policy_instance.state #=> String
    #   resp.traffic_policy_instance.message #=> String
    #   resp.traffic_policy_instance.traffic_policy_id #=> String
    #   resp.traffic_policy_instance.traffic_policy_version #=> Integer
    #   resp.traffic_policy_instance.traffic_policy_type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetTrafficPolicyInstance AWS API Documentation
    #
    # @overload get_traffic_policy_instance(params = {})
    # @param [Hash] params ({})
    def get_traffic_policy_instance(params = {}, options = {})
      req = build_request(:get_traffic_policy_instance, params)
      req.send_request(options)
    end

    # Gets the number of traffic policy instances that are associated with
    # the current Amazon Web Services account.
    #
    # @return [Types::GetTrafficPolicyInstanceCountResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::GetTrafficPolicyInstanceCountResponse#traffic_policy_instance_count #traffic_policy_instance_count} => Integer
    #
    # @example Response structure
    #
    #   resp.traffic_policy_instance_count #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetTrafficPolicyInstanceCount AWS API Documentation
    #
    # @overload get_traffic_policy_instance_count(params = {})
    # @param [Hash] params ({})
    def get_traffic_policy_instance_count(params = {}, options = {})
      req = build_request(:get_traffic_policy_instance_count, params)
      req.send_request(options)
    end

    # Returns a paginated list of location objects and their CIDR blocks.
    #
    # @option params [required, String] :collection_id
    #   The UUID of the CIDR collection.
    #
    # @option params [String] :location_name
    #   The name of the CIDR collection location.
    #
    # @option params [String] :next_token
    #   An opaque pagination token to indicate where the service is to begin
    #   enumerating results.
    #
    # @option params [String] :max_results
    #   Maximum number of results you want returned.
    #
    # @return [Types::ListCidrBlocksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListCidrBlocksResponse#next_token #next_token} => String
    #   * {Types::ListCidrBlocksResponse#cidr_blocks #cidr_blocks} => Array&lt;Types::CidrBlockSummary&gt;
    #
    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_cidr_blocks({
    #     collection_id: "UUID", # required
    #     location_name: "CidrLocationNameDefaultNotAllowed",
    #     next_token: "PaginationToken",
    #     max_results: "MaxResults",
    #   })
    #
    # @example Response structure
    #
    #   resp.next_token #=> String
    #   resp.cidr_blocks #=> Array
    #   resp.cidr_blocks[0].cidr_block #=> String
    #   resp.cidr_blocks[0].location_name #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListCidrBlocks AWS API Documentation
    #
    # @overload list_cidr_blocks(params = {})
    # @param [Hash] params ({})
    def list_cidr_blocks(params = {}, options = {})
      req = build_request(:list_cidr_blocks, params)
      req.send_request(options)
    end

    # Returns a paginated list of CIDR collections in the Amazon Web
    # Services account (metadata only).
    #
    # @option params [String] :next_token
    #   An opaque pagination token to indicate where the service is to begin
    #   enumerating results.
    #
    #   If no value is provided, the listing of results starts from the
    #   beginning.
    #
    # @option params [String] :max_results
    #   The maximum number of CIDR collections to return in the response.
    #
    # @return [Types::ListCidrCollectionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListCidrCollectionsResponse#next_token #next_token} => String
    #   * {Types::ListCidrCollectionsResponse#cidr_collections #cidr_collections} => Array&lt;Types::CollectionSummary&gt;
    #
    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_cidr_collections({
    #     next_token: "PaginationToken",
    #     max_results: "MaxResults",
    #   })
    #
    # @example Response structure
    #
    #   resp.next_token #=> String
    #   resp.cidr_collections #=> Array
    #   resp.cidr_collections[0].arn #=> String
    #   resp.cidr_collections[0].id #=> String
    #   resp.cidr_collections[0].name #=> String
    #   resp.cidr_collections[0].version #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListCidrCollections AWS API Documentation
    #
    # @overload list_cidr_collections(params = {})
    # @param [Hash] params ({})
    def list_cidr_collections(params = {}, options = {})
      req = build_request(:list_cidr_collections, params)
      req.send_request(options)
    end

    # Returns a paginated list of CIDR locations for the given collection
    # (metadata only, does not include CIDR blocks).
    #
    # @option params [required, String] :collection_id
    #   The CIDR collection ID.
    #
    # @option params [String] :next_token
    #   An opaque pagination token to indicate where the service is to begin
    #   enumerating results.
    #
    #   If no value is provided, the listing of results starts from the
    #   beginning.
    #
    # @option params [String] :max_results
    #   The maximum number of CIDR collection locations to return in the
    #   response.
    #
    # @return [Types::ListCidrLocationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListCidrLocationsResponse#next_token #next_token} => String
    #   * {Types::ListCidrLocationsResponse#cidr_locations #cidr_locations} => Array&lt;Types::LocationSummary&gt;
    #
    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_cidr_locations({
    #     collection_id: "UUID", # required
    #     next_token: "PaginationToken",
    #     max_results: "MaxResults",
    #   })
    #
    # @example Response structure
    #
    #   resp.next_token #=> String
    #   resp.cidr_locations #=> Array
    #   resp.cidr_locations[0].location_name #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListCidrLocations AWS API Documentation
    #
    # @overload list_cidr_locations(params = {})
    # @param [Hash] params ({})
    def list_cidr_locations(params = {}, options = {})
      req = build_request(:list_cidr_locations, params)
      req.send_request(options)
    end

    # Retrieves a list of supported geographic locations.
    #
    # Countries are listed first, and continents are listed last. If Amazon
    # Route 53 supports subdivisions for a country (for example, states or
    # provinces), the subdivisions for that country are listed in
    # alphabetical order immediately after the corresponding country.
    #
    # Route 53 does not perform authorization for this API because it
    # retrieves information that is already available to the public.
    #
    # For a list of supported geolocation codes, see the [GeoLocation][1]
    # data type.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_GeoLocation.html
    #
    # @option params [String] :start_continent_code
    #   The code for the continent with which you want to start listing
    #   locations that Amazon Route 53 supports for geolocation. If Route 53
    #   has already returned a page or more of results, if `IsTruncated` is
    #   true, and if `NextContinentCode` from the previous response has a
    #   value, enter that value in `startcontinentcode` to return the next
    #   page of results.
    #
    #   Include `startcontinentcode` only if you want to list continents.
    #   Don't include `startcontinentcode` when you're listing countries or
    #   countries with their subdivisions.
    #
    # @option params [String] :start_country_code
    #   The code for the country with which you want to start listing
    #   locations that Amazon Route 53 supports for geolocation. If Route 53
    #   has already returned a page or more of results, if `IsTruncated` is
    #   `true`, and if `NextCountryCode` from the previous response has a
    #   value, enter that value in `startcountrycode` to return the next page
    #   of results.
    #
    # @option params [String] :start_subdivision_code
    #   The code for the state of the United States with which you want to
    #   start listing locations that Amazon Route 53 supports for geolocation.
    #   If Route 53 has already returned a page or more of results, if
    #   `IsTruncated` is `true`, and if `NextSubdivisionCode` from the
    #   previous response has a value, enter that value in
    #   `startsubdivisioncode` to return the next page of results.
    #
    #   To list subdivisions (U.S. states), you must include both
    #   `startcountrycode` and `startsubdivisioncode`.
    #
    # @option params [Integer] :max_items
    #   (Optional) The maximum number of geolocations to be included in the
    #   response body for this request. If more than `maxitems` geolocations
    #   remain to be listed, then the value of the `IsTruncated` element in
    #   the response is `true`.
    #
    # @return [Types::ListGeoLocationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListGeoLocationsResponse#geo_location_details_list #geo_location_details_list} => Array&lt;Types::GeoLocationDetails&gt;
    #   * {Types::ListGeoLocationsResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListGeoLocationsResponse#next_continent_code #next_continent_code} => String
    #   * {Types::ListGeoLocationsResponse#next_country_code #next_country_code} => String
    #   * {Types::ListGeoLocationsResponse#next_subdivision_code #next_subdivision_code} => String
    #   * {Types::ListGeoLocationsResponse#max_items #max_items} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_geo_locations({
    #     start_continent_code: "GeoLocationContinentCode",
    #     start_country_code: "GeoLocationCountryCode",
    #     start_subdivision_code: "GeoLocationSubdivisionCode",
    #     max_items: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.geo_location_details_list #=> Array
    #   resp.geo_location_details_list[0].continent_code #=> String
    #   resp.geo_location_details_list[0].continent_name #=> String
    #   resp.geo_location_details_list[0].country_code #=> String
    #   resp.geo_location_details_list[0].country_name #=> String
    #   resp.geo_location_details_list[0].subdivision_code #=> String
    #   resp.geo_location_details_list[0].subdivision_name #=> String
    #   resp.is_truncated #=> Boolean
    #   resp.next_continent_code #=> String
    #   resp.next_country_code #=> String
    #   resp.next_subdivision_code #=> String
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListGeoLocations AWS API Documentation
    #
    # @overload list_geo_locations(params = {})
    # @param [Hash] params ({})
    def list_geo_locations(params = {}, options = {})
      req = build_request(:list_geo_locations, params)
      req.send_request(options)
    end

    # Retrieve a list of the health checks that are associated with the
    # current Amazon Web Services account.
    #
    # @option params [String] :marker
    #   If the value of `IsTruncated` in the previous response was `true`, you
    #   have more health checks. To get another group, submit another
    #   `ListHealthChecks` request.
    #
    #   For the value of `marker`, specify the value of `NextMarker` from the
    #   previous response, which is the ID of the first health check that
    #   Amazon Route 53 will return if you submit another request.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more health checks to get.
    #
    # @option params [Integer] :max_items
    #   The maximum number of health checks that you want `ListHealthChecks`
    #   to return in response to the current request. Amazon Route 53 returns
    #   a maximum of 1000 items. If you set `MaxItems` to a value greater than
    #   1000, Route 53 returns only the first 1000 health checks.
    #
    # @return [Types::ListHealthChecksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListHealthChecksResponse#health_checks #health_checks} => Array&lt;Types::HealthCheck&gt;
    #   * {Types::ListHealthChecksResponse#marker #marker} => String
    #   * {Types::ListHealthChecksResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListHealthChecksResponse#next_marker #next_marker} => String
    #   * {Types::ListHealthChecksResponse#max_items #max_items} => Integer
    #
    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_health_checks({
    #     marker: "PageMarker",
    #     max_items: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.health_checks #=> Array
    #   resp.health_checks[0].id #=> String
    #   resp.health_checks[0].caller_reference #=> String
    #   resp.health_checks[0].linked_service.service_principal #=> String
    #   resp.health_checks[0].linked_service.description #=> String
    #   resp.health_checks[0].health_check_config.ip_address #=> String
    #   resp.health_checks[0].health_check_config.port #=> Integer
    #   resp.health_checks[0].health_check_config.type #=> String, one of "HTTP", "HTTPS", "HTTP_STR_MATCH", "HTTPS_STR_MATCH", "TCP", "CALCULATED", "CLOUDWATCH_METRIC", "RECOVERY_CONTROL"
    #   resp.health_checks[0].health_check_config.resource_path #=> String
    #   resp.health_checks[0].health_check_config.fully_qualified_domain_name #=> String
    #   resp.health_checks[0].health_check_config.search_string #=> String
    #   resp.health_checks[0].health_check_config.request_interval #=> Integer
    #   resp.health_checks[0].health_check_config.failure_threshold #=> Integer
    #   resp.health_checks[0].health_check_config.measure_latency #=> Boolean
    #   resp.health_checks[0].health_check_config.inverted #=> Boolean
    #   resp.health_checks[0].health_check_config.disabled #=> Boolean
    #   resp.health_checks[0].health_check_config.health_threshold #=> Integer
    #   resp.health_checks[0].health_check_config.child_health_checks #=> Array
    #   resp.health_checks[0].health_check_config.child_health_checks[0] #=> String
    #   resp.health_checks[0].health_check_config.enable_sni #=> Boolean
    #   resp.health_checks[0].health_check_config.regions #=> Array
    #   resp.health_checks[0].health_check_config.regions[0] #=> String, one of "us-east-1", "us-west-1", "us-west-2", "eu-west-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "sa-east-1"
    #   resp.health_checks[0].health_check_config.alarm_identifier.region #=> String, one of "us-east-1", "us-east-2", "us-west-1", "us-west-2", "ca-central-1", "eu-central-1", "eu-central-2", "eu-west-1", "eu-west-2", "eu-west-3", "ap-east-1", "me-south-1", "me-central-1", "ap-south-1", "ap-south-2", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "eu-north-1", "sa-east-1", "cn-northwest-1", "cn-north-1", "af-south-1", "eu-south-1", "eu-south-2", "us-gov-west-1", "us-gov-east-1", "us-iso-east-1", "us-iso-west-1", "us-isob-east-1", "ap-southeast-4", "il-central-1", "ca-west-1", "ap-southeast-5", "mx-central-1", "us-isof-south-1", "us-isof-east-1", "ap-southeast-7", "ap-east-2", "eu-isoe-west-1", "ap-southeast-6"
    #   resp.health_checks[0].health_check_config.alarm_identifier.name #=> String
    #   resp.health_checks[0].health_check_config.insufficient_data_health_status #=> String, one of "Healthy", "Unhealthy", "LastKnownStatus"
    #   resp.health_checks[0].health_check_config.routing_control_arn #=> String
    #   resp.health_checks[0].health_check_version #=> Integer
    #   resp.health_checks[0].cloud_watch_alarm_configuration.evaluation_periods #=> Integer
    #   resp.health_checks[0].cloud_watch_alarm_configuration.threshold #=> Float
    #   resp.health_checks[0].cloud_watch_alarm_configuration.comparison_operator #=> String, one of "GreaterThanOrEqualToThreshold", "GreaterThanThreshold", "LessThanThreshold", "LessThanOrEqualToThreshold"
    #   resp.health_checks[0].cloud_watch_alarm_configuration.period #=> Integer
    #   resp.health_checks[0].cloud_watch_alarm_configuration.metric_name #=> String
    #   resp.health_checks[0].cloud_watch_alarm_configuration.namespace #=> String
    #   resp.health_checks[0].cloud_watch_alarm_configuration.statistic #=> String, one of "Average", "Sum", "SampleCount", "Maximum", "Minimum"
    #   resp.health_checks[0].cloud_watch_alarm_configuration.dimensions #=> Array
    #   resp.health_checks[0].cloud_watch_alarm_configuration.dimensions[0].name #=> String
    #   resp.health_checks[0].cloud_watch_alarm_configuration.dimensions[0].value #=> String
    #   resp.marker #=> String
    #   resp.is_truncated #=> Boolean
    #   resp.next_marker #=> String
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListHealthChecks AWS API Documentation
    #
    # @overload list_health_checks(params = {})
    # @param [Hash] params ({})
    def list_health_checks(params = {}, options = {})
      req = build_request(:list_health_checks, params)
      req.send_request(options)
    end

    # Retrieves a list of the public and private hosted zones that are
    # associated with the current Amazon Web Services account. The response
    # includes a `HostedZones` child element for each hosted zone.
    #
    # Amazon Route 53 returns a maximum of 100 items in each response. If
    # you have a lot of hosted zones, you can use the `maxitems` parameter
    # to list them in groups of up to 100.
    #
    # @option params [String] :marker
    #   If the value of `IsTruncated` in the previous response was `true`, you
    #   have more hosted zones. To get more hosted zones, submit another
    #   `ListHostedZones` request.
    #
    #   For the value of `marker`, specify the value of `NextMarker` from the
    #   previous response, which is the ID of the first hosted zone that
    #   Amazon Route 53 will return if you submit another request.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more hosted zones to get.
    #
    # @option params [Integer] :max_items
    #   (Optional) The maximum number of hosted zones that you want Amazon
    #   Route 53 to return. If you have more than `maxitems` hosted zones, the
    #   value of `IsTruncated` in the response is `true`, and the value of
    #   `NextMarker` is the hosted zone ID of the first hosted zone that Route
    #   53 will return if you submit another request.
    #
    # @option params [String] :delegation_set_id
    #   If you're using reusable delegation sets and you want to list all of
    #   the hosted zones that are associated with a reusable delegation set,
    #   specify the ID of that reusable delegation set.
    #
    # @option params [String] :hosted_zone_type
    #   (Optional) Specifies if the hosted zone is private.
    #
    # @return [Types::ListHostedZonesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListHostedZonesResponse#hosted_zones #hosted_zones} => Array&lt;Types::HostedZone&gt;
    #   * {Types::ListHostedZonesResponse#marker #marker} => String
    #   * {Types::ListHostedZonesResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListHostedZonesResponse#next_marker #next_marker} => String
    #   * {Types::ListHostedZonesResponse#max_items #max_items} => Integer
    #
    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_hosted_zones({
    #     marker: "PageMarker",
    #     max_items: 1,
    #     delegation_set_id: "ResourceId",
    #     hosted_zone_type: "PrivateHostedZone", # accepts PrivateHostedZone
    #   })
    #
    # @example Response structure
    #
    #   resp.hosted_zones #=> Array
    #   resp.hosted_zones[0].id #=> String
    #   resp.hosted_zones[0].name #=> String
    #   resp.hosted_zones[0].caller_reference #=> String
    #   resp.hosted_zones[0].config.comment #=> String
    #   resp.hosted_zones[0].config.private_zone #=> Boolean
    #   resp.hosted_zones[0].resource_record_set_count #=> Integer
    #   resp.hosted_zones[0].linked_service.service_principal #=> String
    #   resp.hosted_zones[0].linked_service.description #=> String
    #   resp.marker #=> String
    #   resp.is_truncated #=> Boolean
    #   resp.next_marker #=> String
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListHostedZones AWS API Documentation
    #
    # @overload list_hosted_zones(params = {})
    # @param [Hash] params ({})
    def list_hosted_zones(params = {}, options = {})
      req = build_request(:list_hosted_zones, params)
      req.send_request(options)
    end

    # Retrieves a list of your hosted zones in lexicographic order. The
    # response includes a `HostedZones` child element for each hosted zone
    # created by the current Amazon Web Services account.
    #
    # `ListHostedZonesByName` sorts hosted zones by name with the labels
    # reversed. For example:
    #
    # `com.example.www.`
    #
    # Note the trailing dot, which can change the sort order in some
    # circumstances.
    #
    # If the domain name includes escape characters or Punycode,
    # `ListHostedZonesByName` alphabetizes the domain name using the escaped
    # or Punycoded value, which is the format that Amazon Route 53 saves in
    # its database. For example, to create a hosted zone for exämple.com,
    # you specify ex\\344mple.com for the domain name.
    # `ListHostedZonesByName` alphabetizes it as:
    #
    # `com.ex\344mple.`
    #
    # The labels are reversed and alphabetized using the escaped value. For
    # more information about valid domain name formats, including
    # internationalized domain names, see [DNS Domain Name Format][1] in the
    # *Amazon Route 53 Developer Guide*.
    #
    # Route 53 returns up to 100 items in each response. If you have a lot
    # of hosted zones, use the `MaxItems` parameter to list them in groups
    # of up to 100. The response includes values that help navigate from one
    # group of `MaxItems` hosted zones to the next:
    #
    # * The `DNSName` and `HostedZoneId` elements in the response contain
    #   the values, if any, specified for the `dnsname` and `hostedzoneid`
    #   parameters in the request that produced the current response.
    #
    # * The `MaxItems` element in the response contains the value, if any,
    #   that you specified for the `maxitems` parameter in the request that
    #   produced the current response.
    #
    # * If the value of `IsTruncated` in the response is true, there are
    #   more hosted zones associated with the current Amazon Web Services
    #   account.
    #
    #   If `IsTruncated` is false, this response includes the last hosted
    #   zone that is associated with the current account. The `NextDNSName`
    #   element and `NextHostedZoneId` elements are omitted from the
    #   response.
    #
    # * The `NextDNSName` and `NextHostedZoneId` elements in the response
    #   contain the domain name and the hosted zone ID of the next hosted
    #   zone that is associated with the current Amazon Web Services
    #   account. If you want to list more hosted zones, make another call to
    #   `ListHostedZonesByName`, and specify the value of `NextDNSName` and
    #   `NextHostedZoneId` in the `dnsname` and `hostedzoneid` parameters,
    #   respectively.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.html
    #
    # @option params [String] :dns_name
    #   (Optional) For your first request to `ListHostedZonesByName`, include
    #   the `dnsname` parameter only if you want to specify the name of the
    #   first hosted zone in the response. If you don't include the `dnsname`
    #   parameter, Amazon Route 53 returns all of the hosted zones that were
    #   created by the current Amazon Web Services account, in ASCII order.
    #   For subsequent requests, include both `dnsname` and `hostedzoneid`
    #   parameters. For `dnsname`, specify the value of `NextDNSName` from the
    #   previous response.
    #
    # @option params [String] :hosted_zone_id
    #   (Optional) For your first request to `ListHostedZonesByName`, do not
    #   include the `hostedzoneid` parameter.
    #
    #   If you have more hosted zones than the value of `maxitems`,
    #   `ListHostedZonesByName` returns only the first `maxitems` hosted
    #   zones. To get the next group of `maxitems` hosted zones, submit
    #   another request to `ListHostedZonesByName` and include both `dnsname`
    #   and `hostedzoneid` parameters. For the value of `hostedzoneid`,
    #   specify the value of the `NextHostedZoneId` element from the previous
    #   response.
    #
    # @option params [Integer] :max_items
    #   The maximum number of hosted zones to be included in the response body
    #   for this request. If you have more than `maxitems` hosted zones, then
    #   the value of the `IsTruncated` element in the response is true, and
    #   the values of `NextDNSName` and `NextHostedZoneId` specify the first
    #   hosted zone in the next group of `maxitems` hosted zones.
    #
    # @return [Types::ListHostedZonesByNameResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListHostedZonesByNameResponse#hosted_zones #hosted_zones} => Array&lt;Types::HostedZone&gt;
    #   * {Types::ListHostedZonesByNameResponse#dns_name #dns_name} => String
    #   * {Types::ListHostedZonesByNameResponse#hosted_zone_id #hosted_zone_id} => String
    #   * {Types::ListHostedZonesByNameResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListHostedZonesByNameResponse#next_dns_name #next_dns_name} => String
    #   * {Types::ListHostedZonesByNameResponse#next_hosted_zone_id #next_hosted_zone_id} => String
    #   * {Types::ListHostedZonesByNameResponse#max_items #max_items} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_hosted_zones_by_name({
    #     dns_name: "DNSName",
    #     hosted_zone_id: "ResourceId",
    #     max_items: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.hosted_zones #=> Array
    #   resp.hosted_zones[0].id #=> String
    #   resp.hosted_zones[0].name #=> String
    #   resp.hosted_zones[0].caller_reference #=> String
    #   resp.hosted_zones[0].config.comment #=> String
    #   resp.hosted_zones[0].config.private_zone #=> Boolean
    #   resp.hosted_zones[0].resource_record_set_count #=> Integer
    #   resp.hosted_zones[0].linked_service.service_principal #=> String
    #   resp.hosted_zones[0].linked_service.description #=> String
    #   resp.dns_name #=> String
    #   resp.hosted_zone_id #=> String
    #   resp.is_truncated #=> Boolean
    #   resp.next_dns_name #=> String
    #   resp.next_hosted_zone_id #=> String
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListHostedZonesByName AWS API Documentation
    #
    # @overload list_hosted_zones_by_name(params = {})
    # @param [Hash] params ({})
    def list_hosted_zones_by_name(params = {}, options = {})
      req = build_request(:list_hosted_zones_by_name, params)
      req.send_request(options)
    end

    # Lists all the private hosted zones that a specified VPC is associated
    # with, regardless of which Amazon Web Services account or Amazon Web
    # Services service owns the hosted zones. The `HostedZoneOwner`
    # structure in the response contains one of the following values:
    #
    # * An `OwningAccount` element, which contains the account number of
    #   either the current Amazon Web Services account or another Amazon Web
    #   Services account. Some services, such as Cloud Map, create hosted
    #   zones using the current account.
    #
    # * An `OwningService` element, which identifies the Amazon Web Services
    #   service that created and owns the hosted zone. For example, if a
    #   hosted zone was created by Amazon Elastic File System (Amazon EFS),
    #   the value of `Owner` is `efs.amazonaws.com`.
    #
    # `ListHostedZonesByVPC` returns the hosted zones associated with the
    # specified VPC and does not reflect the hosted zone associations to
    # VPCs via Route 53 Profiles. To get the associations to a Profile, call
    # the [ListProfileResourceAssociations][1] API.
    #
    # <note markdown="1"> When listing private hosted zones, the hosted zone and the Amazon VPC
    # must belong to the same partition where the hosted zones were created.
    # A partition is a group of Amazon Web Services Regions. Each Amazon Web
    # Services account is scoped to one partition.
    #
    #  The following are the supported partitions:
    #
    #  * `aws` - Amazon Web Services Regions
    #
    # * `aws-cn` - China Regions
    #
    # * `aws-us-gov` - Amazon Web Services GovCloud (US) Region
    #
    #  For more information, see [Access Management][2] in the *Amazon Web
    # Services General Reference*.
    #
    #  </note>
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53profiles_ListProfileResourceAssociations.html
    # [2]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
    #
    # @option params [required, String] :vpc_id
    #   The ID of the Amazon VPC that you want to list hosted zones for.
    #
    # @option params [required, String] :vpc_region
    #   For the Amazon VPC that you specified for `VPCId`, the Amazon Web
    #   Services Region that you created the VPC in.
    #
    # @option params [Integer] :max_items
    #   (Optional) The maximum number of hosted zones that you want Amazon
    #   Route 53 to return. If the specified VPC is associated with more than
    #   `MaxItems` hosted zones, the response includes a `NextToken` element.
    #   `NextToken` contains an encrypted token that identifies the first
    #   hosted zone that Route 53 will return if you submit another request.
    #
    # @option params [String] :next_token
    #   If the previous response included a `NextToken` element, the specified
    #   VPC is associated with more hosted zones. To get more hosted zones,
    #   submit another `ListHostedZonesByVPC` request.
    #
    #   For the value of `NextToken`, specify the value of `NextToken` from
    #   the previous response.
    #
    #   If the previous response didn't include a `NextToken` element, there
    #   are no more hosted zones to get.
    #
    # @return [Types::ListHostedZonesByVPCResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListHostedZonesByVPCResponse#hosted_zone_summaries #hosted_zone_summaries} => Array&lt;Types::HostedZoneSummary&gt;
    #   * {Types::ListHostedZonesByVPCResponse#max_items #max_items} => Integer
    #   * {Types::ListHostedZonesByVPCResponse#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_hosted_zones_by_vpc({
    #     vpc_id: "VPCId", # required
    #     vpc_region: "us-east-1", # required, accepts us-east-1, us-east-2, us-west-1, us-west-2, eu-west-1, eu-west-2, eu-west-3, eu-central-1, eu-central-2, ap-east-1, me-south-1, us-gov-west-1, us-gov-east-1, us-iso-east-1, us-iso-west-1, us-isob-east-1, me-central-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-south-1, ap-south-2, ap-northeast-1, ap-northeast-2, ap-northeast-3, eu-north-1, sa-east-1, ca-central-1, cn-north-1, cn-northwest-1, af-south-1, eu-south-1, eu-south-2, ap-southeast-4, il-central-1, ca-west-1, ap-southeast-5, mx-central-1, us-isof-south-1, us-isof-east-1, ap-southeast-7, ap-east-2, eu-isoe-west-1, ap-southeast-6
    #     max_items: 1,
    #     next_token: "PaginationToken",
    #   })
    #
    # @example Response structure
    #
    #   resp.hosted_zone_summaries #=> Array
    #   resp.hosted_zone_summaries[0].hosted_zone_id #=> String
    #   resp.hosted_zone_summaries[0].name #=> String
    #   resp.hosted_zone_summaries[0].owner.owning_account #=> String
    #   resp.hosted_zone_summaries[0].owner.owning_service #=> String
    #   resp.max_items #=> Integer
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListHostedZonesByVPC AWS API Documentation
    #
    # @overload list_hosted_zones_by_vpc(params = {})
    # @param [Hash] params ({})
    def list_hosted_zones_by_vpc(params = {}, options = {})
      req = build_request(:list_hosted_zones_by_vpc, params)
      req.send_request(options)
    end

    # Lists the configurations for DNS query logging that are associated
    # with the current Amazon Web Services account or the configuration that
    # is associated with a specified hosted zone.
    #
    # For more information about DNS query logs, see
    # [CreateQueryLoggingConfig][1]. Additional information, including the
    # format of DNS query logs, appears in [Logging DNS Queries][2] in the
    # *Amazon Route 53 Developer Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateQueryLoggingConfig.html
    # [2]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html
    #
    # @option params [String] :hosted_zone_id
    #   (Optional) If you want to list the query logging configuration that is
    #   associated with a hosted zone, specify the ID in `HostedZoneId`.
    #
    #   If you don't specify a hosted zone ID, `ListQueryLoggingConfigs`
    #   returns all of the configurations that are associated with the current
    #   Amazon Web Services account.
    #
    # @option params [String] :next_token
    #   (Optional) If the current Amazon Web Services account has more than
    #   `MaxResults` query logging configurations, use `NextToken` to get the
    #   second and subsequent pages of results.
    #
    #   For the first `ListQueryLoggingConfigs` request, omit this value.
    #
    #   For the second and subsequent requests, get the value of `NextToken`
    #   from the previous response and specify that value for `NextToken` in
    #   the request.
    #
    # @option params [String] :max_results
    #   (Optional) The maximum number of query logging configurations that you
    #   want Amazon Route 53 to return in response to the current request. If
    #   the current Amazon Web Services account has more than `MaxResults`
    #   configurations, use the value of [NextToken][1] in the response to get
    #   the next page of results.
    #
    #   If you don't specify a value for `MaxResults`, Route 53 returns up to
    #   100 configurations.
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_ListQueryLoggingConfigs.html#API_ListQueryLoggingConfigs_RequestSyntax
    #
    # @return [Types::ListQueryLoggingConfigsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListQueryLoggingConfigsResponse#query_logging_configs #query_logging_configs} => Array&lt;Types::QueryLoggingConfig&gt;
    #   * {Types::ListQueryLoggingConfigsResponse#next_token #next_token} => String
    #
    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_query_logging_configs({
    #     hosted_zone_id: "ResourceId",
    #     next_token: "PaginationToken",
    #     max_results: "MaxResults",
    #   })
    #
    # @example Response structure
    #
    #   resp.query_logging_configs #=> Array
    #   resp.query_logging_configs[0].id #=> String
    #   resp.query_logging_configs[0].hosted_zone_id #=> String
    #   resp.query_logging_configs[0].cloud_watch_logs_log_group_arn #=> String
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListQueryLoggingConfigs AWS API Documentation
    #
    # @overload list_query_logging_configs(params = {})
    # @param [Hash] params ({})
    def list_query_logging_configs(params = {}, options = {})
      req = build_request(:list_query_logging_configs, params)
      req.send_request(options)
    end

    # Lists the resource record sets in a specified hosted zone.
    #
    # `ListResourceRecordSets` returns up to 300 resource record sets at a
    # time in ASCII order, beginning at a position specified by the `name`
    # and `type` elements.
    #
    # **Sort order**
    #
    # `ListResourceRecordSets` sorts results first by DNS name with the
    # labels reversed, for example:
    #
    # `com.example.www.`
    #
    # Note the trailing dot, which can change the sort order when the record
    # name contains characters that appear before `.` (decimal 46) in the
    # ASCII table. These characters include the following: `! " # $ % & ' (
    # ) * + , -`
    #
    # When multiple records have the same DNS name, `ListResourceRecordSets`
    # sorts results by the record type.
    #
    # **Specifying where to start listing records**
    #
    # You can use the name and type elements to specify the resource record
    # set that the list begins with:
    #
    # If you do not specify Name or Type
    #
    # : The results begin with the first resource record set that the hosted
    #   zone contains.
    #
    # If you specify Name but not Type
    #
    # : The results begin with the first resource record set in the list
    #   whose name is greater than or equal to `Name`.
    #
    # If you specify Type but not Name
    #
    # : Amazon Route 53 returns the `InvalidInput` error.
    #
    # If you specify both Name and Type
    #
    # : The results begin with the first resource record set in the list
    #   whose name is greater than or equal to `Name`, and whose type is
    #   greater than or equal to `Type`.
    #
    #   <note markdown="1"> Type is only used to sort between records with the same record Name.
    #
    #    </note>
    #
    # **Resource record sets that are PENDING**
    #
    # This action returns the most current version of the records. This
    # includes records that are `PENDING`, and that are not yet available on
    # all Route 53 DNS servers.
    #
    # **Changing resource record sets**
    #
    # To ensure that you get an accurate listing of the resource record sets
    # for a hosted zone at a point in time, do not submit a
    # `ChangeResourceRecordSets` request while you're paging through the
    # results of a `ListResourceRecordSets` request. If you do, some pages
    # may display results without the latest changes while other pages
    # display results with the latest changes.
    #
    # **Displaying the next page of results**
    #
    # If a `ListResourceRecordSets` command returns more than one page of
    # results, the value of `IsTruncated` is `true`. To display the next
    # page of results, get the values of `NextRecordName`, `NextRecordType`,
    # and `NextRecordIdentifier` (if any) from the response. Then submit
    # another `ListResourceRecordSets` request, and specify those values for
    # `StartRecordName`, `StartRecordType`, and `StartRecordIdentifier`.
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the hosted zone that contains the resource record sets that
    #   you want to list.
    #
    # @option params [String] :start_record_name
    #   The first name in the lexicographic ordering of resource record sets
    #   that you want to list. If the specified record name doesn't exist,
    #   the results begin with the first resource record set that has a name
    #   greater than the value of `name`.
    #
    # @option params [String] :start_record_type
    #   The type of resource record set to begin the record listing from.
    #
    #   Valid values for basic resource record sets: `A` \| `AAAA` \| `CAA` \|
    #   `CNAME` \| `MX` \| `NAPTR` \| `NS` \| `PTR` \| `SOA` \| `SPF` \| `SRV`
    #   \| `TXT`
    #
    #   Values for weighted, latency, geolocation, and failover resource
    #   record sets: `A` \| `AAAA` \| `CAA` \| `CNAME` \| `MX` \| `NAPTR` \|
    #   `PTR` \| `SPF` \| `SRV` \| `TXT`
    #
    #   Values for alias resource record sets:
    #
    #   * **API Gateway custom regional API or edge-optimized API**: A
    #
    #   * **CloudFront distribution**: A or AAAA
    #
    #   * **Elastic Beanstalk environment that has a regionalized subdomain**:
    #     A
    #
    #   * **Elastic Load Balancing load balancer**: A \| AAAA
    #
    #   * **S3 bucket**: A
    #
    #   * **VPC interface VPC endpoint**: A
    #
    #   * **Another resource record set in this hosted zone:** The type of the
    #     resource record set that the alias references.
    #
    #   Constraint: Specifying `type` without specifying `name` returns an
    #   `InvalidInput` error.
    #
    # @option params [String] :start_record_identifier
    #   *Resource record sets that have a routing policy other than simple:*
    #   If results were truncated for a given DNS name and type, specify the
    #   value of `NextRecordIdentifier` from the previous response to get the
    #   next resource record set that has the current DNS name and type.
    #
    # @option params [Integer] :max_items
    #   (Optional) The maximum number of resource records sets to include in
    #   the response body for this request. If the response includes more than
    #   `maxitems` resource record sets, the value of the `IsTruncated`
    #   element in the response is `true`, and the values of the
    #   `NextRecordName` and `NextRecordType` elements in the response
    #   identify the first resource record set in the next group of `maxitems`
    #   resource record sets.
    #
    # @return [Types::ListResourceRecordSetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListResourceRecordSetsResponse#resource_record_sets #resource_record_sets} => Array&lt;Types::ResourceRecordSet&gt;
    #   * {Types::ListResourceRecordSetsResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListResourceRecordSetsResponse#next_record_name #next_record_name} => String
    #   * {Types::ListResourceRecordSetsResponse#next_record_type #next_record_type} => String
    #   * {Types::ListResourceRecordSetsResponse#next_record_identifier #next_record_identifier} => String
    #   * {Types::ListResourceRecordSetsResponse#max_items #max_items} => Integer
    #
    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_resource_record_sets({
    #     hosted_zone_id: "ResourceId", # required
    #     start_record_name: "DNSName",
    #     start_record_type: "SOA", # accepts SOA, A, TXT, NS, CNAME, MX, NAPTR, PTR, SRV, SPF, AAAA, CAA, DS, TLSA, SSHFP, SVCB, HTTPS
    #     start_record_identifier: "ResourceRecordSetIdentifier",
    #     max_items: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.resource_record_sets #=> Array
    #   resp.resource_record_sets[0].name #=> String
    #   resp.resource_record_sets[0].type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.resource_record_sets[0].set_identifier #=> String
    #   resp.resource_record_sets[0].weight #=> Integer
    #   resp.resource_record_sets[0].region #=> String, one of "us-east-1", "us-east-2", "us-west-1", "us-west-2", "ca-central-1", "eu-west-1", "eu-west-2", "eu-west-3", "eu-central-1", "eu-central-2", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "eu-north-1", "sa-east-1", "cn-north-1", "cn-northwest-1", "ap-east-1", "me-south-1", "me-central-1", "ap-south-1", "ap-south-2", "af-south-1", "eu-south-1", "eu-south-2", "ap-southeast-4", "il-central-1", "ca-west-1", "ap-southeast-5", "mx-central-1", "ap-southeast-7", "us-gov-east-1", "us-gov-west-1", "ap-east-2", "ap-southeast-6"
    #   resp.resource_record_sets[0].geo_location.continent_code #=> String
    #   resp.resource_record_sets[0].geo_location.country_code #=> String
    #   resp.resource_record_sets[0].geo_location.subdivision_code #=> String
    #   resp.resource_record_sets[0].failover #=> String, one of "PRIMARY", "SECONDARY"
    #   resp.resource_record_sets[0].multi_value_answer #=> Boolean
    #   resp.resource_record_sets[0].ttl #=> Integer
    #   resp.resource_record_sets[0].resource_records #=> Array
    #   resp.resource_record_sets[0].resource_records[0].value #=> String
    #   resp.resource_record_sets[0].alias_target.hosted_zone_id #=> String
    #   resp.resource_record_sets[0].alias_target.dns_name #=> String
    #   resp.resource_record_sets[0].alias_target.evaluate_target_health #=> Boolean
    #   resp.resource_record_sets[0].health_check_id #=> String
    #   resp.resource_record_sets[0].traffic_policy_instance_id #=> String
    #   resp.resource_record_sets[0].cidr_routing_config.collection_id #=> String
    #   resp.resource_record_sets[0].cidr_routing_config.location_name #=> String
    #   resp.resource_record_sets[0].geo_proximity_location.aws_region #=> String
    #   resp.resource_record_sets[0].geo_proximity_location.local_zone_group #=> String
    #   resp.resource_record_sets[0].geo_proximity_location.coordinates.latitude #=> String
    #   resp.resource_record_sets[0].geo_proximity_location.coordinates.longitude #=> String
    #   resp.resource_record_sets[0].geo_proximity_location.bias #=> Integer
    #   resp.is_truncated #=> Boolean
    #   resp.next_record_name #=> String
    #   resp.next_record_type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.next_record_identifier #=> String
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListResourceRecordSets AWS API Documentation
    #
    # @overload list_resource_record_sets(params = {})
    # @param [Hash] params ({})
    def list_resource_record_sets(params = {}, options = {})
      req = build_request(:list_resource_record_sets, params)
      req.send_request(options)
    end

    # Retrieves a list of the reusable delegation sets that are associated
    # with the current Amazon Web Services account.
    #
    # @option params [String] :marker
    #   If the value of `IsTruncated` in the previous response was `true`, you
    #   have more reusable delegation sets. To get another group, submit
    #   another `ListReusableDelegationSets` request.
    #
    #   For the value of `marker`, specify the value of `NextMarker` from the
    #   previous response, which is the ID of the first reusable delegation
    #   set that Amazon Route 53 will return if you submit another request.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more reusable delegation sets to get.
    #
    # @option params [Integer] :max_items
    #   The number of reusable delegation sets that you want Amazon Route 53
    #   to return in the response to this request. If you specify a value
    #   greater than 100, Route 53 returns only the first 100 reusable
    #   delegation sets.
    #
    # @return [Types::ListReusableDelegationSetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListReusableDelegationSetsResponse#delegation_sets #delegation_sets} => Array&lt;Types::DelegationSet&gt;
    #   * {Types::ListReusableDelegationSetsResponse#marker #marker} => String
    #   * {Types::ListReusableDelegationSetsResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListReusableDelegationSetsResponse#next_marker #next_marker} => String
    #   * {Types::ListReusableDelegationSetsResponse#max_items #max_items} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_reusable_delegation_sets({
    #     marker: "PageMarker",
    #     max_items: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.delegation_sets #=> Array
    #   resp.delegation_sets[0].id #=> String
    #   resp.delegation_sets[0].caller_reference #=> String
    #   resp.delegation_sets[0].name_servers #=> Array
    #   resp.delegation_sets[0].name_servers[0] #=> String
    #   resp.marker #=> String
    #   resp.is_truncated #=> Boolean
    #   resp.next_marker #=> String
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListReusableDelegationSets AWS API Documentation
    #
    # @overload list_reusable_delegation_sets(params = {})
    # @param [Hash] params ({})
    def list_reusable_delegation_sets(params = {}, options = {})
      req = build_request(:list_reusable_delegation_sets, params)
      req.send_request(options)
    end

    # Lists tags for one health check or hosted zone.
    #
    # For information about using tags for cost allocation, see [Using Cost
    # Allocation Tags][1] in the *Billing and Cost Management User Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
    #
    # @option params [required, String] :resource_type
    #   The type of the resource.
    #
    #   * The resource type for health checks is `healthcheck`.
    #
    #   * The resource type for hosted zones is `hostedzone`.
    #
    # @option params [required, String] :resource_id
    #   The ID of the resource for which you want to retrieve tags.
    #
    # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListTagsForResourceResponse#resource_tag_set #resource_tag_set} => Types::ResourceTagSet
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_tags_for_resource({
    #     resource_type: "healthcheck", # required, accepts healthcheck, hostedzone
    #     resource_id: "TagResourceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.resource_tag_set.resource_type #=> String, one of "healthcheck", "hostedzone"
    #   resp.resource_tag_set.resource_id #=> String
    #   resp.resource_tag_set.tags #=> Array
    #   resp.resource_tag_set.tags[0].key #=> String
    #   resp.resource_tag_set.tags[0].value #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTagsForResource AWS API Documentation
    #
    # @overload list_tags_for_resource(params = {})
    # @param [Hash] params ({})
    def list_tags_for_resource(params = {}, options = {})
      req = build_request(:list_tags_for_resource, params)
      req.send_request(options)
    end

    # Lists tags for up to 10 health checks or hosted zones.
    #
    # For information about using tags for cost allocation, see [Using Cost
    # Allocation Tags][1] in the *Billing and Cost Management User Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
    #
    # @option params [required, String] :resource_type
    #   The type of the resources.
    #
    #   * The resource type for health checks is `healthcheck`.
    #
    #   * The resource type for hosted zones is `hostedzone`.
    #
    # @option params [required, Array<String>] :resource_ids
    #   A complex type that contains the ResourceId element for each resource
    #   for which you want to get a list of tags.
    #
    # @return [Types::ListTagsForResourcesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListTagsForResourcesResponse#resource_tag_sets #resource_tag_sets} => Array&lt;Types::ResourceTagSet&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_tags_for_resources({
    #     resource_type: "healthcheck", # required, accepts healthcheck, hostedzone
    #     resource_ids: ["TagResourceId"], # required
    #   })
    #
    # @example Response structure
    #
    #   resp.resource_tag_sets #=> Array
    #   resp.resource_tag_sets[0].resource_type #=> String, one of "healthcheck", "hostedzone"
    #   resp.resource_tag_sets[0].resource_id #=> String
    #   resp.resource_tag_sets[0].tags #=> Array
    #   resp.resource_tag_sets[0].tags[0].key #=> String
    #   resp.resource_tag_sets[0].tags[0].value #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTagsForResources AWS API Documentation
    #
    # @overload list_tags_for_resources(params = {})
    # @param [Hash] params ({})
    def list_tags_for_resources(params = {}, options = {})
      req = build_request(:list_tags_for_resources, params)
      req.send_request(options)
    end

    # Gets information about the latest version for every traffic policy
    # that is associated with the current Amazon Web Services account.
    # Policies are listed in the order that they were created in.
    #
    # For information about how of deleting a traffic policy affects the
    # response from `ListTrafficPolicies`, see [DeleteTrafficPolicy][1].
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_DeleteTrafficPolicy.html
    #
    # @option params [String] :traffic_policy_id_marker
    #   (Conditional) For your first request to `ListTrafficPolicies`, don't
    #   include the `TrafficPolicyIdMarker` parameter.
    #
    #   If you have more traffic policies than the value of `MaxItems`,
    #   `ListTrafficPolicies` returns only the first `MaxItems` traffic
    #   policies. To get the next group of policies, submit another request to
    #   `ListTrafficPolicies`. For the value of `TrafficPolicyIdMarker`,
    #   specify the value of `TrafficPolicyIdMarker` that was returned in the
    #   previous response.
    #
    # @option params [Integer] :max_items
    #   (Optional) The maximum number of traffic policies that you want Amazon
    #   Route 53 to return in response to this request. If you have more than
    #   `MaxItems` traffic policies, the value of `IsTruncated` in the
    #   response is `true`, and the value of `TrafficPolicyIdMarker` is the ID
    #   of the first traffic policy that Route 53 will return if you submit
    #   another request.
    #
    # @return [Types::ListTrafficPoliciesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListTrafficPoliciesResponse#traffic_policy_summaries #traffic_policy_summaries} => Array&lt;Types::TrafficPolicySummary&gt;
    #   * {Types::ListTrafficPoliciesResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListTrafficPoliciesResponse#traffic_policy_id_marker #traffic_policy_id_marker} => String
    #   * {Types::ListTrafficPoliciesResponse#max_items #max_items} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_traffic_policies({
    #     traffic_policy_id_marker: "TrafficPolicyId",
    #     max_items: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy_summaries #=> Array
    #   resp.traffic_policy_summaries[0].id #=> String
    #   resp.traffic_policy_summaries[0].name #=> String
    #   resp.traffic_policy_summaries[0].type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.traffic_policy_summaries[0].latest_version #=> Integer
    #   resp.traffic_policy_summaries[0].traffic_policy_count #=> Integer
    #   resp.is_truncated #=> Boolean
    #   resp.traffic_policy_id_marker #=> String
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicies AWS API Documentation
    #
    # @overload list_traffic_policies(params = {})
    # @param [Hash] params ({})
    def list_traffic_policies(params = {}, options = {})
      req = build_request(:list_traffic_policies, params)
      req.send_request(options)
    end

    # Gets information about the traffic policy instances that you created
    # by using the current Amazon Web Services account.
    #
    # <note markdown="1"> After you submit an `UpdateTrafficPolicyInstance` request, there's a
    # brief delay while Amazon Route 53 creates the resource record sets
    # that are specified in the traffic policy definition. For more
    # information, see the `State` response element.
    #
    #  </note>
    #
    # Route 53 returns a maximum of 100 items in each response. If you have
    # a lot of traffic policy instances, you can use the `MaxItems`
    # parameter to list them in groups of up to 100.
    #
    # @option params [String] :hosted_zone_id_marker
    #   If the value of `IsTruncated` in the previous response was `true`, you
    #   have more traffic policy instances. To get more traffic policy
    #   instances, submit another `ListTrafficPolicyInstances` request. For
    #   the value of `HostedZoneId`, specify the value of `HostedZoneIdMarker`
    #   from the previous response, which is the hosted zone ID of the first
    #   traffic policy instance in the next group of traffic policy instances.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more traffic policy instances to get.
    #
    # @option params [String] :traffic_policy_instance_name_marker
    #   If the value of `IsTruncated` in the previous response was `true`, you
    #   have more traffic policy instances. To get more traffic policy
    #   instances, submit another `ListTrafficPolicyInstances` request. For
    #   the value of `trafficpolicyinstancename`, specify the value of
    #   `TrafficPolicyInstanceNameMarker` from the previous response, which is
    #   the name of the first traffic policy instance in the next group of
    #   traffic policy instances.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more traffic policy instances to get.
    #
    # @option params [String] :traffic_policy_instance_type_marker
    #   If the value of `IsTruncated` in the previous response was `true`, you
    #   have more traffic policy instances. To get more traffic policy
    #   instances, submit another `ListTrafficPolicyInstances` request. For
    #   the value of `trafficpolicyinstancetype`, specify the value of
    #   `TrafficPolicyInstanceTypeMarker` from the previous response, which is
    #   the type of the first traffic policy instance in the next group of
    #   traffic policy instances.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more traffic policy instances to get.
    #
    # @option params [Integer] :max_items
    #   The maximum number of traffic policy instances that you want Amazon
    #   Route 53 to return in response to a `ListTrafficPolicyInstances`
    #   request. If you have more than `MaxItems` traffic policy instances,
    #   the value of the `IsTruncated` element in the response is `true`, and
    #   the values of `HostedZoneIdMarker`, `TrafficPolicyInstanceNameMarker`,
    #   and `TrafficPolicyInstanceTypeMarker` represent the first traffic
    #   policy instance in the next group of `MaxItems` traffic policy
    #   instances.
    #
    # @return [Types::ListTrafficPolicyInstancesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListTrafficPolicyInstancesResponse#traffic_policy_instances #traffic_policy_instances} => Array&lt;Types::TrafficPolicyInstance&gt;
    #   * {Types::ListTrafficPolicyInstancesResponse#hosted_zone_id_marker #hosted_zone_id_marker} => String
    #   * {Types::ListTrafficPolicyInstancesResponse#traffic_policy_instance_name_marker #traffic_policy_instance_name_marker} => String
    #   * {Types::ListTrafficPolicyInstancesResponse#traffic_policy_instance_type_marker #traffic_policy_instance_type_marker} => String
    #   * {Types::ListTrafficPolicyInstancesResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListTrafficPolicyInstancesResponse#max_items #max_items} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_traffic_policy_instances({
    #     hosted_zone_id_marker: "ResourceId",
    #     traffic_policy_instance_name_marker: "DNSName",
    #     traffic_policy_instance_type_marker: "SOA", # accepts SOA, A, TXT, NS, CNAME, MX, NAPTR, PTR, SRV, SPF, AAAA, CAA, DS, TLSA, SSHFP, SVCB, HTTPS
    #     max_items: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy_instances #=> Array
    #   resp.traffic_policy_instances[0].id #=> String
    #   resp.traffic_policy_instances[0].hosted_zone_id #=> String
    #   resp.traffic_policy_instances[0].name #=> String
    #   resp.traffic_policy_instances[0].ttl #=> Integer
    #   resp.traffic_policy_instances[0].state #=> String
    #   resp.traffic_policy_instances[0].message #=> String
    #   resp.traffic_policy_instances[0].traffic_policy_id #=> String
    #   resp.traffic_policy_instances[0].traffic_policy_version #=> Integer
    #   resp.traffic_policy_instances[0].traffic_policy_type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.hosted_zone_id_marker #=> String
    #   resp.traffic_policy_instance_name_marker #=> String
    #   resp.traffic_policy_instance_type_marker #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.is_truncated #=> Boolean
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyInstances AWS API Documentation
    #
    # @overload list_traffic_policy_instances(params = {})
    # @param [Hash] params ({})
    def list_traffic_policy_instances(params = {}, options = {})
      req = build_request(:list_traffic_policy_instances, params)
      req.send_request(options)
    end

    # Gets information about the traffic policy instances that you created
    # in a specified hosted zone.
    #
    # <note markdown="1"> After you submit a `CreateTrafficPolicyInstance` or an
    # `UpdateTrafficPolicyInstance` request, there's a brief delay while
    # Amazon Route 53 creates the resource record sets that are specified in
    # the traffic policy definition. For more information, see the `State`
    # response element.
    #
    #  </note>
    #
    # Route 53 returns a maximum of 100 items in each response. If you have
    # a lot of traffic policy instances, you can use the `MaxItems`
    # parameter to list them in groups of up to 100.
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the hosted zone that you want to list traffic policy
    #   instances for.
    #
    # @option params [String] :traffic_policy_instance_name_marker
    #   If the value of `IsTruncated` in the previous response is true, you
    #   have more traffic policy instances. To get more traffic policy
    #   instances, submit another `ListTrafficPolicyInstances` request. For
    #   the value of `trafficpolicyinstancename`, specify the value of
    #   `TrafficPolicyInstanceNameMarker` from the previous response, which is
    #   the name of the first traffic policy instance in the next group of
    #   traffic policy instances.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more traffic policy instances to get.
    #
    # @option params [String] :traffic_policy_instance_type_marker
    #   If the value of `IsTruncated` in the previous response is true, you
    #   have more traffic policy instances. To get more traffic policy
    #   instances, submit another `ListTrafficPolicyInstances` request. For
    #   the value of `trafficpolicyinstancetype`, specify the value of
    #   `TrafficPolicyInstanceTypeMarker` from the previous response, which is
    #   the type of the first traffic policy instance in the next group of
    #   traffic policy instances.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more traffic policy instances to get.
    #
    # @option params [Integer] :max_items
    #   The maximum number of traffic policy instances to be included in the
    #   response body for this request. If you have more than `MaxItems`
    #   traffic policy instances, the value of the `IsTruncated` element in
    #   the response is `true`, and the values of `HostedZoneIdMarker`,
    #   `TrafficPolicyInstanceNameMarker`, and
    #   `TrafficPolicyInstanceTypeMarker` represent the first traffic policy
    #   instance that Amazon Route 53 will return if you submit another
    #   request.
    #
    # @return [Types::ListTrafficPolicyInstancesByHostedZoneResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListTrafficPolicyInstancesByHostedZoneResponse#traffic_policy_instances #traffic_policy_instances} => Array&lt;Types::TrafficPolicyInstance&gt;
    #   * {Types::ListTrafficPolicyInstancesByHostedZoneResponse#traffic_policy_instance_name_marker #traffic_policy_instance_name_marker} => String
    #   * {Types::ListTrafficPolicyInstancesByHostedZoneResponse#traffic_policy_instance_type_marker #traffic_policy_instance_type_marker} => String
    #   * {Types::ListTrafficPolicyInstancesByHostedZoneResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListTrafficPolicyInstancesByHostedZoneResponse#max_items #max_items} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_traffic_policy_instances_by_hosted_zone({
    #     hosted_zone_id: "ResourceId", # required
    #     traffic_policy_instance_name_marker: "DNSName",
    #     traffic_policy_instance_type_marker: "SOA", # accepts SOA, A, TXT, NS, CNAME, MX, NAPTR, PTR, SRV, SPF, AAAA, CAA, DS, TLSA, SSHFP, SVCB, HTTPS
    #     max_items: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy_instances #=> Array
    #   resp.traffic_policy_instances[0].id #=> String
    #   resp.traffic_policy_instances[0].hosted_zone_id #=> String
    #   resp.traffic_policy_instances[0].name #=> String
    #   resp.traffic_policy_instances[0].ttl #=> Integer
    #   resp.traffic_policy_instances[0].state #=> String
    #   resp.traffic_policy_instances[0].message #=> String
    #   resp.traffic_policy_instances[0].traffic_policy_id #=> String
    #   resp.traffic_policy_instances[0].traffic_policy_version #=> Integer
    #   resp.traffic_policy_instances[0].traffic_policy_type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.traffic_policy_instance_name_marker #=> String
    #   resp.traffic_policy_instance_type_marker #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.is_truncated #=> Boolean
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyInstancesByHostedZone AWS API Documentation
    #
    # @overload list_traffic_policy_instances_by_hosted_zone(params = {})
    # @param [Hash] params ({})
    def list_traffic_policy_instances_by_hosted_zone(params = {}, options = {})
      req = build_request(:list_traffic_policy_instances_by_hosted_zone, params)
      req.send_request(options)
    end

    # Gets information about the traffic policy instances that you created
    # by using a specify traffic policy version.
    #
    # <note markdown="1"> After you submit a `CreateTrafficPolicyInstance` or an
    # `UpdateTrafficPolicyInstance` request, there's a brief delay while
    # Amazon Route 53 creates the resource record sets that are specified in
    # the traffic policy definition. For more information, see the `State`
    # response element.
    #
    #  </note>
    #
    # Route 53 returns a maximum of 100 items in each response. If you have
    # a lot of traffic policy instances, you can use the `MaxItems`
    # parameter to list them in groups of up to 100.
    #
    # @option params [required, String] :traffic_policy_id
    #   The ID of the traffic policy for which you want to list traffic policy
    #   instances.
    #
    # @option params [required, Integer] :traffic_policy_version
    #   The version of the traffic policy for which you want to list traffic
    #   policy instances. The version must be associated with the traffic
    #   policy that is specified by `TrafficPolicyId`.
    #
    # @option params [String] :hosted_zone_id_marker
    #   If the value of `IsTruncated` in the previous response was `true`, you
    #   have more traffic policy instances. To get more traffic policy
    #   instances, submit another `ListTrafficPolicyInstancesByPolicy`
    #   request.
    #
    #   For the value of `hostedzoneid`, specify the value of
    #   `HostedZoneIdMarker` from the previous response, which is the hosted
    #   zone ID of the first traffic policy instance that Amazon Route 53 will
    #   return if you submit another request.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more traffic policy instances to get.
    #
    # @option params [String] :traffic_policy_instance_name_marker
    #   If the value of `IsTruncated` in the previous response was `true`, you
    #   have more traffic policy instances. To get more traffic policy
    #   instances, submit another `ListTrafficPolicyInstancesByPolicy`
    #   request.
    #
    #   For the value of `trafficpolicyinstancename`, specify the value of
    #   `TrafficPolicyInstanceNameMarker` from the previous response, which is
    #   the name of the first traffic policy instance that Amazon Route 53
    #   will return if you submit another request.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more traffic policy instances to get.
    #
    # @option params [String] :traffic_policy_instance_type_marker
    #   If the value of `IsTruncated` in the previous response was `true`, you
    #   have more traffic policy instances. To get more traffic policy
    #   instances, submit another `ListTrafficPolicyInstancesByPolicy`
    #   request.
    #
    #   For the value of `trafficpolicyinstancetype`, specify the value of
    #   `TrafficPolicyInstanceTypeMarker` from the previous response, which is
    #   the name of the first traffic policy instance that Amazon Route 53
    #   will return if you submit another request.
    #
    #   If the value of `IsTruncated` in the previous response was `false`,
    #   there are no more traffic policy instances to get.
    #
    # @option params [Integer] :max_items
    #   The maximum number of traffic policy instances to be included in the
    #   response body for this request. If you have more than `MaxItems`
    #   traffic policy instances, the value of the `IsTruncated` element in
    #   the response is `true`, and the values of `HostedZoneIdMarker`,
    #   `TrafficPolicyInstanceNameMarker`, and
    #   `TrafficPolicyInstanceTypeMarker` represent the first traffic policy
    #   instance that Amazon Route 53 will return if you submit another
    #   request.
    #
    # @return [Types::ListTrafficPolicyInstancesByPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListTrafficPolicyInstancesByPolicyResponse#traffic_policy_instances #traffic_policy_instances} => Array&lt;Types::TrafficPolicyInstance&gt;
    #   * {Types::ListTrafficPolicyInstancesByPolicyResponse#hosted_zone_id_marker #hosted_zone_id_marker} => String
    #   * {Types::ListTrafficPolicyInstancesByPolicyResponse#traffic_policy_instance_name_marker #traffic_policy_instance_name_marker} => String
    #   * {Types::ListTrafficPolicyInstancesByPolicyResponse#traffic_policy_instance_type_marker #traffic_policy_instance_type_marker} => String
    #   * {Types::ListTrafficPolicyInstancesByPolicyResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListTrafficPolicyInstancesByPolicyResponse#max_items #max_items} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_traffic_policy_instances_by_policy({
    #     traffic_policy_id: "TrafficPolicyId", # required
    #     traffic_policy_version: 1, # required
    #     hosted_zone_id_marker: "ResourceId",
    #     traffic_policy_instance_name_marker: "DNSName",
    #     traffic_policy_instance_type_marker: "SOA", # accepts SOA, A, TXT, NS, CNAME, MX, NAPTR, PTR, SRV, SPF, AAAA, CAA, DS, TLSA, SSHFP, SVCB, HTTPS
    #     max_items: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy_instances #=> Array
    #   resp.traffic_policy_instances[0].id #=> String
    #   resp.traffic_policy_instances[0].hosted_zone_id #=> String
    #   resp.traffic_policy_instances[0].name #=> String
    #   resp.traffic_policy_instances[0].ttl #=> Integer
    #   resp.traffic_policy_instances[0].state #=> String
    #   resp.traffic_policy_instances[0].message #=> String
    #   resp.traffic_policy_instances[0].traffic_policy_id #=> String
    #   resp.traffic_policy_instances[0].traffic_policy_version #=> Integer
    #   resp.traffic_policy_instances[0].traffic_policy_type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.hosted_zone_id_marker #=> String
    #   resp.traffic_policy_instance_name_marker #=> String
    #   resp.traffic_policy_instance_type_marker #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.is_truncated #=> Boolean
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyInstancesByPolicy AWS API Documentation
    #
    # @overload list_traffic_policy_instances_by_policy(params = {})
    # @param [Hash] params ({})
    def list_traffic_policy_instances_by_policy(params = {}, options = {})
      req = build_request(:list_traffic_policy_instances_by_policy, params)
      req.send_request(options)
    end

    # Gets information about all of the versions for a specified traffic
    # policy.
    #
    # Traffic policy versions are listed in numerical order by
    # `VersionNumber`.
    #
    # @option params [required, String] :id
    #   Specify the value of `Id` of the traffic policy for which you want to
    #   list all versions.
    #
    # @option params [String] :traffic_policy_version_marker
    #   For your first request to `ListTrafficPolicyVersions`, don't include
    #   the `TrafficPolicyVersionMarker` parameter.
    #
    #   If you have more traffic policy versions than the value of `MaxItems`,
    #   `ListTrafficPolicyVersions` returns only the first group of `MaxItems`
    #   versions. To get more traffic policy versions, submit another
    #   `ListTrafficPolicyVersions` request. For the value of
    #   `TrafficPolicyVersionMarker`, specify the value of
    #   `TrafficPolicyVersionMarker` in the previous response.
    #
    # @option params [Integer] :max_items
    #   The maximum number of traffic policy versions that you want Amazon
    #   Route 53 to include in the response body for this request. If the
    #   specified traffic policy has more than `MaxItems` versions, the value
    #   of `IsTruncated` in the response is `true`, and the value of the
    #   `TrafficPolicyVersionMarker` element is the ID of the first version
    #   that Route 53 will return if you submit another request.
    #
    # @return [Types::ListTrafficPolicyVersionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListTrafficPolicyVersionsResponse#traffic_policies #traffic_policies} => Array&lt;Types::TrafficPolicy&gt;
    #   * {Types::ListTrafficPolicyVersionsResponse#is_truncated #is_truncated} => Boolean
    #   * {Types::ListTrafficPolicyVersionsResponse#traffic_policy_version_marker #traffic_policy_version_marker} => String
    #   * {Types::ListTrafficPolicyVersionsResponse#max_items #max_items} => Integer
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_traffic_policy_versions({
    #     id: "TrafficPolicyId", # required
    #     traffic_policy_version_marker: "TrafficPolicyVersionMarker",
    #     max_items: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policies #=> Array
    #   resp.traffic_policies[0].id #=> String
    #   resp.traffic_policies[0].version #=> Integer
    #   resp.traffic_policies[0].name #=> String
    #   resp.traffic_policies[0].type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.traffic_policies[0].document #=> String
    #   resp.traffic_policies[0].comment #=> String
    #   resp.is_truncated #=> Boolean
    #   resp.traffic_policy_version_marker #=> String
    #   resp.max_items #=> Integer
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListTrafficPolicyVersions AWS API Documentation
    #
    # @overload list_traffic_policy_versions(params = {})
    # @param [Hash] params ({})
    def list_traffic_policy_versions(params = {}, options = {})
      req = build_request(:list_traffic_policy_versions, params)
      req.send_request(options)
    end

    # Gets a list of the VPCs that were created by other accounts and that
    # can be associated with a specified hosted zone because you've
    # submitted one or more `CreateVPCAssociationAuthorization` requests.
    #
    # The response includes a `VPCs` element with a `VPC` child element for
    # each VPC that can be associated with the hosted zone.
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the hosted zone for which you want a list of VPCs that can
    #   be associated with the hosted zone.
    #
    # @option params [String] :next_token
    #   *Optional*: If a response includes a `NextToken` element, there are
    #   more VPCs that can be associated with the specified hosted zone. To
    #   get the next page of results, submit another request, and include the
    #   value of `NextToken` from the response in the `nexttoken` parameter in
    #   another `ListVPCAssociationAuthorizations` request.
    #
    # @option params [String] :max_results
    #   *Optional*: An integer that specifies the maximum number of VPCs that
    #   you want Amazon Route 53 to return. If you don't specify a value for
    #   `MaxResults`, Route 53 returns up to 50 VPCs per page.
    #
    # @return [Types::ListVPCAssociationAuthorizationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListVPCAssociationAuthorizationsResponse#hosted_zone_id #hosted_zone_id} => String
    #   * {Types::ListVPCAssociationAuthorizationsResponse#next_token #next_token} => String
    #   * {Types::ListVPCAssociationAuthorizationsResponse#vp_cs #vp_cs} => Array&lt;Types::VPC&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_vpc_association_authorizations({
    #     hosted_zone_id: "ResourceId", # required
    #     next_token: "PaginationToken",
    #     max_results: "MaxResults",
    #   })
    #
    # @example Response structure
    #
    #   resp.hosted_zone_id #=> String
    #   resp.next_token #=> String
    #   resp.vp_cs #=> Array
    #   resp.vp_cs[0].vpc_region #=> String, one of "us-east-1", "us-east-2", "us-west-1", "us-west-2", "eu-west-1", "eu-west-2", "eu-west-3", "eu-central-1", "eu-central-2", "ap-east-1", "me-south-1", "us-gov-west-1", "us-gov-east-1", "us-iso-east-1", "us-iso-west-1", "us-isob-east-1", "me-central-1", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ap-south-1", "ap-south-2", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "eu-north-1", "sa-east-1", "ca-central-1", "cn-north-1", "cn-northwest-1", "af-south-1", "eu-south-1", "eu-south-2", "ap-southeast-4", "il-central-1", "ca-west-1", "ap-southeast-5", "mx-central-1", "us-isof-south-1", "us-isof-east-1", "ap-southeast-7", "ap-east-2", "eu-isoe-west-1", "ap-southeast-6"
    #   resp.vp_cs[0].vpc_id #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/ListVPCAssociationAuthorizations AWS API Documentation
    #
    # @overload list_vpc_association_authorizations(params = {})
    # @param [Hash] params ({})
    def list_vpc_association_authorizations(params = {}, options = {})
      req = build_request(:list_vpc_association_authorizations, params)
      req.send_request(options)
    end

    # Gets the value that Amazon Route 53 returns in response to a DNS
    # request for a specified record name and type. You can optionally
    # specify the IP address of a DNS resolver, an EDNS0 client subnet IP
    # address, and a subnet mask.
    #
    # This call only supports querying public hosted zones.
    #
    # <note markdown="1"> The `TestDnsAnswer ` returns information similar to what you would
    # expect from the answer section of the `dig` command. Therefore, if you
    # query for the name servers of a subdomain that point to the parent
    # name servers, those will not be returned.
    #
    #  </note>
    #
    # @option params [required, String] :hosted_zone_id
    #   The ID of the hosted zone that you want Amazon Route 53 to simulate a
    #   query for.
    #
    # @option params [required, String] :record_name
    #   The name of the resource record set that you want Amazon Route 53 to
    #   simulate a query for.
    #
    # @option params [required, String] :record_type
    #   The type of the resource record set.
    #
    # @option params [String] :resolver_ip
    #   If you want to simulate a request from a specific DNS resolver,
    #   specify the IP address for that resolver. If you omit this value,
    #   `TestDnsAnswer` uses the IP address of a DNS resolver in the Amazon
    #   Web Services US East (N. Virginia) Region (`us-east-1`).
    #
    # @option params [String] :edns0_client_subnet_ip
    #   If the resolver that you specified for resolverip supports EDNS0,
    #   specify the IPv4 or IPv6 address of a client in the applicable
    #   location, for example, `192.0.2.44` or `2001:db8:85a3::8a2e:370:7334`.
    #
    # @option params [String] :edns0_client_subnet_mask
    #   If you specify an IP address for `edns0clientsubnetip`, you can
    #   optionally specify the number of bits of the IP address that you want
    #   the checking tool to include in the DNS query. For example, if you
    #   specify `192.0.2.44` for `edns0clientsubnetip` and `24` for
    #   `edns0clientsubnetmask`, the checking tool will simulate a request
    #   from 192.0.2.0/24. The default value is 24 bits for IPv4 addresses and
    #   64 bits for IPv6 addresses.
    #
    #   The range of valid values depends on whether `edns0clientsubnetip` is
    #   an IPv4 or an IPv6 address:
    #
    #   * **IPv4**: Specify a value between 0 and 32
    #
    #   * **IPv6**: Specify a value between 0 and 128
    #
    # @return [Types::TestDNSAnswerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::TestDNSAnswerResponse#nameserver #nameserver} => String
    #   * {Types::TestDNSAnswerResponse#record_name #record_name} => String
    #   * {Types::TestDNSAnswerResponse#record_type #record_type} => String
    #   * {Types::TestDNSAnswerResponse#record_data #record_data} => Array&lt;String&gt;
    #   * {Types::TestDNSAnswerResponse#response_code #response_code} => String
    #   * {Types::TestDNSAnswerResponse#protocol #protocol} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.test_dns_answer({
    #     hosted_zone_id: "ResourceId", # required
    #     record_name: "DNSName", # required
    #     record_type: "SOA", # required, accepts SOA, A, TXT, NS, CNAME, MX, NAPTR, PTR, SRV, SPF, AAAA, CAA, DS, TLSA, SSHFP, SVCB, HTTPS
    #     resolver_ip: "IPAddress",
    #     edns0_client_subnet_ip: "IPAddress",
    #     edns0_client_subnet_mask: "SubnetMask",
    #   })
    #
    # @example Response structure
    #
    #   resp.nameserver #=> String
    #   resp.record_name #=> String
    #   resp.record_type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.record_data #=> Array
    #   resp.record_data[0] #=> String
    #   resp.response_code #=> String
    #   resp.protocol #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/TestDNSAnswer AWS API Documentation
    #
    # @overload test_dns_answer(params = {})
    # @param [Hash] params ({})
    def test_dns_answer(params = {}, options = {})
      req = build_request(:test_dns_answer, params)
      req.send_request(options)
    end

    # Updates an existing health check. Note that some values can't be
    # updated.
    #
    # For more information about updating health checks, see [Creating,
    # Updating, and Deleting Health Checks][1] in the *Amazon Route 53
    # Developer Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/health-checks-creating-deleting.html
    #
    # @option params [required, String] :health_check_id
    #   The ID for the health check for which you want detailed information.
    #   When you created the health check, `CreateHealthCheck` returned the ID
    #   in the response, in the `HealthCheckId` element.
    #
    # @option params [Integer] :health_check_version
    #   A sequential counter that Amazon Route 53 sets to `1` when you create
    #   a health check and increments by 1 each time you update settings for
    #   the health check.
    #
    #   We recommend that you use `GetHealthCheck` or `ListHealthChecks` to
    #   get the current value of `HealthCheckVersion` for the health check
    #   that you want to update, and that you include that value in your
    #   `UpdateHealthCheck` request. This prevents Route 53 from overwriting
    #   an intervening update:
    #
    #   * If the value in the `UpdateHealthCheck` request matches the value of
    #     `HealthCheckVersion` in the health check, Route 53 updates the
    #     health check with the new settings.
    #
    #   * If the value of `HealthCheckVersion` in the health check is greater,
    #     the health check was changed after you got the version number. Route
    #     53 does not update the health check, and it returns a
    #     `HealthCheckVersionMismatch` error.
    #
    # @option params [String] :ip_address
    #   The IPv4 or IPv6 IP address for the endpoint that you want Amazon
    #   Route 53 to perform health checks on. If you don't specify a value
    #   for `IPAddress`, Route 53 sends a DNS request to resolve the domain
    #   name that you specify in `FullyQualifiedDomainName` at the interval
    #   that you specify in `RequestInterval`. Using an IP address that is
    #   returned by DNS, Route 53 then checks the health of the endpoint.
    #
    #   Use one of the following formats for the value of `IPAddress`:
    #
    #   * **IPv4 address**: four values between 0 and 255, separated by
    #     periods (.), for example, `192.0.2.44`.
    #
    #   * **IPv6 address**: eight groups of four hexadecimal values, separated
    #     by colons (:), for example,
    #     `2001:0db8:85a3:0000:0000:abcd:0001:2345`. You can also shorten IPv6
    #     addresses as described in RFC 5952, for example,
    #     `2001:db8:85a3::abcd:1:2345`.
    #
    #   If the endpoint is an EC2 instance, we recommend that you create an
    #   Elastic IP address, associate it with your EC2 instance, and specify
    #   the Elastic IP address for `IPAddress`. This ensures that the IP
    #   address of your instance never changes. For more information, see the
    #   applicable documentation:
    #
    #   * Linux: [Elastic IP Addresses (EIP)][1] in the *Amazon EC2 User Guide
    #     for Linux Instances*
    #
    #   * Windows: [Elastic IP Addresses (EIP)][2] in the *Amazon EC2 User
    #     Guide for Windows Instances*
    #
    #   <note markdown="1"> If a health check already has a value for `IPAddress`, you can change
    #   the value. However, you can't update an existing health check to add
    #   or remove the value of `IPAddress`.
    #
    #    </note>
    #
    #   For more information, see [FullyQualifiedDomainName][3].
    #
    #   Constraints: Route 53 can't check the health of endpoints for which
    #   the IP address is in local, private, non-routable, or multicast
    #   ranges. For more information about IP addresses for which you can't
    #   create health checks, see the following documents:
    #
    #   * [RFC 5735, Special Use IPv4 Addresses][4]
    #
    #   * [RFC 6598, IANA-Reserved IPv4 Prefix for Shared Address Space][5]
    #
    #   * [RFC 5156, Special-Use IPv6 Addresses][6]
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html
    #   [2]: https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/elastic-ip-addresses-eip.html
    #   [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_UpdateHealthCheck.html#Route53-UpdateHealthCheck-request-FullyQualifiedDomainName
    #   [4]: https://tools.ietf.org/html/rfc5735
    #   [5]: https://tools.ietf.org/html/rfc6598
    #   [6]: https://tools.ietf.org/html/rfc5156
    #
    # @option params [Integer] :port
    #   The port on the endpoint that you want Amazon Route 53 to perform
    #   health checks on.
    #
    #   <note markdown="1"> Don't specify a value for `Port` when you specify a value for `Type`
    #   of `CLOUDWATCH_METRIC` or `CALCULATED`.
    #
    #    </note>
    #
    # @option params [String] :resource_path
    #   The path that you want Amazon Route 53 to request when performing
    #   health checks. The path can be any value for which your endpoint will
    #   return an HTTP status code of 2xx or 3xx when the endpoint is healthy,
    #   for example the file /docs/route53-health-check.html. You can also
    #   include query string parameters, for example,
    #   `/welcome.html?language=jp&login=y`.
    #
    #   Specify this value only if you want to change it.
    #
    # @option params [String] :fully_qualified_domain_name
    #   Amazon Route 53 behavior depends on whether you specify a value for
    #   `IPAddress`.
    #
    #   <note markdown="1"> If a health check already has a value for `IPAddress`, you can change
    #   the value. However, you can't update an existing health check to add
    #   or remove the value of `IPAddress`.
    #
    #    </note>
    #
    #   **If you specify a value for** `IPAddress`:
    #
    #   Route 53 sends health check requests to the specified IPv4 or IPv6
    #   address and passes the value of `FullyQualifiedDomainName` in the
    #   `Host` header for all health checks except TCP health checks. This is
    #   typically the fully qualified DNS name of the endpoint on which you
    #   want Route 53 to perform health checks.
    #
    #   When Route 53 checks the health of an endpoint, here is how it
    #   constructs the `Host` header:
    #
    #   * If you specify a value of `80` for `Port` and `HTTP` or
    #     `HTTP_STR_MATCH` for `Type`, Route 53 passes the value of
    #     `FullyQualifiedDomainName` to the endpoint in the `Host` header.
    #
    #   * If you specify a value of `443` for `Port` and `HTTPS` or
    #     `HTTPS_STR_MATCH` for `Type`, Route 53 passes the value of
    #     `FullyQualifiedDomainName` to the endpoint in the `Host` header.
    #
    #   * If you specify another value for `Port` and any value except `TCP`
    #     for `Type`, Route 53 passes <i>
    #     <code>FullyQualifiedDomainName</code>:<code>Port</code> </i> to the
    #     endpoint in the `Host` header.
    #
    #   If you don't specify a value for `FullyQualifiedDomainName`, Route 53
    #   substitutes the value of `IPAddress` in the `Host` header in each of
    #   the above cases.
    #
    #   **If you don't specify a value for** `IPAddress`:
    #
    #   If you don't specify a value for `IPAddress`, Route 53 sends a DNS
    #   request to the domain that you specify in `FullyQualifiedDomainName`
    #   at the interval you specify in `RequestInterval`. Using an IPv4
    #   address that is returned by DNS, Route 53 then checks the health of
    #   the endpoint.
    #
    #   If you don't specify a value for `IPAddress`, you can’t update the
    #   health check to remove the `FullyQualifiedDomainName`; if you don’t
    #   specify a value for `IPAddress` on creation, a
    #   `FullyQualifiedDomainName` is required.
    #
    #   <note markdown="1"> If you don't specify a value for `IPAddress`, Route 53 uses only IPv4
    #   to send health checks to the endpoint. If there's no resource record
    #   set with a type of A for the name that you specify for
    #   `FullyQualifiedDomainName`, the health check fails with a "DNS
    #   resolution failed" error.
    #
    #    </note>
    #
    #   If you want to check the health of weighted, latency, or failover
    #   resource record sets and you choose to specify the endpoint only by
    #   `FullyQualifiedDomainName`, we recommend that you create a separate
    #   health check for each endpoint. For example, create a health check for
    #   each HTTP server that is serving content for www.example.com. For the
    #   value of `FullyQualifiedDomainName`, specify the domain name of the
    #   server (such as `us-east-2-www.example.com`), not the name of the
    #   resource record sets (www.example.com).
    #
    #   In this configuration, if the value of `FullyQualifiedDomainName`
    #   matches the name of the resource record sets and you then associate
    #   the health check with those resource record sets, health check results
    #   will be unpredictable.
    #
    #   In addition, if the value of `Type` is `HTTP`, `HTTPS`,
    #   `HTTP_STR_MATCH`, or `HTTPS_STR_MATCH`, Route 53 passes the value of
    #   `FullyQualifiedDomainName` in the `Host` header, as it does when you
    #   specify a value for `IPAddress`. If the value of `Type` is `TCP`,
    #   Route 53 doesn't pass a `Host` header.
    #
    # @option params [String] :search_string
    #   If the value of `Type` is `HTTP_STR_MATCH` or `HTTPS_STR_MATCH`, the
    #   string that you want Amazon Route 53 to search for in the response
    #   body from the specified resource. If the string appears in the
    #   response body, Route 53 considers the resource healthy. (You can't
    #   change the value of `Type` when you update a health check.)
    #
    # @option params [Integer] :failure_threshold
    #   The number of consecutive health checks that an endpoint must pass or
    #   fail for Amazon Route 53 to change the current status of the endpoint
    #   from unhealthy to healthy or vice versa. For more information, see
    #   [How Amazon Route 53 Determines Whether an Endpoint Is Healthy][1] in
    #   the *Amazon Route 53 Developer Guide*.
    #
    #   If you don't specify a value for `FailureThreshold`, the default
    #   value is three health checks.
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-determining-health-of-endpoints.html
    #
    # @option params [Boolean] :inverted
    #   Specify whether you want Amazon Route 53 to invert the status of a
    #   health check, for example, to consider a health check unhealthy when
    #   it otherwise would be considered healthy.
    #
    # @option params [Boolean] :disabled
    #   Stops Route 53 from performing health checks. When you disable a
    #   health check, here's what happens:
    #
    #   * **Health checks that check the health of endpoints:** Route 53 stops
    #     submitting requests to your application, server, or other resource.
    #
    #   * **Calculated health checks:** Route 53 stops aggregating the status
    #     of the referenced health checks.
    #
    #   * **Health checks that monitor CloudWatch alarms:** Route 53 stops
    #     monitoring the corresponding CloudWatch metrics.
    #
    #   After you disable a health check, Route 53 considers the status of the
    #   health check to always be healthy. If you configured DNS failover,
    #   Route 53 continues to route traffic to the corresponding resources.
    #   Additionally, in disabled state, you can also invert the status of the
    #   health check to route traffic differently. For more information, see
    #   [Inverted][1].
    #
    #   Charges for a health check still apply when the health check is
    #   disabled. For more information, see [Amazon Route 53 Pricing][2].
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_UpdateHealthCheck.html#Route53-UpdateHealthCheck-request-Inverted
    #   [2]: http://aws.amazon.com/route53/pricing/
    #
    # @option params [Integer] :health_threshold
    #   The number of child health checks that are associated with a
    #   `CALCULATED` health that Amazon Route 53 must consider healthy for the
    #   `CALCULATED` health check to be considered healthy. To specify the
    #   child health checks that you want to associate with a `CALCULATED`
    #   health check, use the `ChildHealthChecks` and `ChildHealthCheck`
    #   elements.
    #
    #   Note the following:
    #
    #   * If you specify a number greater than the number of child health
    #     checks, Route 53 always considers this health check to be unhealthy.
    #
    #   * If you specify `0`, Route 53 always considers this health check to
    #     be healthy.
    #
    # @option params [Array<String>] :child_health_checks
    #   A complex type that contains one `ChildHealthCheck` element for each
    #   health check that you want to associate with a `CALCULATED` health
    #   check.
    #
    # @option params [Boolean] :enable_sni
    #   Specify whether you want Amazon Route 53 to send the value of
    #   `FullyQualifiedDomainName` to the endpoint in the `client_hello`
    #   message during `TLS` negotiation. This allows the endpoint to respond
    #   to `HTTPS` health check requests with the applicable SSL/TLS
    #   certificate.
    #
    #   Some endpoints require that HTTPS requests include the host name in
    #   the `client_hello` message. If you don't enable SNI, the status of
    #   the health check will be SSL alert `handshake_failure`. A health check
    #   can also have that status for other reasons. If SNI is enabled and
    #   you're still getting the error, check the SSL/TLS configuration on
    #   your endpoint and confirm that your certificate is valid.
    #
    #   The SSL/TLS certificate on your endpoint includes a domain name in the
    #   `Common Name` field and possibly several more in the `Subject
    #   Alternative Names` field. One of the domain names in the certificate
    #   should match the value that you specify for
    #   `FullyQualifiedDomainName`. If the endpoint responds to the
    #   `client_hello` message with a certificate that does not include the
    #   domain name that you specified in `FullyQualifiedDomainName`, a health
    #   checker will retry the handshake. In the second attempt, the health
    #   checker will omit `FullyQualifiedDomainName` from the `client_hello`
    #   message.
    #
    # @option params [Array<String>] :regions
    #   A complex type that contains one `Region` element for each region that
    #   you want Amazon Route 53 health checkers to check the specified
    #   endpoint from.
    #
    # @option params [Types::AlarmIdentifier] :alarm_identifier
    #   A complex type that identifies the CloudWatch alarm that you want
    #   Amazon Route 53 health checkers to use to determine whether the
    #   specified health check is healthy.
    #
    # @option params [String] :insufficient_data_health_status
    #   When CloudWatch has insufficient data about the metric to determine
    #   the alarm state, the status that you want Amazon Route 53 to assign to
    #   the health check:
    #
    #   * `Healthy`: Route 53 considers the health check to be healthy.
    #
    #   * `Unhealthy`: Route 53 considers the health check to be unhealthy.
    #
    #   * `LastKnownStatus`: By default, Route 53 uses the status of the
    #     health check from the last time CloudWatch had sufficient data to
    #     determine the alarm state. For new health checks that have no last
    #     known status, the status for the health check is healthy.
    #
    # @option params [Array<String>] :reset_elements
    #   A complex type that contains one `ResettableElementName` element for
    #   each element that you want to reset to the default value. Valid values
    #   for `ResettableElementName` include the following:
    #
    #   * `ChildHealthChecks`: Amazon Route 53 resets [ChildHealthChecks][1]
    #     to null.
    #
    #   * `FullyQualifiedDomainName`: Route 53 resets
    #     [FullyQualifiedDomainName][2]. to null.
    #
    #   * `Regions`: Route 53 resets the [Regions][3] list to the default set
    #     of regions.
    #
    #   * `ResourcePath`: Route 53 resets [ResourcePath][4] to null.
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_HealthCheckConfig.html#Route53-Type-HealthCheckConfig-ChildHealthChecks
    #   [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_UpdateHealthCheck.html#Route53-UpdateHealthCheck-request-FullyQualifiedDomainName
    #   [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_HealthCheckConfig.html#Route53-Type-HealthCheckConfig-Regions
    #   [4]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_HealthCheckConfig.html#Route53-Type-HealthCheckConfig-ResourcePath
    #
    # @return [Types::UpdateHealthCheckResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::UpdateHealthCheckResponse#health_check #health_check} => Types::HealthCheck
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.update_health_check({
    #     health_check_id: "HealthCheckId", # required
    #     health_check_version: 1,
    #     ip_address: "IPAddress",
    #     port: 1,
    #     resource_path: "ResourcePath",
    #     fully_qualified_domain_name: "FullyQualifiedDomainName",
    #     search_string: "SearchString",
    #     failure_threshold: 1,
    #     inverted: false,
    #     disabled: false,
    #     health_threshold: 1,
    #     child_health_checks: ["HealthCheckId"],
    #     enable_sni: false,
    #     regions: ["us-east-1"], # accepts us-east-1, us-west-1, us-west-2, eu-west-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, sa-east-1
    #     alarm_identifier: {
    #       region: "us-east-1", # required, accepts us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-central-1, eu-central-2, eu-west-1, eu-west-2, eu-west-3, ap-east-1, me-south-1, me-central-1, ap-south-1, ap-south-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-northeast-1, ap-northeast-2, ap-northeast-3, eu-north-1, sa-east-1, cn-northwest-1, cn-north-1, af-south-1, eu-south-1, eu-south-2, us-gov-west-1, us-gov-east-1, us-iso-east-1, us-iso-west-1, us-isob-east-1, ap-southeast-4, il-central-1, ca-west-1, ap-southeast-5, mx-central-1, us-isof-south-1, us-isof-east-1, ap-southeast-7, ap-east-2, eu-isoe-west-1, ap-southeast-6
    #       name: "AlarmName", # required
    #     },
    #     insufficient_data_health_status: "Healthy", # accepts Healthy, Unhealthy, LastKnownStatus
    #     reset_elements: ["FullyQualifiedDomainName"], # accepts FullyQualifiedDomainName, Regions, ResourcePath, ChildHealthChecks
    #   })
    #
    # @example Response structure
    #
    #   resp.health_check.id #=> String
    #   resp.health_check.caller_reference #=> String
    #   resp.health_check.linked_service.service_principal #=> String
    #   resp.health_check.linked_service.description #=> String
    #   resp.health_check.health_check_config.ip_address #=> String
    #   resp.health_check.health_check_config.port #=> Integer
    #   resp.health_check.health_check_config.type #=> String, one of "HTTP", "HTTPS", "HTTP_STR_MATCH", "HTTPS_STR_MATCH", "TCP", "CALCULATED", "CLOUDWATCH_METRIC", "RECOVERY_CONTROL"
    #   resp.health_check.health_check_config.resource_path #=> String
    #   resp.health_check.health_check_config.fully_qualified_domain_name #=> String
    #   resp.health_check.health_check_config.search_string #=> String
    #   resp.health_check.health_check_config.request_interval #=> Integer
    #   resp.health_check.health_check_config.failure_threshold #=> Integer
    #   resp.health_check.health_check_config.measure_latency #=> Boolean
    #   resp.health_check.health_check_config.inverted #=> Boolean
    #   resp.health_check.health_check_config.disabled #=> Boolean
    #   resp.health_check.health_check_config.health_threshold #=> Integer
    #   resp.health_check.health_check_config.child_health_checks #=> Array
    #   resp.health_check.health_check_config.child_health_checks[0] #=> String
    #   resp.health_check.health_check_config.enable_sni #=> Boolean
    #   resp.health_check.health_check_config.regions #=> Array
    #   resp.health_check.health_check_config.regions[0] #=> String, one of "us-east-1", "us-west-1", "us-west-2", "eu-west-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "sa-east-1"
    #   resp.health_check.health_check_config.alarm_identifier.region #=> String, one of "us-east-1", "us-east-2", "us-west-1", "us-west-2", "ca-central-1", "eu-central-1", "eu-central-2", "eu-west-1", "eu-west-2", "eu-west-3", "ap-east-1", "me-south-1", "me-central-1", "ap-south-1", "ap-south-2", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "eu-north-1", "sa-east-1", "cn-northwest-1", "cn-north-1", "af-south-1", "eu-south-1", "eu-south-2", "us-gov-west-1", "us-gov-east-1", "us-iso-east-1", "us-iso-west-1", "us-isob-east-1", "ap-southeast-4", "il-central-1", "ca-west-1", "ap-southeast-5", "mx-central-1", "us-isof-south-1", "us-isof-east-1", "ap-southeast-7", "ap-east-2", "eu-isoe-west-1", "ap-southeast-6"
    #   resp.health_check.health_check_config.alarm_identifier.name #=> String
    #   resp.health_check.health_check_config.insufficient_data_health_status #=> String, one of "Healthy", "Unhealthy", "LastKnownStatus"
    #   resp.health_check.health_check_config.routing_control_arn #=> String
    #   resp.health_check.health_check_version #=> Integer
    #   resp.health_check.cloud_watch_alarm_configuration.evaluation_periods #=> Integer
    #   resp.health_check.cloud_watch_alarm_configuration.threshold #=> Float
    #   resp.health_check.cloud_watch_alarm_configuration.comparison_operator #=> String, one of "GreaterThanOrEqualToThreshold", "GreaterThanThreshold", "LessThanThreshold", "LessThanOrEqualToThreshold"
    #   resp.health_check.cloud_watch_alarm_configuration.period #=> Integer
    #   resp.health_check.cloud_watch_alarm_configuration.metric_name #=> String
    #   resp.health_check.cloud_watch_alarm_configuration.namespace #=> String
    #   resp.health_check.cloud_watch_alarm_configuration.statistic #=> String, one of "Average", "Sum", "SampleCount", "Maximum", "Minimum"
    #   resp.health_check.cloud_watch_alarm_configuration.dimensions #=> Array
    #   resp.health_check.cloud_watch_alarm_configuration.dimensions[0].name #=> String
    #   resp.health_check.cloud_watch_alarm_configuration.dimensions[0].value #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateHealthCheck AWS API Documentation
    #
    # @overload update_health_check(params = {})
    # @param [Hash] params ({})
    def update_health_check(params = {}, options = {})
      req = build_request(:update_health_check, params)
      req.send_request(options)
    end

    # Updates the comment for a specified hosted zone.
    #
    # @option params [required, String] :id
    #   The ID for the hosted zone that you want to update the comment for.
    #
    # @option params [String] :comment
    #   The new comment for the hosted zone. If you don't specify a value for
    #   `Comment`, Amazon Route 53 deletes the existing value of the `Comment`
    #   element, if any.
    #
    # @return [Types::UpdateHostedZoneCommentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::UpdateHostedZoneCommentResponse#hosted_zone #hosted_zone} => Types::HostedZone
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.update_hosted_zone_comment({
    #     id: "ResourceId", # required
    #     comment: "ResourceDescription",
    #   })
    #
    # @example Response structure
    #
    #   resp.hosted_zone.id #=> String
    #   resp.hosted_zone.name #=> String
    #   resp.hosted_zone.caller_reference #=> String
    #   resp.hosted_zone.config.comment #=> String
    #   resp.hosted_zone.config.private_zone #=> Boolean
    #   resp.hosted_zone.resource_record_set_count #=> Integer
    #   resp.hosted_zone.linked_service.service_principal #=> String
    #   resp.hosted_zone.linked_service.description #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateHostedZoneComment AWS API Documentation
    #
    # @overload update_hosted_zone_comment(params = {})
    # @param [Hash] params ({})
    def update_hosted_zone_comment(params = {}, options = {})
      req = build_request(:update_hosted_zone_comment, params)
      req.send_request(options)
    end

    # Updates the comment for a specified traffic policy version.
    #
    # @option params [required, String] :id
    #   The value of `Id` for the traffic policy that you want to update the
    #   comment for.
    #
    # @option params [required, Integer] :version
    #   The value of `Version` for the traffic policy that you want to update
    #   the comment for.
    #
    # @option params [required, String] :comment
    #   The new comment for the specified traffic policy and version.
    #
    # @return [Types::UpdateTrafficPolicyCommentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::UpdateTrafficPolicyCommentResponse#traffic_policy #traffic_policy} => Types::TrafficPolicy
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.update_traffic_policy_comment({
    #     id: "TrafficPolicyId", # required
    #     version: 1, # required
    #     comment: "TrafficPolicyComment", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy.id #=> String
    #   resp.traffic_policy.version #=> Integer
    #   resp.traffic_policy.name #=> String
    #   resp.traffic_policy.type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #   resp.traffic_policy.document #=> String
    #   resp.traffic_policy.comment #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateTrafficPolicyComment AWS API Documentation
    #
    # @overload update_traffic_policy_comment(params = {})
    # @param [Hash] params ({})
    def update_traffic_policy_comment(params = {}, options = {})
      req = build_request(:update_traffic_policy_comment, params)
      req.send_request(options)
    end

    # <note markdown="1"> After you submit a `UpdateTrafficPolicyInstance` request, there's a
    # brief delay while Route 53 creates the resource record sets that are
    # specified in the traffic policy definition. Use
    # `GetTrafficPolicyInstance` with the `id` of updated traffic policy
    # instance confirm that the `UpdateTrafficPolicyInstance` request
    # completed successfully. For more information, see the `State` response
    # element.
    #
    #  </note>
    #
    # Updates the resource record sets in a specified hosted zone that were
    # created based on the settings in a specified traffic policy version.
    #
    # When you update a traffic policy instance, Amazon Route 53 continues
    # to respond to DNS queries for the root resource record set name (such
    # as example.com) while it replaces one group of resource record sets
    # with another. Route 53 performs the following operations:
    #
    # 1.  Route 53 creates a new group of resource record sets based on the
    #     specified traffic policy. This is true regardless of how
    #     significant the differences are between the existing resource
    #     record sets and the new resource record sets.
    #
    # 2.  When all of the new resource record sets have been created, Route
    #     53 starts to respond to DNS queries for the root resource record
    #     set name (such as example.com) by using the new resource record
    #     sets.
    #
    # 3.  Route 53 deletes the old group of resource record sets that are
    #     associated with the root resource record set name.
    #
    # @option params [required, String] :id
    #   The ID of the traffic policy instance that you want to update.
    #
    # @option params [required, Integer] :ttl
    #   The TTL that you want Amazon Route 53 to assign to all of the updated
    #   resource record sets.
    #
    # @option params [required, String] :traffic_policy_id
    #   The ID of the traffic policy that you want Amazon Route 53 to use to
    #   update resource record sets for the specified traffic policy instance.
    #
    # @option params [required, Integer] :traffic_policy_version
    #   The version of the traffic policy that you want Amazon Route 53 to use
    #   to update resource record sets for the specified traffic policy
    #   instance.
    #
    # @return [Types::UpdateTrafficPolicyInstanceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::UpdateTrafficPolicyInstanceResponse#traffic_policy_instance #traffic_policy_instance} => Types::TrafficPolicyInstance
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.update_traffic_policy_instance({
    #     id: "TrafficPolicyInstanceId", # required
    #     ttl: 1, # required
    #     traffic_policy_id: "TrafficPolicyId", # required
    #     traffic_policy_version: 1, # required
    #   })
    #
    # @example Response structure
    #
    #   resp.traffic_policy_instance.id #=> String
    #   resp.traffic_policy_instance.hosted_zone_id #=> String
    #   resp.traffic_policy_instance.name #=> String
    #   resp.traffic_policy_instance.ttl #=> Integer
    #   resp.traffic_policy_instance.state #=> String
    #   resp.traffic_policy_instance.message #=> String
    #   resp.traffic_policy_instance.traffic_policy_id #=> String
    #   resp.traffic_policy_instance.traffic_policy_version #=> Integer
    #   resp.traffic_policy_instance.traffic_policy_type #=> String, one of "SOA", "A", "TXT", "NS", "CNAME", "MX", "NAPTR", "PTR", "SRV", "SPF", "AAAA", "CAA", "DS", "TLSA", "SSHFP", "SVCB", "HTTPS"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/UpdateTrafficPolicyInstance AWS API Documentation
    #
    # @overload update_traffic_policy_instance(params = {})
    # @param [Hash] params ({})
    def update_traffic_policy_instance(params = {}, options = {})
      req = build_request(:update_traffic_policy_instance, params)
      req.send_request(options)
    end

    # @!endgroup

    # @param params ({})
    # @api private
    def build_request(operation_name, params = {})
      handlers = @handlers.for(operation_name)
      tracer = config.telemetry_provider.tracer_provider.tracer(
        Aws::Telemetry.module_to_tracer_name('Aws::Route53')
      )
      context = Seahorse::Client::RequestContext.new(
        operation_name: operation_name,
        operation: config.api.operation(operation_name),
        client: self,
        params: params,
        config: config,
        tracer: tracer
      )
      context[:gem_name] = 'aws-sdk-route53'
      context[:gem_version] = '1.122.0'
      Seahorse::Client::Request.new(handlers, context)
    end

    # Polls an API operation until a resource enters a desired state.
    #
    # ## Basic Usage
    #
    # A waiter will call an API operation until:
    #
    # * It is successful
    # * It enters a terminal state
    # * It makes the maximum number of attempts
    #
    # In between attempts, the waiter will sleep.
    #
    #     # polls in a loop, sleeping between attempts
    #     client.wait_until(waiter_name, params)
    #
    # ## Configuration
    #
    # You can configure the maximum number of polling attempts, and the
    # delay (in seconds) between each polling attempt. You can pass
    # configuration as the final arguments hash.
    #
    #     # poll for ~25 seconds
    #     client.wait_until(waiter_name, params, {
    #       max_attempts: 5,
    #       delay: 5,
    #     })
    #
    # ## Callbacks
    #
    # You can be notified before each polling attempt and before each
    # delay. If you throw `:success` or `:failure` from these callbacks,
    # it will terminate the waiter.
    #
    #     started_at = Time.now
    #     client.wait_until(waiter_name, params, {
    #
    #       # disable max attempts
    #       max_attempts: nil,
    #
    #       # poll for 1 hour, instead of a number of attempts
    #       before_wait: -> (attempts, response) do
    #         throw :failure if Time.now - started_at > 3600
    #       end
    #     })
    #
    # ## Handling Errors
    #
    # When a waiter is unsuccessful, it will raise an error.
    # All of the failure errors extend from
    # {Aws::Waiters::Errors::WaiterFailed}.
    #
    #     begin
    #       client.wait_until(...)
    #     rescue Aws::Waiters::Errors::WaiterFailed
    #       # resource did not enter the desired state in time
    #     end
    #
    # ## Valid Waiters
    #
    # The following table lists the valid waiter names, the operations they call,
    # and the default `:delay` and `:max_attempts` values.
    #
    # | waiter_name                  | params              | :delay   | :max_attempts |
    # | ---------------------------- | ------------------- | -------- | ------------- |
    # | resource_record_sets_changed | {Client#get_change} | 30       | 60            |
    #
    # @raise [Errors::FailureStateError] Raised when the waiter terminates
    #   because the waiter has entered a state that it will not transition
    #   out of, preventing success.
    #
    # @raise [Errors::TooManyAttemptsError] Raised when the configured
    #   maximum number of attempts have been made, and the waiter is not
    #   yet successful.
    #
    # @raise [Errors::UnexpectedError] Raised when an error is encounted
    #   while polling for a resource that is not expected.
    #
    # @raise [Errors::NoSuchWaiterError] Raised when you request to wait
    #   for an unknown state.
    #
    # @return [Boolean] Returns `true` if the waiter was successful.
    # @param [Symbol] waiter_name
    # @param [Hash] params ({})
    # @param [Hash] options ({})
    # @option options [Integer] :max_attempts
    # @option options [Integer] :delay
    # @option options [Proc] :before_attempt
    # @option options [Proc] :before_wait
    def wait_until(waiter_name, params = {}, options = {})
      w = waiter(waiter_name, options)
      yield(w.waiter) if block_given? # deprecated
      w.wait(params)
    end

    # @api private
    # @deprecated
    def waiter_names
      waiters.keys
    end

    private

    # @param [Symbol] waiter_name
    # @param [Hash] options ({})
    def waiter(waiter_name, options = {})
      waiter_class = waiters[waiter_name]
      if waiter_class
        waiter_class.new(options.merge(client: self))
      else
        raise Aws::Waiters::Errors::NoSuchWaiterError.new(waiter_name, waiters.keys)
      end
    end

    def waiters
      {
        resource_record_sets_changed: Waiters::ResourceRecordSetsChanged
      }
    end

    class << self

      # @api private
      attr_reader :identifier

      # @api private
      def errors_module
        Errors
      end

    end
  end
end
