directconnect

package
v1.4.17 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 13, 2016 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Overview

Package directconnect provides a client for AWS Direct Connect.

Index

Examples

Constants

View Source 
const (
	// ConnectionStateOrdering is a ConnectionState enum value
	ConnectionStateOrdering = "ordering"

	// ConnectionStateRequested is a ConnectionState enum value
	ConnectionStateRequested = "requested"

	// ConnectionStatePending is a ConnectionState enum value
	ConnectionStatePending = "pending"

	// ConnectionStateAvailable is a ConnectionState enum value
	ConnectionStateAvailable = "available"

	// ConnectionStateDown is a ConnectionState enum value
	ConnectionStateDown = "down"

	// ConnectionStateDeleting is a ConnectionState enum value
	ConnectionStateDeleting = "deleting"

	// ConnectionStateDeleted is a ConnectionState enum value
	ConnectionStateDeleted = "deleted"

	// ConnectionStateRejected is a ConnectionState enum value
	ConnectionStateRejected = "rejected"
)

State of the connection. 

Ordering: The initial state of a hosted connection provisioned on an

interconnect. The connection stays in the ordering state until the owner of the hosted connection confirms or declines the connection order. 

Requested: The initial state of a standard connection. The connection

stays in the requested state until the Letter of Authorization (LOA) is sent to the customer. 

Pending: The connection has been approved, and is being initialized.

Available: The network link is up, and the connection is ready for use.

Down: The network link is down.

Deleting: The connection is in the process of being deleted.

Deleted: The connection has been deleted.

Rejected: A hosted connection in the 'Ordering' state will enter the

'Rejected' state if it is deleted by the end customer.

View Source 
const (
	// InterconnectStateRequested is a InterconnectState enum value
	InterconnectStateRequested = "requested"

	// InterconnectStatePending is a InterconnectState enum value
	InterconnectStatePending = "pending"

	// InterconnectStateAvailable is a InterconnectState enum value
	InterconnectStateAvailable = "available"

	// InterconnectStateDown is a InterconnectState enum value
	InterconnectStateDown = "down"

	// InterconnectStateDeleting is a InterconnectState enum value
	InterconnectStateDeleting = "deleting"

	// InterconnectStateDeleted is a InterconnectState enum value
	InterconnectStateDeleted = "deleted"
)

State of the interconnect. 

Requested: The initial state of an interconnect. The interconnect stays

in the requested state until the Letter of Authorization (LOA) is sent to the customer. 

Pending>: The interconnect has been approved, and is being initialized.

Available: The network link is up, and the interconnect is ready for

use. 

Down: The network link is down.

Deleting: The interconnect is in the process of being deleted.

Deleted: The interconnect has been deleted.
View Source 
const (
	// VirtualInterfaceStateConfirming is a VirtualInterfaceState enum value
	VirtualInterfaceStateConfirming = "confirming"

	// VirtualInterfaceStateVerifying is a VirtualInterfaceState enum value
	VirtualInterfaceStateVerifying = "verifying"

	// VirtualInterfaceStatePending is a VirtualInterfaceState enum value
	VirtualInterfaceStatePending = "pending"

	// VirtualInterfaceStateAvailable is a VirtualInterfaceState enum value
	VirtualInterfaceStateAvailable = "available"

	// VirtualInterfaceStateDown is a VirtualInterfaceState enum value
	VirtualInterfaceStateDown = "down"

	// VirtualInterfaceStateDeleting is a VirtualInterfaceState enum value
	VirtualInterfaceStateDeleting = "deleting"

	// VirtualInterfaceStateDeleted is a VirtualInterfaceState enum value
	VirtualInterfaceStateDeleted = "deleted"

	// VirtualInterfaceStateRejected is a VirtualInterfaceState enum value
	VirtualInterfaceStateRejected = "rejected"
)

State of the virtual interface. 

Confirming: The creation of the virtual interface is pending confirmation

from the virtual interface owner. If the owner of the virtual interface is different from the owner of the connection on which it is provisioned, then the virtual interface will remain in this state until it is confirmed by the virtual interface owner. 

Verifying: This state only applies to public virtual interfaces. Each

public virtual interface needs validation before the virtual interface can be created. 

Pending: A virtual interface is in this state from the time that it is

created until the virtual interface is ready to forward traffic. 

Available: A virtual interface that is able to forward traffic.

Down: A virtual interface that is BGP down.

Deleting: A virtual interface is in this state immediately after calling

DeleteVirtualInterface until it can no longer forward traffic. 

Deleted: A virtual interface that cannot forward traffic.

Rejected: The virtual interface owner has declined creation of the virtual

interface. If a virtual interface in the 'Confirming' state is deleted by the virtual interface owner, the virtual interface will enter the 'Rejected' state.

View Source 
const (
	// LoaContentTypeApplicationPdf is a LoaContentType enum value
	LoaContentTypeApplicationPdf = "application/pdf"
)

A standard media type indicating the content type of the LOA-CFA document. Currently, the only supported value is "application/pdf".

Default: application/pdf

View Source 
const ServiceName = "directconnect"

A ServiceName is the name of the service the client will make API calls to.

Variables

This section is empty.

Functions

This section is empty.

Types

type AllocateConnectionOnInterconnectInput 

type AllocateConnectionOnInterconnectInput struct {

	// Bandwidth of the connection.
	//
	// Example: "500Mbps"
	//
	// Default: None
	//
	// Values: 50M, 100M, 200M, 300M, 400M, or 500M
	//
	// Bandwidth is a required field
	Bandwidth *string `locationName:"bandwidth" type:"string" required:"true"`

	// Name of the provisioned connection.
	//
	// Example: "500M Connection to AWS"
	//
	// Default: None
	//
	// ConnectionName is a required field
	ConnectionName *string `locationName:"connectionName" type:"string" required:"true"`

	// ID of the interconnect on which the connection will be provisioned.
	//
	// Example: dxcon-456abc78
	//
	// Default: None
	//
	// InterconnectId is a required field
	InterconnectId *string `locationName:"interconnectId" type:"string" required:"true"`

	// Numeric account Id of the customer for whom the connection will be provisioned.
	//
	// Example: 123443215678
	//
	// Default: None
	//
	// OwnerAccount is a required field
	OwnerAccount *string `locationName:"ownerAccount" type:"string" required:"true"`

	// The dedicated VLAN provisioned to the connection.
	//
	// Example: 101
	//
	// Default: None
	//
	// Vlan is a required field
	Vlan *int64 `locationName:"vlan" type:"integer" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the AllocateConnectionOnInterconnect operation.

func (AllocateConnectionOnInterconnectInput) GoString added in v0.6.5 

func (s AllocateConnectionOnInterconnectInput) GoString() string

GoString returns the string representation

func (AllocateConnectionOnInterconnectInput) String added in v0.6.5 

func (s AllocateConnectionOnInterconnectInput) String() string

String returns the string representation

func (*AllocateConnectionOnInterconnectInput) Validate added in v1.1.21 

func (s *AllocateConnectionOnInterconnectInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AllocatePrivateVirtualInterfaceInput 

type AllocatePrivateVirtualInterfaceInput struct {

	// The connection ID on which the private virtual interface is provisioned.
	//
	// Default: None
	//
	// ConnectionId is a required field
	ConnectionId *string `locationName:"connectionId" type:"string" required:"true"`

	// Detailed information for the private virtual interface to be provisioned.
	//
	// Default: None
	//
	// NewPrivateVirtualInterfaceAllocation is a required field
	NewPrivateVirtualInterfaceAllocation *NewPrivateVirtualInterfaceAllocation `locationName:"newPrivateVirtualInterfaceAllocation" type:"structure" required:"true"`

	// The AWS account that will own the new private virtual interface.
	//
	// Default: None
	//
	// OwnerAccount is a required field
	OwnerAccount *string `locationName:"ownerAccount" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the AllocatePrivateVirtualInterface operation.

func (AllocatePrivateVirtualInterfaceInput) GoString added in v0.6.5 

func (s AllocatePrivateVirtualInterfaceInput) GoString() string

GoString returns the string representation

func (AllocatePrivateVirtualInterfaceInput) String added in v0.6.5 

func (s AllocatePrivateVirtualInterfaceInput) String() string

String returns the string representation

func (*AllocatePrivateVirtualInterfaceInput) Validate added in v1.1.21 

func (s *AllocatePrivateVirtualInterfaceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type AllocatePublicVirtualInterfaceInput 

type AllocatePublicVirtualInterfaceInput struct {

	// The connection ID on which the public virtual interface is provisioned.
	//
	// Default: None
	//
	// ConnectionId is a required field
	ConnectionId *string `locationName:"connectionId" type:"string" required:"true"`

	// Detailed information for the public virtual interface to be provisioned.
	//
	// Default: None
	//
	// NewPublicVirtualInterfaceAllocation is a required field
	NewPublicVirtualInterfaceAllocation *NewPublicVirtualInterfaceAllocation `locationName:"newPublicVirtualInterfaceAllocation" type:"structure" required:"true"`

	// The AWS account that will own the new public virtual interface.
	//
	// Default: None
	//
	// OwnerAccount is a required field
	OwnerAccount *string `locationName:"ownerAccount" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the AllocatePublicVirtualInterface operation.

func (AllocatePublicVirtualInterfaceInput) GoString added in v0.6.5 

func (s AllocatePublicVirtualInterfaceInput) GoString() string

GoString returns the string representation

func (AllocatePublicVirtualInterfaceInput) String added in v0.6.5 

func (s AllocatePublicVirtualInterfaceInput) String() string

String returns the string representation

func (*AllocatePublicVirtualInterfaceInput) Validate added in v1.1.21 

func (s *AllocatePublicVirtualInterfaceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ConfirmConnectionInput 

type ConfirmConnectionInput struct {

	// ID of the connection.
	//
	// Example: dxcon-fg5678gh
	//
	// Default: None
	//
	// ConnectionId is a required field
	ConnectionId *string `locationName:"connectionId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the ConfirmConnection operation.

func (ConfirmConnectionInput) GoString added in v0.6.5 

func (s ConfirmConnectionInput) GoString() string

GoString returns the string representation

func (ConfirmConnectionInput) String added in v0.6.5 

func (s ConfirmConnectionInput) String() string

String returns the string representation

func (*ConfirmConnectionInput) Validate added in v1.1.21 

func (s *ConfirmConnectionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ConfirmConnectionOutput 

type ConfirmConnectionOutput struct {

	// State of the connection.
	//
	//    Ordering: The initial state of a hosted connection provisioned on an
	// interconnect. The connection stays in the ordering state until the owner
	// of the hosted connection confirms or declines the connection order.
	//
	//    Requested: The initial state of a standard connection. The connection
	// stays in the requested state until the Letter of Authorization (LOA) is sent
	// to the customer.
	//
	//    Pending: The connection has been approved, and is being initialized.
	//
	//    Available: The network link is up, and the connection is ready for use.
	//
	//    Down: The network link is down.
	//
	//    Deleting: The connection is in the process of being deleted.
	//
	//    Deleted: The connection has been deleted.
	//
	//    Rejected: A hosted connection in the 'Ordering' state will enter the
	// 'Rejected' state if it is deleted by the end customer.
	ConnectionState *string `locationName:"connectionState" type:"string" enum:"ConnectionState"`
	// contains filtered or unexported fields
}

The response received when ConfirmConnection is called.

func (ConfirmConnectionOutput) GoString added in v0.6.5 

func (s ConfirmConnectionOutput) GoString() string

GoString returns the string representation

func (ConfirmConnectionOutput) String added in v0.6.5 

func (s ConfirmConnectionOutput) String() string

String returns the string representation

type ConfirmPrivateVirtualInterfaceInput 

type ConfirmPrivateVirtualInterfaceInput struct {

	// ID of the virtual private gateway that will be attached to the virtual interface.
	//
	//  A virtual private gateway can be managed via the Amazon Virtual Private
	// Cloud (VPC) console or the EC2 CreateVpnGateway (http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-CreateVpnGateway.html)
	// action.
	//
	// Default: None
	//
	// VirtualGatewayId is a required field
	VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string" required:"true"`

	// ID of the virtual interface.
	//
	// Example: dxvif-123dfg56
	//
	// Default: None
	//
	// VirtualInterfaceId is a required field
	VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the ConfirmPrivateVirtualInterface operation.

func (ConfirmPrivateVirtualInterfaceInput) GoString added in v0.6.5 

func (s ConfirmPrivateVirtualInterfaceInput) GoString() string

GoString returns the string representation

func (ConfirmPrivateVirtualInterfaceInput) String added in v0.6.5 

func (s ConfirmPrivateVirtualInterfaceInput) String() string

String returns the string representation

func (*ConfirmPrivateVirtualInterfaceInput) Validate added in v1.1.21 

func (s *ConfirmPrivateVirtualInterfaceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ConfirmPrivateVirtualInterfaceOutput 

type ConfirmPrivateVirtualInterfaceOutput struct {

	// State of the virtual interface.
	//
	//    Confirming: The creation of the virtual interface is pending confirmation
	// from the virtual interface owner. If the owner of the virtual interface is
	// different from the owner of the connection on which it is provisioned, then
	// the virtual interface will remain in this state until it is confirmed by
	// the virtual interface owner.
	//
	//    Verifying: This state only applies to public virtual interfaces. Each
	// public virtual interface needs validation before the virtual interface can
	// be created.
	//
	//    Pending: A virtual interface is in this state from the time that it is
	// created until the virtual interface is ready to forward traffic.
	//
	//    Available: A virtual interface that is able to forward traffic.
	//
	//    Down: A virtual interface that is BGP down.
	//
	//    Deleting: A virtual interface is in this state immediately after calling
	// DeleteVirtualInterface until it can no longer forward traffic.
	//
	//    Deleted: A virtual interface that cannot forward traffic.
	//
	//    Rejected: The virtual interface owner has declined creation of the virtual
	// interface. If a virtual interface in the 'Confirming' state is deleted by
	// the virtual interface owner, the virtual interface will enter the 'Rejected'
	// state.
	VirtualInterfaceState *string `locationName:"virtualInterfaceState" type:"string" enum:"VirtualInterfaceState"`
	// contains filtered or unexported fields
}

The response received when ConfirmPrivateVirtualInterface is called.

func (ConfirmPrivateVirtualInterfaceOutput) GoString added in v0.6.5 

func (s ConfirmPrivateVirtualInterfaceOutput) GoString() string

GoString returns the string representation

func (ConfirmPrivateVirtualInterfaceOutput) String added in v0.6.5 

func (s ConfirmPrivateVirtualInterfaceOutput) String() string

String returns the string representation

type ConfirmPublicVirtualInterfaceInput 

type ConfirmPublicVirtualInterfaceInput struct {

	// ID of the virtual interface.
	//
	// Example: dxvif-123dfg56
	//
	// Default: None
	//
	// VirtualInterfaceId is a required field
	VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the ConfirmPublicVirtualInterface operation.

func (ConfirmPublicVirtualInterfaceInput) GoString added in v0.6.5 

func (s ConfirmPublicVirtualInterfaceInput) GoString() string

GoString returns the string representation

func (ConfirmPublicVirtualInterfaceInput) String added in v0.6.5 

func (s ConfirmPublicVirtualInterfaceInput) String() string

String returns the string representation

func (*ConfirmPublicVirtualInterfaceInput) Validate added in v1.1.21 

func (s *ConfirmPublicVirtualInterfaceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ConfirmPublicVirtualInterfaceOutput 

type ConfirmPublicVirtualInterfaceOutput struct {

	// State of the virtual interface.
	//
	//    Confirming: The creation of the virtual interface is pending confirmation
	// from the virtual interface owner. If the owner of the virtual interface is
	// different from the owner of the connection on which it is provisioned, then
	// the virtual interface will remain in this state until it is confirmed by
	// the virtual interface owner.
	//
	//    Verifying: This state only applies to public virtual interfaces. Each
	// public virtual interface needs validation before the virtual interface can
	// be created.
	//
	//    Pending: A virtual interface is in this state from the time that it is
	// created until the virtual interface is ready to forward traffic.
	//
	//    Available: A virtual interface that is able to forward traffic.
	//
	//    Down: A virtual interface that is BGP down.
	//
	//    Deleting: A virtual interface is in this state immediately after calling
	// DeleteVirtualInterface until it can no longer forward traffic.
	//
	//    Deleted: A virtual interface that cannot forward traffic.
	//
	//    Rejected: The virtual interface owner has declined creation of the virtual
	// interface. If a virtual interface in the 'Confirming' state is deleted by
	// the virtual interface owner, the virtual interface will enter the 'Rejected'
	// state.
	VirtualInterfaceState *string `locationName:"virtualInterfaceState" type:"string" enum:"VirtualInterfaceState"`
	// contains filtered or unexported fields
}

The response received when ConfirmPublicVirtualInterface is called.

func (ConfirmPublicVirtualInterfaceOutput) GoString added in v0.6.5 

func (s ConfirmPublicVirtualInterfaceOutput) GoString() string

GoString returns the string representation

func (ConfirmPublicVirtualInterfaceOutput) String added in v0.6.5 

func (s ConfirmPublicVirtualInterfaceOutput) String() string

String returns the string representation

type Connection 

type Connection struct {

	// Bandwidth of the connection.
	//
	// Example: 1Gbps (for regular connections), or 500Mbps (for hosted connections)
	//
	// Default: None
	Bandwidth *string `locationName:"bandwidth" type:"string"`

	// ID of the connection.
	//
	// Example: dxcon-fg5678gh
	//
	// Default: None
	ConnectionId *string `locationName:"connectionId" type:"string"`

	// The name of the connection.
	//
	// Example: "My Connection to AWS"
	//
	// Default: None
	ConnectionName *string `locationName:"connectionName" type:"string"`

	// State of the connection.
	//
	//    Ordering: The initial state of a hosted connection provisioned on an
	// interconnect. The connection stays in the ordering state until the owner
	// of the hosted connection confirms or declines the connection order.
	//
	//    Requested: The initial state of a standard connection. The connection
	// stays in the requested state until the Letter of Authorization (LOA) is sent
	// to the customer.
	//
	//    Pending: The connection has been approved, and is being initialized.
	//
	//    Available: The network link is up, and the connection is ready for use.
	//
	//    Down: The network link is down.
	//
	//    Deleting: The connection is in the process of being deleted.
	//
	//    Deleted: The connection has been deleted.
	//
	//    Rejected: A hosted connection in the 'Ordering' state will enter the
	// 'Rejected' state if it is deleted by the end customer.
	ConnectionState *string `locationName:"connectionState" type:"string" enum:"ConnectionState"`

	// The time of the most recent call to DescribeConnectionLoa for this Connection.
	LoaIssueTime *time.Time `locationName:"loaIssueTime" type:"timestamp" timestampFormat:"unix"`

	// Where the connection is located.
	//
	// Example: EqSV5
	//
	// Default: None
	Location *string `locationName:"location" type:"string"`

	// The AWS account that will own the new connection.
	OwnerAccount *string `locationName:"ownerAccount" type:"string"`

	// The name of the AWS Direct Connect service provider associated with the connection.
	PartnerName *string `locationName:"partnerName" type:"string"`

	// The AWS region where the connection is located.
	//
	// Example: us-east-1
	//
	// Default: None
	Region *string `locationName:"region" type:"string"`

	// The VLAN ID.
	//
	// Example: 101
	Vlan *int64 `locationName:"vlan" type:"integer"`
	// contains filtered or unexported fields
}

A connection represents the physical network connection between the AWS Direct Connect location and the customer.

func (Connection) GoString added in v0.6.5 

func (s Connection) GoString() string

GoString returns the string representation

func (Connection) String added in v0.6.5 

func (s Connection) String() string

String returns the string representation

type Connections 

type Connections struct {

	// A list of connections.
	Connections []*Connection `locationName:"connections" type:"list"`
	// contains filtered or unexported fields
}

A structure containing a list of connections.

func (Connections) GoString added in v0.6.5 

func (s Connections) GoString() string

GoString returns the string representation

func (Connections) String added in v0.6.5 

func (s Connections) String() string

String returns the string representation

type CreateConnectionInput 

type CreateConnectionInput struct {

	// Bandwidth of the connection.
	//
	// Example: 1Gbps
	//
	// Default: None
	//
	// Bandwidth is a required field
	Bandwidth *string `locationName:"bandwidth" type:"string" required:"true"`

	// The name of the connection.
	//
	// Example: "My Connection to AWS"
	//
	// Default: None
	//
	// ConnectionName is a required field
	ConnectionName *string `locationName:"connectionName" type:"string" required:"true"`

	// Where the connection is located.
	//
	// Example: EqSV5
	//
	// Default: None
	//
	// Location is a required field
	Location *string `locationName:"location" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the CreateConnection operation.

func (CreateConnectionInput) GoString added in v0.6.5 

func (s CreateConnectionInput) GoString() string

GoString returns the string representation

func (CreateConnectionInput) String added in v0.6.5 

func (s CreateConnectionInput) String() string

String returns the string representation

func (*CreateConnectionInput) Validate added in v1.1.21 

func (s *CreateConnectionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateInterconnectInput 

type CreateInterconnectInput struct {

	// The port bandwidth
	//
	// Example: 1Gbps
	//
	// Default: None
	//
	// Available values: 1Gbps,10Gbps
	//
	// Bandwidth is a required field
	Bandwidth *string `locationName:"bandwidth" type:"string" required:"true"`

	// The name of the interconnect.
	//
	// Example: "1G Interconnect to AWS"
	//
	// Default: None
	//
	// InterconnectName is a required field
	InterconnectName *string `locationName:"interconnectName" type:"string" required:"true"`

	// Where the interconnect is located
	//
	// Example: EqSV5
	//
	// Default: None
	//
	// Location is a required field
	Location *string `locationName:"location" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the CreateInterconnect operation.

func (CreateInterconnectInput) GoString added in v0.6.5 

func (s CreateInterconnectInput) GoString() string

GoString returns the string representation

func (CreateInterconnectInput) String added in v0.6.5 

func (s CreateInterconnectInput) String() string

String returns the string representation

func (*CreateInterconnectInput) Validate added in v1.1.21 

func (s *CreateInterconnectInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreatePrivateVirtualInterfaceInput 

type CreatePrivateVirtualInterfaceInput struct {

	// ID of the connection.
	//
	// Example: dxcon-fg5678gh
	//
	// Default: None
	//
	// ConnectionId is a required field
	ConnectionId *string `locationName:"connectionId" type:"string" required:"true"`

	// Detailed information for the private virtual interface to be created.
	//
	// Default: None
	//
	// NewPrivateVirtualInterface is a required field
	NewPrivateVirtualInterface *NewPrivateVirtualInterface `locationName:"newPrivateVirtualInterface" type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the CreatePrivateVirtualInterface operation.

func (CreatePrivateVirtualInterfaceInput) GoString added in v0.6.5 

func (s CreatePrivateVirtualInterfaceInput) GoString() string

GoString returns the string representation

func (CreatePrivateVirtualInterfaceInput) String added in v0.6.5 

func (s CreatePrivateVirtualInterfaceInput) String() string

String returns the string representation

func (*CreatePrivateVirtualInterfaceInput) Validate added in v1.1.21 

func (s *CreatePrivateVirtualInterfaceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreatePublicVirtualInterfaceInput 

type CreatePublicVirtualInterfaceInput struct {

	// ID of the connection.
	//
	// Example: dxcon-fg5678gh
	//
	// Default: None
	//
	// ConnectionId is a required field
	ConnectionId *string `locationName:"connectionId" type:"string" required:"true"`

	// Detailed information for the public virtual interface to be created.
	//
	// Default: None
	//
	// NewPublicVirtualInterface is a required field
	NewPublicVirtualInterface *NewPublicVirtualInterface `locationName:"newPublicVirtualInterface" type:"structure" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the CreatePublicVirtualInterface operation.

func (CreatePublicVirtualInterfaceInput) GoString added in v0.6.5 

func (s CreatePublicVirtualInterfaceInput) GoString() string

GoString returns the string representation

func (CreatePublicVirtualInterfaceInput) String added in v0.6.5 

func (s CreatePublicVirtualInterfaceInput) String() string

String returns the string representation

func (*CreatePublicVirtualInterfaceInput) Validate added in v1.1.21 

func (s *CreatePublicVirtualInterfaceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteConnectionInput 

type DeleteConnectionInput struct {

	// ID of the connection.
	//
	// Example: dxcon-fg5678gh
	//
	// Default: None
	//
	// ConnectionId is a required field
	ConnectionId *string `locationName:"connectionId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the DeleteConnection operation.

func (DeleteConnectionInput) GoString added in v0.6.5 

func (s DeleteConnectionInput) GoString() string

GoString returns the string representation

func (DeleteConnectionInput) String added in v0.6.5 

func (s DeleteConnectionInput) String() string

String returns the string representation

func (*DeleteConnectionInput) Validate added in v1.1.21 

func (s *DeleteConnectionInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteInterconnectInput 

type DeleteInterconnectInput struct {

	// The ID of the interconnect.
	//
	// Example: dxcon-abc123
	//
	// InterconnectId is a required field
	InterconnectId *string `locationName:"interconnectId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the DeleteInterconnect operation.

func (DeleteInterconnectInput) GoString added in v0.6.5 

func (s DeleteInterconnectInput) GoString() string

GoString returns the string representation

func (DeleteInterconnectInput) String added in v0.6.5 

func (s DeleteInterconnectInput) String() string

String returns the string representation

func (*DeleteInterconnectInput) Validate added in v1.1.21 

func (s *DeleteInterconnectInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteInterconnectOutput 

type DeleteInterconnectOutput struct {

	// State of the interconnect.
	//
	//    Requested: The initial state of an interconnect. The interconnect stays
	// in the requested state until the Letter of Authorization (LOA) is sent to
	// the customer.
	//
	//    Pending>: The interconnect has been approved, and is being initialized.
	//
	//    Available: The network link is up, and the interconnect is ready for
	// use.
	//
	//    Down: The network link is down.
	//
	//    Deleting: The interconnect is in the process of being deleted.
	//
	//    Deleted: The interconnect has been deleted.
	InterconnectState *string `locationName:"interconnectState" type:"string" enum:"InterconnectState"`
	// contains filtered or unexported fields
}

The response received when DeleteInterconnect is called.

func (DeleteInterconnectOutput) GoString added in v0.6.5 

func (s DeleteInterconnectOutput) GoString() string

GoString returns the string representation

func (DeleteInterconnectOutput) String added in v0.6.5 

func (s DeleteInterconnectOutput) String() string

String returns the string representation

type DeleteVirtualInterfaceInput 

type DeleteVirtualInterfaceInput struct {

	// ID of the virtual interface.
	//
	// Example: dxvif-123dfg56
	//
	// Default: None
	//
	// VirtualInterfaceId is a required field
	VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the DeleteVirtualInterface operation.

func (DeleteVirtualInterfaceInput) GoString added in v0.6.5 

func (s DeleteVirtualInterfaceInput) GoString() string

GoString returns the string representation

func (DeleteVirtualInterfaceInput) String added in v0.6.5 

func (s DeleteVirtualInterfaceInput) String() string

String returns the string representation

func (*DeleteVirtualInterfaceInput) Validate added in v1.1.21 

func (s *DeleteVirtualInterfaceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteVirtualInterfaceOutput 

type DeleteVirtualInterfaceOutput struct {

	// State of the virtual interface.
	//
	//    Confirming: The creation of the virtual interface is pending confirmation
	// from the virtual interface owner. If the owner of the virtual interface is
	// different from the owner of the connection on which it is provisioned, then
	// the virtual interface will remain in this state until it is confirmed by
	// the virtual interface owner.
	//
	//    Verifying: This state only applies to public virtual interfaces. Each
	// public virtual interface needs validation before the virtual interface can
	// be created.
	//
	//    Pending: A virtual interface is in this state from the time that it is
	// created until the virtual interface is ready to forward traffic.
	//
	//    Available: A virtual interface that is able to forward traffic.
	//
	//    Down: A virtual interface that is BGP down.
	//
	//    Deleting: A virtual interface is in this state immediately after calling
	// DeleteVirtualInterface until it can no longer forward traffic.
	//
	//    Deleted: A virtual interface that cannot forward traffic.
	//
	//    Rejected: The virtual interface owner has declined creation of the virtual
	// interface. If a virtual interface in the 'Confirming' state is deleted by
	// the virtual interface owner, the virtual interface will enter the 'Rejected'
	// state.
	VirtualInterfaceState *string `locationName:"virtualInterfaceState" type:"string" enum:"VirtualInterfaceState"`
	// contains filtered or unexported fields
}

The response received when DeleteVirtualInterface is called.

func (DeleteVirtualInterfaceOutput) GoString added in v0.6.5 

func (s DeleteVirtualInterfaceOutput) GoString() string

GoString returns the string representation

func (DeleteVirtualInterfaceOutput) String added in v0.6.5 

func (s DeleteVirtualInterfaceOutput) String() string

String returns the string representation

type DescribeConnectionLoaInput added in v1.2.0 

type DescribeConnectionLoaInput struct {

	// ID of the connection.
	//
	// Example: dxcon-fg5678gh
	//
	// Default: None
	//
	// ConnectionId is a required field
	ConnectionId *string `locationName:"connectionId" type:"string" required:"true"`

	// A standard media type indicating the content type of the LOA-CFA document.
	// Currently, the only supported value is "application/pdf".
	//
	// Default: application/pdf
	LoaContentType *string `locationName:"loaContentType" type:"string" enum:"LoaContentType"`

	// The name of the APN partner or 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.
	//
	// Default: None
	ProviderName *string `locationName:"providerName" type:"string"`
	// contains filtered or unexported fields
}

Container for the parameters to the DescribeConnectionLoa operation.

func (DescribeConnectionLoaInput) GoString added in v1.2.0 

func (s DescribeConnectionLoaInput) GoString() string

GoString returns the string representation

func (DescribeConnectionLoaInput) String added in v1.2.0 

func (s DescribeConnectionLoaInput) String() string

String returns the string representation

func (*DescribeConnectionLoaInput) Validate added in v1.2.0 

func (s *DescribeConnectionLoaInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeConnectionLoaOutput added in v1.2.0 

type DescribeConnectionLoaOutput struct {

	// A structure containing the Letter of Authorization - Connecting Facility
	// Assignment (LOA-CFA) for a connection.
	Loa *Loa `locationName:"loa" type:"structure"`
	// contains filtered or unexported fields
}

The response received when DescribeConnectionLoa is called.

func (DescribeConnectionLoaOutput) GoString added in v1.2.0 

func (s DescribeConnectionLoaOutput) GoString() string

GoString returns the string representation

func (DescribeConnectionLoaOutput) String added in v1.2.0 

func (s DescribeConnectionLoaOutput) String() string

String returns the string representation

type DescribeConnectionsInput 

type DescribeConnectionsInput struct {

	// ID of the connection.
	//
	// Example: dxcon-fg5678gh
	//
	// Default: None
	ConnectionId *string `locationName:"connectionId" type:"string"`
	// contains filtered or unexported fields
}

Container for the parameters to the DescribeConnections operation.

func (DescribeConnectionsInput) GoString added in v0.6.5 

func (s DescribeConnectionsInput) GoString() string

GoString returns the string representation

func (DescribeConnectionsInput) String added in v0.6.5 

func (s DescribeConnectionsInput) String() string

String returns the string representation

type DescribeConnectionsOnInterconnectInput 

type DescribeConnectionsOnInterconnectInput struct {

	// ID of the interconnect on which a list of connection is provisioned.
	//
	// Example: dxcon-abc123
	//
	// Default: None
	//
	// InterconnectId is a required field
	InterconnectId *string `locationName:"interconnectId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Container for the parameters to the DescribeConnectionsOnInterconnect operation.

func (DescribeConnectionsOnInterconnectInput) GoString added in v0.6.5 

func (s DescribeConnectionsOnInterconnectInput) GoString() string

GoString returns the string representation

func (DescribeConnectionsOnInterconnectInput) String added in v0.6.5 

func (s DescribeConnectionsOnInterconnectInput) String() string

String returns the string representation

func (*DescribeConnectionsOnInterconnectInput) Validate added in v1.1.21 

func (s *DescribeConnectionsOnInterconnectInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeInterconnectLoaInput added in v1.2.0 

type DescribeInterconnectLoaInput struct {

	// The ID of the interconnect.
	//
	// Example: dxcon-abc123
	//
	// InterconnectId is a required field
	InterconnectId *string `locationName:"interconnectId" type:"string" required:"true"`

	// A standard media type indicating the content type of the LOA-CFA document.
	// Currently, the only supported value is "application/pdf".
	//
	// Default: application/pdf
	LoaContentType *string `locationName:"loaContentType" type:"string" enum:"LoaContentType"`

	// 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.
	//
	// Default: None
	ProviderName *string `locationName:"providerName" type:"string"`
	// contains filtered or unexported fields
}

Container for the parameters to the DescribeInterconnectLoa operation.

func (DescribeInterconnectLoaInput) GoString added in v1.2.0 

func (s DescribeInterconnectLoaInput) GoString() string

GoString returns the string representation

func (DescribeInterconnectLoaInput) String added in v1.2.0 

func (s DescribeInterconnectLoaInput) String() string

String returns the string representation

func (*DescribeInterconnectLoaInput) Validate added in v1.2.0 

func (s *DescribeInterconnectLoaInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeInterconnectLoaOutput added in v1.2.0 

type DescribeInterconnectLoaOutput struct {

	// A structure containing the Letter of Authorization - Connecting Facility
	// Assignment (LOA-CFA) for a connection.
	Loa *Loa `locationName:"loa" type:"structure"`
	// contains filtered or unexported fields
}

The response received when DescribeInterconnectLoa is called.

func (DescribeInterconnectLoaOutput) GoString added in v1.2.0 

func (s DescribeInterconnectLoaOutput) GoString() string

GoString returns the string representation

func (DescribeInterconnectLoaOutput) String added in v1.2.0 

func (s DescribeInterconnectLoaOutput) String() string

String returns the string representation

type DescribeInterconnectsInput 

type DescribeInterconnectsInput struct {

	// The ID of the interconnect.
	//
	// Example: dxcon-abc123
	InterconnectId *string `locationName:"interconnectId" type:"string"`
	// contains filtered or unexported fields
}

Container for the parameters to the DescribeInterconnects operation.

func (DescribeInterconnectsInput) GoString added in v0.6.5 

func (s DescribeInterconnectsInput) GoString() string

GoString returns the string representation

func (DescribeInterconnectsInput) String added in v0.6.5 

func (s DescribeInterconnectsInput) String() string

String returns the string representation

type DescribeInterconnectsOutput 

type DescribeInterconnectsOutput struct {

	// A list of interconnects.
	Interconnects []*Interconnect `locationName:"interconnects" type:"list"`
	// contains filtered or unexported fields
}

A structure containing a list of interconnects.

func (DescribeInterconnectsOutput) GoString added in v0.6.5 

func (s DescribeInterconnectsOutput) GoString() string

GoString returns the string representation

func (DescribeInterconnectsOutput) String added in v0.6.5 

func (s DescribeInterconnectsOutput) String() string

String returns the string representation

type DescribeLocationsInput 

type DescribeLocationsInput struct {
	// contains filtered or unexported fields
}

func (DescribeLocationsInput) GoString added in v0.6.5 

func (s DescribeLocationsInput) GoString() string

GoString returns the string representation

func (DescribeLocationsInput) String added in v0.6.5 

func (s DescribeLocationsInput) String() string

String returns the string representation

type DescribeLocationsOutput 

type DescribeLocationsOutput struct {

	// A list of colocation hubs where network providers have equipment. Most regions
	// have multiple locations available.
	Locations []*Location `locationName:"locations" type:"list"`
	// contains filtered or unexported fields
}

A location is a network facility where AWS Direct Connect routers are available to be connected. Generally, these are colocation hubs where many network providers have equipment, and where cross connects can be delivered. Locations include a name and facility code, and must be provided when creating a connection.

func (DescribeLocationsOutput) GoString added in v0.6.5 

func (s DescribeLocationsOutput) GoString() string

GoString returns the string representation

func (DescribeLocationsOutput) String added in v0.6.5 

func (s DescribeLocationsOutput) String() string

String returns the string representation

type DescribeVirtualGatewaysInput 

type DescribeVirtualGatewaysInput struct {
	// contains filtered or unexported fields
}

func (DescribeVirtualGatewaysInput) GoString added in v0.6.5 

func (s DescribeVirtualGatewaysInput) GoString() string

GoString returns the string representation

func (DescribeVirtualGatewaysInput) String added in v0.6.5 

func (s DescribeVirtualGatewaysInput) String() string

String returns the string representation

type DescribeVirtualGatewaysOutput 

type DescribeVirtualGatewaysOutput struct {

	// A list of virtual private gateways.
	VirtualGateways []*VirtualGateway `locationName:"virtualGateways" type:"list"`
	// contains filtered or unexported fields
}

A structure containing a list of virtual private gateways.

func (DescribeVirtualGatewaysOutput) GoString added in v0.6.5 

func (s DescribeVirtualGatewaysOutput) GoString() string

GoString returns the string representation

func (DescribeVirtualGatewaysOutput) String added in v0.6.5 

func (s DescribeVirtualGatewaysOutput) String() string

String returns the string representation

type DescribeVirtualInterfacesInput 

type DescribeVirtualInterfacesInput struct {

	// ID of the connection.
	//
	// Example: dxcon-fg5678gh
	//
	// Default: None
	ConnectionId *string `locationName:"connectionId" type:"string"`

	// ID of the virtual interface.
	//
	// Example: dxvif-123dfg56
	//
	// Default: None
	VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string"`
	// contains filtered or unexported fields
}

Container for the parameters to the DescribeVirtualInterfaces operation.

func (DescribeVirtualInterfacesInput) GoString added in v0.6.5 

func (s DescribeVirtualInterfacesInput) GoString() string

GoString returns the string representation

func (DescribeVirtualInterfacesInput) String added in v0.6.5 

func (s DescribeVirtualInterfacesInput) String() string

String returns the string representation

type DescribeVirtualInterfacesOutput 

type DescribeVirtualInterfacesOutput struct {

	// A list of virtual interfaces.
	VirtualInterfaces []*VirtualInterface `locationName:"virtualInterfaces" type:"list"`
	// contains filtered or unexported fields
}

A structure containing a list of virtual interfaces.

func (DescribeVirtualInterfacesOutput) GoString added in v0.6.5 

func (s DescribeVirtualInterfacesOutput) GoString() string

GoString returns the string representation

func (DescribeVirtualInterfacesOutput) String added in v0.6.5 

func (s DescribeVirtualInterfacesOutput) String() string

String returns the string representation

type DirectConnect 

type DirectConnect struct {
	*client.Client
}

AWS Direct Connect links your internal network to an AWS Direct Connect location over a standard 1 gigabit or 10 gigabit Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an AWS Direct Connect router. With this connection in place, you can create virtual interfaces directly to the AWS cloud (for example, to Amazon Elastic Compute Cloud (Amazon EC2) and Amazon Simple Storage Service (Amazon S3)) and to Amazon Virtual Private Cloud (Amazon VPC), bypassing Internet service providers in your network path. An AWS Direct Connect location provides access to AWS in the region it is associated with, as well as access to other US regions. For example, you can provision a single connection to any AWS Direct Connect location in the US and use it to access public AWS services in all US Regions and AWS GovCloud (US). The service client's operations are safe to be used concurrently. It is not safe to mutate any of the client's properties though.

func New 

func New(p client.ConfigProvider, cfgs ...*aws.Config) *DirectConnect

New creates a new instance of the DirectConnect client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.

Example: 

// Create a DirectConnect client from just a session.
svc := directconnect.New(mySession)

// Create a DirectConnect client with additional configuration
svc := directconnect.New(mySession, aws.NewConfig().WithRegion("us-west-2"))

func (*DirectConnect) AllocateConnectionOnInterconnect 

func (c *DirectConnect) AllocateConnectionOnInterconnect(input *AllocateConnectionOnInterconnectInput) (*Connection, error)

AllocateConnectionOnInterconnect API operation for AWS Direct Connect.

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 given interconnect. 

This is intended for use by AWS Direct Connect partners only.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation AllocateConnectionOnInterconnect for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.AllocateConnectionOnInterconnectInput{
		Bandwidth:      aws.String("Bandwidth"),      // Required
		ConnectionName: aws.String("ConnectionName"), // Required
		InterconnectId: aws.String("InterconnectId"), // Required
		OwnerAccount:   aws.String("OwnerAccount"),   // Required
		Vlan:           aws.Int64(1),                 // Required
	}
	resp, err := svc.AllocateConnectionOnInterconnect(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) AllocateConnectionOnInterconnectRequest 

func (c *DirectConnect) AllocateConnectionOnInterconnectRequest(input *AllocateConnectionOnInterconnectInput) (req *request.Request, output *Connection)

AllocateConnectionOnInterconnectRequest generates a "aws/request.Request" representing the client's request for the AllocateConnectionOnInterconnect operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See AllocateConnectionOnInterconnect for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the AllocateConnectionOnInterconnect method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the AllocateConnectionOnInterconnectRequest method.
req, resp := client.AllocateConnectionOnInterconnectRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) AllocatePrivateVirtualInterface 

func (c *DirectConnect) AllocatePrivateVirtualInterface(input *AllocatePrivateVirtualInterfaceInput) (*VirtualInterface, error)

AllocatePrivateVirtualInterface API operation for AWS Direct Connect.

Provisions a private virtual interface to be owned by a different customer.

The owner of a connection calls this function to provision a private virtual interface which will be owned by another AWS customer.

Virtual interfaces created using this function must be confirmed by the virtual interface owner by calling ConfirmPrivateVirtualInterface. Until this step has been completed, the virtual interface will be in 'Confirming' state, and will not be available for handling traffic.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation AllocatePrivateVirtualInterface for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.AllocatePrivateVirtualInterfaceInput{
		ConnectionId: aws.String("ConnectionId"), // Required
		NewPrivateVirtualInterfaceAllocation: &directconnect.NewPrivateVirtualInterfaceAllocation{ // Required
			Asn:                  aws.Int64(1),                       // Required
			VirtualInterfaceName: aws.String("VirtualInterfaceName"), // Required
			Vlan:                 aws.Int64(1),                       // Required
			AmazonAddress:        aws.String("AmazonAddress"),
			AuthKey:              aws.String("BGPAuthKey"),
			CustomerAddress:      aws.String("CustomerAddress"),
		},
		OwnerAccount: aws.String("OwnerAccount"), // Required
	}
	resp, err := svc.AllocatePrivateVirtualInterface(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) AllocatePrivateVirtualInterfaceRequest 

func (c *DirectConnect) AllocatePrivateVirtualInterfaceRequest(input *AllocatePrivateVirtualInterfaceInput) (req *request.Request, output *VirtualInterface)

AllocatePrivateVirtualInterfaceRequest generates a "aws/request.Request" representing the client's request for the AllocatePrivateVirtualInterface operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See AllocatePrivateVirtualInterface for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the AllocatePrivateVirtualInterface method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the AllocatePrivateVirtualInterfaceRequest method.
req, resp := client.AllocatePrivateVirtualInterfaceRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) AllocatePublicVirtualInterface 

func (c *DirectConnect) AllocatePublicVirtualInterface(input *AllocatePublicVirtualInterfaceInput) (*VirtualInterface, error)

AllocatePublicVirtualInterface API operation for AWS Direct Connect.

Provisions a public virtual interface to be owned by a different customer.

The owner of a connection calls this function to provision a public virtual interface which will be owned by another AWS customer.

Virtual interfaces created using this function must be confirmed by the virtual interface owner by calling ConfirmPublicVirtualInterface. Until this step has been completed, the virtual interface will be in 'Confirming' state, and will not be available for handling traffic.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation AllocatePublicVirtualInterface for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.AllocatePublicVirtualInterfaceInput{
		ConnectionId: aws.String("ConnectionId"), // Required
		NewPublicVirtualInterfaceAllocation: &directconnect.NewPublicVirtualInterfaceAllocation{ // Required
			AmazonAddress:   aws.String("AmazonAddress"),   // Required
			Asn:             aws.Int64(1),                  // Required
			CustomerAddress: aws.String("CustomerAddress"), // Required
			RouteFilterPrefixes: []*directconnect.RouteFilterPrefix{ // Required
				{ // Required
					Cidr: aws.String("CIDR"),
				},
				// More values...
			},
			VirtualInterfaceName: aws.String("VirtualInterfaceName"), // Required
			Vlan:                 aws.Int64(1),                       // Required
			AuthKey:              aws.String("BGPAuthKey"),
		},
		OwnerAccount: aws.String("OwnerAccount"), // Required
	}
	resp, err := svc.AllocatePublicVirtualInterface(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) AllocatePublicVirtualInterfaceRequest 

func (c *DirectConnect) AllocatePublicVirtualInterfaceRequest(input *AllocatePublicVirtualInterfaceInput) (req *request.Request, output *VirtualInterface)

AllocatePublicVirtualInterfaceRequest generates a "aws/request.Request" representing the client's request for the AllocatePublicVirtualInterface operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See AllocatePublicVirtualInterface for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the AllocatePublicVirtualInterface method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the AllocatePublicVirtualInterfaceRequest method.
req, resp := client.AllocatePublicVirtualInterfaceRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) ConfirmConnection 

func (c *DirectConnect) ConfirmConnection(input *ConfirmConnectionInput) (*ConfirmConnectionOutput, error)

ConfirmConnection API operation for AWS Direct Connect.

Confirm the creation of a hosted connection on an interconnect.

Upon creation, the hosted connection is initially in the 'Ordering' state, and will remain in this state until the owner calls ConfirmConnection to confirm creation of the hosted connection.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation ConfirmConnection for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.ConfirmConnectionInput{
		ConnectionId: aws.String("ConnectionId"), // Required
	}
	resp, err := svc.ConfirmConnection(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) ConfirmConnectionRequest 

func (c *DirectConnect) ConfirmConnectionRequest(input *ConfirmConnectionInput) (req *request.Request, output *ConfirmConnectionOutput)

ConfirmConnectionRequest generates a "aws/request.Request" representing the client's request for the ConfirmConnection operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See ConfirmConnection for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ConfirmConnection method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the ConfirmConnectionRequest method.
req, resp := client.ConfirmConnectionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) ConfirmPrivateVirtualInterface 

func (c *DirectConnect) ConfirmPrivateVirtualInterface(input *ConfirmPrivateVirtualInterfaceInput) (*ConfirmPrivateVirtualInterfaceOutput, error)

ConfirmPrivateVirtualInterface API operation for AWS Direct Connect.

Accept ownership of a private virtual interface created by another customer.

After the virtual interface owner calls this function, the virtual interface will be created and attached to the given virtual private gateway, and will be available for handling traffic.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation ConfirmPrivateVirtualInterface for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.ConfirmPrivateVirtualInterfaceInput{
		VirtualGatewayId:   aws.String("VirtualGatewayId"),   // Required
		VirtualInterfaceId: aws.String("VirtualInterfaceId"), // Required
	}
	resp, err := svc.ConfirmPrivateVirtualInterface(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) ConfirmPrivateVirtualInterfaceRequest 

func (c *DirectConnect) ConfirmPrivateVirtualInterfaceRequest(input *ConfirmPrivateVirtualInterfaceInput) (req *request.Request, output *ConfirmPrivateVirtualInterfaceOutput)

ConfirmPrivateVirtualInterfaceRequest generates a "aws/request.Request" representing the client's request for the ConfirmPrivateVirtualInterface operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See ConfirmPrivateVirtualInterface for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ConfirmPrivateVirtualInterface method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the ConfirmPrivateVirtualInterfaceRequest method.
req, resp := client.ConfirmPrivateVirtualInterfaceRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) ConfirmPublicVirtualInterface 

func (c *DirectConnect) ConfirmPublicVirtualInterface(input *ConfirmPublicVirtualInterfaceInput) (*ConfirmPublicVirtualInterfaceOutput, error)

ConfirmPublicVirtualInterface API operation for AWS Direct Connect.

Accept ownership of a public virtual interface created by another customer.

After the virtual interface owner calls this function, the specified virtual interface will be created and made available for handling traffic.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation ConfirmPublicVirtualInterface for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.ConfirmPublicVirtualInterfaceInput{
		VirtualInterfaceId: aws.String("VirtualInterfaceId"), // Required
	}
	resp, err := svc.ConfirmPublicVirtualInterface(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) ConfirmPublicVirtualInterfaceRequest 

func (c *DirectConnect) ConfirmPublicVirtualInterfaceRequest(input *ConfirmPublicVirtualInterfaceInput) (req *request.Request, output *ConfirmPublicVirtualInterfaceOutput)

ConfirmPublicVirtualInterfaceRequest generates a "aws/request.Request" representing the client's request for the ConfirmPublicVirtualInterface operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See ConfirmPublicVirtualInterface for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ConfirmPublicVirtualInterface method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the ConfirmPublicVirtualInterfaceRequest method.
req, resp := client.ConfirmPublicVirtualInterfaceRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) CreateConnection 

func (c *DirectConnect) CreateConnection(input *CreateConnectionInput) (*Connection, error)

CreateConnection API operation for AWS Direct Connect.

Creates a new connection between the customer network and a specific AWS Direct Connect location.

A connection links your internal network to an AWS Direct Connect location over a standard 1 gigabit or 10 gigabit Ethernet fiber-optic cable. One end of the cable is connected to your router, the other to an AWS Direct Connect router. An AWS Direct Connect location provides access to Amazon Web Services in the region it is associated with. You can establish connections with AWS Direct Connect locations in multiple regions, but a connection in one region does not provide connectivity to other regions.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation CreateConnection for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.CreateConnectionInput{
		Bandwidth:      aws.String("Bandwidth"),      // Required
		ConnectionName: aws.String("ConnectionName"), // Required
		Location:       aws.String("LocationCode"),   // Required
	}
	resp, err := svc.CreateConnection(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) CreateConnectionRequest 

func (c *DirectConnect) CreateConnectionRequest(input *CreateConnectionInput) (req *request.Request, output *Connection)

CreateConnectionRequest generates a "aws/request.Request" representing the client's request for the CreateConnection operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See CreateConnection for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateConnection method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the CreateConnectionRequest method.
req, resp := client.CreateConnectionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) CreateInterconnect 

func (c *DirectConnect) CreateInterconnect(input *CreateInterconnectInput) (*Interconnect, error)

CreateInterconnect API operation for AWS Direct Connect.

Creates a new interconnect between a AWS Direct Connect partner's network and a specific AWS Direct Connect location.

An interconnect is a connection which is capable of hosting other connections. The AWS Direct Connect partner can use an interconnect to provide sub-1Gbps AWS Direct Connect service to tier 2 customers who do not have their own connections. Like a standard connection, an interconnect links the AWS Direct Connect partner's network to an AWS Direct Connect location over a standard 1 Gbps or 10 Gbps Ethernet fiber-optic cable. One end is connected to the partner's router, the other to an AWS Direct Connect router.

For each end customer, the AWS Direct Connect partner provisions a connection on their interconnect by calling AllocateConnectionOnInterconnect. The end customer can then connect to AWS resources by creating a virtual interface on their connection, using the VLAN assigned to them by the AWS Direct Connect partner. 

This is intended for use by AWS Direct Connect partners only.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation CreateInterconnect for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.CreateInterconnectInput{
		Bandwidth:        aws.String("Bandwidth"),        // Required
		InterconnectName: aws.String("InterconnectName"), // Required
		Location:         aws.String("LocationCode"),     // Required
	}
	resp, err := svc.CreateInterconnect(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) CreateInterconnectRequest 

func (c *DirectConnect) CreateInterconnectRequest(input *CreateInterconnectInput) (req *request.Request, output *Interconnect)

CreateInterconnectRequest generates a "aws/request.Request" representing the client's request for the CreateInterconnect operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See CreateInterconnect for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateInterconnect method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the CreateInterconnectRequest method.
req, resp := client.CreateInterconnectRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) CreatePrivateVirtualInterface 

func (c *DirectConnect) CreatePrivateVirtualInterface(input *CreatePrivateVirtualInterfaceInput) (*VirtualInterface, error)

CreatePrivateVirtualInterface API operation for AWS Direct Connect.

Creates a new private virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. A private virtual interface supports sending traffic to a single virtual private cloud (VPC).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation CreatePrivateVirtualInterface for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.CreatePrivateVirtualInterfaceInput{
		ConnectionId: aws.String("ConnectionId"), // Required
		NewPrivateVirtualInterface: &directconnect.NewPrivateVirtualInterface{ // Required
			Asn:                  aws.Int64(1),                       // Required
			VirtualGatewayId:     aws.String("VirtualGatewayId"),     // Required
			VirtualInterfaceName: aws.String("VirtualInterfaceName"), // Required
			Vlan:                 aws.Int64(1),                       // Required
			AmazonAddress:        aws.String("AmazonAddress"),
			AuthKey:              aws.String("BGPAuthKey"),
			CustomerAddress:      aws.String("CustomerAddress"),
		},
	}
	resp, err := svc.CreatePrivateVirtualInterface(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) CreatePrivateVirtualInterfaceRequest 

func (c *DirectConnect) CreatePrivateVirtualInterfaceRequest(input *CreatePrivateVirtualInterfaceInput) (req *request.Request, output *VirtualInterface)

CreatePrivateVirtualInterfaceRequest generates a "aws/request.Request" representing the client's request for the CreatePrivateVirtualInterface operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See CreatePrivateVirtualInterface for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreatePrivateVirtualInterface method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the CreatePrivateVirtualInterfaceRequest method.
req, resp := client.CreatePrivateVirtualInterfaceRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) CreatePublicVirtualInterface 

func (c *DirectConnect) CreatePublicVirtualInterface(input *CreatePublicVirtualInterfaceInput) (*VirtualInterface, error)

CreatePublicVirtualInterface API operation for AWS Direct Connect.

Creates a new public virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. A public virtual interface supports sending traffic to public services of AWS such as Amazon Simple Storage Service (Amazon S3).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation CreatePublicVirtualInterface for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.CreatePublicVirtualInterfaceInput{
		ConnectionId: aws.String("ConnectionId"), // Required
		NewPublicVirtualInterface: &directconnect.NewPublicVirtualInterface{ // Required
			AmazonAddress:   aws.String("AmazonAddress"),   // Required
			Asn:             aws.Int64(1),                  // Required
			CustomerAddress: aws.String("CustomerAddress"), // Required
			RouteFilterPrefixes: []*directconnect.RouteFilterPrefix{ // Required
				{ // Required
					Cidr: aws.String("CIDR"),
				},
				// More values...
			},
			VirtualInterfaceName: aws.String("VirtualInterfaceName"), // Required
			Vlan:                 aws.Int64(1),                       // Required
			AuthKey:              aws.String("BGPAuthKey"),
		},
	}
	resp, err := svc.CreatePublicVirtualInterface(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) CreatePublicVirtualInterfaceRequest 

func (c *DirectConnect) CreatePublicVirtualInterfaceRequest(input *CreatePublicVirtualInterfaceInput) (req *request.Request, output *VirtualInterface)

CreatePublicVirtualInterfaceRequest generates a "aws/request.Request" representing the client's request for the CreatePublicVirtualInterface operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See CreatePublicVirtualInterface for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreatePublicVirtualInterface method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the CreatePublicVirtualInterfaceRequest method.
req, resp := client.CreatePublicVirtualInterfaceRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DeleteConnection 

func (c *DirectConnect) DeleteConnection(input *DeleteConnectionInput) (*Connection, error)

DeleteConnection API operation for AWS Direct Connect.

Deletes the connection.

Deleting a connection only stops the AWS Direct Connect port hour and data transfer charges. You need to cancel separately with the providers any services or charges for cross-connects or network circuits that connect you to the AWS Direct Connect location.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DeleteConnection for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.DeleteConnectionInput{
		ConnectionId: aws.String("ConnectionId"), // Required
	}
	resp, err := svc.DeleteConnection(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DeleteConnectionRequest 

func (c *DirectConnect) DeleteConnectionRequest(input *DeleteConnectionInput) (req *request.Request, output *Connection)

DeleteConnectionRequest generates a "aws/request.Request" representing the client's request for the DeleteConnection operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteConnection for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteConnection method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DeleteConnectionRequest method.
req, resp := client.DeleteConnectionRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DeleteInterconnect 

func (c *DirectConnect) DeleteInterconnect(input *DeleteInterconnectInput) (*DeleteInterconnectOutput, error)

DeleteInterconnect API operation for AWS Direct Connect.

Deletes the specified interconnect. 

This is intended for use by AWS Direct Connect partners only.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DeleteInterconnect for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.DeleteInterconnectInput{
		InterconnectId: aws.String("InterconnectId"), // Required
	}
	resp, err := svc.DeleteInterconnect(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DeleteInterconnectRequest 

func (c *DirectConnect) DeleteInterconnectRequest(input *DeleteInterconnectInput) (req *request.Request, output *DeleteInterconnectOutput)

DeleteInterconnectRequest generates a "aws/request.Request" representing the client's request for the DeleteInterconnect operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteInterconnect for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteInterconnect method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DeleteInterconnectRequest method.
req, resp := client.DeleteInterconnectRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DeleteVirtualInterface 

func (c *DirectConnect) DeleteVirtualInterface(input *DeleteVirtualInterfaceInput) (*DeleteVirtualInterfaceOutput, error)

DeleteVirtualInterface API operation for AWS Direct Connect.

Deletes a virtual interface.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DeleteVirtualInterface for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.DeleteVirtualInterfaceInput{
		VirtualInterfaceId: aws.String("VirtualInterfaceId"), // Required
	}
	resp, err := svc.DeleteVirtualInterface(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DeleteVirtualInterfaceRequest 

func (c *DirectConnect) DeleteVirtualInterfaceRequest(input *DeleteVirtualInterfaceInput) (req *request.Request, output *DeleteVirtualInterfaceOutput)

DeleteVirtualInterfaceRequest generates a "aws/request.Request" representing the client's request for the DeleteVirtualInterface operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteVirtualInterface for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteVirtualInterface method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DeleteVirtualInterfaceRequest method.
req, resp := client.DeleteVirtualInterfaceRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DescribeConnectionLoa added in v1.2.0 

func (c *DirectConnect) DescribeConnectionLoa(input *DescribeConnectionLoaInput) (*DescribeConnectionLoaOutput, error)

DescribeConnectionLoa API operation for AWS Direct Connect.

Returns 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 AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations (http://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html) in the AWS Direct Connect user guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DescribeConnectionLoa for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.DescribeConnectionLoaInput{
		ConnectionId:   aws.String("ConnectionId"), // Required
		LoaContentType: aws.String("LoaContentType"),
		ProviderName:   aws.String("ProviderName"),
	}
	resp, err := svc.DescribeConnectionLoa(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DescribeConnectionLoaRequest added in v1.2.0 

func (c *DirectConnect) DescribeConnectionLoaRequest(input *DescribeConnectionLoaInput) (req *request.Request, output *DescribeConnectionLoaOutput)

DescribeConnectionLoaRequest generates a "aws/request.Request" representing the client's request for the DescribeConnectionLoa operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeConnectionLoa for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeConnectionLoa method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DescribeConnectionLoaRequest method.
req, resp := client.DescribeConnectionLoaRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DescribeConnections 

func (c *DirectConnect) DescribeConnections(input *DescribeConnectionsInput) (*Connections, error)

DescribeConnections API operation for AWS Direct Connect.

Displays all connections in this region.

If a connection ID is provided, the call returns only that particular connection.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DescribeConnections for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.DescribeConnectionsInput{
		ConnectionId: aws.String("ConnectionId"),
	}
	resp, err := svc.DescribeConnections(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DescribeConnectionsOnInterconnect 

func (c *DirectConnect) DescribeConnectionsOnInterconnect(input *DescribeConnectionsOnInterconnectInput) (*Connections, error)

DescribeConnectionsOnInterconnect API operation for AWS Direct Connect.

Return a list of connections that have been provisioned on the given interconnect. 

This is intended for use by AWS Direct Connect partners only.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DescribeConnectionsOnInterconnect for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.DescribeConnectionsOnInterconnectInput{
		InterconnectId: aws.String("InterconnectId"), // Required
	}
	resp, err := svc.DescribeConnectionsOnInterconnect(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DescribeConnectionsOnInterconnectRequest 

func (c *DirectConnect) DescribeConnectionsOnInterconnectRequest(input *DescribeConnectionsOnInterconnectInput) (req *request.Request, output *Connections)

DescribeConnectionsOnInterconnectRequest generates a "aws/request.Request" representing the client's request for the DescribeConnectionsOnInterconnect operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeConnectionsOnInterconnect for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeConnectionsOnInterconnect method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DescribeConnectionsOnInterconnectRequest method.
req, resp := client.DescribeConnectionsOnInterconnectRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DescribeConnectionsRequest 

func (c *DirectConnect) DescribeConnectionsRequest(input *DescribeConnectionsInput) (req *request.Request, output *Connections)

DescribeConnectionsRequest generates a "aws/request.Request" representing the client's request for the DescribeConnections operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeConnections for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeConnections method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DescribeConnectionsRequest method.
req, resp := client.DescribeConnectionsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DescribeInterconnectLoa added in v1.2.0 

func (c *DirectConnect) DescribeInterconnectLoa(input *DescribeInterconnectLoaInput) (*DescribeInterconnectLoaOutput, error)

DescribeInterconnectLoa API operation for AWS Direct Connect.

Returns the LOA-CFA for an Interconnect.

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations (http://docs.aws.amazon.com/directconnect/latest/UserGuide/Colocation.html) in the AWS Direct Connect user guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DescribeInterconnectLoa for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.DescribeInterconnectLoaInput{
		InterconnectId: aws.String("InterconnectId"), // Required
		LoaContentType: aws.String("LoaContentType"),
		ProviderName:   aws.String("ProviderName"),
	}
	resp, err := svc.DescribeInterconnectLoa(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DescribeInterconnectLoaRequest added in v1.2.0 

func (c *DirectConnect) DescribeInterconnectLoaRequest(input *DescribeInterconnectLoaInput) (req *request.Request, output *DescribeInterconnectLoaOutput)

DescribeInterconnectLoaRequest generates a "aws/request.Request" representing the client's request for the DescribeInterconnectLoa operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeInterconnectLoa for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeInterconnectLoa method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DescribeInterconnectLoaRequest method.
req, resp := client.DescribeInterconnectLoaRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DescribeInterconnects 

func (c *DirectConnect) DescribeInterconnects(input *DescribeInterconnectsInput) (*DescribeInterconnectsOutput, error)

DescribeInterconnects API operation for AWS Direct Connect.

Returns a list of interconnects owned by the AWS account.

If an interconnect ID is provided, it will only return this particular interconnect.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DescribeInterconnects for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.DescribeInterconnectsInput{
		InterconnectId: aws.String("InterconnectId"),
	}
	resp, err := svc.DescribeInterconnects(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DescribeInterconnectsRequest 

func (c *DirectConnect) DescribeInterconnectsRequest(input *DescribeInterconnectsInput) (req *request.Request, output *DescribeInterconnectsOutput)

DescribeInterconnectsRequest generates a "aws/request.Request" representing the client's request for the DescribeInterconnects operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeInterconnects for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeInterconnects method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DescribeInterconnectsRequest method.
req, resp := client.DescribeInterconnectsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DescribeLocations 

func (c *DirectConnect) DescribeLocations(input *DescribeLocationsInput) (*DescribeLocationsOutput, error)

DescribeLocations API operation for AWS Direct Connect.

Returns the list of AWS Direct Connect locations in the current AWS region. These are the locations that may be selected when calling CreateConnection or CreateInterconnect.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DescribeLocations for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	var params *directconnect.DescribeLocationsInput
	resp, err := svc.DescribeLocations(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DescribeLocationsRequest 

func (c *DirectConnect) DescribeLocationsRequest(input *DescribeLocationsInput) (req *request.Request, output *DescribeLocationsOutput)

DescribeLocationsRequest generates a "aws/request.Request" representing the client's request for the DescribeLocations operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeLocations for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeLocations method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DescribeLocationsRequest method.
req, resp := client.DescribeLocationsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DescribeVirtualGateways 

func (c *DirectConnect) DescribeVirtualGateways(input *DescribeVirtualGatewaysInput) (*DescribeVirtualGatewaysOutput, error)

DescribeVirtualGateways API operation for AWS Direct Connect.

Returns a list of virtual private gateways owned by the AWS account.

You can create one or more AWS Direct Connect private virtual interfaces linking to a virtual private gateway. A virtual private gateway can be managed via Amazon Virtual Private Cloud (VPC) console or the EC2 CreateVpnGateway (http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-CreateVpnGateway.html) action.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DescribeVirtualGateways for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	var params *directconnect.DescribeVirtualGatewaysInput
	resp, err := svc.DescribeVirtualGateways(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DescribeVirtualGatewaysRequest 

func (c *DirectConnect) DescribeVirtualGatewaysRequest(input *DescribeVirtualGatewaysInput) (req *request.Request, output *DescribeVirtualGatewaysOutput)

DescribeVirtualGatewaysRequest generates a "aws/request.Request" representing the client's request for the DescribeVirtualGateways operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeVirtualGateways for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeVirtualGateways method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DescribeVirtualGatewaysRequest method.
req, resp := client.DescribeVirtualGatewaysRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*DirectConnect) DescribeVirtualInterfaces 

func (c *DirectConnect) DescribeVirtualInterfaces(input *DescribeVirtualInterfacesInput) (*DescribeVirtualInterfacesOutput, error)

DescribeVirtualInterfaces API operation for AWS Direct Connect.

Displays all virtual interfaces for an AWS account. Virtual interfaces deleted fewer than 15 minutes before DescribeVirtualInterfaces is called are also returned. If a connection ID is included then only virtual interfaces associated with this connection will be returned. If a virtual interface ID is included then only a single virtual interface will be returned.

A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect location and the customer.

If a connection ID is provided, only virtual interfaces provisioned on the specified connection will be returned. If a virtual interface ID is provided, only this particular virtual interface will be returned.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Direct Connect's API operation DescribeVirtualInterfaces for usage and error information.

Returned Error Codes:

  • ServerException A server-side error occurred during the API call. The error message will contain additional details about the cause.

  • ClientException The API was called with invalid parameters. The error message will contain additional details about the cause.

Example 
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/directconnect"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := directconnect.New(sess)

	params := &directconnect.DescribeVirtualInterfacesInput{
		ConnectionId:       aws.String("ConnectionId"),
		VirtualInterfaceId: aws.String("VirtualInterfaceId"),
	}
	resp, err := svc.DescribeVirtualInterfaces(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}

Output:

func (*DirectConnect) DescribeVirtualInterfacesRequest 

func (c *DirectConnect) DescribeVirtualInterfacesRequest(input *DescribeVirtualInterfacesInput) (req *request.Request, output *DescribeVirtualInterfacesOutput)

DescribeVirtualInterfacesRequest generates a "aws/request.Request" representing the client's request for the DescribeVirtualInterfaces operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DescribeVirtualInterfaces for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeVirtualInterfaces method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// Example sending a request using the DescribeVirtualInterfacesRequest method.
req, resp := client.DescribeVirtualInterfacesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

type Interconnect 

type Interconnect struct {

	// Bandwidth of the connection.
	//
	// Example: 1Gbps
	//
	// Default: None
	Bandwidth *string `locationName:"bandwidth" type:"string"`

	// The ID of the interconnect.
	//
	// Example: dxcon-abc123
	InterconnectId *string `locationName:"interconnectId" type:"string"`

	// The name of the interconnect.
	//
	// Example: "1G Interconnect to AWS"
	InterconnectName *string `locationName:"interconnectName" type:"string"`

	// State of the interconnect.
	//
	//    Requested: The initial state of an interconnect. The interconnect stays
	// in the requested state until the Letter of Authorization (LOA) is sent to
	// the customer.
	//
	//    Pending>: The interconnect has been approved, and is being initialized.
	//
	//    Available: The network link is up, and the interconnect is ready for
	// use.
	//
	//    Down: The network link is down.
	//
	//    Deleting: The interconnect is in the process of being deleted.
	//
	//    Deleted: The interconnect has been deleted.
	InterconnectState *string `locationName:"interconnectState" type:"string" enum:"InterconnectState"`

	// The time of the most recent call to DescribeInterconnectLoa for this Interconnect.
	LoaIssueTime *time.Time `locationName:"loaIssueTime" type:"timestamp" timestampFormat:"unix"`

	// Where the connection is located.
	//
	// Example: EqSV5
	//
	// Default: None
	Location *string `locationName:"location" type:"string"`

	// The AWS region where the connection is located.
	//
	// Example: us-east-1
	//
	// Default: None
	Region *string `locationName:"region" type:"string"`
	// contains filtered or unexported fields
}

An interconnect is a connection that can host other connections.

Like a standard AWS Direct Connect connection, an interconnect represents the physical connection between an AWS Direct Connect partner's network and a specific Direct Connect location. An AWS Direct Connect partner who owns an interconnect can provision hosted connections on the interconnect for their end customers, thereby providing the end customers with connectivity to AWS services.

The resources of the interconnect, including bandwidth and VLAN numbers, are shared by all of the hosted connections on the interconnect, and the owner of the interconnect determines how these resources are assigned.

func (Interconnect) GoString added in v0.6.5 

func (s Interconnect) GoString() string

GoString returns the string representation

func (Interconnect) String added in v0.6.5 

func (s Interconnect) String() string

String returns the string representation

type Loa added in v1.2.0 

type Loa struct {

	// The binary contents of the LOA-CFA document.
	//
	// LoaContent is automatically base64 encoded/decoded by the SDK.
	LoaContent []byte `locationName:"loaContent" type:"blob"`

	// A standard media type indicating the content type of the LOA-CFA document.
	// Currently, the only supported value is "application/pdf".
	//
	// Default: application/pdf
	LoaContentType *string `locationName:"loaContentType" type:"string" enum:"LoaContentType"`
	// contains filtered or unexported fields
}

A structure containing the Letter of Authorization - Connecting Facility Assignment (LOA-CFA) for a connection.

func (Loa) GoString added in v1.2.0 

func (s Loa) GoString() string

GoString returns the string representation

func (Loa) String added in v1.2.0 

func (s Loa) String() string

String returns the string representation

type Location 

type Location struct {

	// The code used to indicate the AWS Direct Connect location.
	LocationCode *string `locationName:"locationCode" type:"string"`

	// The name of the AWS Direct Connect location. The name includes the colocation
	// partner name and the physical site of the lit building.
	LocationName *string `locationName:"locationName" type:"string"`
	// contains filtered or unexported fields
}

An AWS Direct Connect location where connections and interconnects can be requested.

func (Location) GoString added in v0.6.5 

func (s Location) GoString() string

GoString returns the string representation

func (Location) String added in v0.6.5 

func (s Location) String() string

String returns the string representation

type NewPrivateVirtualInterface 

type NewPrivateVirtualInterface struct {

	// IP address assigned to the Amazon interface.
	//
	// Example: 192.168.1.1/30
	AmazonAddress *string `locationName:"amazonAddress" type:"string"`

	// Autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.
	//
	// Example: 65000
	//
	// Asn is a required field
	Asn *int64 `locationName:"asn" type:"integer" required:"true"`

	// Authentication key for BGP configuration.
	//
	// Example: asdf34example
	AuthKey *string `locationName:"authKey" type:"string"`

	// IP address assigned to the customer interface.
	//
	// Example: 192.168.1.2/30
	CustomerAddress *string `locationName:"customerAddress" type:"string"`

	// The ID of the virtual private gateway to a VPC. This only applies to private
	// virtual interfaces.
	//
	// Example: vgw-123er56
	//
	// VirtualGatewayId is a required field
	VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string" required:"true"`

	// The name of the virtual interface assigned by the customer.
	//
	// Example: "My VPC"
	//
	// VirtualInterfaceName is a required field
	VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string" required:"true"`

	// The VLAN ID.
	//
	// Example: 101
	//
	// Vlan is a required field
	Vlan *int64 `locationName:"vlan" type:"integer" required:"true"`
	// contains filtered or unexported fields
}

A structure containing information about a new private virtual interface.

func (NewPrivateVirtualInterface) GoString added in v0.6.5 

func (s NewPrivateVirtualInterface) GoString() string

GoString returns the string representation

func (NewPrivateVirtualInterface) String added in v0.6.5 

func (s NewPrivateVirtualInterface) String() string

String returns the string representation

func (*NewPrivateVirtualInterface) Validate added in v1.1.21 

func (s *NewPrivateVirtualInterface) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type NewPrivateVirtualInterfaceAllocation 

type NewPrivateVirtualInterfaceAllocation struct {

	// IP address assigned to the Amazon interface.
	//
	// Example: 192.168.1.1/30
	AmazonAddress *string `locationName:"amazonAddress" type:"string"`

	// Autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.
	//
	// Example: 65000
	//
	// Asn is a required field
	Asn *int64 `locationName:"asn" type:"integer" required:"true"`

	// Authentication key for BGP configuration.
	//
	// Example: asdf34example
	AuthKey *string `locationName:"authKey" type:"string"`

	// IP address assigned to the customer interface.
	//
	// Example: 192.168.1.2/30
	CustomerAddress *string `locationName:"customerAddress" type:"string"`

	// The name of the virtual interface assigned by the customer.
	//
	// Example: "My VPC"
	//
	// VirtualInterfaceName is a required field
	VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string" required:"true"`

	// The VLAN ID.
	//
	// Example: 101
	//
	// Vlan is a required field
	Vlan *int64 `locationName:"vlan" type:"integer" required:"true"`
	// contains filtered or unexported fields
}

A structure containing information about a private virtual interface that will be provisioned on a connection.

func (NewPrivateVirtualInterfaceAllocation) GoString added in v0.6.5 

func (s NewPrivateVirtualInterfaceAllocation) GoString() string

GoString returns the string representation

func (NewPrivateVirtualInterfaceAllocation) String added in v0.6.5 

func (s NewPrivateVirtualInterfaceAllocation) String() string

String returns the string representation

func (*NewPrivateVirtualInterfaceAllocation) Validate added in v1.1.21 

func (s *NewPrivateVirtualInterfaceAllocation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type NewPublicVirtualInterface 

type NewPublicVirtualInterface struct {

	// IP address assigned to the Amazon interface.
	//
	// Example: 192.168.1.1/30
	//
	// AmazonAddress is a required field
	AmazonAddress *string `locationName:"amazonAddress" type:"string" required:"true"`

	// Autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.
	//
	// Example: 65000
	//
	// Asn is a required field
	Asn *int64 `locationName:"asn" type:"integer" required:"true"`

	// Authentication key for BGP configuration.
	//
	// Example: asdf34example
	AuthKey *string `locationName:"authKey" type:"string"`

	// IP address assigned to the customer interface.
	//
	// Example: 192.168.1.2/30
	//
	// CustomerAddress is a required field
	CustomerAddress *string `locationName:"customerAddress" type:"string" required:"true"`

	// A list of routes to be advertised to the AWS network in this region (public
	// virtual interface).
	//
	// RouteFilterPrefixes is a required field
	RouteFilterPrefixes []*RouteFilterPrefix `locationName:"routeFilterPrefixes" type:"list" required:"true"`

	// The name of the virtual interface assigned by the customer.
	//
	// Example: "My VPC"
	//
	// VirtualInterfaceName is a required field
	VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string" required:"true"`

	// The VLAN ID.
	//
	// Example: 101
	//
	// Vlan is a required field
	Vlan *int64 `locationName:"vlan" type:"integer" required:"true"`
	// contains filtered or unexported fields
}

A structure containing information about a new public virtual interface.

func (NewPublicVirtualInterface) GoString added in v0.6.5 

func (s NewPublicVirtualInterface) GoString() string

GoString returns the string representation

func (NewPublicVirtualInterface) String added in v0.6.5 

func (s NewPublicVirtualInterface) String() string

String returns the string representation

func (*NewPublicVirtualInterface) Validate added in v1.1.21 

func (s *NewPublicVirtualInterface) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type NewPublicVirtualInterfaceAllocation 

type NewPublicVirtualInterfaceAllocation struct {

	// IP address assigned to the Amazon interface.
	//
	// Example: 192.168.1.1/30
	//
	// AmazonAddress is a required field
	AmazonAddress *string `locationName:"amazonAddress" type:"string" required:"true"`

	// Autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.
	//
	// Example: 65000
	//
	// Asn is a required field
	Asn *int64 `locationName:"asn" type:"integer" required:"true"`

	// Authentication key for BGP configuration.
	//
	// Example: asdf34example
	AuthKey *string `locationName:"authKey" type:"string"`

	// IP address assigned to the customer interface.
	//
	// Example: 192.168.1.2/30
	//
	// CustomerAddress is a required field
	CustomerAddress *string `locationName:"customerAddress" type:"string" required:"true"`

	// A list of routes to be advertised to the AWS network in this region (public
	// virtual interface).
	//
	// RouteFilterPrefixes is a required field
	RouteFilterPrefixes []*RouteFilterPrefix `locationName:"routeFilterPrefixes" type:"list" required:"true"`

	// The name of the virtual interface assigned by the customer.
	//
	// Example: "My VPC"
	//
	// VirtualInterfaceName is a required field
	VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string" required:"true"`

	// The VLAN ID.
	//
	// Example: 101
	//
	// Vlan is a required field
	Vlan *int64 `locationName:"vlan" type:"integer" required:"true"`
	// contains filtered or unexported fields
}

A structure containing information about a public virtual interface that will be provisioned on a connection.

func (NewPublicVirtualInterfaceAllocation) GoString added in v0.6.5 

func (s NewPublicVirtualInterfaceAllocation) GoString() string

GoString returns the string representation

func (NewPublicVirtualInterfaceAllocation) String added in v0.6.5 

func (s NewPublicVirtualInterfaceAllocation) String() string

String returns the string representation

func (*NewPublicVirtualInterfaceAllocation) Validate added in v1.1.21 

func (s *NewPublicVirtualInterfaceAllocation) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type RouteFilterPrefix 

type RouteFilterPrefix struct {

	// CIDR notation for the advertised route. Multiple routes are separated by
	// commas.
	//
	// Example: 10.10.10.0/24,10.10.11.0/24
	Cidr *string `locationName:"cidr" type:"string"`
	// contains filtered or unexported fields
}

A route filter prefix that the customer can advertise through Border Gateway Protocol (BGP) over a public virtual interface.

func (RouteFilterPrefix) GoString added in v0.6.5 

func (s RouteFilterPrefix) GoString() string

GoString returns the string representation

func (RouteFilterPrefix) String added in v0.6.5 

func (s RouteFilterPrefix) String() string

String returns the string representation

type VirtualGateway 

type VirtualGateway struct {

	// The ID of the virtual private gateway to a VPC. This only applies to private
	// virtual interfaces.
	//
	// Example: vgw-123er56
	VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string"`

	// State of the virtual private gateway.
	//
	//    Pending: This is the initial state after calling CreateVpnGateway.
	//
	//    Available: Ready for use by a private virtual interface.
	//
	//    Deleting: This is the initial state after calling DeleteVpnGateway.
	//
	//    Deleted: In this state, a private virtual interface is unable to send
	// traffic over this gateway.
	VirtualGatewayState *string `locationName:"virtualGatewayState" type:"string"`
	// contains filtered or unexported fields
}

You can create one or more AWS Direct Connect private virtual interfaces linking to your virtual private gateway.

Virtual private gateways can be managed using the Amazon Virtual Private Cloud (Amazon VPC) console or the Amazon EC2 CreateVpnGateway action (http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-CreateVpnGateway.html).

func (VirtualGateway) GoString added in v0.6.5 

func (s VirtualGateway) GoString() string

GoString returns the string representation

func (VirtualGateway) String added in v0.6.5 

func (s VirtualGateway) String() string

String returns the string representation

type VirtualInterface 

type VirtualInterface struct {

	// IP address assigned to the Amazon interface.
	//
	// Example: 192.168.1.1/30
	AmazonAddress *string `locationName:"amazonAddress" type:"string"`

	// Autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.
	//
	// Example: 65000
	Asn *int64 `locationName:"asn" type:"integer"`

	// Authentication key for BGP configuration.
	//
	// Example: asdf34example
	AuthKey *string `locationName:"authKey" type:"string"`

	// ID of the connection.
	//
	// Example: dxcon-fg5678gh
	//
	// Default: None
	ConnectionId *string `locationName:"connectionId" type:"string"`

	// IP address assigned to the customer interface.
	//
	// Example: 192.168.1.2/30
	CustomerAddress *string `locationName:"customerAddress" type:"string"`

	// Information for generating the customer router configuration.
	CustomerRouterConfig *string `locationName:"customerRouterConfig" type:"string"`

	// Where the connection is located.
	//
	// Example: EqSV5
	//
	// Default: None
	Location *string `locationName:"location" type:"string"`

	// The AWS account that will own the new virtual interface.
	OwnerAccount *string `locationName:"ownerAccount" type:"string"`

	// A list of routes to be advertised to the AWS network in this region (public
	// virtual interface).
	RouteFilterPrefixes []*RouteFilterPrefix `locationName:"routeFilterPrefixes" type:"list"`

	// The ID of the virtual private gateway to a VPC. This only applies to private
	// virtual interfaces.
	//
	// Example: vgw-123er56
	VirtualGatewayId *string `locationName:"virtualGatewayId" type:"string"`

	// ID of the virtual interface.
	//
	// Example: dxvif-123dfg56
	//
	// Default: None
	VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string"`

	// The name of the virtual interface assigned by the customer.
	//
	// Example: "My VPC"
	VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string"`

	// State of the virtual interface.
	//
	//    Confirming: The creation of the virtual interface is pending confirmation
	// from the virtual interface owner. If the owner of the virtual interface is
	// different from the owner of the connection on which it is provisioned, then
	// the virtual interface will remain in this state until it is confirmed by
	// the virtual interface owner.
	//
	//    Verifying: This state only applies to public virtual interfaces. Each
	// public virtual interface needs validation before the virtual interface can
	// be created.
	//
	//    Pending: A virtual interface is in this state from the time that it is
	// created until the virtual interface is ready to forward traffic.
	//
	//    Available: A virtual interface that is able to forward traffic.
	//
	//    Down: A virtual interface that is BGP down.
	//
	//    Deleting: A virtual interface is in this state immediately after calling
	// DeleteVirtualInterface until it can no longer forward traffic.
	//
	//    Deleted: A virtual interface that cannot forward traffic.
	//
	//    Rejected: The virtual interface owner has declined creation of the virtual
	// interface. If a virtual interface in the 'Confirming' state is deleted by
	// the virtual interface owner, the virtual interface will enter the 'Rejected'
	// state.
	VirtualInterfaceState *string `locationName:"virtualInterfaceState" type:"string" enum:"VirtualInterfaceState"`

	// The type of virtual interface.
	//
	// Example: private (Amazon VPC) or public (Amazon S3, Amazon DynamoDB, and
	// so on.)
	VirtualInterfaceType *string `locationName:"virtualInterfaceType" type:"string"`

	// The VLAN ID.
	//
	// Example: 101
	Vlan *int64 `locationName:"vlan" type:"integer"`
	// contains filtered or unexported fields
}

A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect location and the customer.

func (VirtualInterface) GoString added in v0.6.5 

func (s VirtualInterface) GoString() string

GoString returns the string representation

func (VirtualInterface) String added in v0.6.5 

func (s VirtualInterface) String() string

String returns the string representation

Source Files

View all Source files

Directories

Path Synopsis
Package directconnectiface provides an interface to enable mocking the AWS Direct Connect service client for testing your code.
 Package directconnectiface provides an interface to enable mocking the AWS Direct Connect service client for testing your code.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.