Skip to content

Commit 93445f3

Browse files
author
awstools
committed
docs(client-direct-connect): describe-direct-connect-gateway-associations includes a new status, updating, indicating that the association is currently in-process of updating.
1 parent 61626a5 commit 93445f3

File tree

9 files changed

+1291
-1994
lines changed

9 files changed

+1291
-1994
lines changed

clients/client-direct-connect/src/DirectConnect.ts

+17-10
Original file line numberDiff line numberDiff line change
@@ -820,7 +820,6 @@ export class DirectConnect extends DirectConnectClient {
820820

821821
/**
822822
* <p>Accepts ownership of a transit virtual interface created by another Amazon Web Services account.</p>
823-
*
824823
* <p> After the owner of the transit virtual interface makes this call, the specified transit virtual interface is created and made available to handle traffic.</p>
825824
*/
826825
public confirmTransitVirtualInterface(
@@ -854,11 +853,20 @@ export class DirectConnect extends DirectConnectClient {
854853

855854
/**
856855
* <p>Creates a BGP peer on the specified virtual interface.</p>
857-
* <p>You must create a BGP peer for the corresponding address family (IPv4/IPv6) in order to access Amazon Web Services resources that also use that address family.</p>
856+
* <p>You must create a BGP peer for the corresponding address family (IPv4/IPv6) in order to
857+
* access Amazon Web Services resources that also use that address family.</p>
858858
* <p>If logical redundancy is not supported by the connection, interconnect, or LAG, the BGP peer cannot
859859
* be in the same address family as an existing BGP peer on the virtual interface.</p>
860860
* <p>When creating a IPv6 BGP peer, omit the Amazon address and customer address. IPv6 addresses are automatically assigned from
861861
* the Amazon pool of IPv6 addresses; you cannot specify custom IPv6 addresses.</p>
862+
* <important>
863+
* <p>If you let Amazon Web Services auto-assign IPv4 addresses, a /30 CIDR will be allocated
864+
* from 169.254.0.0/16. Amazon Web Services does not recommend this option if you intend to use
865+
* the customer router peer IP address as the source and destination for traffic. Instead you
866+
* should use RFC 1918 or other addressing, and specify the address yourself. For more
867+
* information about RFC 1918 see <a href="https://datatracker.ietf.org/doc/html/rfc1918">
868+
* Address Allocation for Private Internets</a>.</p>
869+
* </important>
862870
* <p>For a public virtual interface, the Autonomous System Number (ASN) must be private or already on the allow list for the virtual interface.</p>
863871
*/
864872
public createBGPPeer(
@@ -892,7 +900,6 @@ export class DirectConnect extends DirectConnectClient {
892900

893901
/**
894902
* <p>Creates a connection between a customer network and a specific Direct Connect location.</p>
895-
*
896903
* <p>A connection links your internal network to an Direct Connect location over a standard Ethernet fiber-optic
897904
* cable. One end of the cable is connected to your router, the other to an Direct Connect router.</p>
898905
* <p>To find the locations for your Region, use <a>DescribeLocations</a>.</p>
@@ -1090,7 +1097,7 @@ export class DirectConnect extends DirectConnectClient {
10901097
* A LAG is a logical interface that uses the Link Aggregation Control Protocol
10911098
* (LACP) to aggregate multiple interfaces, enabling you to treat them as a single
10921099
* interface.</p>
1093-
* <p>All connections in a LAG must use the same bandwidth (either 1Gbps or 10Gbps) and must terminate at the same Direct Connect endpoint.</p>
1100+
* <p>All connections in a LAG must use the same bandwidth (either 1Gbps or 10Gbps) and must terminate at the same Direct Connect endpoint.</p>
10941101
* <p>You can have up to 10 dedicated connections per LAG. Regardless of this limit, if you
10951102
* request more connections for the LAG than Direct Connect can allocate on a single endpoint, no LAG is
10961103
* created.</p>
@@ -1209,12 +1216,12 @@ export class DirectConnect extends DirectConnectClient {
12091216
* <important>
12101217
* <p>If you associate your transit gateway with one or more Direct Connect gateways, the Autonomous System Number (ASN) used by the transit gateway and the Direct Connect gateway must be different. For example, if you use the default ASN 64512 for both your the transit gateway and Direct Connect gateway, the association request fails.</p>
12111218
* </important>
1212-
* <p>Setting the MTU of a virtual interface to 8500 (jumbo frames) can cause an update to
1213-
* the underlying physical connection if it wasn't updated to support jumbo frames. Updating
1214-
* the connection disrupts network connectivity for all virtual interfaces associated with
1215-
* the connection for up to 30 seconds. To check whether your connection supports jumbo
1216-
* frames, call <a>DescribeConnections</a>. To check whether your virtual
1217-
* interface supports jumbo frames, call <a>DescribeVirtualInterfaces</a>.</p>
1219+
* <p>A jumbo MTU value must be either 1500 or 8500. No other values will be accepted. Setting
1220+
* the MTU of a virtual interface to 8500 (jumbo frames) can cause an update to the underlying
1221+
* physical connection if it wasn't updated to support jumbo frames. Updating the connection
1222+
* disrupts network connectivity for all virtual interfaces associated with the connection for up
1223+
* to 30 seconds. To check whether your connection supports jumbo frames, call <a>DescribeConnections</a>. To check whether your virtual interface supports jumbo
1224+
* frames, call <a>DescribeVirtualInterfaces</a>.</p>
12181225
*/
12191226
public createTransitVirtualInterface(
12201227
args: CreateTransitVirtualInterfaceCommandInput,

clients/client-direct-connect/src/commands/ConfirmTransitVirtualInterfaceCommand.ts

-1
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,6 @@ export interface ConfirmTransitVirtualInterfaceCommandOutput
3838

3939
/**
4040
* <p>Accepts ownership of a transit virtual interface created by another Amazon Web Services account.</p>
41-
*
4241
* <p> After the owner of the transit virtual interface makes this call, the specified transit virtual interface is created and made available to handle traffic.</p>
4342
* @example
4443
* Use a bare-bones client and the command you need to make an API call.

clients/client-direct-connect/src/commands/CreateBGPPeerCommand.ts

+10-1
Original file line numberDiff line numberDiff line change
@@ -36,11 +36,20 @@ export interface CreateBGPPeerCommandOutput extends CreateBGPPeerResponse, __Met
3636

3737
/**
3838
* <p>Creates a BGP peer on the specified virtual interface.</p>
39-
* <p>You must create a BGP peer for the corresponding address family (IPv4/IPv6) in order to access Amazon Web Services resources that also use that address family.</p>
39+
* <p>You must create a BGP peer for the corresponding address family (IPv4/IPv6) in order to
40+
* access Amazon Web Services resources that also use that address family.</p>
4041
* <p>If logical redundancy is not supported by the connection, interconnect, or LAG, the BGP peer cannot
4142
* be in the same address family as an existing BGP peer on the virtual interface.</p>
4243
* <p>When creating a IPv6 BGP peer, omit the Amazon address and customer address. IPv6 addresses are automatically assigned from
4344
* the Amazon pool of IPv6 addresses; you cannot specify custom IPv6 addresses.</p>
45+
* <important>
46+
* <p>If you let Amazon Web Services auto-assign IPv4 addresses, a /30 CIDR will be allocated
47+
* from 169.254.0.0/16. Amazon Web Services does not recommend this option if you intend to use
48+
* the customer router peer IP address as the source and destination for traffic. Instead you
49+
* should use RFC 1918 or other addressing, and specify the address yourself. For more
50+
* information about RFC 1918 see <a href="https://datatracker.ietf.org/doc/html/rfc1918">
51+
* Address Allocation for Private Internets</a>.</p>
52+
* </important>
4453
* <p>For a public virtual interface, the Autonomous System Number (ASN) must be private or already on the allow list for the virtual interface.</p>
4554
* @example
4655
* Use a bare-bones client and the command you need to make an API call.

clients/client-direct-connect/src/commands/CreateConnectionCommand.ts

-1
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,6 @@ export interface CreateConnectionCommandOutput extends Connection, __MetadataBea
3636

3737
/**
3838
* <p>Creates a connection between a customer network and a specific Direct Connect location.</p>
39-
*
4039
* <p>A connection links your internal network to an Direct Connect location over a standard Ethernet fiber-optic
4140
* cable. One end of the cable is connected to your router, the other to an Direct Connect router.</p>
4241
* <p>To find the locations for your Region, use <a>DescribeLocations</a>.</p>

clients/client-direct-connect/src/commands/CreateLagCommand.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ export interface CreateLagCommandOutput extends Lag, __MetadataBearer {}
3232
* A LAG is a logical interface that uses the Link Aggregation Control Protocol
3333
* (LACP) to aggregate multiple interfaces, enabling you to treat them as a single
3434
* interface.</p>
35-
* <p>All connections in a LAG must use the same bandwidth (either 1Gbps or 10Gbps) and must terminate at the same Direct Connect endpoint.</p>
35+
* <p>All connections in a LAG must use the same bandwidth (either 1Gbps or 10Gbps) and must terminate at the same Direct Connect endpoint.</p>
3636
* <p>You can have up to 10 dedicated connections per LAG. Regardless of this limit, if you
3737
* request more connections for the LAG than Direct Connect can allocate on a single endpoint, no LAG is
3838
* created.</p>

clients/client-direct-connect/src/commands/CreateTransitVirtualInterfaceCommand.ts

+6-6
Original file line numberDiff line numberDiff line change
@@ -41,12 +41,12 @@ export interface CreateTransitVirtualInterfaceCommandOutput
4141
* <important>
4242
* <p>If you associate your transit gateway with one or more Direct Connect gateways, the Autonomous System Number (ASN) used by the transit gateway and the Direct Connect gateway must be different. For example, if you use the default ASN 64512 for both your the transit gateway and Direct Connect gateway, the association request fails.</p>
4343
* </important>
44-
* <p>Setting the MTU of a virtual interface to 8500 (jumbo frames) can cause an update to
45-
* the underlying physical connection if it wasn't updated to support jumbo frames. Updating
46-
* the connection disrupts network connectivity for all virtual interfaces associated with
47-
* the connection for up to 30 seconds. To check whether your connection supports jumbo
48-
* frames, call <a>DescribeConnections</a>. To check whether your virtual
49-
* interface supports jumbo frames, call <a>DescribeVirtualInterfaces</a>.</p>
44+
* <p>A jumbo MTU value must be either 1500 or 8500. No other values will be accepted. Setting
45+
* the MTU of a virtual interface to 8500 (jumbo frames) can cause an update to the underlying
46+
* physical connection if it wasn't updated to support jumbo frames. Updating the connection
47+
* disrupts network connectivity for all virtual interfaces associated with the connection for up
48+
* to 30 seconds. To check whether your connection supports jumbo frames, call <a>DescribeConnections</a>. To check whether your virtual interface supports jumbo
49+
* frames, call <a>DescribeVirtualInterfaces</a>.</p>
5050
* @example
5151
* Use a bare-bones client and the command you need to make an API call.
5252
* ```javascript

clients/client-direct-connect/src/endpoint/ruleset.ts

+20-17
Original file line numberDiff line numberDiff line change
@@ -6,24 +6,27 @@ import { RuleSetObject } from "@aws-sdk/util-endpoints";
66
or see "smithy.rules#endpointRuleSet"
77
in codegen/sdk-codegen/aws-models/direct-connect.json */
88

9-
const p="required",
10-
q="fn",
11-
r="argv",
12-
s="ref";
13-
const a="PartitionResult",
9+
const s="required",
10+
t="fn",
11+
u="argv",
12+
v="ref";
13+
const a="isSet",
1414
b="tree",
1515
c="error",
1616
d="endpoint",
17-
e={[p]:false,"type":"String"},
18-
f={[p]:true,"default":false,"type":"Boolean"},
19-
g={[s]:"Endpoint"},
20-
h={[q]:"booleanEquals",[r]:[{[s]:"UseFIPS"},true]},
21-
i={[q]:"booleanEquals",[r]:[{[s]:"UseDualStack"},true]},
22-
j={},
23-
k={[q]:"booleanEquals",[r]:[true,{[q]:"getAttr",[r]:[{[s]:a},"supportsFIPS"]}]},
24-
l={[q]:"booleanEquals",[r]:[true,{[q]:"getAttr",[r]:[{[s]:a},"supportsDualStack"]}]},
25-
m=[g],
26-
n=[h],
27-
o=[i];
28-
const _data={version:"1.0",parameters:{Region:e,UseDualStack:f,UseFIPS:f,Endpoint:e},rules:[{conditions:[{[q]:"aws.partition",[r]:[{[s]:"Region"}],assign:a}],type:b,rules:[{conditions:[{[q]:"isSet",[r]:m},{[q]:"parseURL",[r]:m,assign:"url"}],type:b,rules:[{conditions:n,error:"Invalid Configuration: FIPS and custom endpoint are not supported",type:c},{type:b,rules:[{conditions:o,error:"Invalid Configuration: Dualstack and custom endpoint are not supported",type:c},{endpoint:{url:g,properties:j,headers:j},type:d}]}]},{conditions:[h,i],type:b,rules:[{conditions:[k,l],type:b,rules:[{endpoint:{url:"https://directconnect-fips.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:j,headers:j},type:d}]},{error:"FIPS and DualStack are enabled, but this partition does not support one or both",type:c}]},{conditions:n,type:b,rules:[{conditions:[k],type:b,rules:[{type:b,rules:[{endpoint:{url:"https://directconnect-fips.{Region}.{PartitionResult#dnsSuffix}",properties:j,headers:j},type:d}]}]},{error:"FIPS is enabled but this partition does not support FIPS",type:c}]},{conditions:o,type:b,rules:[{conditions:[l],type:b,rules:[{endpoint:{url:"https://directconnect.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:j,headers:j},type:d}]},{error:"DualStack is enabled but this partition does not support DualStack",type:c}]},{endpoint:{url:"https://directconnect.{Region}.{PartitionResult#dnsSuffix}",properties:j,headers:j},type:d}]}]};
17+
e="PartitionResult",
18+
f="stringEquals",
19+
g={[s]:false,"type":"String"},
20+
h={[s]:true,"default":false,"type":"Boolean"},
21+
i={[v]:"Endpoint"},
22+
j={[t]:"booleanEquals",[u]:[{[v]:"UseFIPS"},true]},
23+
k={[t]:"booleanEquals",[u]:[{[v]:"UseDualStack"},true]},
24+
l={},
25+
m={[v]:"Region"},
26+
n={[t]:"booleanEquals",[u]:[true,{[t]:"getAttr",[u]:[{[v]:e},"supportsFIPS"]}]},
27+
o={[t]:"booleanEquals",[u]:[true,{[t]:"getAttr",[u]:[{[v]:e},"supportsDualStack"]}]},
28+
p=[j],
29+
q=[k],
30+
r=[m];
31+
const _data={version:"1.0",parameters:{Region:g,UseDualStack:h,UseFIPS:h,Endpoint:g},rules:[{conditions:[{[t]:a,[u]:[i]}],type:b,rules:[{conditions:p,error:"Invalid Configuration: FIPS and custom endpoint are not supported",type:c},{type:b,rules:[{conditions:q,error:"Invalid Configuration: Dualstack and custom endpoint are not supported",type:c},{endpoint:{url:i,properties:l,headers:l},type:d}]}]},{type:b,rules:[{conditions:[{[t]:a,[u]:r}],type:b,rules:[{conditions:[{[t]:"aws.partition",[u]:r,assign:e}],type:b,rules:[{conditions:[j,k],type:b,rules:[{conditions:[n,o],type:b,rules:[{type:b,rules:[{endpoint:{url:"https://directconnect-fips.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:l,headers:l},type:d}]}]},{error:"FIPS and DualStack are enabled, but this partition does not support one or both",type:c}]},{conditions:p,type:b,rules:[{conditions:[n],type:b,rules:[{type:b,rules:[{endpoint:{url:"https://directconnect-fips.{Region}.{PartitionResult#dnsSuffix}",properties:l,headers:l},type:d}]}]},{error:"FIPS is enabled but this partition does not support FIPS",type:c}]},{conditions:q,type:b,rules:[{conditions:[o],type:b,rules:[{type:b,rules:[{endpoint:{url:"https://directconnect.{Region}.{PartitionResult#dualStackDnsSuffix}",properties:l,headers:l},type:d}]}]},{error:"DualStack is enabled but this partition does not support DualStack",type:c}]},{type:b,rules:[{conditions:[{[t]:f,[u]:[m,"us-gov-east-1"]}],endpoint:{url:"https://directconnect.us-gov-east-1.amazonaws.com",properties:l,headers:l},type:d},{conditions:[{[t]:f,[u]:[m,"us-gov-west-1"]}],endpoint:{url:"https://directconnect.us-gov-west-1.amazonaws.com",properties:l,headers:l},type:d},{endpoint:{url:"https://directconnect.{Region}.{PartitionResult#dnsSuffix}",properties:l,headers:l},type:d}]}]}]},{error:"Invalid Configuration: Missing Region",type:c}]}]};
2932
export const ruleSet: RuleSetObject = _data;

0 commit comments

Comments
 (0)