Documentation ¶
Overview ¶
Package directconnect provides a client for AWS Direct Connect.
Index ¶
- Constants
- type AllocateConnectionOnInterconnectInput
- type AllocatePrivateVirtualInterfaceInput
- type AllocatePublicVirtualInterfaceInput
- type ConfirmConnectionInput
- type ConfirmConnectionOutput
- type ConfirmPrivateVirtualInterfaceInput
- type ConfirmPrivateVirtualInterfaceOutput
- type ConfirmPublicVirtualInterfaceInput
- type ConfirmPublicVirtualInterfaceOutput
- type Connection
- type Connections
- type CreateConnectionInput
- type CreateInterconnectInput
- type CreatePrivateVirtualInterfaceInput
- type CreatePublicVirtualInterfaceInput
- type DeleteConnectionInput
- type DeleteInterconnectInput
- type DeleteInterconnectOutput
- type DeleteVirtualInterfaceInput
- type DeleteVirtualInterfaceOutput
- type DescribeConnectionLoaInput
- type DescribeConnectionLoaOutput
- type DescribeConnectionsInput
- type DescribeConnectionsOnInterconnectInput
- type DescribeInterconnectLoaInput
- type DescribeInterconnectLoaOutput
- type DescribeInterconnectsInput
- type DescribeInterconnectsOutput
- type DescribeLocationsInput
- type DescribeLocationsOutput
- type DescribeVirtualGatewaysInput
- type DescribeVirtualGatewaysOutput
- type DescribeVirtualInterfacesInput
- type DescribeVirtualInterfacesOutput
- type DirectConnect
- func (c *DirectConnect) AllocateConnectionOnInterconnect(input *AllocateConnectionOnInterconnectInput) (*Connection, error)
- func (c *DirectConnect) AllocateConnectionOnInterconnectRequest(input *AllocateConnectionOnInterconnectInput) (req *request.Request, output *Connection)
- func (c *DirectConnect) AllocatePrivateVirtualInterface(input *AllocatePrivateVirtualInterfaceInput) (*VirtualInterface, error)
- func (c *DirectConnect) AllocatePrivateVirtualInterfaceRequest(input *AllocatePrivateVirtualInterfaceInput) (req *request.Request, output *VirtualInterface)
- func (c *DirectConnect) AllocatePublicVirtualInterface(input *AllocatePublicVirtualInterfaceInput) (*VirtualInterface, error)
- func (c *DirectConnect) AllocatePublicVirtualInterfaceRequest(input *AllocatePublicVirtualInterfaceInput) (req *request.Request, output *VirtualInterface)
- func (c *DirectConnect) ConfirmConnection(input *ConfirmConnectionInput) (*ConfirmConnectionOutput, error)
- func (c *DirectConnect) ConfirmConnectionRequest(input *ConfirmConnectionInput) (req *request.Request, output *ConfirmConnectionOutput)
- func (c *DirectConnect) ConfirmPrivateVirtualInterface(input *ConfirmPrivateVirtualInterfaceInput) (*ConfirmPrivateVirtualInterfaceOutput, error)
- func (c *DirectConnect) ConfirmPrivateVirtualInterfaceRequest(input *ConfirmPrivateVirtualInterfaceInput) (req *request.Request, output *ConfirmPrivateVirtualInterfaceOutput)
- func (c *DirectConnect) ConfirmPublicVirtualInterface(input *ConfirmPublicVirtualInterfaceInput) (*ConfirmPublicVirtualInterfaceOutput, error)
- func (c *DirectConnect) ConfirmPublicVirtualInterfaceRequest(input *ConfirmPublicVirtualInterfaceInput) (req *request.Request, output *ConfirmPublicVirtualInterfaceOutput)
- func (c *DirectConnect) CreateConnection(input *CreateConnectionInput) (*Connection, error)
- func (c *DirectConnect) CreateConnectionRequest(input *CreateConnectionInput) (req *request.Request, output *Connection)
- func (c *DirectConnect) CreateInterconnect(input *CreateInterconnectInput) (*Interconnect, error)
- func (c *DirectConnect) CreateInterconnectRequest(input *CreateInterconnectInput) (req *request.Request, output *Interconnect)
- func (c *DirectConnect) CreatePrivateVirtualInterface(input *CreatePrivateVirtualInterfaceInput) (*VirtualInterface, error)
- func (c *DirectConnect) CreatePrivateVirtualInterfaceRequest(input *CreatePrivateVirtualInterfaceInput) (req *request.Request, output *VirtualInterface)
- func (c *DirectConnect) CreatePublicVirtualInterface(input *CreatePublicVirtualInterfaceInput) (*VirtualInterface, error)
- func (c *DirectConnect) CreatePublicVirtualInterfaceRequest(input *CreatePublicVirtualInterfaceInput) (req *request.Request, output *VirtualInterface)
- func (c *DirectConnect) DeleteConnection(input *DeleteConnectionInput) (*Connection, error)
- func (c *DirectConnect) DeleteConnectionRequest(input *DeleteConnectionInput) (req *request.Request, output *Connection)
- func (c *DirectConnect) DeleteInterconnect(input *DeleteInterconnectInput) (*DeleteInterconnectOutput, error)
- func (c *DirectConnect) DeleteInterconnectRequest(input *DeleteInterconnectInput) (req *request.Request, output *DeleteInterconnectOutput)
- func (c *DirectConnect) DeleteVirtualInterface(input *DeleteVirtualInterfaceInput) (*DeleteVirtualInterfaceOutput, error)
- func (c *DirectConnect) DeleteVirtualInterfaceRequest(input *DeleteVirtualInterfaceInput) (req *request.Request, output *DeleteVirtualInterfaceOutput)
- func (c *DirectConnect) DescribeConnectionLoa(input *DescribeConnectionLoaInput) (*DescribeConnectionLoaOutput, error)
- func (c *DirectConnect) DescribeConnectionLoaRequest(input *DescribeConnectionLoaInput) (req *request.Request, output *DescribeConnectionLoaOutput)
- func (c *DirectConnect) DescribeConnections(input *DescribeConnectionsInput) (*Connections, error)
- func (c *DirectConnect) DescribeConnectionsOnInterconnect(input *DescribeConnectionsOnInterconnectInput) (*Connections, error)
- func (c *DirectConnect) DescribeConnectionsOnInterconnectRequest(input *DescribeConnectionsOnInterconnectInput) (req *request.Request, output *Connections)
- func (c *DirectConnect) DescribeConnectionsRequest(input *DescribeConnectionsInput) (req *request.Request, output *Connections)
- func (c *DirectConnect) DescribeInterconnectLoa(input *DescribeInterconnectLoaInput) (*DescribeInterconnectLoaOutput, error)
- func (c *DirectConnect) DescribeInterconnectLoaRequest(input *DescribeInterconnectLoaInput) (req *request.Request, output *DescribeInterconnectLoaOutput)
- func (c *DirectConnect) DescribeInterconnects(input *DescribeInterconnectsInput) (*DescribeInterconnectsOutput, error)
- func (c *DirectConnect) DescribeInterconnectsRequest(input *DescribeInterconnectsInput) (req *request.Request, output *DescribeInterconnectsOutput)
- func (c *DirectConnect) DescribeLocations(input *DescribeLocationsInput) (*DescribeLocationsOutput, error)
- func (c *DirectConnect) DescribeLocationsRequest(input *DescribeLocationsInput) (req *request.Request, output *DescribeLocationsOutput)
- func (c *DirectConnect) DescribeVirtualGateways(input *DescribeVirtualGatewaysInput) (*DescribeVirtualGatewaysOutput, error)
- func (c *DirectConnect) DescribeVirtualGatewaysRequest(input *DescribeVirtualGatewaysInput) (req *request.Request, output *DescribeVirtualGatewaysOutput)
- func (c *DirectConnect) DescribeVirtualInterfaces(input *DescribeVirtualInterfacesInput) (*DescribeVirtualInterfacesOutput, error)
- func (c *DirectConnect) DescribeVirtualInterfacesRequest(input *DescribeVirtualInterfacesInput) (req *request.Request, output *DescribeVirtualInterfacesOutput)
- type Interconnect
- type Loa
- type Location
- type NewPrivateVirtualInterface
- type NewPrivateVirtualInterfaceAllocation
- type NewPublicVirtualInterface
- type NewPublicVirtualInterfaceAllocation
- type RouteFilterPrefix
- type VirtualGateway
- type VirtualInterface
Examples ¶
- DirectConnect.AllocateConnectionOnInterconnect
- DirectConnect.AllocatePrivateVirtualInterface
- DirectConnect.AllocatePublicVirtualInterface
- DirectConnect.ConfirmConnection
- DirectConnect.ConfirmPrivateVirtualInterface
- DirectConnect.ConfirmPublicVirtualInterface
- DirectConnect.CreateConnection
- DirectConnect.CreateInterconnect
- DirectConnect.CreatePrivateVirtualInterface
- DirectConnect.CreatePublicVirtualInterface
- DirectConnect.DeleteConnection
- DirectConnect.DeleteInterconnect
- DirectConnect.DeleteVirtualInterface
- DirectConnect.DescribeConnectionLoa
- DirectConnect.DescribeConnections
- DirectConnect.DescribeConnectionsOnInterconnect
- DirectConnect.DescribeInterconnectLoa
- DirectConnect.DescribeInterconnects
- DirectConnect.DescribeLocations
- DirectConnect.DescribeVirtualGateways
- DirectConnect.DescribeVirtualInterfaces
Constants ¶
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.
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.
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.
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
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 ¶
func (s AllocateConnectionOnInterconnectInput) GoString() string
GoString returns the string representation
func (AllocateConnectionOnInterconnectInput) String ¶
func (s AllocateConnectionOnInterconnectInput) String() string
String returns the string representation
func (*AllocateConnectionOnInterconnectInput) Validate ¶
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 ¶
func (s AllocatePrivateVirtualInterfaceInput) GoString() string
GoString returns the string representation
func (AllocatePrivateVirtualInterfaceInput) String ¶
func (s AllocatePrivateVirtualInterfaceInput) String() string
String returns the string representation
func (*AllocatePrivateVirtualInterfaceInput) Validate ¶
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 ¶
func (s AllocatePublicVirtualInterfaceInput) GoString() string
GoString returns the string representation
func (AllocatePublicVirtualInterfaceInput) String ¶
func (s AllocatePublicVirtualInterfaceInput) String() string
String returns the string representation
func (*AllocatePublicVirtualInterfaceInput) Validate ¶
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 ¶
func (s ConfirmConnectionInput) GoString() string
GoString returns the string representation
func (ConfirmConnectionInput) String ¶
func (s ConfirmConnectionInput) String() string
String returns the string representation
func (*ConfirmConnectionInput) Validate ¶
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 ¶
func (s ConfirmConnectionOutput) GoString() string
GoString returns the string representation
func (ConfirmConnectionOutput) String ¶
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 ¶
func (s ConfirmPrivateVirtualInterfaceInput) GoString() string
GoString returns the string representation
func (ConfirmPrivateVirtualInterfaceInput) String ¶
func (s ConfirmPrivateVirtualInterfaceInput) String() string
String returns the string representation
func (*ConfirmPrivateVirtualInterfaceInput) Validate ¶
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 ¶
func (s ConfirmPrivateVirtualInterfaceOutput) GoString() string
GoString returns the string representation
func (ConfirmPrivateVirtualInterfaceOutput) String ¶
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 ¶
func (s ConfirmPublicVirtualInterfaceInput) GoString() string
GoString returns the string representation
func (ConfirmPublicVirtualInterfaceInput) String ¶
func (s ConfirmPublicVirtualInterfaceInput) String() string
String returns the string representation
func (*ConfirmPublicVirtualInterfaceInput) Validate ¶
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 ¶
func (s ConfirmPublicVirtualInterfaceOutput) GoString() string
GoString returns the string representation
func (ConfirmPublicVirtualInterfaceOutput) String ¶
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 ¶
func (s Connection) GoString() string
GoString returns the string representation
func (Connection) String ¶
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 ¶
func (s Connections) GoString() string
GoString returns the string representation
func (Connections) String ¶
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 ¶
func (s CreateConnectionInput) GoString() string
GoString returns the string representation
func (CreateConnectionInput) String ¶
func (s CreateConnectionInput) String() string
String returns the string representation
func (*CreateConnectionInput) Validate ¶
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 ¶
func (s CreateInterconnectInput) GoString() string
GoString returns the string representation
func (CreateInterconnectInput) String ¶
func (s CreateInterconnectInput) String() string
String returns the string representation
func (*CreateInterconnectInput) Validate ¶
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 ¶
func (s CreatePrivateVirtualInterfaceInput) GoString() string
GoString returns the string representation
func (CreatePrivateVirtualInterfaceInput) String ¶
func (s CreatePrivateVirtualInterfaceInput) String() string
String returns the string representation
func (*CreatePrivateVirtualInterfaceInput) Validate ¶
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 ¶
func (s CreatePublicVirtualInterfaceInput) GoString() string
GoString returns the string representation
func (CreatePublicVirtualInterfaceInput) String ¶
func (s CreatePublicVirtualInterfaceInput) String() string
String returns the string representation
func (*CreatePublicVirtualInterfaceInput) Validate ¶
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 ¶
func (s DeleteConnectionInput) GoString() string
GoString returns the string representation
func (DeleteConnectionInput) String ¶
func (s DeleteConnectionInput) String() string
String returns the string representation
func (*DeleteConnectionInput) Validate ¶
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 ¶
func (s DeleteInterconnectInput) GoString() string
GoString returns the string representation
func (DeleteInterconnectInput) String ¶
func (s DeleteInterconnectInput) String() string
String returns the string representation
func (*DeleteInterconnectInput) Validate ¶
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 ¶
func (s DeleteInterconnectOutput) GoString() string
GoString returns the string representation
func (DeleteInterconnectOutput) String ¶
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 ¶
func (s DeleteVirtualInterfaceInput) GoString() string
GoString returns the string representation
func (DeleteVirtualInterfaceInput) String ¶
func (s DeleteVirtualInterfaceInput) String() string
String returns the string representation
func (*DeleteVirtualInterfaceInput) Validate ¶
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 ¶
func (s DeleteVirtualInterfaceOutput) GoString() string
GoString returns the string representation
func (DeleteVirtualInterfaceOutput) String ¶
func (s DeleteVirtualInterfaceOutput) String() string
String returns the string representation
type DescribeConnectionLoaInput ¶
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 ¶
func (s DescribeConnectionLoaInput) GoString() string
GoString returns the string representation
func (DescribeConnectionLoaInput) String ¶
func (s DescribeConnectionLoaInput) String() string
String returns the string representation
func (*DescribeConnectionLoaInput) Validate ¶
func (s *DescribeConnectionLoaInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DescribeConnectionLoaOutput ¶
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 ¶
func (s DescribeConnectionLoaOutput) GoString() string
GoString returns the string representation
func (DescribeConnectionLoaOutput) String ¶
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 ¶
func (s DescribeConnectionsInput) GoString() string
GoString returns the string representation
func (DescribeConnectionsInput) String ¶
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 ¶
func (s DescribeConnectionsOnInterconnectInput) GoString() string
GoString returns the string representation
func (DescribeConnectionsOnInterconnectInput) String ¶
func (s DescribeConnectionsOnInterconnectInput) String() string
String returns the string representation
func (*DescribeConnectionsOnInterconnectInput) Validate ¶
func (s *DescribeConnectionsOnInterconnectInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DescribeInterconnectLoaInput ¶
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 ¶
func (s DescribeInterconnectLoaInput) GoString() string
GoString returns the string representation
func (DescribeInterconnectLoaInput) String ¶
func (s DescribeInterconnectLoaInput) String() string
String returns the string representation
func (*DescribeInterconnectLoaInput) Validate ¶
func (s *DescribeInterconnectLoaInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DescribeInterconnectLoaOutput ¶
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 ¶
func (s DescribeInterconnectLoaOutput) GoString() string
GoString returns the string representation
func (DescribeInterconnectLoaOutput) String ¶
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 ¶
func (s DescribeInterconnectsInput) GoString() string
GoString returns the string representation
func (DescribeInterconnectsInput) String ¶
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 ¶
func (s DescribeInterconnectsOutput) GoString() string
GoString returns the string representation
func (DescribeInterconnectsOutput) String ¶
func (s DescribeInterconnectsOutput) String() string
String returns the string representation
type DescribeLocationsInput ¶
type DescribeLocationsInput struct {
// contains filtered or unexported fields
}
func (DescribeLocationsInput) GoString ¶
func (s DescribeLocationsInput) GoString() string
GoString returns the string representation
func (DescribeLocationsInput) String ¶
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 ¶
func (s DescribeLocationsOutput) GoString() string
GoString returns the string representation
func (DescribeLocationsOutput) String ¶
func (s DescribeLocationsOutput) String() string
String returns the string representation
type DescribeVirtualGatewaysInput ¶
type DescribeVirtualGatewaysInput struct {
// contains filtered or unexported fields
}
func (DescribeVirtualGatewaysInput) GoString ¶
func (s DescribeVirtualGatewaysInput) GoString() string
GoString returns the string representation
func (DescribeVirtualGatewaysInput) String ¶
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 ¶
func (s DescribeVirtualGatewaysOutput) GoString() string
GoString returns the string representation
func (DescribeVirtualGatewaysOutput) String ¶
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 ¶
func (s DescribeVirtualInterfacesInput) GoString() string
GoString returns the string representation
func (DescribeVirtualInterfacesInput) String ¶
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 ¶
func (s DescribeVirtualInterfacesOutput) GoString() string
GoString returns the string representation
func (DescribeVirtualInterfacesOutput) String ¶
func (s DescribeVirtualInterfacesOutput) String() string
String returns the string representation
type DirectConnect ¶
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 ¶
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 ¶
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 ¶
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 ¶
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 ¶
func (s Interconnect) GoString() string
GoString returns the string representation
func (Interconnect) String ¶
func (s Interconnect) String() string
String returns the string representation
type Loa ¶
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.
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.
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 ¶
func (s NewPrivateVirtualInterface) GoString() string
GoString returns the string representation
func (NewPrivateVirtualInterface) String ¶
func (s NewPrivateVirtualInterface) String() string
String returns the string representation
func (*NewPrivateVirtualInterface) Validate ¶
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 ¶
func (s NewPrivateVirtualInterfaceAllocation) GoString() string
GoString returns the string representation
func (NewPrivateVirtualInterfaceAllocation) String ¶
func (s NewPrivateVirtualInterfaceAllocation) String() string
String returns the string representation
func (*NewPrivateVirtualInterfaceAllocation) Validate ¶
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 ¶
func (s NewPublicVirtualInterface) GoString() string
GoString returns the string representation
func (NewPublicVirtualInterface) String ¶
func (s NewPublicVirtualInterface) String() string
String returns the string representation
func (*NewPublicVirtualInterface) Validate ¶
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 ¶
func (s NewPublicVirtualInterfaceAllocation) GoString() string
GoString returns the string representation
func (NewPublicVirtualInterfaceAllocation) String ¶
func (s NewPublicVirtualInterfaceAllocation) String() string
String returns the string representation
func (*NewPublicVirtualInterfaceAllocation) Validate ¶
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 ¶
func (s RouteFilterPrefix) GoString() string
GoString returns the string representation
func (RouteFilterPrefix) String ¶
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 ¶
func (s VirtualGateway) GoString() string
GoString returns the string representation
func (VirtualGateway) String ¶
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 ¶
func (s VirtualInterface) GoString() string
GoString returns the string representation
func (VirtualInterface) String ¶
func (s VirtualInterface) String() string
String returns the string representation
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. |