Skip to content

Client

directconnect R Documentation

AWS Direct Connect

Description

Direct Connect 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. With this connection in place, you can create virtual interfaces directly to the Amazon Web Services Cloud (for example, to Amazon EC2 and Amazon S3) and to Amazon VPC, bypassing Internet service providers in your network path. A connection provides access to all Amazon Web Services Regions except the China (Beijing) and (China) Ningxia Regions. Amazon Web Services resources in the China Regions can only be accessed through locations associated with those Regions.

Usage

directconnect(
  config = list(),
  credentials = list(),
  endpoint = NULL,
  region = NULL
)

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

  • endpoint: The complete URL to use for the constructed client.

  • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. ⁠http://s3.amazonaws.com/BUCKET/KEY⁠.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- directconnect(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

accept_direct_connect_gateway_association_proposal
Accepts a proposal request to attach a virtual private gateway or transit gateway to a Direct Connect gateway
allocate_connection_on_interconnect
Deprecated
allocate_hosted_connection
Creates a hosted connection on the specified interconnect or a link aggregation group (LAG) of interconnects
allocate_private_virtual_interface
Provisions a private virtual interface to be owned by the specified Amazon Web Services account
allocate_public_virtual_interface
Provisions a public virtual interface to be owned by the specified Amazon Web Services account
allocate_transit_virtual_interface
Provisions a transit virtual interface to be owned by the specified Amazon Web Services account
associate_connection_with_lag
Associates an existing connection with a link aggregation group (LAG)
associate_hosted_connection
Associates a hosted connection and its virtual interfaces with a link aggregation group (LAG) or interconnect
associate_mac_sec_key
Associates a MAC Security (MACsec) Connection Key Name (CKN)/ Connectivity Association Key (CAK) pair with an Direct Connect dedicated connection
associate_virtual_interface
Associates a virtual interface with a specified link aggregation group (LAG) or connection
confirm_connection
Confirms the creation of the specified hosted connection on an interconnect
confirm_customer_agreement
The confirmation of the terms of agreement when creating the connection/link aggregation group (LAG)
confirm_private_virtual_interface
Accepts ownership of a private virtual interface created by another Amazon Web Services account
confirm_public_virtual_interface
Accepts ownership of a public virtual interface created by another Amazon Web Services account
confirm_transit_virtual_interface
Accepts ownership of a transit virtual interface created by another Amazon Web Services account
create_bgp_peer
Creates a BGP peer on the specified virtual interface
create_connection
Creates a connection between a customer network and a specific Direct Connect location
create_direct_connect_gateway
Creates a Direct Connect gateway, which is an intermediate object that enables you to connect a set of virtual interfaces and virtual private gateways
create_direct_connect_gateway_association
Creates an association between a Direct Connect gateway and a virtual private gateway
create_direct_connect_gateway_association_proposal
Creates a proposal to associate the specified virtual private gateway or transit gateway with the specified Direct Connect gateway
create_interconnect
Creates an interconnect between an Direct Connect Partner's network and a specific Direct Connect location
create_lag
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
create_private_virtual_interface
Creates a private virtual interface
create_public_virtual_interface
Creates a public virtual interface
create_transit_virtual_interface
Creates a transit virtual interface
delete_bgp_peer
Deletes the specified BGP peer on the specified virtual interface with the specified customer address and ASN
delete_connection
Deletes the specified connection
delete_direct_connect_gateway
Deletes the specified Direct Connect gateway
delete_direct_connect_gateway_association
Deletes the association between the specified Direct Connect gateway and virtual private gateway
delete_direct_connect_gateway_association_proposal
Deletes the association proposal request between the specified Direct Connect gateway and virtual private gateway or transit gateway
delete_interconnect
Deletes the specified interconnect
delete_lag
Deletes the specified link aggregation group (LAG)
delete_virtual_interface
Deletes a virtual interface
describe_connection_loa
Deprecated
describe_connections
Displays the specified connection or all connections in this Region
describe_connections_on_interconnect
Deprecated
describe_customer_metadata
Get and view a list of customer agreements, along with their signed status and whether the customer is an NNIPartner, NNIPartnerV2, or a nonPartner
describe_direct_connect_gateway_association_proposals
Describes one or more association proposals for connection between a virtual private gateway or transit gateway and a Direct Connect gateway
describe_direct_connect_gateway_associations
Lists the associations between your Direct Connect gateways and virtual private gateways and transit gateways
describe_direct_connect_gateway_attachments
Lists the attachments between your Direct Connect gateways and virtual interfaces
describe_direct_connect_gateways
Lists all your Direct Connect gateways or only the specified Direct Connect gateway
describe_hosted_connections
Lists the hosted connections that have been provisioned on the specified interconnect or link aggregation group (LAG)
describe_interconnect_loa
Deprecated
describe_interconnects
Lists the interconnects owned by the Amazon Web Services account or only the specified interconnect
describe_lags
Describes all your link aggregation groups (LAG) or the specified LAG
describe_loa
Gets the LOA-CFA for a connection, interconnect, or link aggregation group (LAG)
describe_locations
Lists the Direct Connect locations in the current Amazon Web Services Region
describe_router_configuration
Details about the router
describe_tags
Describes the tags associated with the specified Direct Connect resources
describe_virtual_gateways
Deprecated
describe_virtual_interfaces
Displays all virtual interfaces for an Amazon Web Services account
disassociate_connection_from_lag
Disassociates a connection from a link aggregation group (LAG)
disassociate_mac_sec_key
Removes the association between a MAC Security (MACsec) security key and an Direct Connect dedicated connection
list_virtual_interface_test_history
Lists the virtual interface failover test history
start_bgp_failover_test
Starts the virtual interface failover test that verifies your configuration meets your resiliency requirements by placing the BGP peering session in the DOWN state
stop_bgp_failover_test
Stops the virtual interface failover test
tag_resource
Adds the specified tags to the specified Direct Connect resource
untag_resource
Removes one or more tags from the specified Direct Connect resource
update_connection
Updates the Direct Connect dedicated connection configuration
update_direct_connect_gateway
Updates the name of a current Direct Connect gateway
update_direct_connect_gateway_association
Updates the specified attributes of the Direct Connect gateway association
update_lag
Updates the attributes of the specified link aggregation group (LAG)
update_virtual_interface_attributes
Updates the specified attributes of the specified virtual private interface

Examples

## Not run: 
svc <- directconnect()
svc$accept_direct_connect_gateway_association_proposal(
  Foo = 123
)

## End(Not run)