# 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/json_rpc'

module Aws::DirectConnect
  # An API client for DirectConnect.  To construct a client, you need to configure a `:region` and `:credentials`.
  #
  #     client = Aws::DirectConnect::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 = :directconnect

    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::JsonRpc)
    add_plugin(Aws::DirectConnect::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] :simple_json (false)
    #     Disables request parameter conversion, validation, and formatting.
    #     Also disables response data type conversions. The request parameters
    #     hash must be formatted exactly as the API expects.This option is useful
    #     when you want to ensure the highest level of performance by avoiding
    #     overhead of walking request parameters and response data structures.
    #
    #   @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::DirectConnect::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::DirectConnect::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

    # Accepts a proposal request to attach a virtual private gateway or
    # transit gateway to a Direct Connect gateway.
    #
    # @option params [required, String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @option params [required, String] :proposal_id
    #   The ID of the request proposal.
    #
    # @option params [required, String] :associated_gateway_owner_account
    #   The ID of the Amazon Web Services account that owns the virtual
    #   private gateway or transit gateway.
    #
    # @option params [Array<Types::RouteFilterPrefix>] :override_allowed_prefixes_to_direct_connect_gateway
    #   Overrides the Amazon VPC prefixes advertised to the Direct Connect
    #   gateway.
    #
    #   For information about how to set the prefixes, see [Allowed
    #   Prefixes][1] in the *Direct Connect User Guide*.
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/directconnect/latest/UserGuide/multi-account-associate-vgw.html#allowed-prefixes
    #
    # @return [Types::AcceptDirectConnectGatewayAssociationProposalResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::AcceptDirectConnectGatewayAssociationProposalResult#direct_connect_gateway_association #direct_connect_gateway_association} => Types::DirectConnectGatewayAssociation
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.accept_direct_connect_gateway_association_proposal({
    #     direct_connect_gateway_id: "DirectConnectGatewayId", # required
    #     proposal_id: "DirectConnectGatewayAssociationProposalId", # required
    #     associated_gateway_owner_account: "OwnerAccount", # required
    #     override_allowed_prefixes_to_direct_connect_gateway: [
    #       {
    #         cidr: "CIDR",
    #       },
    #     ],
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway_association.direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway_association.direct_connect_gateway_owner_account #=> String
    #   resp.direct_connect_gateway_association.association_state #=> String, one of "associating", "associated", "disassociating", "disassociated", "updating"
    #   resp.direct_connect_gateway_association.state_change_error #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.id #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.type #=> String, one of "virtualPrivateGateway", "transitGateway"
    #   resp.direct_connect_gateway_association.associated_gateway.owner_account #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.region #=> String
    #   resp.direct_connect_gateway_association.association_id #=> String
    #   resp.direct_connect_gateway_association.allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_association.allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.id #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.owner_account #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.attachment_id #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_region #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_owner_account #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AcceptDirectConnectGatewayAssociationProposal AWS API Documentation
    #
    # @overload accept_direct_connect_gateway_association_proposal(params = {})
    # @param [Hash] params ({})
    def accept_direct_connect_gateway_association_proposal(params = {}, options = {})
      req = build_request(:accept_direct_connect_gateway_association_proposal, params)
      req.send_request(options)
    end

    # <note markdown="1"> Deprecated. Use AllocateHostedConnection instead.
    #
    #  </note>
    #
    # Creates a hosted connection on an interconnect.
    #
    # Allocates a VLAN number and a specified amount of bandwidth for use by
    # a hosted connection on the specified interconnect.
    #
    # <note markdown="1"> Intended for use by Direct Connect Partners only.
    #
    #  </note>
    #
    # @option params [required, String] :bandwidth
    #   The bandwidth of the connection. The possible values are 50Mbps,
    #   100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps, and
    #   10Gbps. Note that only those Direct Connect Partners who have met
    #   specific requirements are allowed to create a 1Gbps, 2Gbps, 5Gbps or
    #   10Gbps hosted connection.
    #
    # @option params [required, String] :connection_name
    #   The name of the provisioned connection.
    #
    # @option params [required, String] :owner_account
    #   The ID of the Amazon Web Services account of the customer for whom the
    #   connection will be provisioned.
    #
    # @option params [required, String] :interconnect_id
    #   The ID of the interconnect on which the connection will be
    #   provisioned.
    #
    # @option params [required, Integer] :vlan
    #   The dedicated VLAN provisioned to the connection.
    #
    # @return [Types::Connection] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connection#owner_account #owner_account} => String
    #   * {Types::Connection#connection_id #connection_id} => String
    #   * {Types::Connection#connection_name #connection_name} => String
    #   * {Types::Connection#connection_state #connection_state} => String
    #   * {Types::Connection#region #region} => String
    #   * {Types::Connection#location #location} => String
    #   * {Types::Connection#bandwidth #bandwidth} => String
    #   * {Types::Connection#vlan #vlan} => Integer
    #   * {Types::Connection#partner_name #partner_name} => String
    #   * {Types::Connection#loa_issue_time #loa_issue_time} => Time
    #   * {Types::Connection#lag_id #lag_id} => String
    #   * {Types::Connection#aws_device #aws_device} => String
    #   * {Types::Connection#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Connection#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Connection#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Connection#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Connection#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Connection#provider_name #provider_name} => String
    #   * {Types::Connection#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Connection#port_encryption_status #port_encryption_status} => String
    #   * {Types::Connection#encryption_mode #encryption_mode} => String
    #   * {Types::Connection#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #   * {Types::Connection#partner_interconnect_mac_sec_capable #partner_interconnect_mac_sec_capable} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.allocate_connection_on_interconnect({
    #     bandwidth: "Bandwidth", # required
    #     connection_name: "ConnectionName", # required
    #     owner_account: "OwnerAccount", # required
    #     interconnect_id: "InterconnectId", # required
    #     vlan: 1, # required
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.connection_id #=> String
    #   resp.connection_name #=> String
    #   resp.connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.region #=> String
    #   resp.location #=> String
    #   resp.bandwidth #=> String
    #   resp.vlan #=> Integer
    #   resp.partner_name #=> String
    #   resp.loa_issue_time #=> Time
    #   resp.lag_id #=> String
    #   resp.aws_device #=> String
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.port_encryption_status #=> String
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #   resp.partner_interconnect_mac_sec_capable #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AllocateConnectionOnInterconnect AWS API Documentation
    #
    # @overload allocate_connection_on_interconnect(params = {})
    # @param [Hash] params ({})
    def allocate_connection_on_interconnect(params = {}, options = {})
      req = build_request(:allocate_connection_on_interconnect, params)
      req.send_request(options)
    end

    # Creates a hosted connection on the specified interconnect or a link
    # aggregation group (LAG) of interconnects.
    #
    # Allocates a VLAN number and a specified amount of capacity (bandwidth)
    # for use by a hosted connection on the specified interconnect or LAG of
    # interconnects. Amazon Web Services polices the hosted connection for
    # the specified capacity and the Direct Connect Partner must also police
    # the hosted connection for the specified capacity.
    #
    # <note markdown="1"> Intended for use by Direct Connect Partners only.
    #
    #  </note>
    #
    # @option params [required, String] :connection_id
    #   The ID of the interconnect or LAG.
    #
    # @option params [required, String] :owner_account
    #   The ID of the Amazon Web Services account ID of the customer for the
    #   connection.
    #
    # @option params [required, String] :bandwidth
    #   The bandwidth of the connection. The possible values are 50Mbps,
    #   100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps,
    #   10Gbps, and 25Gbps. Note that only those Direct Connect Partners who
    #   have met specific requirements are allowed to create a 1Gbps, 2Gbps,
    #   5Gbps, 10Gbps, or 25Gbps hosted connection.
    #
    # @option params [required, String] :connection_name
    #   The name of the hosted connection.
    #
    # @option params [required, Integer] :vlan
    #   The dedicated VLAN provisioned to the hosted connection.
    #
    # @option params [Array<Types::Tag>] :tags
    #   The tags associated with the connection.
    #
    # @return [Types::Connection] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connection#owner_account #owner_account} => String
    #   * {Types::Connection#connection_id #connection_id} => String
    #   * {Types::Connection#connection_name #connection_name} => String
    #   * {Types::Connection#connection_state #connection_state} => String
    #   * {Types::Connection#region #region} => String
    #   * {Types::Connection#location #location} => String
    #   * {Types::Connection#bandwidth #bandwidth} => String
    #   * {Types::Connection#vlan #vlan} => Integer
    #   * {Types::Connection#partner_name #partner_name} => String
    #   * {Types::Connection#loa_issue_time #loa_issue_time} => Time
    #   * {Types::Connection#lag_id #lag_id} => String
    #   * {Types::Connection#aws_device #aws_device} => String
    #   * {Types::Connection#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Connection#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Connection#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Connection#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Connection#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Connection#provider_name #provider_name} => String
    #   * {Types::Connection#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Connection#port_encryption_status #port_encryption_status} => String
    #   * {Types::Connection#encryption_mode #encryption_mode} => String
    #   * {Types::Connection#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #   * {Types::Connection#partner_interconnect_mac_sec_capable #partner_interconnect_mac_sec_capable} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.allocate_hosted_connection({
    #     connection_id: "ConnectionId", # required
    #     owner_account: "OwnerAccount", # required
    #     bandwidth: "Bandwidth", # required
    #     connection_name: "ConnectionName", # required
    #     vlan: 1, # required
    #     tags: [
    #       {
    #         key: "TagKey", # required
    #         value: "TagValue",
    #       },
    #     ],
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.connection_id #=> String
    #   resp.connection_name #=> String
    #   resp.connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.region #=> String
    #   resp.location #=> String
    #   resp.bandwidth #=> String
    #   resp.vlan #=> Integer
    #   resp.partner_name #=> String
    #   resp.loa_issue_time #=> Time
    #   resp.lag_id #=> String
    #   resp.aws_device #=> String
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.port_encryption_status #=> String
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #   resp.partner_interconnect_mac_sec_capable #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AllocateHostedConnection AWS API Documentation
    #
    # @overload allocate_hosted_connection(params = {})
    # @param [Hash] params ({})
    def allocate_hosted_connection(params = {}, options = {})
      req = build_request(:allocate_hosted_connection, params)
      req.send_request(options)
    end

    # Provisions a private virtual interface to be owned by the specified
    # Amazon Web Services account.
    #
    # Virtual interfaces created using this action must be confirmed by the
    # owner using ConfirmPrivateVirtualInterface. Until then, the virtual
    # interface is in the `Confirming` state and is not available to handle
    # traffic.
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection on which the private virtual interface is
    #   provisioned.
    #
    # @option params [required, String] :owner_account
    #   The ID of the Amazon Web Services account that owns the virtual
    #   private interface.
    #
    # @option params [required, Types::NewPrivateVirtualInterfaceAllocation] :new_private_virtual_interface_allocation
    #   Information about the private virtual interface.
    #
    # @return [Types::VirtualInterface] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::VirtualInterface#owner_account #owner_account} => String
    #   * {Types::VirtualInterface#virtual_interface_id #virtual_interface_id} => String
    #   * {Types::VirtualInterface#location #location} => String
    #   * {Types::VirtualInterface#connection_id #connection_id} => String
    #   * {Types::VirtualInterface#virtual_interface_type #virtual_interface_type} => String
    #   * {Types::VirtualInterface#virtual_interface_name #virtual_interface_name} => String
    #   * {Types::VirtualInterface#vlan #vlan} => Integer
    #   * {Types::VirtualInterface#asn #asn} => Integer
    #   * {Types::VirtualInterface#asn_long #asn_long} => Integer
    #   * {Types::VirtualInterface#amazon_side_asn #amazon_side_asn} => Integer
    #   * {Types::VirtualInterface#auth_key #auth_key} => String
    #   * {Types::VirtualInterface#amazon_address #amazon_address} => String
    #   * {Types::VirtualInterface#customer_address #customer_address} => String
    #   * {Types::VirtualInterface#address_family #address_family} => String
    #   * {Types::VirtualInterface#virtual_interface_state #virtual_interface_state} => String
    #   * {Types::VirtualInterface#customer_router_config #customer_router_config} => String
    #   * {Types::VirtualInterface#mtu #mtu} => Integer
    #   * {Types::VirtualInterface#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::VirtualInterface#virtual_gateway_id #virtual_gateway_id} => String
    #   * {Types::VirtualInterface#direct_connect_gateway_id #direct_connect_gateway_id} => String
    #   * {Types::VirtualInterface#route_filter_prefixes #route_filter_prefixes} => Array&lt;Types::RouteFilterPrefix&gt;
    #   * {Types::VirtualInterface#bgp_peers #bgp_peers} => Array&lt;Types::BGPPeer&gt;
    #   * {Types::VirtualInterface#region #region} => String
    #   * {Types::VirtualInterface#aws_device_v2 #aws_device_v2} => String
    #   * {Types::VirtualInterface#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::VirtualInterface#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::VirtualInterface#site_link_enabled #site_link_enabled} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.allocate_private_virtual_interface({
    #     connection_id: "ConnectionId", # required
    #     owner_account: "OwnerAccount", # required
    #     new_private_virtual_interface_allocation: { # required
    #       virtual_interface_name: "VirtualInterfaceName", # required
    #       vlan: 1, # required
    #       asn: 1,
    #       asn_long: 1,
    #       mtu: 1,
    #       auth_key: "BGPAuthKey",
    #       amazon_address: "AmazonAddress",
    #       address_family: "ipv4", # accepts ipv4, ipv6
    #       customer_address: "CustomerAddress",
    #       tags: [
    #         {
    #           key: "TagKey", # required
    #           value: "TagValue",
    #         },
    #       ],
    #     },
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.virtual_interface_id #=> String
    #   resp.location #=> String
    #   resp.connection_id #=> String
    #   resp.virtual_interface_type #=> String
    #   resp.virtual_interface_name #=> String
    #   resp.vlan #=> Integer
    #   resp.asn #=> Integer
    #   resp.asn_long #=> Integer
    #   resp.amazon_side_asn #=> Integer
    #   resp.auth_key #=> String
    #   resp.amazon_address #=> String
    #   resp.customer_address #=> String
    #   resp.address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.customer_router_config #=> String
    #   resp.mtu #=> Integer
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_id #=> String
    #   resp.route_filter_prefixes #=> Array
    #   resp.route_filter_prefixes[0].cidr #=> String
    #   resp.bgp_peers #=> Array
    #   resp.bgp_peers[0].bgp_peer_id #=> String
    #   resp.bgp_peers[0].asn #=> Integer
    #   resp.bgp_peers[0].asn_long #=> Integer
    #   resp.bgp_peers[0].auth_key #=> String
    #   resp.bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.bgp_peers[0].amazon_address #=> String
    #   resp.bgp_peers[0].customer_address #=> String
    #   resp.bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.bgp_peers[0].aws_device_v2 #=> String
    #   resp.bgp_peers[0].aws_logical_device_id #=> String
    #   resp.region #=> String
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.site_link_enabled #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AllocatePrivateVirtualInterface AWS API Documentation
    #
    # @overload allocate_private_virtual_interface(params = {})
    # @param [Hash] params ({})
    def allocate_private_virtual_interface(params = {}, options = {})
      req = build_request(:allocate_private_virtual_interface, params)
      req.send_request(options)
    end

    # Provisions a public virtual interface to be owned by the specified
    # Amazon Web Services account.
    #
    # The owner of a connection calls this function to provision a public
    # virtual interface to be owned by the specified Amazon Web Services
    # account.
    #
    # Virtual interfaces created using this function must be confirmed by
    # the owner using ConfirmPublicVirtualInterface. Until this step has
    # been completed, the virtual interface is in the `confirming` state and
    # is not available to handle traffic.
    #
    # When creating an IPv6 public virtual interface, omit the Amazon
    # address and customer address. IPv6 addresses are automatically
    # assigned from the Amazon pool of IPv6 addresses; you cannot specify
    # custom IPv6 addresses.
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection on which the public virtual interface is
    #   provisioned.
    #
    # @option params [required, String] :owner_account
    #   The ID of the Amazon Web Services account that owns the public virtual
    #   interface.
    #
    # @option params [required, Types::NewPublicVirtualInterfaceAllocation] :new_public_virtual_interface_allocation
    #   Information about the public virtual interface.
    #
    # @return [Types::VirtualInterface] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::VirtualInterface#owner_account #owner_account} => String
    #   * {Types::VirtualInterface#virtual_interface_id #virtual_interface_id} => String
    #   * {Types::VirtualInterface#location #location} => String
    #   * {Types::VirtualInterface#connection_id #connection_id} => String
    #   * {Types::VirtualInterface#virtual_interface_type #virtual_interface_type} => String
    #   * {Types::VirtualInterface#virtual_interface_name #virtual_interface_name} => String
    #   * {Types::VirtualInterface#vlan #vlan} => Integer
    #   * {Types::VirtualInterface#asn #asn} => Integer
    #   * {Types::VirtualInterface#asn_long #asn_long} => Integer
    #   * {Types::VirtualInterface#amazon_side_asn #amazon_side_asn} => Integer
    #   * {Types::VirtualInterface#auth_key #auth_key} => String
    #   * {Types::VirtualInterface#amazon_address #amazon_address} => String
    #   * {Types::VirtualInterface#customer_address #customer_address} => String
    #   * {Types::VirtualInterface#address_family #address_family} => String
    #   * {Types::VirtualInterface#virtual_interface_state #virtual_interface_state} => String
    #   * {Types::VirtualInterface#customer_router_config #customer_router_config} => String
    #   * {Types::VirtualInterface#mtu #mtu} => Integer
    #   * {Types::VirtualInterface#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::VirtualInterface#virtual_gateway_id #virtual_gateway_id} => String
    #   * {Types::VirtualInterface#direct_connect_gateway_id #direct_connect_gateway_id} => String
    #   * {Types::VirtualInterface#route_filter_prefixes #route_filter_prefixes} => Array&lt;Types::RouteFilterPrefix&gt;
    #   * {Types::VirtualInterface#bgp_peers #bgp_peers} => Array&lt;Types::BGPPeer&gt;
    #   * {Types::VirtualInterface#region #region} => String
    #   * {Types::VirtualInterface#aws_device_v2 #aws_device_v2} => String
    #   * {Types::VirtualInterface#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::VirtualInterface#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::VirtualInterface#site_link_enabled #site_link_enabled} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.allocate_public_virtual_interface({
    #     connection_id: "ConnectionId", # required
    #     owner_account: "OwnerAccount", # required
    #     new_public_virtual_interface_allocation: { # required
    #       virtual_interface_name: "VirtualInterfaceName", # required
    #       vlan: 1, # required
    #       asn: 1,
    #       asn_long: 1,
    #       auth_key: "BGPAuthKey",
    #       amazon_address: "AmazonAddress",
    #       customer_address: "CustomerAddress",
    #       address_family: "ipv4", # accepts ipv4, ipv6
    #       route_filter_prefixes: [
    #         {
    #           cidr: "CIDR",
    #         },
    #       ],
    #       tags: [
    #         {
    #           key: "TagKey", # required
    #           value: "TagValue",
    #         },
    #       ],
    #     },
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.virtual_interface_id #=> String
    #   resp.location #=> String
    #   resp.connection_id #=> String
    #   resp.virtual_interface_type #=> String
    #   resp.virtual_interface_name #=> String
    #   resp.vlan #=> Integer
    #   resp.asn #=> Integer
    #   resp.asn_long #=> Integer
    #   resp.amazon_side_asn #=> Integer
    #   resp.auth_key #=> String
    #   resp.amazon_address #=> String
    #   resp.customer_address #=> String
    #   resp.address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.customer_router_config #=> String
    #   resp.mtu #=> Integer
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_id #=> String
    #   resp.route_filter_prefixes #=> Array
    #   resp.route_filter_prefixes[0].cidr #=> String
    #   resp.bgp_peers #=> Array
    #   resp.bgp_peers[0].bgp_peer_id #=> String
    #   resp.bgp_peers[0].asn #=> Integer
    #   resp.bgp_peers[0].asn_long #=> Integer
    #   resp.bgp_peers[0].auth_key #=> String
    #   resp.bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.bgp_peers[0].amazon_address #=> String
    #   resp.bgp_peers[0].customer_address #=> String
    #   resp.bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.bgp_peers[0].aws_device_v2 #=> String
    #   resp.bgp_peers[0].aws_logical_device_id #=> String
    #   resp.region #=> String
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.site_link_enabled #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AllocatePublicVirtualInterface AWS API Documentation
    #
    # @overload allocate_public_virtual_interface(params = {})
    # @param [Hash] params ({})
    def allocate_public_virtual_interface(params = {}, options = {})
      req = build_request(:allocate_public_virtual_interface, params)
      req.send_request(options)
    end

    # Provisions a transit virtual interface to be owned by the specified
    # Amazon Web Services account. Use this type of interface to connect a
    # transit gateway to your Direct Connect gateway.
    #
    # The owner of a connection provisions a transit virtual interface to be
    # owned by the specified Amazon Web Services account.
    #
    # After you create a transit virtual interface, it must be confirmed by
    # the owner using ConfirmTransitVirtualInterface. Until this step has
    # been completed, the transit virtual interface is in the `requested`
    # state and is not available to handle traffic.
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection on which the transit virtual interface is
    #   provisioned.
    #
    # @option params [required, String] :owner_account
    #   The ID of the Amazon Web Services account that owns the transit
    #   virtual interface.
    #
    # @option params [required, Types::NewTransitVirtualInterfaceAllocation] :new_transit_virtual_interface_allocation
    #   Information about the transit virtual interface.
    #
    # @return [Types::AllocateTransitVirtualInterfaceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::AllocateTransitVirtualInterfaceResult#virtual_interface #virtual_interface} => Types::VirtualInterface
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.allocate_transit_virtual_interface({
    #     connection_id: "ConnectionId", # required
    #     owner_account: "OwnerAccount", # required
    #     new_transit_virtual_interface_allocation: { # required
    #       virtual_interface_name: "VirtualInterfaceName",
    #       vlan: 1,
    #       asn: 1,
    #       asn_long: 1,
    #       mtu: 1,
    #       auth_key: "BGPAuthKey",
    #       amazon_address: "AmazonAddress",
    #       customer_address: "CustomerAddress",
    #       address_family: "ipv4", # accepts ipv4, ipv6
    #       tags: [
    #         {
    #           key: "TagKey", # required
    #           value: "TagValue",
    #         },
    #       ],
    #     },
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface.owner_account #=> String
    #   resp.virtual_interface.virtual_interface_id #=> String
    #   resp.virtual_interface.location #=> String
    #   resp.virtual_interface.connection_id #=> String
    #   resp.virtual_interface.virtual_interface_type #=> String
    #   resp.virtual_interface.virtual_interface_name #=> String
    #   resp.virtual_interface.vlan #=> Integer
    #   resp.virtual_interface.asn #=> Integer
    #   resp.virtual_interface.asn_long #=> Integer
    #   resp.virtual_interface.amazon_side_asn #=> Integer
    #   resp.virtual_interface.auth_key #=> String
    #   resp.virtual_interface.amazon_address #=> String
    #   resp.virtual_interface.customer_address #=> String
    #   resp.virtual_interface.address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.virtual_interface.customer_router_config #=> String
    #   resp.virtual_interface.mtu #=> Integer
    #   resp.virtual_interface.jumbo_frame_capable #=> Boolean
    #   resp.virtual_interface.virtual_gateway_id #=> String
    #   resp.virtual_interface.direct_connect_gateway_id #=> String
    #   resp.virtual_interface.route_filter_prefixes #=> Array
    #   resp.virtual_interface.route_filter_prefixes[0].cidr #=> String
    #   resp.virtual_interface.bgp_peers #=> Array
    #   resp.virtual_interface.bgp_peers[0].bgp_peer_id #=> String
    #   resp.virtual_interface.bgp_peers[0].asn #=> Integer
    #   resp.virtual_interface.bgp_peers[0].asn_long #=> Integer
    #   resp.virtual_interface.bgp_peers[0].auth_key #=> String
    #   resp.virtual_interface.bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface.bgp_peers[0].amazon_address #=> String
    #   resp.virtual_interface.bgp_peers[0].customer_address #=> String
    #   resp.virtual_interface.bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.virtual_interface.bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.virtual_interface.bgp_peers[0].aws_device_v2 #=> String
    #   resp.virtual_interface.bgp_peers[0].aws_logical_device_id #=> String
    #   resp.virtual_interface.region #=> String
    #   resp.virtual_interface.aws_device_v2 #=> String
    #   resp.virtual_interface.aws_logical_device_id #=> String
    #   resp.virtual_interface.tags #=> Array
    #   resp.virtual_interface.tags[0].key #=> String
    #   resp.virtual_interface.tags[0].value #=> String
    #   resp.virtual_interface.site_link_enabled #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AllocateTransitVirtualInterface AWS API Documentation
    #
    # @overload allocate_transit_virtual_interface(params = {})
    # @param [Hash] params ({})
    def allocate_transit_virtual_interface(params = {}, options = {})
      req = build_request(:allocate_transit_virtual_interface, params)
      req.send_request(options)
    end

    # Associates an existing connection with a link aggregation group (LAG).
    # The connection is interrupted and re-established as a member of the
    # LAG (connectivity to Amazon Web Services is interrupted). The
    # connection must be hosted on the same Direct Connect endpoint as the
    # LAG, and its bandwidth must match the bandwidth for the LAG. You can
    # re-associate a connection that's currently associated with a
    # different LAG; however, if removing the connection would cause the
    # original LAG to fall below its setting for minimum number of
    # operational connections, the request fails.
    #
    # Any virtual interfaces that are directly associated with the
    # connection are automatically re-associated with the LAG. If the
    # connection was originally associated with a different LAG, the virtual
    # interfaces remain associated with the original LAG.
    #
    # For interconnects, any hosted connections are automatically
    # re-associated with the LAG. If the interconnect was originally
    # associated with a different LAG, the hosted connections remain
    # associated with the original LAG.
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection.
    #
    # @option params [required, String] :lag_id
    #   The ID of the LAG with which to associate the connection.
    #
    # @return [Types::Connection] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connection#owner_account #owner_account} => String
    #   * {Types::Connection#connection_id #connection_id} => String
    #   * {Types::Connection#connection_name #connection_name} => String
    #   * {Types::Connection#connection_state #connection_state} => String
    #   * {Types::Connection#region #region} => String
    #   * {Types::Connection#location #location} => String
    #   * {Types::Connection#bandwidth #bandwidth} => String
    #   * {Types::Connection#vlan #vlan} => Integer
    #   * {Types::Connection#partner_name #partner_name} => String
    #   * {Types::Connection#loa_issue_time #loa_issue_time} => Time
    #   * {Types::Connection#lag_id #lag_id} => String
    #   * {Types::Connection#aws_device #aws_device} => String
    #   * {Types::Connection#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Connection#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Connection#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Connection#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Connection#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Connection#provider_name #provider_name} => String
    #   * {Types::Connection#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Connection#port_encryption_status #port_encryption_status} => String
    #   * {Types::Connection#encryption_mode #encryption_mode} => String
    #   * {Types::Connection#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #   * {Types::Connection#partner_interconnect_mac_sec_capable #partner_interconnect_mac_sec_capable} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.associate_connection_with_lag({
    #     connection_id: "ConnectionId", # required
    #     lag_id: "LagId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.connection_id #=> String
    #   resp.connection_name #=> String
    #   resp.connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.region #=> String
    #   resp.location #=> String
    #   resp.bandwidth #=> String
    #   resp.vlan #=> Integer
    #   resp.partner_name #=> String
    #   resp.loa_issue_time #=> Time
    #   resp.lag_id #=> String
    #   resp.aws_device #=> String
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.port_encryption_status #=> String
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #   resp.partner_interconnect_mac_sec_capable #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AssociateConnectionWithLag AWS API Documentation
    #
    # @overload associate_connection_with_lag(params = {})
    # @param [Hash] params ({})
    def associate_connection_with_lag(params = {}, options = {})
      req = build_request(:associate_connection_with_lag, params)
      req.send_request(options)
    end

    # Associates a hosted connection and its virtual interfaces with a link
    # aggregation group (LAG) or interconnect. If the target interconnect or
    # LAG has an existing hosted connection with a conflicting VLAN number
    # or IP address, the operation fails. This action temporarily interrupts
    # the hosted connection's connectivity to Amazon Web Services as it is
    # being migrated.
    #
    # <note markdown="1"> Intended for use by Direct Connect Partners only.
    #
    #  </note>
    #
    # @option params [required, String] :connection_id
    #   The ID of the hosted connection.
    #
    # @option params [required, String] :parent_connection_id
    #   The ID of the interconnect or the LAG.
    #
    # @return [Types::Connection] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connection#owner_account #owner_account} => String
    #   * {Types::Connection#connection_id #connection_id} => String
    #   * {Types::Connection#connection_name #connection_name} => String
    #   * {Types::Connection#connection_state #connection_state} => String
    #   * {Types::Connection#region #region} => String
    #   * {Types::Connection#location #location} => String
    #   * {Types::Connection#bandwidth #bandwidth} => String
    #   * {Types::Connection#vlan #vlan} => Integer
    #   * {Types::Connection#partner_name #partner_name} => String
    #   * {Types::Connection#loa_issue_time #loa_issue_time} => Time
    #   * {Types::Connection#lag_id #lag_id} => String
    #   * {Types::Connection#aws_device #aws_device} => String
    #   * {Types::Connection#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Connection#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Connection#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Connection#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Connection#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Connection#provider_name #provider_name} => String
    #   * {Types::Connection#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Connection#port_encryption_status #port_encryption_status} => String
    #   * {Types::Connection#encryption_mode #encryption_mode} => String
    #   * {Types::Connection#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #   * {Types::Connection#partner_interconnect_mac_sec_capable #partner_interconnect_mac_sec_capable} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.associate_hosted_connection({
    #     connection_id: "ConnectionId", # required
    #     parent_connection_id: "ConnectionId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.connection_id #=> String
    #   resp.connection_name #=> String
    #   resp.connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.region #=> String
    #   resp.location #=> String
    #   resp.bandwidth #=> String
    #   resp.vlan #=> Integer
    #   resp.partner_name #=> String
    #   resp.loa_issue_time #=> Time
    #   resp.lag_id #=> String
    #   resp.aws_device #=> String
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.port_encryption_status #=> String
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #   resp.partner_interconnect_mac_sec_capable #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AssociateHostedConnection AWS API Documentation
    #
    # @overload associate_hosted_connection(params = {})
    # @param [Hash] params ({})
    def associate_hosted_connection(params = {}, options = {})
      req = build_request(:associate_hosted_connection, params)
      req.send_request(options)
    end

    # Associates a MAC Security (MACsec) Connection Key Name (CKN)/
    # Connectivity Association Key (CAK) pair with a Direct Connect
    # connection.
    #
    # You must supply either the `secretARN,` or the CKN/CAK (`ckn` and
    # `cak`) pair in the request.
    #
    # For information about MAC Security (MACsec) key considerations, see
    # [MACsec pre-shared CKN/CAK key considerations ][1] in the *Direct
    # Connect User Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-mac-sec-getting-started.html#mac-sec-key-consideration
    #
    # @option params [required, String] :connection_id
    #   The ID of the dedicated connection (dxcon-xxxx), interconnect
    #   (dxcon-xxxx), or LAG (dxlag-xxxx).
    #
    #   You can use DescribeConnections, DescribeInterconnects, or
    #   DescribeLags to retrieve connection ID.
    #
    # @option params [String] :secret_arn
    #   The Amazon Resource Name (ARN) of the MAC Security (MACsec) secret key
    #   to associate with the connection.
    #
    #   You can use DescribeConnections or DescribeLags to retrieve the MAC
    #   Security (MACsec) secret key.
    #
    #   If you use this request parameter, you do not use the `ckn` and `cak`
    #   request parameters.
    #
    # @option params [String] :ckn
    #   The MAC Security (MACsec) CKN to associate with the connection.
    #
    #   You can create the CKN/CAK pair using an industry standard tool.
    #
    #   The valid values are 64 hexadecimal characters (0-9, A-E).
    #
    #   If you use this request parameter, you must use the `cak` request
    #   parameter and not use the `secretARN` request parameter.
    #
    # @option params [String] :cak
    #   The MAC Security (MACsec) CAK to associate with the connection.
    #
    #   You can create the CKN/CAK pair using an industry standard tool.
    #
    #   The valid values are 64 hexadecimal characters (0-9, A-E).
    #
    #   If you use this request parameter, you must use the `ckn` request
    #   parameter and not use the `secretARN` request parameter.
    #
    # @return [Types::AssociateMacSecKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::AssociateMacSecKeyResponse#connection_id #connection_id} => String
    #   * {Types::AssociateMacSecKeyResponse#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.associate_mac_sec_key({
    #     connection_id: "ConnectionId", # required
    #     secret_arn: "SecretARN",
    #     ckn: "Ckn",
    #     cak: "Cak",
    #   })
    #
    # @example Response structure
    #
    #   resp.connection_id #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AssociateMacSecKey AWS API Documentation
    #
    # @overload associate_mac_sec_key(params = {})
    # @param [Hash] params ({})
    def associate_mac_sec_key(params = {}, options = {})
      req = build_request(:associate_mac_sec_key, params)
      req.send_request(options)
    end

    # Associates a virtual interface with a specified link aggregation group
    # (LAG) or connection. Connectivity to Amazon Web Services is
    # temporarily interrupted as the virtual interface is being migrated. If
    # the target connection or LAG has an associated virtual interface with
    # a conflicting VLAN number or a conflicting IP address, the operation
    # fails.
    #
    # Virtual interfaces associated with a hosted connection cannot be
    # associated with a LAG; hosted connections must be migrated along with
    # their virtual interfaces using AssociateHostedConnection.
    #
    # To reassociate a virtual interface to a new connection or LAG, the
    # requester must own either the virtual interface itself or the
    # connection to which the virtual interface is currently associated.
    # Additionally, the requester must own the connection or LAG for the
    # association.
    #
    # @option params [required, String] :virtual_interface_id
    #   The ID of the virtual interface.
    #
    # @option params [required, String] :connection_id
    #   The ID of the LAG or connection.
    #
    # @return [Types::VirtualInterface] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::VirtualInterface#owner_account #owner_account} => String
    #   * {Types::VirtualInterface#virtual_interface_id #virtual_interface_id} => String
    #   * {Types::VirtualInterface#location #location} => String
    #   * {Types::VirtualInterface#connection_id #connection_id} => String
    #   * {Types::VirtualInterface#virtual_interface_type #virtual_interface_type} => String
    #   * {Types::VirtualInterface#virtual_interface_name #virtual_interface_name} => String
    #   * {Types::VirtualInterface#vlan #vlan} => Integer
    #   * {Types::VirtualInterface#asn #asn} => Integer
    #   * {Types::VirtualInterface#asn_long #asn_long} => Integer
    #   * {Types::VirtualInterface#amazon_side_asn #amazon_side_asn} => Integer
    #   * {Types::VirtualInterface#auth_key #auth_key} => String
    #   * {Types::VirtualInterface#amazon_address #amazon_address} => String
    #   * {Types::VirtualInterface#customer_address #customer_address} => String
    #   * {Types::VirtualInterface#address_family #address_family} => String
    #   * {Types::VirtualInterface#virtual_interface_state #virtual_interface_state} => String
    #   * {Types::VirtualInterface#customer_router_config #customer_router_config} => String
    #   * {Types::VirtualInterface#mtu #mtu} => Integer
    #   * {Types::VirtualInterface#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::VirtualInterface#virtual_gateway_id #virtual_gateway_id} => String
    #   * {Types::VirtualInterface#direct_connect_gateway_id #direct_connect_gateway_id} => String
    #   * {Types::VirtualInterface#route_filter_prefixes #route_filter_prefixes} => Array&lt;Types::RouteFilterPrefix&gt;
    #   * {Types::VirtualInterface#bgp_peers #bgp_peers} => Array&lt;Types::BGPPeer&gt;
    #   * {Types::VirtualInterface#region #region} => String
    #   * {Types::VirtualInterface#aws_device_v2 #aws_device_v2} => String
    #   * {Types::VirtualInterface#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::VirtualInterface#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::VirtualInterface#site_link_enabled #site_link_enabled} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.associate_virtual_interface({
    #     virtual_interface_id: "VirtualInterfaceId", # required
    #     connection_id: "ConnectionId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.virtual_interface_id #=> String
    #   resp.location #=> String
    #   resp.connection_id #=> String
    #   resp.virtual_interface_type #=> String
    #   resp.virtual_interface_name #=> String
    #   resp.vlan #=> Integer
    #   resp.asn #=> Integer
    #   resp.asn_long #=> Integer
    #   resp.amazon_side_asn #=> Integer
    #   resp.auth_key #=> String
    #   resp.amazon_address #=> String
    #   resp.customer_address #=> String
    #   resp.address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.customer_router_config #=> String
    #   resp.mtu #=> Integer
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_id #=> String
    #   resp.route_filter_prefixes #=> Array
    #   resp.route_filter_prefixes[0].cidr #=> String
    #   resp.bgp_peers #=> Array
    #   resp.bgp_peers[0].bgp_peer_id #=> String
    #   resp.bgp_peers[0].asn #=> Integer
    #   resp.bgp_peers[0].asn_long #=> Integer
    #   resp.bgp_peers[0].auth_key #=> String
    #   resp.bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.bgp_peers[0].amazon_address #=> String
    #   resp.bgp_peers[0].customer_address #=> String
    #   resp.bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.bgp_peers[0].aws_device_v2 #=> String
    #   resp.bgp_peers[0].aws_logical_device_id #=> String
    #   resp.region #=> String
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.site_link_enabled #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AssociateVirtualInterface AWS API Documentation
    #
    # @overload associate_virtual_interface(params = {})
    # @param [Hash] params ({})
    def associate_virtual_interface(params = {}, options = {})
      req = build_request(:associate_virtual_interface, params)
      req.send_request(options)
    end

    # Confirms the creation of the specified hosted connection on an
    # interconnect.
    #
    # Upon creation, the hosted connection is initially in the `Ordering`
    # state, and remains in this state until the owner confirms creation of
    # the hosted connection.
    #
    # @option params [required, String] :connection_id
    #   The ID of the hosted connection.
    #
    # @return [Types::ConfirmConnectionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ConfirmConnectionResponse#connection_state #connection_state} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.confirm_connection({
    #     connection_id: "ConnectionId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/ConfirmConnection AWS API Documentation
    #
    # @overload confirm_connection(params = {})
    # @param [Hash] params ({})
    def confirm_connection(params = {}, options = {})
      req = build_request(:confirm_connection, params)
      req.send_request(options)
    end

    # The confirmation of the terms of agreement when creating the
    # connection/link aggregation group (LAG).
    #
    # @option params [String] :agreement_name
    #   The name of the customer agreement.
    #
    # @return [Types::ConfirmCustomerAgreementResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ConfirmCustomerAgreementResponse#status #status} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.confirm_customer_agreement({
    #     agreement_name: "AgreementName",
    #   })
    #
    # @example Response structure
    #
    #   resp.status #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/ConfirmCustomerAgreement AWS API Documentation
    #
    # @overload confirm_customer_agreement(params = {})
    # @param [Hash] params ({})
    def confirm_customer_agreement(params = {}, options = {})
      req = build_request(:confirm_customer_agreement, params)
      req.send_request(options)
    end

    # Accepts ownership of a private virtual interface created by another
    # Amazon Web Services account.
    #
    # After the virtual interface owner makes this call, the virtual
    # interface is created and attached to the specified virtual private
    # gateway or Direct Connect gateway, and is made available to handle
    # traffic.
    #
    # @option params [required, String] :virtual_interface_id
    #   The ID of the virtual interface.
    #
    # @option params [String] :virtual_gateway_id
    #   The ID of the virtual private gateway.
    #
    # @option params [String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @return [Types::ConfirmPrivateVirtualInterfaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ConfirmPrivateVirtualInterfaceResponse#virtual_interface_state #virtual_interface_state} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.confirm_private_virtual_interface({
    #     virtual_interface_id: "VirtualInterfaceId", # required
    #     virtual_gateway_id: "VirtualGatewayId",
    #     direct_connect_gateway_id: "DirectConnectGatewayId",
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/ConfirmPrivateVirtualInterface AWS API Documentation
    #
    # @overload confirm_private_virtual_interface(params = {})
    # @param [Hash] params ({})
    def confirm_private_virtual_interface(params = {}, options = {})
      req = build_request(:confirm_private_virtual_interface, params)
      req.send_request(options)
    end

    # Accepts ownership of a public virtual interface created by another
    # Amazon Web Services account.
    #
    # After the virtual interface owner makes this call, the specified
    # virtual interface is created and made available to handle traffic.
    #
    # @option params [required, String] :virtual_interface_id
    #   The ID of the virtual interface.
    #
    # @return [Types::ConfirmPublicVirtualInterfaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ConfirmPublicVirtualInterfaceResponse#virtual_interface_state #virtual_interface_state} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.confirm_public_virtual_interface({
    #     virtual_interface_id: "VirtualInterfaceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/ConfirmPublicVirtualInterface AWS API Documentation
    #
    # @overload confirm_public_virtual_interface(params = {})
    # @param [Hash] params ({})
    def confirm_public_virtual_interface(params = {}, options = {})
      req = build_request(:confirm_public_virtual_interface, params)
      req.send_request(options)
    end

    # Accepts ownership of a transit virtual interface created by another
    # Amazon Web Services account.
    #
    # After the owner of the transit virtual interface makes this call, the
    # specified transit virtual interface is created and made available to
    # handle traffic.
    #
    # @option params [required, String] :virtual_interface_id
    #   The ID of the virtual interface.
    #
    # @option params [required, String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @return [Types::ConfirmTransitVirtualInterfaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ConfirmTransitVirtualInterfaceResponse#virtual_interface_state #virtual_interface_state} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.confirm_transit_virtual_interface({
    #     virtual_interface_id: "VirtualInterfaceId", # required
    #     direct_connect_gateway_id: "DirectConnectGatewayId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/ConfirmTransitVirtualInterface AWS API Documentation
    #
    # @overload confirm_transit_virtual_interface(params = {})
    # @param [Hash] params ({})
    def confirm_transit_virtual_interface(params = {}, options = {})
      req = build_request(:confirm_transit_virtual_interface, params)
      req.send_request(options)
    end

    # Creates a BGP peer on the specified virtual interface.
    #
    # You must create a BGP peer for the corresponding address family
    # (IPv4/IPv6) in order to access Amazon Web Services resources that also
    # use that address family.
    #
    # If logical redundancy is not supported by the connection,
    # interconnect, or LAG, the BGP peer cannot be in the same address
    # family as an existing BGP peer on the virtual interface.
    #
    # When creating a IPv6 BGP peer, omit the Amazon address and customer
    # address. IPv6 addresses are automatically assigned from the Amazon
    # pool of IPv6 addresses; you cannot specify custom IPv6 addresses.
    #
    # If you let Amazon Web Services auto-assign IPv4 addresses, a /30 CIDR
    # will be allocated from 169.254.0.0/16. Amazon Web Services does not
    # recommend this option if you intend to use the customer router peer IP
    # address as the source and destination for traffic. Instead you should
    # use RFC 1918 or other addressing, and specify the address yourself.
    # For more information about RFC 1918 see [ Address Allocation for
    # Private Internets][1].
    #
    # For a public virtual interface, the Autonomous System Number (ASN)
    # must be private or already on the allow list for the virtual
    # interface.
    #
    #
    #
    # [1]: https://datatracker.ietf.org/doc/html/rfc1918
    #
    # @option params [String] :virtual_interface_id
    #   The ID of the virtual interface.
    #
    # @option params [Types::NewBGPPeer] :new_bgp_peer
    #   Information about the BGP peer.
    #
    # @return [Types::CreateBGPPeerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateBGPPeerResponse#virtual_interface #virtual_interface} => Types::VirtualInterface
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_bgp_peer({
    #     virtual_interface_id: "VirtualInterfaceId",
    #     new_bgp_peer: {
    #       asn: 1,
    #       asn_long: 1,
    #       auth_key: "BGPAuthKey",
    #       address_family: "ipv4", # accepts ipv4, ipv6
    #       amazon_address: "AmazonAddress",
    #       customer_address: "CustomerAddress",
    #     },
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface.owner_account #=> String
    #   resp.virtual_interface.virtual_interface_id #=> String
    #   resp.virtual_interface.location #=> String
    #   resp.virtual_interface.connection_id #=> String
    #   resp.virtual_interface.virtual_interface_type #=> String
    #   resp.virtual_interface.virtual_interface_name #=> String
    #   resp.virtual_interface.vlan #=> Integer
    #   resp.virtual_interface.asn #=> Integer
    #   resp.virtual_interface.asn_long #=> Integer
    #   resp.virtual_interface.amazon_side_asn #=> Integer
    #   resp.virtual_interface.auth_key #=> String
    #   resp.virtual_interface.amazon_address #=> String
    #   resp.virtual_interface.customer_address #=> String
    #   resp.virtual_interface.address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.virtual_interface.customer_router_config #=> String
    #   resp.virtual_interface.mtu #=> Integer
    #   resp.virtual_interface.jumbo_frame_capable #=> Boolean
    #   resp.virtual_interface.virtual_gateway_id #=> String
    #   resp.virtual_interface.direct_connect_gateway_id #=> String
    #   resp.virtual_interface.route_filter_prefixes #=> Array
    #   resp.virtual_interface.route_filter_prefixes[0].cidr #=> String
    #   resp.virtual_interface.bgp_peers #=> Array
    #   resp.virtual_interface.bgp_peers[0].bgp_peer_id #=> String
    #   resp.virtual_interface.bgp_peers[0].asn #=> Integer
    #   resp.virtual_interface.bgp_peers[0].asn_long #=> Integer
    #   resp.virtual_interface.bgp_peers[0].auth_key #=> String
    #   resp.virtual_interface.bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface.bgp_peers[0].amazon_address #=> String
    #   resp.virtual_interface.bgp_peers[0].customer_address #=> String
    #   resp.virtual_interface.bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.virtual_interface.bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.virtual_interface.bgp_peers[0].aws_device_v2 #=> String
    #   resp.virtual_interface.bgp_peers[0].aws_logical_device_id #=> String
    #   resp.virtual_interface.region #=> String
    #   resp.virtual_interface.aws_device_v2 #=> String
    #   resp.virtual_interface.aws_logical_device_id #=> String
    #   resp.virtual_interface.tags #=> Array
    #   resp.virtual_interface.tags[0].key #=> String
    #   resp.virtual_interface.tags[0].value #=> String
    #   resp.virtual_interface.site_link_enabled #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateBGPPeer AWS API Documentation
    #
    # @overload create_bgp_peer(params = {})
    # @param [Hash] params ({})
    def create_bgp_peer(params = {}, options = {})
      req = build_request(:create_bgp_peer, params)
      req.send_request(options)
    end

    # Creates a connection between a customer network and a specific Direct
    # Connect location.
    #
    # A connection links your internal network to an Direct Connect location
    # over a standard Ethernet fiber-optic cable. One end of the cable is
    # connected to your router, the other to an Direct Connect router.
    #
    # To find the locations for your Region, use DescribeLocations.
    #
    # You can automatically add the new connection to a link aggregation
    # group (LAG) by specifying a LAG ID in the request. This ensures that
    # the new connection is allocated on the same Direct Connect endpoint
    # that hosts the specified LAG. If there are no available ports on the
    # endpoint, the request fails and no connection is created.
    #
    # @option params [required, String] :location
    #   The location of the connection.
    #
    # @option params [required, String] :bandwidth
    #   The bandwidth of the connection.
    #
    # @option params [required, String] :connection_name
    #   The name of the connection.
    #
    # @option params [String] :lag_id
    #   The ID of the LAG.
    #
    # @option params [Array<Types::Tag>] :tags
    #   The tags to associate with the lag.
    #
    # @option params [String] :provider_name
    #   The name of the service provider associated with the requested
    #   connection.
    #
    # @option params [Boolean] :request_mac_sec
    #   Indicates whether you want the connection to support MAC Security
    #   (MACsec).
    #
    #   MAC Security (MACsec) is unavailable on hosted connections. For
    #   information about MAC Security (MACsec) prerequisites, see [MAC
    #   Security in Direct Connect][1] in the *Direct Connect User Guide*.
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/directconnect/latest/UserGuide/MACSec.html
    #
    # @return [Types::Connection] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connection#owner_account #owner_account} => String
    #   * {Types::Connection#connection_id #connection_id} => String
    #   * {Types::Connection#connection_name #connection_name} => String
    #   * {Types::Connection#connection_state #connection_state} => String
    #   * {Types::Connection#region #region} => String
    #   * {Types::Connection#location #location} => String
    #   * {Types::Connection#bandwidth #bandwidth} => String
    #   * {Types::Connection#vlan #vlan} => Integer
    #   * {Types::Connection#partner_name #partner_name} => String
    #   * {Types::Connection#loa_issue_time #loa_issue_time} => Time
    #   * {Types::Connection#lag_id #lag_id} => String
    #   * {Types::Connection#aws_device #aws_device} => String
    #   * {Types::Connection#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Connection#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Connection#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Connection#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Connection#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Connection#provider_name #provider_name} => String
    #   * {Types::Connection#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Connection#port_encryption_status #port_encryption_status} => String
    #   * {Types::Connection#encryption_mode #encryption_mode} => String
    #   * {Types::Connection#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #   * {Types::Connection#partner_interconnect_mac_sec_capable #partner_interconnect_mac_sec_capable} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_connection({
    #     location: "LocationCode", # required
    #     bandwidth: "Bandwidth", # required
    #     connection_name: "ConnectionName", # required
    #     lag_id: "LagId",
    #     tags: [
    #       {
    #         key: "TagKey", # required
    #         value: "TagValue",
    #       },
    #     ],
    #     provider_name: "ProviderName",
    #     request_mac_sec: false,
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.connection_id #=> String
    #   resp.connection_name #=> String
    #   resp.connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.region #=> String
    #   resp.location #=> String
    #   resp.bandwidth #=> String
    #   resp.vlan #=> Integer
    #   resp.partner_name #=> String
    #   resp.loa_issue_time #=> Time
    #   resp.lag_id #=> String
    #   resp.aws_device #=> String
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.port_encryption_status #=> String
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #   resp.partner_interconnect_mac_sec_capable #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateConnection AWS API Documentation
    #
    # @overload create_connection(params = {})
    # @param [Hash] params ({})
    def create_connection(params = {}, options = {})
      req = build_request(:create_connection, params)
      req.send_request(options)
    end

    # Creates a Direct Connect gateway, which is an intermediate object that
    # enables you to connect a set of virtual interfaces and virtual private
    # gateways. A Direct Connect gateway is global and visible in any Amazon
    # Web Services Region after it is created. The virtual interfaces and
    # virtual private gateways that are connected through a Direct Connect
    # gateway can be in different Amazon Web Services Regions. This enables
    # you to connect to a VPC in any Region, regardless of the Region in
    # which the virtual interfaces are located, and pass traffic between
    # them.
    #
    # @option params [required, String] :direct_connect_gateway_name
    #   The name of the Direct Connect gateway.
    #
    # @option params [Array<Types::Tag>] :tags
    #   The key-value pair tags associated with the request.
    #
    # @option params [Integer] :amazon_side_asn
    #   The autonomous system number (ASN) for Border Gateway Protocol (BGP)
    #   to be configured on the Amazon side of the connection. The ASN must be
    #   in the private range of 64,512 to 65,534 or 4,200,000,000 to
    #   4,294,967,294. The default is 64512.
    #
    # @return [Types::CreateDirectConnectGatewayResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateDirectConnectGatewayResult#direct_connect_gateway #direct_connect_gateway} => Types::DirectConnectGateway
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_direct_connect_gateway({
    #     direct_connect_gateway_name: "DirectConnectGatewayName", # required
    #     tags: [
    #       {
    #         key: "TagKey", # required
    #         value: "TagValue",
    #       },
    #     ],
    #     amazon_side_asn: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway.direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway.direct_connect_gateway_name #=> String
    #   resp.direct_connect_gateway.amazon_side_asn #=> Integer
    #   resp.direct_connect_gateway.owner_account #=> String
    #   resp.direct_connect_gateway.direct_connect_gateway_state #=> String, one of "pending", "available", "deleting", "deleted"
    #   resp.direct_connect_gateway.state_change_error #=> String
    #   resp.direct_connect_gateway.tags #=> Array
    #   resp.direct_connect_gateway.tags[0].key #=> String
    #   resp.direct_connect_gateway.tags[0].value #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateDirectConnectGateway AWS API Documentation
    #
    # @overload create_direct_connect_gateway(params = {})
    # @param [Hash] params ({})
    def create_direct_connect_gateway(params = {}, options = {})
      req = build_request(:create_direct_connect_gateway, params)
      req.send_request(options)
    end

    # Creates an association between a Direct Connect gateway and a virtual
    # private gateway. The virtual private gateway must be attached to a VPC
    # and must not be associated with another Direct Connect gateway.
    #
    # @option params [required, String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @option params [String] :gateway_id
    #   The ID of the virtual private gateway or transit gateway.
    #
    # @option params [Array<Types::RouteFilterPrefix>] :add_allowed_prefixes_to_direct_connect_gateway
    #   The Amazon VPC prefixes to advertise to the Direct Connect gateway
    #
    #   This parameter is required when you create an association to a transit
    #   gateway.
    #
    #   For information about how to set the prefixes, see [Allowed
    #   Prefixes][1] in the *Direct Connect User Guide*.
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/directconnect/latest/UserGuide/multi-account-associate-vgw.html#allowed-prefixes
    #
    # @option params [String] :virtual_gateway_id
    #   The ID of the virtual private gateway.
    #
    # @return [Types::CreateDirectConnectGatewayAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateDirectConnectGatewayAssociationResult#direct_connect_gateway_association #direct_connect_gateway_association} => Types::DirectConnectGatewayAssociation
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_direct_connect_gateway_association({
    #     direct_connect_gateway_id: "DirectConnectGatewayId", # required
    #     gateway_id: "GatewayIdToAssociate",
    #     add_allowed_prefixes_to_direct_connect_gateway: [
    #       {
    #         cidr: "CIDR",
    #       },
    #     ],
    #     virtual_gateway_id: "VirtualGatewayId",
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway_association.direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway_association.direct_connect_gateway_owner_account #=> String
    #   resp.direct_connect_gateway_association.association_state #=> String, one of "associating", "associated", "disassociating", "disassociated", "updating"
    #   resp.direct_connect_gateway_association.state_change_error #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.id #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.type #=> String, one of "virtualPrivateGateway", "transitGateway"
    #   resp.direct_connect_gateway_association.associated_gateway.owner_account #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.region #=> String
    #   resp.direct_connect_gateway_association.association_id #=> String
    #   resp.direct_connect_gateway_association.allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_association.allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.id #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.owner_account #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.attachment_id #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_region #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_owner_account #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateDirectConnectGatewayAssociation AWS API Documentation
    #
    # @overload create_direct_connect_gateway_association(params = {})
    # @param [Hash] params ({})
    def create_direct_connect_gateway_association(params = {}, options = {})
      req = build_request(:create_direct_connect_gateway_association, params)
      req.send_request(options)
    end

    # Creates a proposal to associate the specified virtual private gateway
    # or transit gateway with the specified Direct Connect gateway.
    #
    # You can associate a Direct Connect gateway and virtual private gateway
    # or transit gateway that is owned by any Amazon Web Services account.
    #
    # @option params [required, String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @option params [required, String] :direct_connect_gateway_owner_account
    #   The ID of the Amazon Web Services account that owns the Direct Connect
    #   gateway.
    #
    # @option params [required, String] :gateway_id
    #   The ID of the virtual private gateway or transit gateway.
    #
    # @option params [Array<Types::RouteFilterPrefix>] :add_allowed_prefixes_to_direct_connect_gateway
    #   The Amazon VPC prefixes to advertise to the Direct Connect gateway.
    #
    # @option params [Array<Types::RouteFilterPrefix>] :remove_allowed_prefixes_to_direct_connect_gateway
    #   The Amazon VPC prefixes to no longer advertise to the Direct Connect
    #   gateway.
    #
    # @return [Types::CreateDirectConnectGatewayAssociationProposalResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateDirectConnectGatewayAssociationProposalResult#direct_connect_gateway_association_proposal #direct_connect_gateway_association_proposal} => Types::DirectConnectGatewayAssociationProposal
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_direct_connect_gateway_association_proposal({
    #     direct_connect_gateway_id: "DirectConnectGatewayId", # required
    #     direct_connect_gateway_owner_account: "OwnerAccount", # required
    #     gateway_id: "GatewayIdToAssociate", # required
    #     add_allowed_prefixes_to_direct_connect_gateway: [
    #       {
    #         cidr: "CIDR",
    #       },
    #     ],
    #     remove_allowed_prefixes_to_direct_connect_gateway: [
    #       {
    #         cidr: "CIDR",
    #       },
    #     ],
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway_association_proposal.proposal_id #=> String
    #   resp.direct_connect_gateway_association_proposal.direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway_association_proposal.direct_connect_gateway_owner_account #=> String
    #   resp.direct_connect_gateway_association_proposal.proposal_state #=> String, one of "requested", "accepted", "deleted"
    #   resp.direct_connect_gateway_association_proposal.associated_gateway.id #=> String
    #   resp.direct_connect_gateway_association_proposal.associated_gateway.type #=> String, one of "virtualPrivateGateway", "transitGateway"
    #   resp.direct_connect_gateway_association_proposal.associated_gateway.owner_account #=> String
    #   resp.direct_connect_gateway_association_proposal.associated_gateway.region #=> String
    #   resp.direct_connect_gateway_association_proposal.existing_allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_association_proposal.existing_allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #   resp.direct_connect_gateway_association_proposal.requested_allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_association_proposal.requested_allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateDirectConnectGatewayAssociationProposal AWS API Documentation
    #
    # @overload create_direct_connect_gateway_association_proposal(params = {})
    # @param [Hash] params ({})
    def create_direct_connect_gateway_association_proposal(params = {}, options = {})
      req = build_request(:create_direct_connect_gateway_association_proposal, params)
      req.send_request(options)
    end

    # Creates an interconnect between an Direct Connect Partner's network
    # and a specific Direct Connect location.
    #
    # An interconnect is a connection that is capable of hosting other
    # connections. The Direct Connect Partner can use an interconnect to
    # provide Direct Connect hosted connections to customers through their
    # own network services. Like a standard connection, an interconnect
    # links the partner's network to an Direct Connect location over a
    # standard Ethernet fiber-optic cable. One end is connected to the
    # partner's router, the other to an Direct Connect router.
    #
    # You can automatically add the new interconnect to a link aggregation
    # group (LAG) by specifying a LAG ID in the request. This ensures that
    # the new interconnect is allocated on the same Direct Connect endpoint
    # that hosts the specified LAG. If there are no available ports on the
    # endpoint, the request fails and no interconnect is created.
    #
    # For each end customer, the Direct Connect Partner provisions a
    # connection on their interconnect by calling AllocateHostedConnection.
    # The end customer can then connect to Amazon Web Services resources by
    # creating a virtual interface on their connection, using the VLAN
    # assigned to them by the Direct Connect Partner.
    #
    # <note markdown="1"> Intended for use by Direct Connect Partners only.
    #
    #  </note>
    #
    # @option params [required, String] :interconnect_name
    #   The name of the interconnect.
    #
    # @option params [required, String] :bandwidth
    #   The port bandwidth, in Gbps. The possible values are 1, 10, and 100.
    #
    # @option params [required, String] :location
    #   The location of the interconnect.
    #
    # @option params [String] :lag_id
    #   The ID of the LAG.
    #
    # @option params [Array<Types::Tag>] :tags
    #   The tags to associate with the interconnect.
    #
    # @option params [String] :provider_name
    #   The name of the service provider associated with the interconnect.
    #
    # @option params [Boolean] :request_mac_sec
    #   Indicates whether you want the interconnect to support MAC Security
    #   (MACsec).
    #
    # @return [Types::Interconnect] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Interconnect#interconnect_id #interconnect_id} => String
    #   * {Types::Interconnect#interconnect_name #interconnect_name} => String
    #   * {Types::Interconnect#interconnect_state #interconnect_state} => String
    #   * {Types::Interconnect#region #region} => String
    #   * {Types::Interconnect#location #location} => String
    #   * {Types::Interconnect#bandwidth #bandwidth} => String
    #   * {Types::Interconnect#loa_issue_time #loa_issue_time} => Time
    #   * {Types::Interconnect#lag_id #lag_id} => String
    #   * {Types::Interconnect#aws_device #aws_device} => String
    #   * {Types::Interconnect#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Interconnect#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Interconnect#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Interconnect#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Interconnect#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Interconnect#provider_name #provider_name} => String
    #   * {Types::Interconnect#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Interconnect#port_encryption_status #port_encryption_status} => String
    #   * {Types::Interconnect#encryption_mode #encryption_mode} => String
    #   * {Types::Interconnect#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_interconnect({
    #     interconnect_name: "InterconnectName", # required
    #     bandwidth: "Bandwidth", # required
    #     location: "LocationCode", # required
    #     lag_id: "LagId",
    #     tags: [
    #       {
    #         key: "TagKey", # required
    #         value: "TagValue",
    #       },
    #     ],
    #     provider_name: "ProviderName",
    #     request_mac_sec: false,
    #   })
    #
    # @example Response structure
    #
    #   resp.interconnect_id #=> String
    #   resp.interconnect_name #=> String
    #   resp.interconnect_state #=> String, one of "requested", "pending", "available", "down", "deleting", "deleted", "unknown"
    #   resp.region #=> String
    #   resp.location #=> String
    #   resp.bandwidth #=> String
    #   resp.loa_issue_time #=> Time
    #   resp.lag_id #=> String
    #   resp.aws_device #=> String
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.port_encryption_status #=> String
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateInterconnect AWS API Documentation
    #
    # @overload create_interconnect(params = {})
    # @param [Hash] params ({})
    def create_interconnect(params = {}, options = {})
      req = build_request(:create_interconnect, params)
      req.send_request(options)
    end

    # Creates a link aggregation group (LAG) with the specified number of
    # bundled physical dedicated connections between the customer network
    # and a specific Direct Connect location. A LAG is a logical interface
    # that uses the Link Aggregation Control Protocol (LACP) to aggregate
    # multiple interfaces, enabling you to treat them as a single interface.
    #
    # All connections in a LAG must use the same bandwidth (either 1Gbps,
    # 10Gbps, 100Gbps, or 400Gbps) and must terminate at the same Direct
    # Connect endpoint.
    #
    # You can have up to 10 dedicated connections per location. Regardless
    # of this limit, if you request more connections for the LAG than Direct
    # Connect can allocate on a single endpoint, no LAG is created..
    #
    # You can specify an existing physical dedicated connection or
    # interconnect to include in the LAG (which counts towards the total
    # number of connections). Doing so interrupts the current physical
    # dedicated connection, and re-establishes them as a member of the LAG.
    # The LAG will be created on the same Direct Connect endpoint to which
    # the dedicated connection terminates. Any virtual interfaces associated
    # with the dedicated connection are automatically disassociated and
    # re-associated with the LAG. The connection ID does not change.
    #
    # If the Amazon Web Services account used to create a LAG is a
    # registered Direct Connect Partner, the LAG is automatically enabled to
    # host sub-connections. For a LAG owned by a partner, any associated
    # virtual interfaces cannot be directly configured.
    #
    # @option params [required, Integer] :number_of_connections
    #   The number of physical dedicated connections initially provisioned and
    #   bundled by the LAG. You can have a maximum of four connections when
    #   the port speed is 1Gbps or 10Gbps, or two when the port speed is
    #   100Gbps or 400Gbps.
    #
    # @option params [required, String] :location
    #   The location for the LAG.
    #
    # @option params [required, String] :connections_bandwidth
    #   The bandwidth of the individual physical dedicated connections bundled
    #   by the LAG. The possible values are 1Gbps,10Gbps, 100Gbps, and
    #   400Gbps.
    #
    # @option params [required, String] :lag_name
    #   The name of the LAG.
    #
    # @option params [String] :connection_id
    #   The ID of an existing dedicated connection to migrate to the LAG.
    #
    # @option params [Array<Types::Tag>] :tags
    #   The tags to associate with the LAG.
    #
    # @option params [Array<Types::Tag>] :child_connection_tags
    #   The tags to associate with the automtically created LAGs.
    #
    # @option params [String] :provider_name
    #   The name of the service provider associated with the LAG.
    #
    # @option params [Boolean] :request_mac_sec
    #   Indicates whether the connection will support MAC Security (MACsec).
    #
    #   <note markdown="1"> All connections in the LAG must be capable of supporting MAC Security
    #   (MACsec). For information about MAC Security (MACsec) prerequisties,
    #   see [MACsec prerequisties][1] in the *Direct Connect User Guide*.
    #
    #    </note>
    #
    #
    #
    #   [1]: https://docs.aws.amazon.com/directconnect/latest/UserGuide/direct-connect-mac-sec-getting-started.html#mac-sec-prerequisites
    #
    # @return [Types::Lag] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Lag#connections_bandwidth #connections_bandwidth} => String
    #   * {Types::Lag#number_of_connections #number_of_connections} => Integer
    #   * {Types::Lag#lag_id #lag_id} => String
    #   * {Types::Lag#owner_account #owner_account} => String
    #   * {Types::Lag#lag_name #lag_name} => String
    #   * {Types::Lag#lag_state #lag_state} => String
    #   * {Types::Lag#location #location} => String
    #   * {Types::Lag#region #region} => String
    #   * {Types::Lag#minimum_links #minimum_links} => Integer
    #   * {Types::Lag#aws_device #aws_device} => String
    #   * {Types::Lag#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Lag#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Lag#connections #connections} => Array&lt;Types::Connection&gt;
    #   * {Types::Lag#allows_hosted_connections #allows_hosted_connections} => Boolean
    #   * {Types::Lag#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Lag#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Lag#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Lag#provider_name #provider_name} => String
    #   * {Types::Lag#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Lag#encryption_mode #encryption_mode} => String
    #   * {Types::Lag#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_lag({
    #     number_of_connections: 1, # required
    #     location: "LocationCode", # required
    #     connections_bandwidth: "Bandwidth", # required
    #     lag_name: "LagName", # required
    #     connection_id: "ConnectionId",
    #     tags: [
    #       {
    #         key: "TagKey", # required
    #         value: "TagValue",
    #       },
    #     ],
    #     child_connection_tags: [
    #       {
    #         key: "TagKey", # required
    #         value: "TagValue",
    #       },
    #     ],
    #     provider_name: "ProviderName",
    #     request_mac_sec: false,
    #   })
    #
    # @example Response structure
    #
    #   resp.connections_bandwidth #=> String
    #   resp.number_of_connections #=> Integer
    #   resp.lag_id #=> String
    #   resp.owner_account #=> String
    #   resp.lag_name #=> String
    #   resp.lag_state #=> String, one of "requested", "pending", "available", "down", "deleting", "deleted", "unknown"
    #   resp.location #=> String
    #   resp.region #=> String
    #   resp.minimum_links #=> Integer
    #   resp.aws_device #=> String
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.connections #=> Array
    #   resp.connections[0].owner_account #=> String
    #   resp.connections[0].connection_id #=> String
    #   resp.connections[0].connection_name #=> String
    #   resp.connections[0].connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.connections[0].region #=> String
    #   resp.connections[0].location #=> String
    #   resp.connections[0].bandwidth #=> String
    #   resp.connections[0].vlan #=> Integer
    #   resp.connections[0].partner_name #=> String
    #   resp.connections[0].loa_issue_time #=> Time
    #   resp.connections[0].lag_id #=> String
    #   resp.connections[0].aws_device #=> String
    #   resp.connections[0].jumbo_frame_capable #=> Boolean
    #   resp.connections[0].aws_device_v2 #=> String
    #   resp.connections[0].aws_logical_device_id #=> String
    #   resp.connections[0].has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.connections[0].tags #=> Array
    #   resp.connections[0].tags[0].key #=> String
    #   resp.connections[0].tags[0].value #=> String
    #   resp.connections[0].provider_name #=> String
    #   resp.connections[0].mac_sec_capable #=> Boolean
    #   resp.connections[0].port_encryption_status #=> String
    #   resp.connections[0].encryption_mode #=> String
    #   resp.connections[0].mac_sec_keys #=> Array
    #   resp.connections[0].mac_sec_keys[0].secret_arn #=> String
    #   resp.connections[0].mac_sec_keys[0].ckn #=> String
    #   resp.connections[0].mac_sec_keys[0].state #=> String
    #   resp.connections[0].mac_sec_keys[0].start_on #=> String
    #   resp.connections[0].partner_interconnect_mac_sec_capable #=> Boolean
    #   resp.allows_hosted_connections #=> Boolean
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateLag AWS API Documentation
    #
    # @overload create_lag(params = {})
    # @param [Hash] params ({})
    def create_lag(params = {}, options = {})
      req = build_request(:create_lag, params)
      req.send_request(options)
    end

    # Creates a private virtual interface. A virtual interface is the VLAN
    # that transports Direct Connect traffic. A private virtual interface
    # can be connected to either a Direct Connect gateway or a Virtual
    # Private Gateway (VGW). Connecting the private virtual interface to a
    # Direct Connect gateway enables the possibility for connecting to
    # multiple VPCs, including VPCs in different Amazon Web Services
    # Regions. Connecting the private virtual interface to a VGW only
    # provides access to a single VPC within the same Region.
    #
    # Setting the MTU of a virtual interface to 8500 (jumbo frames) can
    # cause an update to the underlying physical connection if it wasn't
    # updated to support jumbo frames. Updating the connection disrupts
    # network connectivity for all virtual interfaces associated with the
    # connection for up to 30 seconds. To check whether your connection
    # supports jumbo frames, call DescribeConnections. To check whether your
    # virtual interface supports jumbo frames, call
    # DescribeVirtualInterfaces.
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection.
    #
    # @option params [required, Types::NewPrivateVirtualInterface] :new_private_virtual_interface
    #   Information about the private virtual interface.
    #
    # @return [Types::VirtualInterface] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::VirtualInterface#owner_account #owner_account} => String
    #   * {Types::VirtualInterface#virtual_interface_id #virtual_interface_id} => String
    #   * {Types::VirtualInterface#location #location} => String
    #   * {Types::VirtualInterface#connection_id #connection_id} => String
    #   * {Types::VirtualInterface#virtual_interface_type #virtual_interface_type} => String
    #   * {Types::VirtualInterface#virtual_interface_name #virtual_interface_name} => String
    #   * {Types::VirtualInterface#vlan #vlan} => Integer
    #   * {Types::VirtualInterface#asn #asn} => Integer
    #   * {Types::VirtualInterface#asn_long #asn_long} => Integer
    #   * {Types::VirtualInterface#amazon_side_asn #amazon_side_asn} => Integer
    #   * {Types::VirtualInterface#auth_key #auth_key} => String
    #   * {Types::VirtualInterface#amazon_address #amazon_address} => String
    #   * {Types::VirtualInterface#customer_address #customer_address} => String
    #   * {Types::VirtualInterface#address_family #address_family} => String
    #   * {Types::VirtualInterface#virtual_interface_state #virtual_interface_state} => String
    #   * {Types::VirtualInterface#customer_router_config #customer_router_config} => String
    #   * {Types::VirtualInterface#mtu #mtu} => Integer
    #   * {Types::VirtualInterface#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::VirtualInterface#virtual_gateway_id #virtual_gateway_id} => String
    #   * {Types::VirtualInterface#direct_connect_gateway_id #direct_connect_gateway_id} => String
    #   * {Types::VirtualInterface#route_filter_prefixes #route_filter_prefixes} => Array&lt;Types::RouteFilterPrefix&gt;
    #   * {Types::VirtualInterface#bgp_peers #bgp_peers} => Array&lt;Types::BGPPeer&gt;
    #   * {Types::VirtualInterface#region #region} => String
    #   * {Types::VirtualInterface#aws_device_v2 #aws_device_v2} => String
    #   * {Types::VirtualInterface#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::VirtualInterface#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::VirtualInterface#site_link_enabled #site_link_enabled} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_private_virtual_interface({
    #     connection_id: "ConnectionId", # required
    #     new_private_virtual_interface: { # required
    #       virtual_interface_name: "VirtualInterfaceName", # required
    #       vlan: 1, # required
    #       asn: 1,
    #       asn_long: 1,
    #       mtu: 1,
    #       auth_key: "BGPAuthKey",
    #       amazon_address: "AmazonAddress",
    #       customer_address: "CustomerAddress",
    #       address_family: "ipv4", # accepts ipv4, ipv6
    #       virtual_gateway_id: "VirtualGatewayId",
    #       direct_connect_gateway_id: "DirectConnectGatewayId",
    #       tags: [
    #         {
    #           key: "TagKey", # required
    #           value: "TagValue",
    #         },
    #       ],
    #       enable_site_link: false,
    #     },
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.virtual_interface_id #=> String
    #   resp.location #=> String
    #   resp.connection_id #=> String
    #   resp.virtual_interface_type #=> String
    #   resp.virtual_interface_name #=> String
    #   resp.vlan #=> Integer
    #   resp.asn #=> Integer
    #   resp.asn_long #=> Integer
    #   resp.amazon_side_asn #=> Integer
    #   resp.auth_key #=> String
    #   resp.amazon_address #=> String
    #   resp.customer_address #=> String
    #   resp.address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.customer_router_config #=> String
    #   resp.mtu #=> Integer
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_id #=> String
    #   resp.route_filter_prefixes #=> Array
    #   resp.route_filter_prefixes[0].cidr #=> String
    #   resp.bgp_peers #=> Array
    #   resp.bgp_peers[0].bgp_peer_id #=> String
    #   resp.bgp_peers[0].asn #=> Integer
    #   resp.bgp_peers[0].asn_long #=> Integer
    #   resp.bgp_peers[0].auth_key #=> String
    #   resp.bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.bgp_peers[0].amazon_address #=> String
    #   resp.bgp_peers[0].customer_address #=> String
    #   resp.bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.bgp_peers[0].aws_device_v2 #=> String
    #   resp.bgp_peers[0].aws_logical_device_id #=> String
    #   resp.region #=> String
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.site_link_enabled #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreatePrivateVirtualInterface AWS API Documentation
    #
    # @overload create_private_virtual_interface(params = {})
    # @param [Hash] params ({})
    def create_private_virtual_interface(params = {}, options = {})
      req = build_request(:create_private_virtual_interface, params)
      req.send_request(options)
    end

    # Creates a public virtual interface. A virtual interface is the VLAN
    # that transports Direct Connect traffic. A public virtual interface
    # supports sending traffic to public services of Amazon Web Services
    # such as Amazon S3.
    #
    # When creating an IPv6 public virtual interface (`addressFamily` is
    # `ipv6`), leave the `customer` and `amazon` address fields blank to use
    # auto-assigned IPv6 space. Custom IPv6 addresses are not supported.
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection.
    #
    # @option params [required, Types::NewPublicVirtualInterface] :new_public_virtual_interface
    #   Information about the public virtual interface.
    #
    # @return [Types::VirtualInterface] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::VirtualInterface#owner_account #owner_account} => String
    #   * {Types::VirtualInterface#virtual_interface_id #virtual_interface_id} => String
    #   * {Types::VirtualInterface#location #location} => String
    #   * {Types::VirtualInterface#connection_id #connection_id} => String
    #   * {Types::VirtualInterface#virtual_interface_type #virtual_interface_type} => String
    #   * {Types::VirtualInterface#virtual_interface_name #virtual_interface_name} => String
    #   * {Types::VirtualInterface#vlan #vlan} => Integer
    #   * {Types::VirtualInterface#asn #asn} => Integer
    #   * {Types::VirtualInterface#asn_long #asn_long} => Integer
    #   * {Types::VirtualInterface#amazon_side_asn #amazon_side_asn} => Integer
    #   * {Types::VirtualInterface#auth_key #auth_key} => String
    #   * {Types::VirtualInterface#amazon_address #amazon_address} => String
    #   * {Types::VirtualInterface#customer_address #customer_address} => String
    #   * {Types::VirtualInterface#address_family #address_family} => String
    #   * {Types::VirtualInterface#virtual_interface_state #virtual_interface_state} => String
    #   * {Types::VirtualInterface#customer_router_config #customer_router_config} => String
    #   * {Types::VirtualInterface#mtu #mtu} => Integer
    #   * {Types::VirtualInterface#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::VirtualInterface#virtual_gateway_id #virtual_gateway_id} => String
    #   * {Types::VirtualInterface#direct_connect_gateway_id #direct_connect_gateway_id} => String
    #   * {Types::VirtualInterface#route_filter_prefixes #route_filter_prefixes} => Array&lt;Types::RouteFilterPrefix&gt;
    #   * {Types::VirtualInterface#bgp_peers #bgp_peers} => Array&lt;Types::BGPPeer&gt;
    #   * {Types::VirtualInterface#region #region} => String
    #   * {Types::VirtualInterface#aws_device_v2 #aws_device_v2} => String
    #   * {Types::VirtualInterface#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::VirtualInterface#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::VirtualInterface#site_link_enabled #site_link_enabled} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_public_virtual_interface({
    #     connection_id: "ConnectionId", # required
    #     new_public_virtual_interface: { # required
    #       virtual_interface_name: "VirtualInterfaceName", # required
    #       vlan: 1, # required
    #       asn: 1,
    #       asn_long: 1,
    #       auth_key: "BGPAuthKey",
    #       amazon_address: "AmazonAddress",
    #       customer_address: "CustomerAddress",
    #       address_family: "ipv4", # accepts ipv4, ipv6
    #       route_filter_prefixes: [
    #         {
    #           cidr: "CIDR",
    #         },
    #       ],
    #       tags: [
    #         {
    #           key: "TagKey", # required
    #           value: "TagValue",
    #         },
    #       ],
    #     },
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.virtual_interface_id #=> String
    #   resp.location #=> String
    #   resp.connection_id #=> String
    #   resp.virtual_interface_type #=> String
    #   resp.virtual_interface_name #=> String
    #   resp.vlan #=> Integer
    #   resp.asn #=> Integer
    #   resp.asn_long #=> Integer
    #   resp.amazon_side_asn #=> Integer
    #   resp.auth_key #=> String
    #   resp.amazon_address #=> String
    #   resp.customer_address #=> String
    #   resp.address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.customer_router_config #=> String
    #   resp.mtu #=> Integer
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_id #=> String
    #   resp.route_filter_prefixes #=> Array
    #   resp.route_filter_prefixes[0].cidr #=> String
    #   resp.bgp_peers #=> Array
    #   resp.bgp_peers[0].bgp_peer_id #=> String
    #   resp.bgp_peers[0].asn #=> Integer
    #   resp.bgp_peers[0].asn_long #=> Integer
    #   resp.bgp_peers[0].auth_key #=> String
    #   resp.bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.bgp_peers[0].amazon_address #=> String
    #   resp.bgp_peers[0].customer_address #=> String
    #   resp.bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.bgp_peers[0].aws_device_v2 #=> String
    #   resp.bgp_peers[0].aws_logical_device_id #=> String
    #   resp.region #=> String
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.site_link_enabled #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreatePublicVirtualInterface AWS API Documentation
    #
    # @overload create_public_virtual_interface(params = {})
    # @param [Hash] params ({})
    def create_public_virtual_interface(params = {}, options = {})
      req = build_request(:create_public_virtual_interface, params)
      req.send_request(options)
    end

    # Creates a transit virtual interface. A transit virtual interface
    # should be used to access one or more transit gateways associated with
    # Direct Connect gateways. A transit virtual interface enables the
    # connection of multiple VPCs attached to a transit gateway to a Direct
    # Connect gateway.
    #
    # If you associate your transit gateway with one or more Direct Connect
    # gateways, the Autonomous System Number (ASN) used by the transit
    # gateway and the Direct Connect gateway must be different. For example,
    # if you use the default ASN 64512 for both your the transit gateway and
    # Direct Connect gateway, the association request fails.
    #
    # A jumbo MTU value must be either 1500 or 8500. No other values will be
    # accepted. Setting the MTU of a virtual interface to 8500 (jumbo
    # frames) can cause an update to the underlying physical connection if
    # it wasn't updated to support jumbo frames. Updating the connection
    # disrupts network connectivity for all virtual interfaces associated
    # with the connection for up to 30 seconds. To check whether your
    # connection supports jumbo frames, call DescribeConnections. To check
    # whether your virtual interface supports jumbo frames, call
    # DescribeVirtualInterfaces.
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection.
    #
    # @option params [required, Types::NewTransitVirtualInterface] :new_transit_virtual_interface
    #   Information about the transit virtual interface.
    #
    # @return [Types::CreateTransitVirtualInterfaceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::CreateTransitVirtualInterfaceResult#virtual_interface #virtual_interface} => Types::VirtualInterface
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.create_transit_virtual_interface({
    #     connection_id: "ConnectionId", # required
    #     new_transit_virtual_interface: { # required
    #       virtual_interface_name: "VirtualInterfaceName",
    #       vlan: 1,
    #       asn: 1,
    #       asn_long: 1,
    #       mtu: 1,
    #       auth_key: "BGPAuthKey",
    #       amazon_address: "AmazonAddress",
    #       customer_address: "CustomerAddress",
    #       address_family: "ipv4", # accepts ipv4, ipv6
    #       direct_connect_gateway_id: "DirectConnectGatewayId",
    #       tags: [
    #         {
    #           key: "TagKey", # required
    #           value: "TagValue",
    #         },
    #       ],
    #       enable_site_link: false,
    #     },
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface.owner_account #=> String
    #   resp.virtual_interface.virtual_interface_id #=> String
    #   resp.virtual_interface.location #=> String
    #   resp.virtual_interface.connection_id #=> String
    #   resp.virtual_interface.virtual_interface_type #=> String
    #   resp.virtual_interface.virtual_interface_name #=> String
    #   resp.virtual_interface.vlan #=> Integer
    #   resp.virtual_interface.asn #=> Integer
    #   resp.virtual_interface.asn_long #=> Integer
    #   resp.virtual_interface.amazon_side_asn #=> Integer
    #   resp.virtual_interface.auth_key #=> String
    #   resp.virtual_interface.amazon_address #=> String
    #   resp.virtual_interface.customer_address #=> String
    #   resp.virtual_interface.address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.virtual_interface.customer_router_config #=> String
    #   resp.virtual_interface.mtu #=> Integer
    #   resp.virtual_interface.jumbo_frame_capable #=> Boolean
    #   resp.virtual_interface.virtual_gateway_id #=> String
    #   resp.virtual_interface.direct_connect_gateway_id #=> String
    #   resp.virtual_interface.route_filter_prefixes #=> Array
    #   resp.virtual_interface.route_filter_prefixes[0].cidr #=> String
    #   resp.virtual_interface.bgp_peers #=> Array
    #   resp.virtual_interface.bgp_peers[0].bgp_peer_id #=> String
    #   resp.virtual_interface.bgp_peers[0].asn #=> Integer
    #   resp.virtual_interface.bgp_peers[0].asn_long #=> Integer
    #   resp.virtual_interface.bgp_peers[0].auth_key #=> String
    #   resp.virtual_interface.bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface.bgp_peers[0].amazon_address #=> String
    #   resp.virtual_interface.bgp_peers[0].customer_address #=> String
    #   resp.virtual_interface.bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.virtual_interface.bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.virtual_interface.bgp_peers[0].aws_device_v2 #=> String
    #   resp.virtual_interface.bgp_peers[0].aws_logical_device_id #=> String
    #   resp.virtual_interface.region #=> String
    #   resp.virtual_interface.aws_device_v2 #=> String
    #   resp.virtual_interface.aws_logical_device_id #=> String
    #   resp.virtual_interface.tags #=> Array
    #   resp.virtual_interface.tags[0].key #=> String
    #   resp.virtual_interface.tags[0].value #=> String
    #   resp.virtual_interface.site_link_enabled #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/CreateTransitVirtualInterface AWS API Documentation
    #
    # @overload create_transit_virtual_interface(params = {})
    # @param [Hash] params ({})
    def create_transit_virtual_interface(params = {}, options = {})
      req = build_request(:create_transit_virtual_interface, params)
      req.send_request(options)
    end

    # Deletes the specified BGP peer on the specified virtual interface with
    # the specified customer address and ASN.
    #
    # You cannot delete the last BGP peer from a virtual interface.
    #
    # @option params [String] :virtual_interface_id
    #   The ID of the virtual interface.
    #
    # @option params [Integer] :asn
    #   The autonomous system number (ASN). The valid range is from 1 to
    #   2147483646 for Border Gateway Protocol (BGP) configuration. If you
    #   provide a number greater than the maximum, an error is returned. Use
    #   `asnLong` instead.
    #
    #   <note markdown="1"> You can use `asnLong` or `asn`, but not both. We recommend using
    #   `asnLong` as it supports a greater pool of numbers.
    #
    #    * The `asnLong` attribute accepts both ASN and long ASN ranges.
    #
    #   * If you provide a value in the same API call for both `asn` and
    #     `asnLong`, the API will only accept the value for `asnLong`.
    #
    #    </note>
    #
    # @option params [Integer] :asn_long
    #   The long ASN for the BGP peer to be deleted from a Direct Connect
    #   virtual interface. The valid range is from 1 to 4294967294 for BGP
    #   configuration.
    #
    #   <note markdown="1"> You can use `asnLong` or `asn`, but not both. We recommend using
    #   `asnLong` as it supports a greater pool of numbers.
    #
    #    * The `asnLong` attribute accepts both ASN and long ASN ranges.
    #
    #   * If you provide a value in the same API call for both `asn` and
    #     `asnLong`, the API will only accept the value for `asnLong`.
    #
    #    </note>
    #
    # @option params [String] :customer_address
    #   The IP address assigned to the customer interface.
    #
    # @option params [String] :bgp_peer_id
    #   The ID of the BGP peer.
    #
    # @return [Types::DeleteBGPPeerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DeleteBGPPeerResponse#virtual_interface #virtual_interface} => Types::VirtualInterface
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_bgp_peer({
    #     virtual_interface_id: "VirtualInterfaceId",
    #     asn: 1,
    #     asn_long: 1,
    #     customer_address: "CustomerAddress",
    #     bgp_peer_id: "BGPPeerId",
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface.owner_account #=> String
    #   resp.virtual_interface.virtual_interface_id #=> String
    #   resp.virtual_interface.location #=> String
    #   resp.virtual_interface.connection_id #=> String
    #   resp.virtual_interface.virtual_interface_type #=> String
    #   resp.virtual_interface.virtual_interface_name #=> String
    #   resp.virtual_interface.vlan #=> Integer
    #   resp.virtual_interface.asn #=> Integer
    #   resp.virtual_interface.asn_long #=> Integer
    #   resp.virtual_interface.amazon_side_asn #=> Integer
    #   resp.virtual_interface.auth_key #=> String
    #   resp.virtual_interface.amazon_address #=> String
    #   resp.virtual_interface.customer_address #=> String
    #   resp.virtual_interface.address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.virtual_interface.customer_router_config #=> String
    #   resp.virtual_interface.mtu #=> Integer
    #   resp.virtual_interface.jumbo_frame_capable #=> Boolean
    #   resp.virtual_interface.virtual_gateway_id #=> String
    #   resp.virtual_interface.direct_connect_gateway_id #=> String
    #   resp.virtual_interface.route_filter_prefixes #=> Array
    #   resp.virtual_interface.route_filter_prefixes[0].cidr #=> String
    #   resp.virtual_interface.bgp_peers #=> Array
    #   resp.virtual_interface.bgp_peers[0].bgp_peer_id #=> String
    #   resp.virtual_interface.bgp_peers[0].asn #=> Integer
    #   resp.virtual_interface.bgp_peers[0].asn_long #=> Integer
    #   resp.virtual_interface.bgp_peers[0].auth_key #=> String
    #   resp.virtual_interface.bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface.bgp_peers[0].amazon_address #=> String
    #   resp.virtual_interface.bgp_peers[0].customer_address #=> String
    #   resp.virtual_interface.bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.virtual_interface.bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.virtual_interface.bgp_peers[0].aws_device_v2 #=> String
    #   resp.virtual_interface.bgp_peers[0].aws_logical_device_id #=> String
    #   resp.virtual_interface.region #=> String
    #   resp.virtual_interface.aws_device_v2 #=> String
    #   resp.virtual_interface.aws_logical_device_id #=> String
    #   resp.virtual_interface.tags #=> Array
    #   resp.virtual_interface.tags[0].key #=> String
    #   resp.virtual_interface.tags[0].value #=> String
    #   resp.virtual_interface.site_link_enabled #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteBGPPeer AWS API Documentation
    #
    # @overload delete_bgp_peer(params = {})
    # @param [Hash] params ({})
    def delete_bgp_peer(params = {}, options = {})
      req = build_request(:delete_bgp_peer, params)
      req.send_request(options)
    end

    # Deletes the specified connection.
    #
    # Deleting a connection only stops the Direct Connect port hour and data
    # transfer charges. If you are partnering with any third parties to
    # connect with the Direct Connect location, you must cancel your service
    # with them separately.
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection.
    #
    # @return [Types::Connection] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connection#owner_account #owner_account} => String
    #   * {Types::Connection#connection_id #connection_id} => String
    #   * {Types::Connection#connection_name #connection_name} => String
    #   * {Types::Connection#connection_state #connection_state} => String
    #   * {Types::Connection#region #region} => String
    #   * {Types::Connection#location #location} => String
    #   * {Types::Connection#bandwidth #bandwidth} => String
    #   * {Types::Connection#vlan #vlan} => Integer
    #   * {Types::Connection#partner_name #partner_name} => String
    #   * {Types::Connection#loa_issue_time #loa_issue_time} => Time
    #   * {Types::Connection#lag_id #lag_id} => String
    #   * {Types::Connection#aws_device #aws_device} => String
    #   * {Types::Connection#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Connection#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Connection#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Connection#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Connection#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Connection#provider_name #provider_name} => String
    #   * {Types::Connection#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Connection#port_encryption_status #port_encryption_status} => String
    #   * {Types::Connection#encryption_mode #encryption_mode} => String
    #   * {Types::Connection#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #   * {Types::Connection#partner_interconnect_mac_sec_capable #partner_interconnect_mac_sec_capable} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_connection({
    #     connection_id: "ConnectionId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.connection_id #=> String
    #   resp.connection_name #=> String
    #   resp.connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.region #=> String
    #   resp.location #=> String
    #   resp.bandwidth #=> String
    #   resp.vlan #=> Integer
    #   resp.partner_name #=> String
    #   resp.loa_issue_time #=> Time
    #   resp.lag_id #=> String
    #   resp.aws_device #=> String
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.port_encryption_status #=> String
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #   resp.partner_interconnect_mac_sec_capable #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteConnection AWS API Documentation
    #
    # @overload delete_connection(params = {})
    # @param [Hash] params ({})
    def delete_connection(params = {}, options = {})
      req = build_request(:delete_connection, params)
      req.send_request(options)
    end

    # Deletes the specified Direct Connect gateway. You must first delete
    # all virtual interfaces that are attached to the Direct Connect gateway
    # and disassociate all virtual private gateways associated with the
    # Direct Connect gateway.
    #
    # @option params [required, String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @return [Types::DeleteDirectConnectGatewayResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DeleteDirectConnectGatewayResult#direct_connect_gateway #direct_connect_gateway} => Types::DirectConnectGateway
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_direct_connect_gateway({
    #     direct_connect_gateway_id: "DirectConnectGatewayId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway.direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway.direct_connect_gateway_name #=> String
    #   resp.direct_connect_gateway.amazon_side_asn #=> Integer
    #   resp.direct_connect_gateway.owner_account #=> String
    #   resp.direct_connect_gateway.direct_connect_gateway_state #=> String, one of "pending", "available", "deleting", "deleted"
    #   resp.direct_connect_gateway.state_change_error #=> String
    #   resp.direct_connect_gateway.tags #=> Array
    #   resp.direct_connect_gateway.tags[0].key #=> String
    #   resp.direct_connect_gateway.tags[0].value #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteDirectConnectGateway AWS API Documentation
    #
    # @overload delete_direct_connect_gateway(params = {})
    # @param [Hash] params ({})
    def delete_direct_connect_gateway(params = {}, options = {})
      req = build_request(:delete_direct_connect_gateway, params)
      req.send_request(options)
    end

    # Deletes the association between the specified Direct Connect gateway
    # and virtual private gateway.
    #
    # We recommend that you specify the `associationID` to delete the
    # association. Alternatively, if you own virtual gateway and a Direct
    # Connect gateway association, you can specify the `virtualGatewayId`
    # and `directConnectGatewayId` to delete an association.
    #
    # @option params [String] :association_id
    #   The ID of the Direct Connect gateway association.
    #
    # @option params [String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @option params [String] :virtual_gateway_id
    #   The ID of the virtual private gateway.
    #
    # @return [Types::DeleteDirectConnectGatewayAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DeleteDirectConnectGatewayAssociationResult#direct_connect_gateway_association #direct_connect_gateway_association} => Types::DirectConnectGatewayAssociation
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_direct_connect_gateway_association({
    #     association_id: "DirectConnectGatewayAssociationId",
    #     direct_connect_gateway_id: "DirectConnectGatewayId",
    #     virtual_gateway_id: "VirtualGatewayId",
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway_association.direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway_association.direct_connect_gateway_owner_account #=> String
    #   resp.direct_connect_gateway_association.association_state #=> String, one of "associating", "associated", "disassociating", "disassociated", "updating"
    #   resp.direct_connect_gateway_association.state_change_error #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.id #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.type #=> String, one of "virtualPrivateGateway", "transitGateway"
    #   resp.direct_connect_gateway_association.associated_gateway.owner_account #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.region #=> String
    #   resp.direct_connect_gateway_association.association_id #=> String
    #   resp.direct_connect_gateway_association.allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_association.allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.id #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.owner_account #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.attachment_id #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_region #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_owner_account #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteDirectConnectGatewayAssociation AWS API Documentation
    #
    # @overload delete_direct_connect_gateway_association(params = {})
    # @param [Hash] params ({})
    def delete_direct_connect_gateway_association(params = {}, options = {})
      req = build_request(:delete_direct_connect_gateway_association, params)
      req.send_request(options)
    end

    # Deletes the association proposal request between the specified Direct
    # Connect gateway and virtual private gateway or transit gateway.
    #
    # @option params [required, String] :proposal_id
    #   The ID of the proposal.
    #
    # @return [Types::DeleteDirectConnectGatewayAssociationProposalResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DeleteDirectConnectGatewayAssociationProposalResult#direct_connect_gateway_association_proposal #direct_connect_gateway_association_proposal} => Types::DirectConnectGatewayAssociationProposal
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_direct_connect_gateway_association_proposal({
    #     proposal_id: "DirectConnectGatewayAssociationProposalId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway_association_proposal.proposal_id #=> String
    #   resp.direct_connect_gateway_association_proposal.direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway_association_proposal.direct_connect_gateway_owner_account #=> String
    #   resp.direct_connect_gateway_association_proposal.proposal_state #=> String, one of "requested", "accepted", "deleted"
    #   resp.direct_connect_gateway_association_proposal.associated_gateway.id #=> String
    #   resp.direct_connect_gateway_association_proposal.associated_gateway.type #=> String, one of "virtualPrivateGateway", "transitGateway"
    #   resp.direct_connect_gateway_association_proposal.associated_gateway.owner_account #=> String
    #   resp.direct_connect_gateway_association_proposal.associated_gateway.region #=> String
    #   resp.direct_connect_gateway_association_proposal.existing_allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_association_proposal.existing_allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #   resp.direct_connect_gateway_association_proposal.requested_allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_association_proposal.requested_allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteDirectConnectGatewayAssociationProposal AWS API Documentation
    #
    # @overload delete_direct_connect_gateway_association_proposal(params = {})
    # @param [Hash] params ({})
    def delete_direct_connect_gateway_association_proposal(params = {}, options = {})
      req = build_request(:delete_direct_connect_gateway_association_proposal, params)
      req.send_request(options)
    end

    # Deletes the specified interconnect.
    #
    # <note markdown="1"> Intended for use by Direct Connect Partners only.
    #
    #  </note>
    #
    # @option params [required, String] :interconnect_id
    #   The ID of the interconnect.
    #
    # @return [Types::DeleteInterconnectResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DeleteInterconnectResponse#interconnect_state #interconnect_state} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_interconnect({
    #     interconnect_id: "InterconnectId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.interconnect_state #=> String, one of "requested", "pending", "available", "down", "deleting", "deleted", "unknown"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteInterconnect AWS API Documentation
    #
    # @overload delete_interconnect(params = {})
    # @param [Hash] params ({})
    def delete_interconnect(params = {}, options = {})
      req = build_request(:delete_interconnect, params)
      req.send_request(options)
    end

    # Deletes the specified link aggregation group (LAG). You cannot delete
    # a LAG if it has active virtual interfaces or hosted connections.
    #
    # @option params [required, String] :lag_id
    #   The ID of the LAG.
    #
    # @return [Types::Lag] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Lag#connections_bandwidth #connections_bandwidth} => String
    #   * {Types::Lag#number_of_connections #number_of_connections} => Integer
    #   * {Types::Lag#lag_id #lag_id} => String
    #   * {Types::Lag#owner_account #owner_account} => String
    #   * {Types::Lag#lag_name #lag_name} => String
    #   * {Types::Lag#lag_state #lag_state} => String
    #   * {Types::Lag#location #location} => String
    #   * {Types::Lag#region #region} => String
    #   * {Types::Lag#minimum_links #minimum_links} => Integer
    #   * {Types::Lag#aws_device #aws_device} => String
    #   * {Types::Lag#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Lag#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Lag#connections #connections} => Array&lt;Types::Connection&gt;
    #   * {Types::Lag#allows_hosted_connections #allows_hosted_connections} => Boolean
    #   * {Types::Lag#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Lag#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Lag#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Lag#provider_name #provider_name} => String
    #   * {Types::Lag#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Lag#encryption_mode #encryption_mode} => String
    #   * {Types::Lag#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_lag({
    #     lag_id: "LagId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.connections_bandwidth #=> String
    #   resp.number_of_connections #=> Integer
    #   resp.lag_id #=> String
    #   resp.owner_account #=> String
    #   resp.lag_name #=> String
    #   resp.lag_state #=> String, one of "requested", "pending", "available", "down", "deleting", "deleted", "unknown"
    #   resp.location #=> String
    #   resp.region #=> String
    #   resp.minimum_links #=> Integer
    #   resp.aws_device #=> String
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.connections #=> Array
    #   resp.connections[0].owner_account #=> String
    #   resp.connections[0].connection_id #=> String
    #   resp.connections[0].connection_name #=> String
    #   resp.connections[0].connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.connections[0].region #=> String
    #   resp.connections[0].location #=> String
    #   resp.connections[0].bandwidth #=> String
    #   resp.connections[0].vlan #=> Integer
    #   resp.connections[0].partner_name #=> String
    #   resp.connections[0].loa_issue_time #=> Time
    #   resp.connections[0].lag_id #=> String
    #   resp.connections[0].aws_device #=> String
    #   resp.connections[0].jumbo_frame_capable #=> Boolean
    #   resp.connections[0].aws_device_v2 #=> String
    #   resp.connections[0].aws_logical_device_id #=> String
    #   resp.connections[0].has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.connections[0].tags #=> Array
    #   resp.connections[0].tags[0].key #=> String
    #   resp.connections[0].tags[0].value #=> String
    #   resp.connections[0].provider_name #=> String
    #   resp.connections[0].mac_sec_capable #=> Boolean
    #   resp.connections[0].port_encryption_status #=> String
    #   resp.connections[0].encryption_mode #=> String
    #   resp.connections[0].mac_sec_keys #=> Array
    #   resp.connections[0].mac_sec_keys[0].secret_arn #=> String
    #   resp.connections[0].mac_sec_keys[0].ckn #=> String
    #   resp.connections[0].mac_sec_keys[0].state #=> String
    #   resp.connections[0].mac_sec_keys[0].start_on #=> String
    #   resp.connections[0].partner_interconnect_mac_sec_capable #=> Boolean
    #   resp.allows_hosted_connections #=> Boolean
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteLag AWS API Documentation
    #
    # @overload delete_lag(params = {})
    # @param [Hash] params ({})
    def delete_lag(params = {}, options = {})
      req = build_request(:delete_lag, params)
      req.send_request(options)
    end

    # Deletes a virtual interface.
    #
    # @option params [required, String] :virtual_interface_id
    #   The ID of the virtual interface.
    #
    # @return [Types::DeleteVirtualInterfaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DeleteVirtualInterfaceResponse#virtual_interface_state #virtual_interface_state} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.delete_virtual_interface({
    #     virtual_interface_id: "VirtualInterfaceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DeleteVirtualInterface AWS API Documentation
    #
    # @overload delete_virtual_interface(params = {})
    # @param [Hash] params ({})
    def delete_virtual_interface(params = {}, options = {})
      req = build_request(:delete_virtual_interface, params)
      req.send_request(options)
    end

    # <note markdown="1"> Deprecated. Use DescribeLoa instead.
    #
    #  </note>
    #
    # Gets the LOA-CFA for a connection.
    #
    # The Letter of Authorization - Connecting Facility Assignment (LOA-CFA)
    # is a document that your APN partner or service provider uses when
    # establishing your cross connect to Amazon Web Services at the
    # colocation facility. For more information, see [Requesting Cross
    # Connects at Direct Connect Locations][1] in the *Direct Connect User
    # Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection.
    #
    # @option params [String] :provider_name
    #   The name of the APN partner or service provider who establishes
    #   connectivity on your behalf. If you specify this parameter, the
    #   LOA-CFA lists the provider name alongside your company name as the
    #   requester of the cross connect.
    #
    # @option params [String] :loa_content_type
    #   The standard media type for the LOA-CFA document. The only supported
    #   value is application/pdf.
    #
    # @return [Types::DescribeConnectionLoaResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DescribeConnectionLoaResponse#loa #loa} => Types::Loa
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_connection_loa({
    #     connection_id: "ConnectionId", # required
    #     provider_name: "ProviderName",
    #     loa_content_type: "application/pdf", # accepts application/pdf
    #   })
    #
    # @example Response structure
    #
    #   resp.loa.loa_content #=> String
    #   resp.loa.loa_content_type #=> String, one of "application/pdf"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeConnectionLoa AWS API Documentation
    #
    # @overload describe_connection_loa(params = {})
    # @param [Hash] params ({})
    def describe_connection_loa(params = {}, options = {})
      req = build_request(:describe_connection_loa, params)
      req.send_request(options)
    end

    # Displays the specified connection or all connections in this Region.
    #
    # @option params [String] :connection_id
    #   The ID of the connection.
    #
    # @option params [Integer] :max_results
    #   The maximum number of results to return with a single call. To
    #   retrieve the remaining results, make another call with the returned
    #   `nextToken` value.
    #
    #   If `MaxResults` is given a value larger than 100, only 100 results are
    #   returned.
    #
    # @option params [String] :next_token
    #   The token for the next page of results.
    #
    # @return [Types::Connections] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connections#connections #connections} => Array&lt;Types::Connection&gt;
    #   * {Types::Connections#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_connections({
    #     connection_id: "ConnectionId",
    #     max_results: 1,
    #     next_token: "PaginationToken",
    #   })
    #
    # @example Response structure
    #
    #   resp.connections #=> Array
    #   resp.connections[0].owner_account #=> String
    #   resp.connections[0].connection_id #=> String
    #   resp.connections[0].connection_name #=> String
    #   resp.connections[0].connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.connections[0].region #=> String
    #   resp.connections[0].location #=> String
    #   resp.connections[0].bandwidth #=> String
    #   resp.connections[0].vlan #=> Integer
    #   resp.connections[0].partner_name #=> String
    #   resp.connections[0].loa_issue_time #=> Time
    #   resp.connections[0].lag_id #=> String
    #   resp.connections[0].aws_device #=> String
    #   resp.connections[0].jumbo_frame_capable #=> Boolean
    #   resp.connections[0].aws_device_v2 #=> String
    #   resp.connections[0].aws_logical_device_id #=> String
    #   resp.connections[0].has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.connections[0].tags #=> Array
    #   resp.connections[0].tags[0].key #=> String
    #   resp.connections[0].tags[0].value #=> String
    #   resp.connections[0].provider_name #=> String
    #   resp.connections[0].mac_sec_capable #=> Boolean
    #   resp.connections[0].port_encryption_status #=> String
    #   resp.connections[0].encryption_mode #=> String
    #   resp.connections[0].mac_sec_keys #=> Array
    #   resp.connections[0].mac_sec_keys[0].secret_arn #=> String
    #   resp.connections[0].mac_sec_keys[0].ckn #=> String
    #   resp.connections[0].mac_sec_keys[0].state #=> String
    #   resp.connections[0].mac_sec_keys[0].start_on #=> String
    #   resp.connections[0].partner_interconnect_mac_sec_capable #=> Boolean
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeConnections AWS API Documentation
    #
    # @overload describe_connections(params = {})
    # @param [Hash] params ({})
    def describe_connections(params = {}, options = {})
      req = build_request(:describe_connections, params)
      req.send_request(options)
    end

    # <note markdown="1"> Deprecated. Use DescribeHostedConnections instead.
    #
    #  </note>
    #
    # Lists the connections that have been provisioned on the specified
    # interconnect.
    #
    # <note markdown="1"> Intended for use by Direct Connect Partners only.
    #
    #  </note>
    #
    # @option params [required, String] :interconnect_id
    #   The ID of the interconnect.
    #
    # @return [Types::Connections] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connections#connections #connections} => Array&lt;Types::Connection&gt;
    #   * {Types::Connections#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_connections_on_interconnect({
    #     interconnect_id: "InterconnectId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.connections #=> Array
    #   resp.connections[0].owner_account #=> String
    #   resp.connections[0].connection_id #=> String
    #   resp.connections[0].connection_name #=> String
    #   resp.connections[0].connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.connections[0].region #=> String
    #   resp.connections[0].location #=> String
    #   resp.connections[0].bandwidth #=> String
    #   resp.connections[0].vlan #=> Integer
    #   resp.connections[0].partner_name #=> String
    #   resp.connections[0].loa_issue_time #=> Time
    #   resp.connections[0].lag_id #=> String
    #   resp.connections[0].aws_device #=> String
    #   resp.connections[0].jumbo_frame_capable #=> Boolean
    #   resp.connections[0].aws_device_v2 #=> String
    #   resp.connections[0].aws_logical_device_id #=> String
    #   resp.connections[0].has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.connections[0].tags #=> Array
    #   resp.connections[0].tags[0].key #=> String
    #   resp.connections[0].tags[0].value #=> String
    #   resp.connections[0].provider_name #=> String
    #   resp.connections[0].mac_sec_capable #=> Boolean
    #   resp.connections[0].port_encryption_status #=> String
    #   resp.connections[0].encryption_mode #=> String
    #   resp.connections[0].mac_sec_keys #=> Array
    #   resp.connections[0].mac_sec_keys[0].secret_arn #=> String
    #   resp.connections[0].mac_sec_keys[0].ckn #=> String
    #   resp.connections[0].mac_sec_keys[0].state #=> String
    #   resp.connections[0].mac_sec_keys[0].start_on #=> String
    #   resp.connections[0].partner_interconnect_mac_sec_capable #=> Boolean
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeConnectionsOnInterconnect AWS API Documentation
    #
    # @overload describe_connections_on_interconnect(params = {})
    # @param [Hash] params ({})
    def describe_connections_on_interconnect(params = {}, options = {})
      req = build_request(:describe_connections_on_interconnect, params)
      req.send_request(options)
    end

    # Get and view a list of customer agreements, along with their signed
    # status and whether the customer is an NNIPartner, NNIPartnerV2, or a
    # nonPartner.
    #
    # @return [Types::DescribeCustomerMetadataResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DescribeCustomerMetadataResponse#agreements #agreements} => Array&lt;Types::CustomerAgreement&gt;
    #   * {Types::DescribeCustomerMetadataResponse#nni_partner_type #nni_partner_type} => String
    #
    # @example Response structure
    #
    #   resp.agreements #=> Array
    #   resp.agreements[0].agreement_name #=> String
    #   resp.agreements[0].status #=> String
    #   resp.nni_partner_type #=> String, one of "v1", "v2", "nonPartner"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeCustomerMetadata AWS API Documentation
    #
    # @overload describe_customer_metadata(params = {})
    # @param [Hash] params ({})
    def describe_customer_metadata(params = {}, options = {})
      req = build_request(:describe_customer_metadata, params)
      req.send_request(options)
    end

    # Describes one or more association proposals for connection between a
    # virtual private gateway or transit gateway and a Direct Connect
    # gateway.
    #
    # @option params [String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @option params [String] :proposal_id
    #   The ID of the proposal.
    #
    # @option params [String] :associated_gateway_id
    #   The ID of the associated gateway.
    #
    # @option params [Integer] :max_results
    #   The maximum number of results to return with a single call. To
    #   retrieve the remaining results, make another call with the returned
    #   `nextToken` value.
    #
    #   If `MaxResults` is given a value larger than 100, only 100 results are
    #   returned.
    #
    # @option params [String] :next_token
    #   The token for the next page of results.
    #
    # @return [Types::DescribeDirectConnectGatewayAssociationProposalsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DescribeDirectConnectGatewayAssociationProposalsResult#direct_connect_gateway_association_proposals #direct_connect_gateway_association_proposals} => Array&lt;Types::DirectConnectGatewayAssociationProposal&gt;
    #   * {Types::DescribeDirectConnectGatewayAssociationProposalsResult#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_direct_connect_gateway_association_proposals({
    #     direct_connect_gateway_id: "DirectConnectGatewayId",
    #     proposal_id: "DirectConnectGatewayAssociationProposalId",
    #     associated_gateway_id: "AssociatedGatewayId",
    #     max_results: 1,
    #     next_token: "PaginationToken",
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway_association_proposals #=> Array
    #   resp.direct_connect_gateway_association_proposals[0].proposal_id #=> String
    #   resp.direct_connect_gateway_association_proposals[0].direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway_association_proposals[0].direct_connect_gateway_owner_account #=> String
    #   resp.direct_connect_gateway_association_proposals[0].proposal_state #=> String, one of "requested", "accepted", "deleted"
    #   resp.direct_connect_gateway_association_proposals[0].associated_gateway.id #=> String
    #   resp.direct_connect_gateway_association_proposals[0].associated_gateway.type #=> String, one of "virtualPrivateGateway", "transitGateway"
    #   resp.direct_connect_gateway_association_proposals[0].associated_gateway.owner_account #=> String
    #   resp.direct_connect_gateway_association_proposals[0].associated_gateway.region #=> String
    #   resp.direct_connect_gateway_association_proposals[0].existing_allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_association_proposals[0].existing_allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #   resp.direct_connect_gateway_association_proposals[0].requested_allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_association_proposals[0].requested_allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeDirectConnectGatewayAssociationProposals AWS API Documentation
    #
    # @overload describe_direct_connect_gateway_association_proposals(params = {})
    # @param [Hash] params ({})
    def describe_direct_connect_gateway_association_proposals(params = {}, options = {})
      req = build_request(:describe_direct_connect_gateway_association_proposals, params)
      req.send_request(options)
    end

    # Lists the associations between your Direct Connect gateways and
    # virtual private gateways and transit gateways. You must specify one of
    # the following:
    #
    # * A Direct Connect gateway
    #
    #   The response contains all virtual private gateways and transit
    #   gateways associated with the Direct Connect gateway.
    #
    # * A virtual private gateway
    #
    #   The response contains the Direct Connect gateway.
    #
    # * A transit gateway
    #
    #   The response contains the Direct Connect gateway.
    #
    # * A Direct Connect gateway and a virtual private gateway
    #
    #   The response contains the association between the Direct Connect
    #   gateway and virtual private gateway.
    #
    # * A Direct Connect gateway and a transit gateway
    #
    #   The response contains the association between the Direct Connect
    #   gateway and transit gateway.
    #
    # * A Direct Connect gateway and a virtual private gateway
    #
    #   The response contains the association between the Direct Connect
    #   gateway and virtual private gateway.
    #
    # * A Direct Connect gateway association to a Cloud WAN core network
    #
    #   The response contains the Cloud WAN core network ID that the Direct
    #   Connect gateway is associated to.
    #
    # @option params [String] :association_id
    #   The ID of the Direct Connect gateway association.
    #
    # @option params [String] :associated_gateway_id
    #   The ID of the associated gateway.
    #
    # @option params [String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @option params [Integer] :max_results
    #   The maximum number of results to return with a single call. To
    #   retrieve the remaining results, make another call with the returned
    #   `nextToken` value.
    #
    #   If `MaxResults` is given a value larger than 100, only 100 results are
    #   returned.
    #
    # @option params [String] :next_token
    #   The token provided in the previous call to retrieve the next page.
    #
    # @option params [String] :virtual_gateway_id
    #   The ID of the virtual private gateway or transit gateway.
    #
    # @return [Types::DescribeDirectConnectGatewayAssociationsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DescribeDirectConnectGatewayAssociationsResult#direct_connect_gateway_associations #direct_connect_gateway_associations} => Array&lt;Types::DirectConnectGatewayAssociation&gt;
    #   * {Types::DescribeDirectConnectGatewayAssociationsResult#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_direct_connect_gateway_associations({
    #     association_id: "DirectConnectGatewayAssociationId",
    #     associated_gateway_id: "AssociatedGatewayId",
    #     direct_connect_gateway_id: "DirectConnectGatewayId",
    #     max_results: 1,
    #     next_token: "PaginationToken",
    #     virtual_gateway_id: "VirtualGatewayId",
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway_associations #=> Array
    #   resp.direct_connect_gateway_associations[0].direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway_associations[0].direct_connect_gateway_owner_account #=> String
    #   resp.direct_connect_gateway_associations[0].association_state #=> String, one of "associating", "associated", "disassociating", "disassociated", "updating"
    #   resp.direct_connect_gateway_associations[0].state_change_error #=> String
    #   resp.direct_connect_gateway_associations[0].associated_gateway.id #=> String
    #   resp.direct_connect_gateway_associations[0].associated_gateway.type #=> String, one of "virtualPrivateGateway", "transitGateway"
    #   resp.direct_connect_gateway_associations[0].associated_gateway.owner_account #=> String
    #   resp.direct_connect_gateway_associations[0].associated_gateway.region #=> String
    #   resp.direct_connect_gateway_associations[0].association_id #=> String
    #   resp.direct_connect_gateway_associations[0].allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_associations[0].allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #   resp.direct_connect_gateway_associations[0].associated_core_network.id #=> String
    #   resp.direct_connect_gateway_associations[0].associated_core_network.owner_account #=> String
    #   resp.direct_connect_gateway_associations[0].associated_core_network.attachment_id #=> String
    #   resp.direct_connect_gateway_associations[0].virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_associations[0].virtual_gateway_region #=> String
    #   resp.direct_connect_gateway_associations[0].virtual_gateway_owner_account #=> String
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeDirectConnectGatewayAssociations AWS API Documentation
    #
    # @overload describe_direct_connect_gateway_associations(params = {})
    # @param [Hash] params ({})
    def describe_direct_connect_gateway_associations(params = {}, options = {})
      req = build_request(:describe_direct_connect_gateway_associations, params)
      req.send_request(options)
    end

    # Lists the attachments between your Direct Connect gateways and virtual
    # interfaces. You must specify a Direct Connect gateway, a virtual
    # interface, or both. If you specify a Direct Connect gateway, the
    # response contains all virtual interfaces attached to the Direct
    # Connect gateway. If you specify a virtual interface, the response
    # contains all Direct Connect gateways attached to the virtual
    # interface. If you specify both, the response contains the attachment
    # between the Direct Connect gateway and the virtual interface.
    #
    # @option params [String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @option params [String] :virtual_interface_id
    #   The ID of the virtual interface.
    #
    # @option params [Integer] :max_results
    #   The maximum number of results to return with a single call. To
    #   retrieve the remaining results, make another call with the returned
    #   `nextToken` value.
    #
    #   If `MaxResults` is given a value larger than 100, only 100 results are
    #   returned.
    #
    # @option params [String] :next_token
    #   The token provided in the previous call to retrieve the next page.
    #
    # @return [Types::DescribeDirectConnectGatewayAttachmentsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DescribeDirectConnectGatewayAttachmentsResult#direct_connect_gateway_attachments #direct_connect_gateway_attachments} => Array&lt;Types::DirectConnectGatewayAttachment&gt;
    #   * {Types::DescribeDirectConnectGatewayAttachmentsResult#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_direct_connect_gateway_attachments({
    #     direct_connect_gateway_id: "DirectConnectGatewayId",
    #     virtual_interface_id: "VirtualInterfaceId",
    #     max_results: 1,
    #     next_token: "PaginationToken",
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway_attachments #=> Array
    #   resp.direct_connect_gateway_attachments[0].direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway_attachments[0].virtual_interface_id #=> String
    #   resp.direct_connect_gateway_attachments[0].virtual_interface_region #=> String
    #   resp.direct_connect_gateway_attachments[0].virtual_interface_owner_account #=> String
    #   resp.direct_connect_gateway_attachments[0].attachment_state #=> String, one of "attaching", "attached", "detaching", "detached"
    #   resp.direct_connect_gateway_attachments[0].attachment_type #=> String, one of "TransitVirtualInterface", "PrivateVirtualInterface"
    #   resp.direct_connect_gateway_attachments[0].state_change_error #=> String
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeDirectConnectGatewayAttachments AWS API Documentation
    #
    # @overload describe_direct_connect_gateway_attachments(params = {})
    # @param [Hash] params ({})
    def describe_direct_connect_gateway_attachments(params = {}, options = {})
      req = build_request(:describe_direct_connect_gateway_attachments, params)
      req.send_request(options)
    end

    # Lists all your Direct Connect gateways or only the specified Direct
    # Connect gateway. Deleted Direct Connect gateways are not returned.
    #
    # @option params [String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway.
    #
    # @option params [Integer] :max_results
    #   The maximum number of results to return with a single call. To
    #   retrieve the remaining results, make another call with the returned
    #   `nextToken` value.
    #
    #   If `MaxResults` is given a value larger than 100, only 100 results are
    #   returned.
    #
    # @option params [String] :next_token
    #   The token provided in the previous call to retrieve the next page.
    #
    # @return [Types::DescribeDirectConnectGatewaysResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DescribeDirectConnectGatewaysResult#direct_connect_gateways #direct_connect_gateways} => Array&lt;Types::DirectConnectGateway&gt;
    #   * {Types::DescribeDirectConnectGatewaysResult#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_direct_connect_gateways({
    #     direct_connect_gateway_id: "DirectConnectGatewayId",
    #     max_results: 1,
    #     next_token: "PaginationToken",
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateways #=> Array
    #   resp.direct_connect_gateways[0].direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateways[0].direct_connect_gateway_name #=> String
    #   resp.direct_connect_gateways[0].amazon_side_asn #=> Integer
    #   resp.direct_connect_gateways[0].owner_account #=> String
    #   resp.direct_connect_gateways[0].direct_connect_gateway_state #=> String, one of "pending", "available", "deleting", "deleted"
    #   resp.direct_connect_gateways[0].state_change_error #=> String
    #   resp.direct_connect_gateways[0].tags #=> Array
    #   resp.direct_connect_gateways[0].tags[0].key #=> String
    #   resp.direct_connect_gateways[0].tags[0].value #=> String
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeDirectConnectGateways AWS API Documentation
    #
    # @overload describe_direct_connect_gateways(params = {})
    # @param [Hash] params ({})
    def describe_direct_connect_gateways(params = {}, options = {})
      req = build_request(:describe_direct_connect_gateways, params)
      req.send_request(options)
    end

    # Lists the hosted connections that have been provisioned on the
    # specified interconnect or link aggregation group (LAG).
    #
    # <note markdown="1"> Intended for use by Direct Connect Partners only.
    #
    #  </note>
    #
    # @option params [required, String] :connection_id
    #   The ID of the interconnect or LAG.
    #
    # @option params [Integer] :max_results
    #   The maximum number of results to return with a single call. To
    #   retrieve the remaining results, make another call with the returned
    #   `nextToken` value.
    #
    #   If `MaxResults` is given a value larger than 100, only 100 results are
    #   returned.
    #
    # @option params [String] :next_token
    #   The token for the next page of results.
    #
    # @return [Types::Connections] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connections#connections #connections} => Array&lt;Types::Connection&gt;
    #   * {Types::Connections#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_hosted_connections({
    #     connection_id: "ConnectionId", # required
    #     max_results: 1,
    #     next_token: "PaginationToken",
    #   })
    #
    # @example Response structure
    #
    #   resp.connections #=> Array
    #   resp.connections[0].owner_account #=> String
    #   resp.connections[0].connection_id #=> String
    #   resp.connections[0].connection_name #=> String
    #   resp.connections[0].connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.connections[0].region #=> String
    #   resp.connections[0].location #=> String
    #   resp.connections[0].bandwidth #=> String
    #   resp.connections[0].vlan #=> Integer
    #   resp.connections[0].partner_name #=> String
    #   resp.connections[0].loa_issue_time #=> Time
    #   resp.connections[0].lag_id #=> String
    #   resp.connections[0].aws_device #=> String
    #   resp.connections[0].jumbo_frame_capable #=> Boolean
    #   resp.connections[0].aws_device_v2 #=> String
    #   resp.connections[0].aws_logical_device_id #=> String
    #   resp.connections[0].has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.connections[0].tags #=> Array
    #   resp.connections[0].tags[0].key #=> String
    #   resp.connections[0].tags[0].value #=> String
    #   resp.connections[0].provider_name #=> String
    #   resp.connections[0].mac_sec_capable #=> Boolean
    #   resp.connections[0].port_encryption_status #=> String
    #   resp.connections[0].encryption_mode #=> String
    #   resp.connections[0].mac_sec_keys #=> Array
    #   resp.connections[0].mac_sec_keys[0].secret_arn #=> String
    #   resp.connections[0].mac_sec_keys[0].ckn #=> String
    #   resp.connections[0].mac_sec_keys[0].state #=> String
    #   resp.connections[0].mac_sec_keys[0].start_on #=> String
    #   resp.connections[0].partner_interconnect_mac_sec_capable #=> Boolean
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeHostedConnections AWS API Documentation
    #
    # @overload describe_hosted_connections(params = {})
    # @param [Hash] params ({})
    def describe_hosted_connections(params = {}, options = {})
      req = build_request(:describe_hosted_connections, params)
      req.send_request(options)
    end

    # <note markdown="1"> Deprecated. Use DescribeLoa instead.
    #
    #  </note>
    #
    # Gets the LOA-CFA for the specified interconnect.
    #
    # The Letter of Authorization - Connecting Facility Assignment (LOA-CFA)
    # is a document that is used when establishing your cross connect to
    # Amazon Web Services at the colocation facility. For more information,
    # see [Requesting Cross Connects at Direct Connect Locations][1] in the
    # *Direct Connect User Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html
    #
    # @option params [required, String] :interconnect_id
    #   The ID of the interconnect.
    #
    # @option params [String] :provider_name
    #   The name of the service provider who establishes connectivity on your
    #   behalf. If you supply this parameter, the LOA-CFA lists the provider
    #   name alongside your company name as the requester of the cross
    #   connect.
    #
    # @option params [String] :loa_content_type
    #   The standard media type for the LOA-CFA document. The only supported
    #   value is application/pdf.
    #
    # @return [Types::DescribeInterconnectLoaResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DescribeInterconnectLoaResponse#loa #loa} => Types::Loa
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_interconnect_loa({
    #     interconnect_id: "InterconnectId", # required
    #     provider_name: "ProviderName",
    #     loa_content_type: "application/pdf", # accepts application/pdf
    #   })
    #
    # @example Response structure
    #
    #   resp.loa.loa_content #=> String
    #   resp.loa.loa_content_type #=> String, one of "application/pdf"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeInterconnectLoa AWS API Documentation
    #
    # @overload describe_interconnect_loa(params = {})
    # @param [Hash] params ({})
    def describe_interconnect_loa(params = {}, options = {})
      req = build_request(:describe_interconnect_loa, params)
      req.send_request(options)
    end

    # Lists the interconnects owned by the Amazon Web Services account or
    # only the specified interconnect.
    #
    # @option params [String] :interconnect_id
    #   The ID of the interconnect.
    #
    # @option params [Integer] :max_results
    #   The maximum number of results to return with a single call. To
    #   retrieve the remaining results, make another call with the returned
    #   `nextToken` value.
    #
    #   If `MaxResults` is given a value larger than 100, only 100 results are
    #   returned.
    #
    # @option params [String] :next_token
    #   The token for the next page of results.
    #
    # @return [Types::Interconnects] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Interconnects#interconnects #interconnects} => Array&lt;Types::Interconnect&gt;
    #   * {Types::Interconnects#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_interconnects({
    #     interconnect_id: "InterconnectId",
    #     max_results: 1,
    #     next_token: "PaginationToken",
    #   })
    #
    # @example Response structure
    #
    #   resp.interconnects #=> Array
    #   resp.interconnects[0].interconnect_id #=> String
    #   resp.interconnects[0].interconnect_name #=> String
    #   resp.interconnects[0].interconnect_state #=> String, one of "requested", "pending", "available", "down", "deleting", "deleted", "unknown"
    #   resp.interconnects[0].region #=> String
    #   resp.interconnects[0].location #=> String
    #   resp.interconnects[0].bandwidth #=> String
    #   resp.interconnects[0].loa_issue_time #=> Time
    #   resp.interconnects[0].lag_id #=> String
    #   resp.interconnects[0].aws_device #=> String
    #   resp.interconnects[0].jumbo_frame_capable #=> Boolean
    #   resp.interconnects[0].aws_device_v2 #=> String
    #   resp.interconnects[0].aws_logical_device_id #=> String
    #   resp.interconnects[0].has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.interconnects[0].tags #=> Array
    #   resp.interconnects[0].tags[0].key #=> String
    #   resp.interconnects[0].tags[0].value #=> String
    #   resp.interconnects[0].provider_name #=> String
    #   resp.interconnects[0].mac_sec_capable #=> Boolean
    #   resp.interconnects[0].port_encryption_status #=> String
    #   resp.interconnects[0].encryption_mode #=> String
    #   resp.interconnects[0].mac_sec_keys #=> Array
    #   resp.interconnects[0].mac_sec_keys[0].secret_arn #=> String
    #   resp.interconnects[0].mac_sec_keys[0].ckn #=> String
    #   resp.interconnects[0].mac_sec_keys[0].state #=> String
    #   resp.interconnects[0].mac_sec_keys[0].start_on #=> String
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeInterconnects AWS API Documentation
    #
    # @overload describe_interconnects(params = {})
    # @param [Hash] params ({})
    def describe_interconnects(params = {}, options = {})
      req = build_request(:describe_interconnects, params)
      req.send_request(options)
    end

    # Describes all your link aggregation groups (LAG) or the specified LAG.
    #
    # @option params [String] :lag_id
    #   The ID of the LAG.
    #
    # @option params [Integer] :max_results
    #   The maximum number of results to return with a single call. To
    #   retrieve the remaining results, make another call with the returned
    #   `nextToken` value.
    #
    #   If `MaxResults` is given a value larger than 100, only 100 results are
    #   returned.
    #
    # @option params [String] :next_token
    #   The token for the next page of results.
    #
    # @return [Types::Lags] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Lags#lags #lags} => Array&lt;Types::Lag&gt;
    #   * {Types::Lags#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_lags({
    #     lag_id: "LagId",
    #     max_results: 1,
    #     next_token: "PaginationToken",
    #   })
    #
    # @example Response structure
    #
    #   resp.lags #=> Array
    #   resp.lags[0].connections_bandwidth #=> String
    #   resp.lags[0].number_of_connections #=> Integer
    #   resp.lags[0].lag_id #=> String
    #   resp.lags[0].owner_account #=> String
    #   resp.lags[0].lag_name #=> String
    #   resp.lags[0].lag_state #=> String, one of "requested", "pending", "available", "down", "deleting", "deleted", "unknown"
    #   resp.lags[0].location #=> String
    #   resp.lags[0].region #=> String
    #   resp.lags[0].minimum_links #=> Integer
    #   resp.lags[0].aws_device #=> String
    #   resp.lags[0].aws_device_v2 #=> String
    #   resp.lags[0].aws_logical_device_id #=> String
    #   resp.lags[0].connections #=> Array
    #   resp.lags[0].connections[0].owner_account #=> String
    #   resp.lags[0].connections[0].connection_id #=> String
    #   resp.lags[0].connections[0].connection_name #=> String
    #   resp.lags[0].connections[0].connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.lags[0].connections[0].region #=> String
    #   resp.lags[0].connections[0].location #=> String
    #   resp.lags[0].connections[0].bandwidth #=> String
    #   resp.lags[0].connections[0].vlan #=> Integer
    #   resp.lags[0].connections[0].partner_name #=> String
    #   resp.lags[0].connections[0].loa_issue_time #=> Time
    #   resp.lags[0].connections[0].lag_id #=> String
    #   resp.lags[0].connections[0].aws_device #=> String
    #   resp.lags[0].connections[0].jumbo_frame_capable #=> Boolean
    #   resp.lags[0].connections[0].aws_device_v2 #=> String
    #   resp.lags[0].connections[0].aws_logical_device_id #=> String
    #   resp.lags[0].connections[0].has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.lags[0].connections[0].tags #=> Array
    #   resp.lags[0].connections[0].tags[0].key #=> String
    #   resp.lags[0].connections[0].tags[0].value #=> String
    #   resp.lags[0].connections[0].provider_name #=> String
    #   resp.lags[0].connections[0].mac_sec_capable #=> Boolean
    #   resp.lags[0].connections[0].port_encryption_status #=> String
    #   resp.lags[0].connections[0].encryption_mode #=> String
    #   resp.lags[0].connections[0].mac_sec_keys #=> Array
    #   resp.lags[0].connections[0].mac_sec_keys[0].secret_arn #=> String
    #   resp.lags[0].connections[0].mac_sec_keys[0].ckn #=> String
    #   resp.lags[0].connections[0].mac_sec_keys[0].state #=> String
    #   resp.lags[0].connections[0].mac_sec_keys[0].start_on #=> String
    #   resp.lags[0].connections[0].partner_interconnect_mac_sec_capable #=> Boolean
    #   resp.lags[0].allows_hosted_connections #=> Boolean
    #   resp.lags[0].jumbo_frame_capable #=> Boolean
    #   resp.lags[0].has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.lags[0].tags #=> Array
    #   resp.lags[0].tags[0].key #=> String
    #   resp.lags[0].tags[0].value #=> String
    #   resp.lags[0].provider_name #=> String
    #   resp.lags[0].mac_sec_capable #=> Boolean
    #   resp.lags[0].encryption_mode #=> String
    #   resp.lags[0].mac_sec_keys #=> Array
    #   resp.lags[0].mac_sec_keys[0].secret_arn #=> String
    #   resp.lags[0].mac_sec_keys[0].ckn #=> String
    #   resp.lags[0].mac_sec_keys[0].state #=> String
    #   resp.lags[0].mac_sec_keys[0].start_on #=> String
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeLags AWS API Documentation
    #
    # @overload describe_lags(params = {})
    # @param [Hash] params ({})
    def describe_lags(params = {}, options = {})
      req = build_request(:describe_lags, params)
      req.send_request(options)
    end

    # Gets the LOA-CFA for a connection, interconnect, or link aggregation
    # group (LAG).
    #
    # The Letter of Authorization - Connecting Facility Assignment (LOA-CFA)
    # is a document that is used when establishing your cross connect to
    # Amazon Web Services at the colocation facility. For more information,
    # see [Requesting Cross Connects at Direct Connect Locations][1] in the
    # *Direct Connect User Guide*.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html
    #
    # @option params [required, String] :connection_id
    #   The ID of a connection, LAG, or interconnect.
    #
    # @option params [String] :provider_name
    #   The name of the service provider who establishes connectivity on your
    #   behalf. If you specify this parameter, the LOA-CFA lists the provider
    #   name alongside your company name as the requester of the cross
    #   connect.
    #
    # @option params [String] :loa_content_type
    #   The standard media type for the LOA-CFA document. The only supported
    #   value is application/pdf.
    #
    # @return [Types::Loa] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Loa#loa_content #loa_content} => String
    #   * {Types::Loa#loa_content_type #loa_content_type} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_loa({
    #     connection_id: "ConnectionId", # required
    #     provider_name: "ProviderName",
    #     loa_content_type: "application/pdf", # accepts application/pdf
    #   })
    #
    # @example Response structure
    #
    #   resp.loa_content #=> String
    #   resp.loa_content_type #=> String, one of "application/pdf"
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeLoa AWS API Documentation
    #
    # @overload describe_loa(params = {})
    # @param [Hash] params ({})
    def describe_loa(params = {}, options = {})
      req = build_request(:describe_loa, params)
      req.send_request(options)
    end

    # Lists the Direct Connect locations in the current Amazon Web Services
    # Region. These are the locations that can be selected when calling
    # CreateConnection or CreateInterconnect.
    #
    # @return [Types::Locations] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Locations#locations #locations} => Array&lt;Types::Location&gt;
    #
    # @example Response structure
    #
    #   resp.locations #=> Array
    #   resp.locations[0].location_code #=> String
    #   resp.locations[0].location_name #=> String
    #   resp.locations[0].region #=> String
    #   resp.locations[0].available_port_speeds #=> Array
    #   resp.locations[0].available_port_speeds[0] #=> String
    #   resp.locations[0].available_providers #=> Array
    #   resp.locations[0].available_providers[0] #=> String
    #   resp.locations[0].available_mac_sec_port_speeds #=> Array
    #   resp.locations[0].available_mac_sec_port_speeds[0] #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeLocations AWS API Documentation
    #
    # @overload describe_locations(params = {})
    # @param [Hash] params ({})
    def describe_locations(params = {}, options = {})
      req = build_request(:describe_locations, params)
      req.send_request(options)
    end

    # Details about the router.
    #
    # @option params [required, String] :virtual_interface_id
    #   The ID of the virtual interface.
    #
    # @option params [String] :router_type_identifier
    #   Identifies the router by a combination of vendor, platform, and
    #   software version. For example,
    #   `CiscoSystemsInc-2900SeriesRouters-IOS124`.
    #
    # @return [Types::DescribeRouterConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DescribeRouterConfigurationResponse#customer_router_config #customer_router_config} => String
    #   * {Types::DescribeRouterConfigurationResponse#router #router} => Types::RouterType
    #   * {Types::DescribeRouterConfigurationResponse#virtual_interface_id #virtual_interface_id} => String
    #   * {Types::DescribeRouterConfigurationResponse#virtual_interface_name #virtual_interface_name} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_router_configuration({
    #     virtual_interface_id: "VirtualInterfaceId", # required
    #     router_type_identifier: "RouterTypeIdentifier",
    #   })
    #
    # @example Response structure
    #
    #   resp.customer_router_config #=> String
    #   resp.router.vendor #=> String
    #   resp.router.platform #=> String
    #   resp.router.software #=> String
    #   resp.router.xslt_template_name #=> String
    #   resp.router.xslt_template_name_for_mac_sec #=> String
    #   resp.router.router_type_identifier #=> String
    #   resp.virtual_interface_id #=> String
    #   resp.virtual_interface_name #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeRouterConfiguration AWS API Documentation
    #
    # @overload describe_router_configuration(params = {})
    # @param [Hash] params ({})
    def describe_router_configuration(params = {}, options = {})
      req = build_request(:describe_router_configuration, params)
      req.send_request(options)
    end

    # Describes the tags associated with the specified Direct Connect
    # resources.
    #
    # @option params [required, Array<String>] :resource_arns
    #   The Amazon Resource Names (ARNs) of the resources.
    #
    # @return [Types::DescribeTagsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DescribeTagsResponse#resource_tags #resource_tags} => Array&lt;Types::ResourceTag&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_tags({
    #     resource_arns: ["ResourceArn"], # required
    #   })
    #
    # @example Response structure
    #
    #   resp.resource_tags #=> Array
    #   resp.resource_tags[0].resource_arn #=> String
    #   resp.resource_tags[0].tags #=> Array
    #   resp.resource_tags[0].tags[0].key #=> String
    #   resp.resource_tags[0].tags[0].value #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeTags AWS API Documentation
    #
    # @overload describe_tags(params = {})
    # @param [Hash] params ({})
    def describe_tags(params = {}, options = {})
      req = build_request(:describe_tags, params)
      req.send_request(options)
    end

    # <note markdown="1"> Deprecated. Use `DescribeVpnGateways` instead. See
    # [DescribeVPNGateways][1] in the *Amazon Elastic Compute Cloud API
    # Reference*.
    #
    #  </note>
    #
    # Lists the virtual private gateways owned by the Amazon Web Services
    # account.
    #
    # You can create one or more Direct Connect private virtual interfaces
    # linked to a virtual private gateway.
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpnGateways.html
    #
    # @return [Types::VirtualGateways] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::VirtualGateways#virtual_gateways #virtual_gateways} => Array&lt;Types::VirtualGateway&gt;
    #
    # @example Response structure
    #
    #   resp.virtual_gateways #=> Array
    #   resp.virtual_gateways[0].virtual_gateway_id #=> String
    #   resp.virtual_gateways[0].virtual_gateway_state #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeVirtualGateways AWS API Documentation
    #
    # @overload describe_virtual_gateways(params = {})
    # @param [Hash] params ({})
    def describe_virtual_gateways(params = {}, options = {})
      req = build_request(:describe_virtual_gateways, params)
      req.send_request(options)
    end

    # Displays all virtual interfaces for an Amazon Web Services account.
    # Virtual interfaces deleted fewer than 15 minutes before you make the
    # request are also returned. If you specify a connection ID, only the
    # virtual interfaces associated with the connection are returned. If you
    # specify a virtual interface ID, then only a single virtual interface
    # is returned.
    #
    # A virtual interface (VLAN) transmits the traffic between the Direct
    # Connect location and the customer network.
    #
    # * If you're using an `asn`, the response includes ASN value in both
    #   the `asn` and `asnLong` fields.
    #
    # * If you're using `asnLong`, the response returns a value of `0`
    #   (zero) for the `asn` attribute because it exceeds the highest ASN
    #   value of 2,147,483,647 that it can support
    #
    # @option params [String] :connection_id
    #   The ID of the connection.
    #
    # @option params [String] :virtual_interface_id
    #   The ID of the virtual interface.
    #
    # @option params [Integer] :max_results
    #   The maximum number of results to return with a single call. To
    #   retrieve the remaining results, make another call with the returned
    #   `nextToken` value.
    #
    #   If `MaxResults` is given a value larger than 100, only 100 results are
    #   returned.
    #
    # @option params [String] :next_token
    #   The token for the next page of results.
    #
    # @return [Types::VirtualInterfaces] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::VirtualInterfaces#virtual_interfaces #virtual_interfaces} => Array&lt;Types::VirtualInterface&gt;
    #   * {Types::VirtualInterfaces#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.describe_virtual_interfaces({
    #     connection_id: "ConnectionId",
    #     virtual_interface_id: "VirtualInterfaceId",
    #     max_results: 1,
    #     next_token: "PaginationToken",
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interfaces #=> Array
    #   resp.virtual_interfaces[0].owner_account #=> String
    #   resp.virtual_interfaces[0].virtual_interface_id #=> String
    #   resp.virtual_interfaces[0].location #=> String
    #   resp.virtual_interfaces[0].connection_id #=> String
    #   resp.virtual_interfaces[0].virtual_interface_type #=> String
    #   resp.virtual_interfaces[0].virtual_interface_name #=> String
    #   resp.virtual_interfaces[0].vlan #=> Integer
    #   resp.virtual_interfaces[0].asn #=> Integer
    #   resp.virtual_interfaces[0].asn_long #=> Integer
    #   resp.virtual_interfaces[0].amazon_side_asn #=> Integer
    #   resp.virtual_interfaces[0].auth_key #=> String
    #   resp.virtual_interfaces[0].amazon_address #=> String
    #   resp.virtual_interfaces[0].customer_address #=> String
    #   resp.virtual_interfaces[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interfaces[0].virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.virtual_interfaces[0].customer_router_config #=> String
    #   resp.virtual_interfaces[0].mtu #=> Integer
    #   resp.virtual_interfaces[0].jumbo_frame_capable #=> Boolean
    #   resp.virtual_interfaces[0].virtual_gateway_id #=> String
    #   resp.virtual_interfaces[0].direct_connect_gateway_id #=> String
    #   resp.virtual_interfaces[0].route_filter_prefixes #=> Array
    #   resp.virtual_interfaces[0].route_filter_prefixes[0].cidr #=> String
    #   resp.virtual_interfaces[0].bgp_peers #=> Array
    #   resp.virtual_interfaces[0].bgp_peers[0].bgp_peer_id #=> String
    #   resp.virtual_interfaces[0].bgp_peers[0].asn #=> Integer
    #   resp.virtual_interfaces[0].bgp_peers[0].asn_long #=> Integer
    #   resp.virtual_interfaces[0].bgp_peers[0].auth_key #=> String
    #   resp.virtual_interfaces[0].bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interfaces[0].bgp_peers[0].amazon_address #=> String
    #   resp.virtual_interfaces[0].bgp_peers[0].customer_address #=> String
    #   resp.virtual_interfaces[0].bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.virtual_interfaces[0].bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.virtual_interfaces[0].bgp_peers[0].aws_device_v2 #=> String
    #   resp.virtual_interfaces[0].bgp_peers[0].aws_logical_device_id #=> String
    #   resp.virtual_interfaces[0].region #=> String
    #   resp.virtual_interfaces[0].aws_device_v2 #=> String
    #   resp.virtual_interfaces[0].aws_logical_device_id #=> String
    #   resp.virtual_interfaces[0].tags #=> Array
    #   resp.virtual_interfaces[0].tags[0].key #=> String
    #   resp.virtual_interfaces[0].tags[0].value #=> String
    #   resp.virtual_interfaces[0].site_link_enabled #=> Boolean
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeVirtualInterfaces AWS API Documentation
    #
    # @overload describe_virtual_interfaces(params = {})
    # @param [Hash] params ({})
    def describe_virtual_interfaces(params = {}, options = {})
      req = build_request(:describe_virtual_interfaces, params)
      req.send_request(options)
    end

    # Disassociates a connection from a link aggregation group (LAG). The
    # connection is interrupted and re-established as a standalone
    # connection (the connection is not deleted; to delete the connection,
    # use the DeleteConnection request). If the LAG has associated virtual
    # interfaces or hosted connections, they remain associated with the LAG.
    # A disassociated connection owned by an Direct Connect Partner is
    # automatically converted to an interconnect.
    #
    # If disassociating the connection would cause the LAG to fall below its
    # setting for minimum number of operational connections, the request
    # fails, except when it's the last member of the LAG. If all
    # connections are disassociated, the LAG continues to exist as an empty
    # LAG with no physical connections.
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection.
    #
    # @option params [required, String] :lag_id
    #   The ID of the LAG.
    #
    # @return [Types::Connection] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connection#owner_account #owner_account} => String
    #   * {Types::Connection#connection_id #connection_id} => String
    #   * {Types::Connection#connection_name #connection_name} => String
    #   * {Types::Connection#connection_state #connection_state} => String
    #   * {Types::Connection#region #region} => String
    #   * {Types::Connection#location #location} => String
    #   * {Types::Connection#bandwidth #bandwidth} => String
    #   * {Types::Connection#vlan #vlan} => Integer
    #   * {Types::Connection#partner_name #partner_name} => String
    #   * {Types::Connection#loa_issue_time #loa_issue_time} => Time
    #   * {Types::Connection#lag_id #lag_id} => String
    #   * {Types::Connection#aws_device #aws_device} => String
    #   * {Types::Connection#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Connection#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Connection#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Connection#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Connection#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Connection#provider_name #provider_name} => String
    #   * {Types::Connection#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Connection#port_encryption_status #port_encryption_status} => String
    #   * {Types::Connection#encryption_mode #encryption_mode} => String
    #   * {Types::Connection#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #   * {Types::Connection#partner_interconnect_mac_sec_capable #partner_interconnect_mac_sec_capable} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.disassociate_connection_from_lag({
    #     connection_id: "ConnectionId", # required
    #     lag_id: "LagId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.connection_id #=> String
    #   resp.connection_name #=> String
    #   resp.connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.region #=> String
    #   resp.location #=> String
    #   resp.bandwidth #=> String
    #   resp.vlan #=> Integer
    #   resp.partner_name #=> String
    #   resp.loa_issue_time #=> Time
    #   resp.lag_id #=> String
    #   resp.aws_device #=> String
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.port_encryption_status #=> String
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #   resp.partner_interconnect_mac_sec_capable #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DisassociateConnectionFromLag AWS API Documentation
    #
    # @overload disassociate_connection_from_lag(params = {})
    # @param [Hash] params ({})
    def disassociate_connection_from_lag(params = {}, options = {})
      req = build_request(:disassociate_connection_from_lag, params)
      req.send_request(options)
    end

    # Removes the association between a MAC Security (MACsec) security key
    # and a Direct Connect connection.
    #
    # @option params [required, String] :connection_id
    #   The ID of the dedicated connection (dxcon-xxxx), interconnect
    #   (dxcon-xxxx), or LAG (dxlag-xxxx).
    #
    #   You can use DescribeConnections, DescribeInterconnects, or
    #   DescribeLags to retrieve connection ID.
    #
    # @option params [required, String] :secret_arn
    #   The Amazon Resource Name (ARN) of the MAC Security (MACsec) secret
    #   key.
    #
    #   You can use DescribeConnections to retrieve the ARN of the MAC
    #   Security (MACsec) secret key.
    #
    # @return [Types::DisassociateMacSecKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::DisassociateMacSecKeyResponse#connection_id #connection_id} => String
    #   * {Types::DisassociateMacSecKeyResponse#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.disassociate_mac_sec_key({
    #     connection_id: "ConnectionId", # required
    #     secret_arn: "SecretARN", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.connection_id #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DisassociateMacSecKey AWS API Documentation
    #
    # @overload disassociate_mac_sec_key(params = {})
    # @param [Hash] params ({})
    def disassociate_mac_sec_key(params = {}, options = {})
      req = build_request(:disassociate_mac_sec_key, params)
      req.send_request(options)
    end

    # Lists the virtual interface failover test history.
    #
    # @option params [String] :test_id
    #   The ID of the virtual interface failover test.
    #
    # @option params [String] :virtual_interface_id
    #   The ID of the virtual interface that was tested.
    #
    # @option params [Array<String>] :bgp_peers
    #   The BGP peers that were placed in the DOWN state during the virtual
    #   interface failover test.
    #
    # @option params [String] :status
    #   The status of the virtual interface failover test.
    #
    # @option params [Integer] :max_results
    #   The maximum number of results to return with a single call. To
    #   retrieve the remaining results, make another call with the returned
    #   `nextToken` value.
    #
    #   If `MaxResults` is given a value larger than 100, only 100 results are
    #   returned.
    #
    # @option params [String] :next_token
    #   The token for the next page of results.
    #
    # @return [Types::ListVirtualInterfaceTestHistoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::ListVirtualInterfaceTestHistoryResponse#virtual_interface_test_history #virtual_interface_test_history} => Array&lt;Types::VirtualInterfaceTestHistory&gt;
    #   * {Types::ListVirtualInterfaceTestHistoryResponse#next_token #next_token} => String
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.list_virtual_interface_test_history({
    #     test_id: "TestId",
    #     virtual_interface_id: "VirtualInterfaceId",
    #     bgp_peers: ["BGPPeerId"],
    #     status: "FailureTestHistoryStatus",
    #     max_results: 1,
    #     next_token: "PaginationToken",
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface_test_history #=> Array
    #   resp.virtual_interface_test_history[0].test_id #=> String
    #   resp.virtual_interface_test_history[0].virtual_interface_id #=> String
    #   resp.virtual_interface_test_history[0].bgp_peers #=> Array
    #   resp.virtual_interface_test_history[0].bgp_peers[0] #=> String
    #   resp.virtual_interface_test_history[0].status #=> String
    #   resp.virtual_interface_test_history[0].owner_account #=> String
    #   resp.virtual_interface_test_history[0].test_duration_in_minutes #=> Integer
    #   resp.virtual_interface_test_history[0].start_time #=> Time
    #   resp.virtual_interface_test_history[0].end_time #=> Time
    #   resp.next_token #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/ListVirtualInterfaceTestHistory AWS API Documentation
    #
    # @overload list_virtual_interface_test_history(params = {})
    # @param [Hash] params ({})
    def list_virtual_interface_test_history(params = {}, options = {})
      req = build_request(:list_virtual_interface_test_history, params)
      req.send_request(options)
    end

    # Starts the virtual interface failover test that verifies your
    # configuration meets your resiliency requirements by placing the BGP
    # peering session in the DOWN state. You can then send traffic to verify
    # that there are no outages.
    #
    # You can run the test on public, private, transit, and hosted virtual
    # interfaces.
    #
    # You can use [ListVirtualInterfaceTestHistory][1] to view the virtual
    # interface test history.
    #
    # If you need to stop the test before the test interval completes, use
    # [StopBgpFailoverTest][2].
    #
    #
    #
    # [1]: https://docs.aws.amazon.com/directconnect/latest/APIReference/API_ListVirtualInterfaceTestHistory.html
    # [2]: https://docs.aws.amazon.com/directconnect/latest/APIReference/API_StopBgpFailoverTest.html
    #
    # @option params [required, String] :virtual_interface_id
    #   The ID of the virtual interface you want to test.
    #
    # @option params [Array<String>] :bgp_peers
    #   The BGP peers to place in the DOWN state.
    #
    # @option params [Integer] :test_duration_in_minutes
    #   The time in minutes that the virtual interface failover test will
    #   last.
    #
    #   Maximum value: 4,320 minutes (72 hours).
    #
    #   Default: 180 minutes (3 hours).
    #
    # @return [Types::StartBgpFailoverTestResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::StartBgpFailoverTestResponse#virtual_interface_test #virtual_interface_test} => Types::VirtualInterfaceTestHistory
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.start_bgp_failover_test({
    #     virtual_interface_id: "VirtualInterfaceId", # required
    #     bgp_peers: ["BGPPeerId"],
    #     test_duration_in_minutes: 1,
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface_test.test_id #=> String
    #   resp.virtual_interface_test.virtual_interface_id #=> String
    #   resp.virtual_interface_test.bgp_peers #=> Array
    #   resp.virtual_interface_test.bgp_peers[0] #=> String
    #   resp.virtual_interface_test.status #=> String
    #   resp.virtual_interface_test.owner_account #=> String
    #   resp.virtual_interface_test.test_duration_in_minutes #=> Integer
    #   resp.virtual_interface_test.start_time #=> Time
    #   resp.virtual_interface_test.end_time #=> Time
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/StartBgpFailoverTest AWS API Documentation
    #
    # @overload start_bgp_failover_test(params = {})
    # @param [Hash] params ({})
    def start_bgp_failover_test(params = {}, options = {})
      req = build_request(:start_bgp_failover_test, params)
      req.send_request(options)
    end

    # Stops the virtual interface failover test.
    #
    # @option params [required, String] :virtual_interface_id
    #   The ID of the virtual interface you no longer want to test.
    #
    # @return [Types::StopBgpFailoverTestResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::StopBgpFailoverTestResponse#virtual_interface_test #virtual_interface_test} => Types::VirtualInterfaceTestHistory
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.stop_bgp_failover_test({
    #     virtual_interface_id: "VirtualInterfaceId", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.virtual_interface_test.test_id #=> String
    #   resp.virtual_interface_test.virtual_interface_id #=> String
    #   resp.virtual_interface_test.bgp_peers #=> Array
    #   resp.virtual_interface_test.bgp_peers[0] #=> String
    #   resp.virtual_interface_test.status #=> String
    #   resp.virtual_interface_test.owner_account #=> String
    #   resp.virtual_interface_test.test_duration_in_minutes #=> Integer
    #   resp.virtual_interface_test.start_time #=> Time
    #   resp.virtual_interface_test.end_time #=> Time
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/StopBgpFailoverTest AWS API Documentation
    #
    # @overload stop_bgp_failover_test(params = {})
    # @param [Hash] params ({})
    def stop_bgp_failover_test(params = {}, options = {})
      req = build_request(:stop_bgp_failover_test, params)
      req.send_request(options)
    end

    # Adds the specified tags to the specified Direct Connect resource. Each
    # resource can have a maximum of 50 tags.
    #
    # Each tag consists of a key and an optional value. If a tag with the
    # same key is already associated with the resource, this action updates
    # its value.
    #
    # @option params [required, String] :resource_arn
    #   The Amazon Resource Name (ARN) of the resource.
    #
    # @option params [required, Array<Types::Tag>] :tags
    #   The tags to add.
    #
    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.tag_resource({
    #     resource_arn: "ResourceArn", # required
    #     tags: [ # required
    #       {
    #         key: "TagKey", # required
    #         value: "TagValue",
    #       },
    #     ],
    #   })
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/TagResource AWS API Documentation
    #
    # @overload tag_resource(params = {})
    # @param [Hash] params ({})
    def tag_resource(params = {}, options = {})
      req = build_request(:tag_resource, params)
      req.send_request(options)
    end

    # Removes one or more tags from the specified Direct Connect resource.
    #
    # @option params [required, String] :resource_arn
    #   The Amazon Resource Name (ARN) of the resource.
    #
    # @option params [required, Array<String>] :tag_keys
    #   The tag keys of the tags to remove.
    #
    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.untag_resource({
    #     resource_arn: "ResourceArn", # required
    #     tag_keys: ["TagKey"], # required
    #   })
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/UntagResource AWS API Documentation
    #
    # @overload untag_resource(params = {})
    # @param [Hash] params ({})
    def untag_resource(params = {}, options = {})
      req = build_request(:untag_resource, params)
      req.send_request(options)
    end

    # Updates the Direct Connect connection configuration.
    #
    # You can update the following parameters for a connection:
    #
    # * The connection name
    #
    # * The connection's MAC Security (MACsec) encryption mode.
    #
    # @option params [required, String] :connection_id
    #   The ID of the connection.
    #
    #   You can use DescribeConnections to retrieve the connection ID.
    #
    # @option params [String] :connection_name
    #   The name of the connection.
    #
    # @option params [String] :encryption_mode
    #   The connection MAC Security (MACsec) encryption mode.
    #
    #   The valid values are `no_encrypt`, `should_encrypt`, and
    #   `must_encrypt`.
    #
    # @return [Types::Connection] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Connection#owner_account #owner_account} => String
    #   * {Types::Connection#connection_id #connection_id} => String
    #   * {Types::Connection#connection_name #connection_name} => String
    #   * {Types::Connection#connection_state #connection_state} => String
    #   * {Types::Connection#region #region} => String
    #   * {Types::Connection#location #location} => String
    #   * {Types::Connection#bandwidth #bandwidth} => String
    #   * {Types::Connection#vlan #vlan} => Integer
    #   * {Types::Connection#partner_name #partner_name} => String
    #   * {Types::Connection#loa_issue_time #loa_issue_time} => Time
    #   * {Types::Connection#lag_id #lag_id} => String
    #   * {Types::Connection#aws_device #aws_device} => String
    #   * {Types::Connection#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Connection#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Connection#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Connection#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Connection#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Connection#provider_name #provider_name} => String
    #   * {Types::Connection#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Connection#port_encryption_status #port_encryption_status} => String
    #   * {Types::Connection#encryption_mode #encryption_mode} => String
    #   * {Types::Connection#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #   * {Types::Connection#partner_interconnect_mac_sec_capable #partner_interconnect_mac_sec_capable} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.update_connection({
    #     connection_id: "ConnectionId", # required
    #     connection_name: "ConnectionName",
    #     encryption_mode: "EncryptionMode",
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.connection_id #=> String
    #   resp.connection_name #=> String
    #   resp.connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.region #=> String
    #   resp.location #=> String
    #   resp.bandwidth #=> String
    #   resp.vlan #=> Integer
    #   resp.partner_name #=> String
    #   resp.loa_issue_time #=> Time
    #   resp.lag_id #=> String
    #   resp.aws_device #=> String
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.port_encryption_status #=> String
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #   resp.partner_interconnect_mac_sec_capable #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/UpdateConnection AWS API Documentation
    #
    # @overload update_connection(params = {})
    # @param [Hash] params ({})
    def update_connection(params = {}, options = {})
      req = build_request(:update_connection, params)
      req.send_request(options)
    end

    # Updates the name of a current Direct Connect gateway.
    #
    # @option params [required, String] :direct_connect_gateway_id
    #   The ID of the Direct Connect gateway to update.
    #
    # @option params [required, String] :new_direct_connect_gateway_name
    #   The new name for the Direct Connect gateway.
    #
    # @return [Types::UpdateDirectConnectGatewayResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::UpdateDirectConnectGatewayResponse#direct_connect_gateway #direct_connect_gateway} => Types::DirectConnectGateway
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.update_direct_connect_gateway({
    #     direct_connect_gateway_id: "DirectConnectGatewayId", # required
    #     new_direct_connect_gateway_name: "DirectConnectGatewayName", # required
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway.direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway.direct_connect_gateway_name #=> String
    #   resp.direct_connect_gateway.amazon_side_asn #=> Integer
    #   resp.direct_connect_gateway.owner_account #=> String
    #   resp.direct_connect_gateway.direct_connect_gateway_state #=> String, one of "pending", "available", "deleting", "deleted"
    #   resp.direct_connect_gateway.state_change_error #=> String
    #   resp.direct_connect_gateway.tags #=> Array
    #   resp.direct_connect_gateway.tags[0].key #=> String
    #   resp.direct_connect_gateway.tags[0].value #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/UpdateDirectConnectGateway AWS API Documentation
    #
    # @overload update_direct_connect_gateway(params = {})
    # @param [Hash] params ({})
    def update_direct_connect_gateway(params = {}, options = {})
      req = build_request(:update_direct_connect_gateway, params)
      req.send_request(options)
    end

    # Updates the specified attributes of the Direct Connect gateway
    # association.
    #
    # Add or remove prefixes from the association.
    #
    # @option params [String] :association_id
    #   The ID of the Direct Connect gateway association.
    #
    # @option params [Array<Types::RouteFilterPrefix>] :add_allowed_prefixes_to_direct_connect_gateway
    #   The Amazon VPC prefixes to advertise to the Direct Connect gateway.
    #
    # @option params [Array<Types::RouteFilterPrefix>] :remove_allowed_prefixes_to_direct_connect_gateway
    #   The Amazon VPC prefixes to no longer advertise to the Direct Connect
    #   gateway.
    #
    # @return [Types::UpdateDirectConnectGatewayAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::UpdateDirectConnectGatewayAssociationResult#direct_connect_gateway_association #direct_connect_gateway_association} => Types::DirectConnectGatewayAssociation
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.update_direct_connect_gateway_association({
    #     association_id: "DirectConnectGatewayAssociationId",
    #     add_allowed_prefixes_to_direct_connect_gateway: [
    #       {
    #         cidr: "CIDR",
    #       },
    #     ],
    #     remove_allowed_prefixes_to_direct_connect_gateway: [
    #       {
    #         cidr: "CIDR",
    #       },
    #     ],
    #   })
    #
    # @example Response structure
    #
    #   resp.direct_connect_gateway_association.direct_connect_gateway_id #=> String
    #   resp.direct_connect_gateway_association.direct_connect_gateway_owner_account #=> String
    #   resp.direct_connect_gateway_association.association_state #=> String, one of "associating", "associated", "disassociating", "disassociated", "updating"
    #   resp.direct_connect_gateway_association.state_change_error #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.id #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.type #=> String, one of "virtualPrivateGateway", "transitGateway"
    #   resp.direct_connect_gateway_association.associated_gateway.owner_account #=> String
    #   resp.direct_connect_gateway_association.associated_gateway.region #=> String
    #   resp.direct_connect_gateway_association.association_id #=> String
    #   resp.direct_connect_gateway_association.allowed_prefixes_to_direct_connect_gateway #=> Array
    #   resp.direct_connect_gateway_association.allowed_prefixes_to_direct_connect_gateway[0].cidr #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.id #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.owner_account #=> String
    #   resp.direct_connect_gateway_association.associated_core_network.attachment_id #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_region #=> String
    #   resp.direct_connect_gateway_association.virtual_gateway_owner_account #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/UpdateDirectConnectGatewayAssociation AWS API Documentation
    #
    # @overload update_direct_connect_gateway_association(params = {})
    # @param [Hash] params ({})
    def update_direct_connect_gateway_association(params = {}, options = {})
      req = build_request(:update_direct_connect_gateway_association, params)
      req.send_request(options)
    end

    # Updates the attributes of the specified link aggregation group (LAG).
    #
    # You can update the following LAG attributes:
    #
    # * The name of the LAG.
    #
    # * The value for the minimum number of connections that must be
    #   operational for the LAG itself to be operational.
    #
    # * The LAG's MACsec encryption mode.
    #
    #   Amazon Web Services assigns this value to each connection which is
    #   part of the LAG.
    #
    # * The tags
    #
    # <note markdown="1"> If you adjust the threshold value for the minimum number of
    # operational connections, ensure that the new value does not cause the
    # LAG to fall below the threshold and become non-operational.
    #
    #  </note>
    #
    # @option params [required, String] :lag_id
    #   The ID of the LAG.
    #
    # @option params [String] :lag_name
    #   The name of the LAG.
    #
    # @option params [Integer] :minimum_links
    #   The minimum number of physical connections that must be operational
    #   for the LAG itself to be operational.
    #
    # @option params [String] :encryption_mode
    #   The LAG MAC Security (MACsec) encryption mode.
    #
    #   Amazon Web Services applies the value to all connections which are
    #   part of the LAG.
    #
    # @return [Types::Lag] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::Lag#connections_bandwidth #connections_bandwidth} => String
    #   * {Types::Lag#number_of_connections #number_of_connections} => Integer
    #   * {Types::Lag#lag_id #lag_id} => String
    #   * {Types::Lag#owner_account #owner_account} => String
    #   * {Types::Lag#lag_name #lag_name} => String
    #   * {Types::Lag#lag_state #lag_state} => String
    #   * {Types::Lag#location #location} => String
    #   * {Types::Lag#region #region} => String
    #   * {Types::Lag#minimum_links #minimum_links} => Integer
    #   * {Types::Lag#aws_device #aws_device} => String
    #   * {Types::Lag#aws_device_v2 #aws_device_v2} => String
    #   * {Types::Lag#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::Lag#connections #connections} => Array&lt;Types::Connection&gt;
    #   * {Types::Lag#allows_hosted_connections #allows_hosted_connections} => Boolean
    #   * {Types::Lag#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::Lag#has_logical_redundancy #has_logical_redundancy} => String
    #   * {Types::Lag#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::Lag#provider_name #provider_name} => String
    #   * {Types::Lag#mac_sec_capable #mac_sec_capable} => Boolean
    #   * {Types::Lag#encryption_mode #encryption_mode} => String
    #   * {Types::Lag#mac_sec_keys #mac_sec_keys} => Array&lt;Types::MacSecKey&gt;
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.update_lag({
    #     lag_id: "LagId", # required
    #     lag_name: "LagName",
    #     minimum_links: 1,
    #     encryption_mode: "EncryptionMode",
    #   })
    #
    # @example Response structure
    #
    #   resp.connections_bandwidth #=> String
    #   resp.number_of_connections #=> Integer
    #   resp.lag_id #=> String
    #   resp.owner_account #=> String
    #   resp.lag_name #=> String
    #   resp.lag_state #=> String, one of "requested", "pending", "available", "down", "deleting", "deleted", "unknown"
    #   resp.location #=> String
    #   resp.region #=> String
    #   resp.minimum_links #=> Integer
    #   resp.aws_device #=> String
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.connections #=> Array
    #   resp.connections[0].owner_account #=> String
    #   resp.connections[0].connection_id #=> String
    #   resp.connections[0].connection_name #=> String
    #   resp.connections[0].connection_state #=> String, one of "ordering", "requested", "pending", "available", "down", "deleting", "deleted", "rejected", "unknown"
    #   resp.connections[0].region #=> String
    #   resp.connections[0].location #=> String
    #   resp.connections[0].bandwidth #=> String
    #   resp.connections[0].vlan #=> Integer
    #   resp.connections[0].partner_name #=> String
    #   resp.connections[0].loa_issue_time #=> Time
    #   resp.connections[0].lag_id #=> String
    #   resp.connections[0].aws_device #=> String
    #   resp.connections[0].jumbo_frame_capable #=> Boolean
    #   resp.connections[0].aws_device_v2 #=> String
    #   resp.connections[0].aws_logical_device_id #=> String
    #   resp.connections[0].has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.connections[0].tags #=> Array
    #   resp.connections[0].tags[0].key #=> String
    #   resp.connections[0].tags[0].value #=> String
    #   resp.connections[0].provider_name #=> String
    #   resp.connections[0].mac_sec_capable #=> Boolean
    #   resp.connections[0].port_encryption_status #=> String
    #   resp.connections[0].encryption_mode #=> String
    #   resp.connections[0].mac_sec_keys #=> Array
    #   resp.connections[0].mac_sec_keys[0].secret_arn #=> String
    #   resp.connections[0].mac_sec_keys[0].ckn #=> String
    #   resp.connections[0].mac_sec_keys[0].state #=> String
    #   resp.connections[0].mac_sec_keys[0].start_on #=> String
    #   resp.connections[0].partner_interconnect_mac_sec_capable #=> Boolean
    #   resp.allows_hosted_connections #=> Boolean
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.has_logical_redundancy #=> String, one of "unknown", "yes", "no"
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.provider_name #=> String
    #   resp.mac_sec_capable #=> Boolean
    #   resp.encryption_mode #=> String
    #   resp.mac_sec_keys #=> Array
    #   resp.mac_sec_keys[0].secret_arn #=> String
    #   resp.mac_sec_keys[0].ckn #=> String
    #   resp.mac_sec_keys[0].state #=> String
    #   resp.mac_sec_keys[0].start_on #=> String
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/UpdateLag AWS API Documentation
    #
    # @overload update_lag(params = {})
    # @param [Hash] params ({})
    def update_lag(params = {}, options = {})
      req = build_request(:update_lag, params)
      req.send_request(options)
    end

    # Updates the specified attributes of the specified virtual private
    # interface.
    #
    # Setting the MTU of a virtual interface to 8500 (jumbo frames) can
    # cause an update to the underlying physical connection if it wasn't
    # updated to support jumbo frames. Updating the connection disrupts
    # network connectivity for all virtual interfaces associated with the
    # connection for up to 30 seconds. To check whether your connection
    # supports jumbo frames, call DescribeConnections. To check whether your
    # virtual interface supports jumbo frames, call
    # DescribeVirtualInterfaces.
    #
    # @option params [required, String] :virtual_interface_id
    #   The ID of the virtual private interface.
    #
    # @option params [Integer] :mtu
    #   The maximum transmission unit (MTU), in bytes. The supported values
    #   are 1500 and 8500. The default value is 1500.
    #
    # @option params [Boolean] :enable_site_link
    #   Indicates whether to enable or disable SiteLink.
    #
    # @option params [String] :virtual_interface_name
    #   The name of the virtual private interface.
    #
    # @return [Types::VirtualInterface] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
    #
    #   * {Types::VirtualInterface#owner_account #owner_account} => String
    #   * {Types::VirtualInterface#virtual_interface_id #virtual_interface_id} => String
    #   * {Types::VirtualInterface#location #location} => String
    #   * {Types::VirtualInterface#connection_id #connection_id} => String
    #   * {Types::VirtualInterface#virtual_interface_type #virtual_interface_type} => String
    #   * {Types::VirtualInterface#virtual_interface_name #virtual_interface_name} => String
    #   * {Types::VirtualInterface#vlan #vlan} => Integer
    #   * {Types::VirtualInterface#asn #asn} => Integer
    #   * {Types::VirtualInterface#asn_long #asn_long} => Integer
    #   * {Types::VirtualInterface#amazon_side_asn #amazon_side_asn} => Integer
    #   * {Types::VirtualInterface#auth_key #auth_key} => String
    #   * {Types::VirtualInterface#amazon_address #amazon_address} => String
    #   * {Types::VirtualInterface#customer_address #customer_address} => String
    #   * {Types::VirtualInterface#address_family #address_family} => String
    #   * {Types::VirtualInterface#virtual_interface_state #virtual_interface_state} => String
    #   * {Types::VirtualInterface#customer_router_config #customer_router_config} => String
    #   * {Types::VirtualInterface#mtu #mtu} => Integer
    #   * {Types::VirtualInterface#jumbo_frame_capable #jumbo_frame_capable} => Boolean
    #   * {Types::VirtualInterface#virtual_gateway_id #virtual_gateway_id} => String
    #   * {Types::VirtualInterface#direct_connect_gateway_id #direct_connect_gateway_id} => String
    #   * {Types::VirtualInterface#route_filter_prefixes #route_filter_prefixes} => Array&lt;Types::RouteFilterPrefix&gt;
    #   * {Types::VirtualInterface#bgp_peers #bgp_peers} => Array&lt;Types::BGPPeer&gt;
    #   * {Types::VirtualInterface#region #region} => String
    #   * {Types::VirtualInterface#aws_device_v2 #aws_device_v2} => String
    #   * {Types::VirtualInterface#aws_logical_device_id #aws_logical_device_id} => String
    #   * {Types::VirtualInterface#tags #tags} => Array&lt;Types::Tag&gt;
    #   * {Types::VirtualInterface#site_link_enabled #site_link_enabled} => Boolean
    #
    # @example Request syntax with placeholder values
    #
    #   resp = client.update_virtual_interface_attributes({
    #     virtual_interface_id: "VirtualInterfaceId", # required
    #     mtu: 1,
    #     enable_site_link: false,
    #     virtual_interface_name: "VirtualInterfaceName",
    #   })
    #
    # @example Response structure
    #
    #   resp.owner_account #=> String
    #   resp.virtual_interface_id #=> String
    #   resp.location #=> String
    #   resp.connection_id #=> String
    #   resp.virtual_interface_type #=> String
    #   resp.virtual_interface_name #=> String
    #   resp.vlan #=> Integer
    #   resp.asn #=> Integer
    #   resp.asn_long #=> Integer
    #   resp.amazon_side_asn #=> Integer
    #   resp.auth_key #=> String
    #   resp.amazon_address #=> String
    #   resp.customer_address #=> String
    #   resp.address_family #=> String, one of "ipv4", "ipv6"
    #   resp.virtual_interface_state #=> String, one of "confirming", "verifying", "pending", "available", "down", "testing", "deleting", "deleted", "rejected", "unknown"
    #   resp.customer_router_config #=> String
    #   resp.mtu #=> Integer
    #   resp.jumbo_frame_capable #=> Boolean
    #   resp.virtual_gateway_id #=> String
    #   resp.direct_connect_gateway_id #=> String
    #   resp.route_filter_prefixes #=> Array
    #   resp.route_filter_prefixes[0].cidr #=> String
    #   resp.bgp_peers #=> Array
    #   resp.bgp_peers[0].bgp_peer_id #=> String
    #   resp.bgp_peers[0].asn #=> Integer
    #   resp.bgp_peers[0].asn_long #=> Integer
    #   resp.bgp_peers[0].auth_key #=> String
    #   resp.bgp_peers[0].address_family #=> String, one of "ipv4", "ipv6"
    #   resp.bgp_peers[0].amazon_address #=> String
    #   resp.bgp_peers[0].customer_address #=> String
    #   resp.bgp_peers[0].bgp_peer_state #=> String, one of "verifying", "pending", "available", "deleting", "deleted"
    #   resp.bgp_peers[0].bgp_status #=> String, one of "up", "down", "unknown"
    #   resp.bgp_peers[0].aws_device_v2 #=> String
    #   resp.bgp_peers[0].aws_logical_device_id #=> String
    #   resp.region #=> String
    #   resp.aws_device_v2 #=> String
    #   resp.aws_logical_device_id #=> String
    #   resp.tags #=> Array
    #   resp.tags[0].key #=> String
    #   resp.tags[0].value #=> String
    #   resp.site_link_enabled #=> Boolean
    #
    # @see http://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/UpdateVirtualInterfaceAttributes AWS API Documentation
    #
    # @overload update_virtual_interface_attributes(params = {})
    # @param [Hash] params ({})
    def update_virtual_interface_attributes(params = {}, options = {})
      req = build_request(:update_virtual_interface_attributes, 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::DirectConnect')
      )
      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-directconnect'
      context[:gem_version] = '1.99.0'
      Seahorse::Client::Request.new(handlers, context)
    end

    # @api private
    # @deprecated
    def waiter_names
      []
    end

    class << self

      # @api private
      attr_reader :identifier

      # @api private
      def errors_module
        Errors
      end

    end
  end
end
