-
Notifications
You must be signed in to change notification settings - Fork 598
/
api_op_AssociateVirtualInterface.go
244 lines (196 loc) · 9.26 KB
/
api_op_AssociateVirtualInterface.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
package directconnect
import (
"context"
"github.com/aws/aws-sdk-go-v2/aws"
"github.com/aws/aws-sdk-go-v2/internal/awsutil"
)
// Please also see https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AssociateVirtualInterfaceRequest
type AssociateVirtualInterfaceInput struct {
_ struct{} `type:"structure"`
// The ID of the LAG or connection.
//
// ConnectionId is a required field
ConnectionId *string `locationName:"connectionId" type:"string" required:"true"`
// The ID of the virtual interface.
//
// VirtualInterfaceId is a required field
VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string" required:"true"`
}
// String returns the string representation
func (s AssociateVirtualInterfaceInput) String() string {
return awsutil.Prettify(s)
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *AssociateVirtualInterfaceInput) Validate() error {
invalidParams := aws.ErrInvalidParams{Context: "AssociateVirtualInterfaceInput"}
if s.ConnectionId == nil {
invalidParams.Add(aws.NewErrParamRequired("ConnectionId"))
}
if s.VirtualInterfaceId == nil {
invalidParams.Add(aws.NewErrParamRequired("VirtualInterfaceId"))
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
// Information about a virtual interface.
// Please also see https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/VirtualInterface
type AssociateVirtualInterfaceOutput struct {
_ struct{} `type:"structure"`
// The address family for the BGP peer.
AddressFamily AddressFamily `locationName:"addressFamily" type:"string" enum:"true"`
// The IP address assigned to the Amazon interface.
AmazonAddress *string `locationName:"amazonAddress" type:"string"`
// The autonomous system number (ASN) for the Amazon side of the connection.
AmazonSideAsn *int64 `locationName:"amazonSideAsn" type:"long"`
// The autonomous system (AS) number for Border Gateway Protocol (BGP) configuration.
Asn *int64 `locationName:"asn" type:"integer"`
// The authentication key for BGP configuration. This string has a minimum length
// of 6 characters and and a maximun lenth of 80 characters.
AuthKey *string `locationName:"authKey" type:"string"`
// The Direct Connect endpoint on which the virtual interface terminates.
AwsDeviceV2 *string `locationName:"awsDeviceV2" type:"string"`
// The BGP peers configured on this virtual interface.
BgpPeers []BGPPeer `locationName:"bgpPeers" type:"list"`
// The ID of the connection.
ConnectionId *string `locationName:"connectionId" type:"string"`
// The IP address assigned to the customer interface.
CustomerAddress *string `locationName:"customerAddress" type:"string"`
// The customer router configuration.
CustomerRouterConfig *string `locationName:"customerRouterConfig" type:"string"`
// The ID of the Direct Connect gateway.
DirectConnectGatewayId *string `locationName:"directConnectGatewayId" type:"string"`
// Indicates whether jumbo frames (9001 MTU) are supported.
JumboFrameCapable *bool `locationName:"jumboFrameCapable" type:"boolean"`
// The location of the connection.
Location *string `locationName:"location" type:"string"`
// The maximum transmission unit (MTU), in bytes. The supported values are 1500
// and 9001. The default value is 1500.
Mtu *int64 `locationName:"mtu" type:"integer"`
// The ID of the AWS account that owns the virtual interface.
OwnerAccount *string `locationName:"ownerAccount" type:"string"`
// The AWS Region where the virtual interface is located.
Region *string `locationName:"region" type:"string"`
// The routes to be advertised to the AWS network in this Region. Applies to
// public virtual interfaces.
RouteFilterPrefixes []RouteFilterPrefix `locationName:"routeFilterPrefixes" type:"list"`
// Any tags assigned to the virtual interface.
Tags []Tag `locationName:"tags" min:"1" type:"list"`
// The ID of the virtual private gateway. Applies only to private virtual interfaces.
VirtualGatewayId *string `locationName:"virtualGatewayId" deprecated:"true" type:"string"`
// The ID of the virtual interface.
VirtualInterfaceId *string `locationName:"virtualInterfaceId" type:"string"`
// The name of the virtual interface assigned by the customer network.
VirtualInterfaceName *string `locationName:"virtualInterfaceName" type:"string"`
// The state of the virtual interface. The following are the possible values:
//
// * 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 enters the Rejected
// state.
//
// * unknown: The state of the virtual interface is not available.
VirtualInterfaceState VirtualInterfaceState `locationName:"virtualInterfaceState" type:"string" enum:"true"`
// The type of virtual interface. The possible values are private and public.
VirtualInterfaceType *string `locationName:"virtualInterfaceType" type:"string"`
// The ID of the VLAN.
Vlan *int64 `locationName:"vlan" type:"integer"`
}
// String returns the string representation
func (s AssociateVirtualInterfaceOutput) String() string {
return awsutil.Prettify(s)
}
const opAssociateVirtualInterface = "AssociateVirtualInterface"
// AssociateVirtualInterfaceRequest returns a request value for making API operation for
// AWS Direct Connect.
//
// Associates a virtual interface with a specified link aggregation group (LAG)
// or connection. Connectivity to AWS is temporarily interrupted as the virtual
// interface is being migrated. If the target connection or LAG has an associated
// virtual interface with a conflicting VLAN number or a conflicting IP address,
// the operation fails.
//
// Virtual interfaces associated with a hosted connection cannot be associated
// with a LAG; hosted connections must be migrated along with their virtual
// interfaces using AssociateHostedConnection.
//
// To reassociate a virtual interface to a new connection or LAG, the requester
// must own either the virtual interface itself or the connection to which the
// virtual interface is currently associated. Additionally, the requester must
// own the connection or LAG for the association.
//
// // Example sending a request using AssociateVirtualInterfaceRequest.
// req := client.AssociateVirtualInterfaceRequest(params)
// resp, err := req.Send(context.TODO())
// if err == nil {
// fmt.Println(resp)
// }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/AssociateVirtualInterface
func (c *Client) AssociateVirtualInterfaceRequest(input *AssociateVirtualInterfaceInput) AssociateVirtualInterfaceRequest {
op := &aws.Operation{
Name: opAssociateVirtualInterface,
HTTPMethod: "POST",
HTTPPath: "/",
}
if input == nil {
input = &AssociateVirtualInterfaceInput{}
}
req := c.newRequest(op, input, &AssociateVirtualInterfaceOutput{})
return AssociateVirtualInterfaceRequest{Request: req, Input: input, Copy: c.AssociateVirtualInterfaceRequest}
}
// AssociateVirtualInterfaceRequest is the request type for the
// AssociateVirtualInterface API operation.
type AssociateVirtualInterfaceRequest struct {
*aws.Request
Input *AssociateVirtualInterfaceInput
Copy func(*AssociateVirtualInterfaceInput) AssociateVirtualInterfaceRequest
}
// Send marshals and sends the AssociateVirtualInterface API request.
func (r AssociateVirtualInterfaceRequest) Send(ctx context.Context) (*AssociateVirtualInterfaceResponse, error) {
r.Request.SetContext(ctx)
err := r.Request.Send()
if err != nil {
return nil, err
}
resp := &AssociateVirtualInterfaceResponse{
AssociateVirtualInterfaceOutput: r.Request.Data.(*AssociateVirtualInterfaceOutput),
response: &aws.Response{Request: r.Request},
}
return resp, nil
}
// AssociateVirtualInterfaceResponse is the response type for the
// AssociateVirtualInterface API operation.
type AssociateVirtualInterfaceResponse struct {
*AssociateVirtualInterfaceOutput
response *aws.Response
}
// SDKResponseMetdata returns the response metadata for the
// AssociateVirtualInterface request.
func (r *AssociateVirtualInterfaceResponse) SDKResponseMetdata() *aws.Response {
return r.response
}