diff --git a/codegen/sdk-codegen/aws-models/application-auto-scaling.json b/codegen/sdk-codegen/aws-models/application-auto-scaling.json index fe417d8d90e..1cc31a38a78 100644 --- a/codegen/sdk-codegen/aws-models/application-auto-scaling.json +++ b/codegen/sdk-codegen/aws-models/application-auto-scaling.json @@ -147,7 +147,7 @@ "name": "application-autoscaling" }, "aws.protocols#awsJson1_1": {}, - "smithy.api#documentation": "

With Application Auto Scaling, you can configure automatic scaling for the following\n resources:

\n \n

To learn more about Application Auto Scaling, see the Application Auto Scaling User\n Guide.

\n

\n API Summary\n

\n

The Application Auto Scaling service API includes three key sets of actions:

\n ", + "smithy.api#documentation": "

With Application Auto Scaling, you can configure automatic scaling for the following\n resources:

\n \n

To learn more about Application Auto Scaling, see the Application Auto Scaling User\n Guide.

\n

\n API Summary\n

\n

The Application Auto Scaling service API includes three key sets of actions:

\n ", "smithy.api#title": "Application Auto Scaling", "smithy.rules#endpointRuleSet": { "version": "1.0", @@ -1252,14 +1252,14 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scalable target.\n This string consists of the resource type and unique identifier.

\n ", + "smithy.api#documentation": "

The identifier of the resource associated with the scalable target.\n This string consists of the resource type and unique identifier.

\n ", "smithy.api#required": {} } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", + "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", "smithy.api#required": {} } } @@ -1334,14 +1334,14 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scheduled action.\n This string consists of the resource type and unique identifier.

\n ", + "smithy.api#documentation": "

The identifier of the resource associated with the scheduled action.\n This string consists of the resource type and unique identifier.

\n ", "smithy.api#required": {} } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", + "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", "smithy.api#required": {} } } @@ -1408,14 +1408,14 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scalable target.\n This string consists of the resource type and unique identifier.

\n ", + "smithy.api#documentation": "

The identifier of the resource associated with the scalable target.\n This string consists of the resource type and unique identifier.

\n ", "smithy.api#required": {} } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension associated with the scalable target.\n This string consists of the service namespace, resource type, and scaling property.

\n ", + "smithy.api#documentation": "

The scalable dimension associated with the scalable target.\n This string consists of the service namespace, resource type, and scaling property.

\n ", "smithy.api#required": {} } } @@ -1518,13 +1518,13 @@ "ResourceIds": { "target": "com.amazonaws.applicationautoscaling#ResourceIdsMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scalable target.\n This string consists of the resource type and unique identifier.

\n " + "smithy.api#documentation": "

The identifier of the resource associated with the scalable target.\n This string consists of the resource type and unique identifier.

\n " } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension associated with the scalable target.\n This string consists of the service namespace, resource type, and scaling property. If you specify a scalable dimension, you must also specify a resource ID.

\n " + "smithy.api#documentation": "

The scalable dimension associated with the scalable target.\n This string consists of the service namespace, resource type, and scaling property. If you specify a scalable dimension, you must also specify a resource ID.

\n " } }, "MaxResults": { @@ -1636,13 +1636,13 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scaling activity.\n This string consists of the resource type and unique identifier.

\n " + "smithy.api#documentation": "

The identifier of the resource associated with the scaling activity.\n This string consists of the resource type and unique identifier.

\n " } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.\n If you specify a scalable dimension, you must also specify a resource ID.

\n " + "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.\n If you specify a scalable dimension, you must also specify a resource ID.

\n " } }, "MaxResults": { @@ -1781,13 +1781,13 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scaling policy.\n This string consists of the resource type and unique identifier.

\n " + "smithy.api#documentation": "

The identifier of the resource associated with the scaling policy.\n This string consists of the resource type and unique identifier.

\n " } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.\n If you specify a scalable dimension, you must also specify a resource ID.

\n " + "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.\n If you specify a scalable dimension, you must also specify a resource ID.

\n " } }, "MaxResults": { @@ -1917,13 +1917,13 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scheduled action.\n This string consists of the resource type and unique identifier.

\n " + "smithy.api#documentation": "

The identifier of the resource associated with the scheduled action.\n This string consists of the resource type and unique identifier.

\n " } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.\n If you specify a scalable dimension, you must also specify a resource ID.

\n " + "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.\n If you specify a scalable dimension, you must also specify a resource ID.

\n " } }, "MaxResults": { @@ -2578,14 +2578,14 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scaling policy.\n This string consists of the resource type and unique identifier.

\n ", + "smithy.api#documentation": "

The identifier of the resource associated with the scaling policy.\n This string consists of the resource type and unique identifier.

\n ", "smithy.api#required": {} } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", + "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", "smithy.api#required": {} } }, @@ -2711,14 +2711,14 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scheduled action.\n This string consists of the resource type and unique identifier.

\n ", + "smithy.api#documentation": "

The identifier of the resource associated with the scheduled action.\n This string consists of the resource type and unique identifier.

\n ", "smithy.api#required": {} } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", + "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", "smithy.api#required": {} } }, @@ -2807,14 +2807,14 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource that is associated with the scalable target.\n This string consists of the resource type and unique identifier.

\n ", + "smithy.api#documentation": "

The identifier of the resource that is associated with the scalable target.\n This string consists of the resource type and unique identifier.

\n ", "smithy.api#required": {} } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension associated with the scalable target.\n This string consists of the service namespace, resource type, and scaling property.

\n ", + "smithy.api#documentation": "

The scalable dimension associated with the scalable target.\n This string consists of the service namespace, resource type, and scaling property.

\n ", "smithy.api#required": {} } }, @@ -3085,14 +3085,14 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scalable target.\n This string consists of the resource type and unique identifier.

\n ", + "smithy.api#documentation": "

The identifier of the resource associated with the scalable target.\n This string consists of the resource type and unique identifier.

\n ", "smithy.api#required": {} } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension associated with the scalable target.\n This string consists of the service namespace, resource type, and scaling property.

\n ", + "smithy.api#documentation": "

The scalable dimension associated with the scalable target.\n This string consists of the service namespace, resource type, and scaling property.

\n ", "smithy.api#required": {} } }, @@ -3193,14 +3193,14 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scaling activity.\n This string consists of the resource type and unique identifier.

\n ", + "smithy.api#documentation": "

The identifier of the resource associated with the scaling activity.\n This string consists of the resource type and unique identifier.

\n ", "smithy.api#required": {} } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", + "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", "smithy.api#required": {} } }, @@ -3338,14 +3338,14 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scaling policy.\n This string consists of the resource type and unique identifier.

\n ", + "smithy.api#documentation": "

The identifier of the resource associated with the scaling policy.\n This string consists of the resource type and unique identifier.

\n ", "smithy.api#required": {} } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", + "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n ", "smithy.api#required": {} } }, @@ -3429,14 +3429,14 @@ "ResourceId": { "target": "com.amazonaws.applicationautoscaling#ResourceIdMaxLen1600", "traits": { - "smithy.api#documentation": "

The identifier of the resource associated with the scaling policy.\n This string consists of the resource type and unique identifier.

\n ", + "smithy.api#documentation": "

The identifier of the resource associated with the scaling policy.\n This string consists of the resource type and unique identifier.

\n ", "smithy.api#required": {} } }, "ScalableDimension": { "target": "com.amazonaws.applicationautoscaling#ScalableDimension", "traits": { - "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n " + "smithy.api#documentation": "

The scalable dimension. This string consists of the service namespace, resource type, and scaling property.

\n " } }, "StartTime": { diff --git a/codegen/sdk-codegen/aws-models/direct-connect.json b/codegen/sdk-codegen/aws-models/direct-connect.json index 5839503f07e..62a44e16034 100644 --- a/codegen/sdk-codegen/aws-models/direct-connect.json +++ b/codegen/sdk-codegen/aws-models/direct-connect.json @@ -94,7 +94,10 @@ "type": "structure", "members": { "directConnectGatewayAssociation": { - "target": "com.amazonaws.directconnect#DirectConnectGatewayAssociation" + "target": "com.amazonaws.directconnect#DirectConnectGatewayAssociation", + "traits": { + "smithy.api#documentation": "

Information about an association between a Direct Connect gateway and a virtual gateway or transit gateway.

" + } } }, "traits": { @@ -151,7 +154,7 @@ ], "traits": { "smithy.api#deprecated": {}, - "smithy.api#documentation": "

Deprecated. Use AllocateHostedConnection instead.

\n

Creates a hosted connection on an interconnect.

\n

Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the specified interconnect.

\n \n

Intended for use by Direct Connect Partners only.

\n
" + "smithy.api#documentation": "\n

Deprecated. Use AllocateHostedConnection instead.

\n
\n

Creates a hosted connection on an interconnect.

\n

Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the specified interconnect.

\n \n

Intended for use by Direct Connect Partners only.

\n
" } }, "com.amazonaws.directconnect#AllocateConnectionOnInterconnectRequest": { @@ -244,7 +247,7 @@ "bandwidth": { "target": "com.amazonaws.directconnect#Bandwidth", "traits": { - "smithy.api#documentation": "

The bandwidth of the connection. The possible values are 50Mbps, 100Mbps, 200Mbps, 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps, and 10Gbps. Note that only those Direct Connect Partners who have met specific requirements are allowed to create a 1Gbps, 2Gbps, 5Gbps or 10Gbps hosted connection.

", + "smithy.api#documentation": "

The bandwidth of the connection. The possible values are 50Mbps, 100Mbps, 200Mbps,\n 300Mbps, 400Mbps, 500Mbps, 1Gbps, 2Gbps, 5Gbps, 10Gbps, and 25Gbps. Note that only those\n Direct Connect Partners who have met specific requirements are allowed to create a 1Gbps, 2Gbps, 5Gbps,\n 10Gbps, or 25Gbps hosted connection.

", "smithy.api#required": {} } }, @@ -443,7 +446,10 @@ "type": "structure", "members": { "virtualInterface": { - "target": "com.amazonaws.directconnect#VirtualInterface" + "target": "com.amazonaws.directconnect#VirtualInterface", + "traits": { + "smithy.api#documentation": "

Information about the transit virtual interface.

" + } } }, "traits": { @@ -1735,7 +1741,7 @@ "bandwidth": { "target": "com.amazonaws.directconnect#Bandwidth", "traits": { - "smithy.api#documentation": "

The port bandwidth, in Gbps. The possible values are 1 and 10.

", + "smithy.api#documentation": "

The port bandwidth, in Gbps. The possible values are 1, 10, and 100.

", "smithy.api#required": {} } }, @@ -1792,7 +1798,7 @@ } ], "traits": { - "smithy.api#documentation": "

Creates a link aggregation group (LAG) with the specified number of bundled\n physical dedicated connections between the customer network and a specific Direct Connect location.\n A LAG is a logical interface that uses the Link Aggregation Control Protocol\n (LACP) to aggregate multiple interfaces, enabling you to treat them as a single \n interface.

\n

All connections in a LAG must use the same bandwidth (either 1Gbps or 10Gbps) and must terminate at the same Direct Connect endpoint.

\n

You can have up to 10 dedicated connections per LAG. Regardless of this limit, if you\n request more connections for the LAG than Direct Connect can allocate on a single endpoint, no LAG is\n created.

\n

You can specify an existing physical dedicated connection or interconnect to include in\n the LAG (which counts towards the total number of connections). Doing so interrupts the\n current physical dedicated connection, and re-establishes them as a member of the LAG. The LAG\n will be created on the same Direct Connect endpoint to which the dedicated connection terminates. Any\n virtual interfaces associated with the dedicated connection are automatically disassociated\n and re-associated with the LAG. The connection ID does not change.

\n

If the Amazon Web Services account used to create a LAG is a registered Direct Connect Partner, the LAG is \n automatically enabled to host sub-connections. For a LAG owned by a partner, any associated virtual \n interfaces cannot be directly configured.

" + "smithy.api#documentation": "

Creates a link aggregation group (LAG) with the specified number of bundled\n physical dedicated connections between the customer network and a specific Direct Connect location.\n A LAG is a logical interface that uses the Link Aggregation Control Protocol\n (LACP) to aggregate multiple interfaces, enabling you to treat them as a single \n interface.

\n

All connections in a LAG must use the same bandwidth (either 1Gbps, 10Gbps, 100Gbps,\n or 400Gbps) and must terminate at the same Direct Connect endpoint.

\n

You can have up to 10 dedicated connections per location. Regardless of this limit, if you\n request more connections for the LAG than Direct Connect can allocate on a single endpoint, no LAG is\n created..

\n

You can specify an existing physical dedicated connection or interconnect to include in\n the LAG (which counts towards the total number of connections). Doing so interrupts the\n current physical dedicated connection, and re-establishes them as a member of the LAG. The LAG\n will be created on the same Direct Connect endpoint to which the dedicated connection terminates. Any\n virtual interfaces associated with the dedicated connection are automatically disassociated\n and re-associated with the LAG. The connection ID does not change.

\n

If the Amazon Web Services account used to create a LAG is a registered Direct Connect Partner, the LAG is \n automatically enabled to host sub-connections. For a LAG owned by a partner, any associated virtual \n interfaces cannot be directly configured.

" } }, "com.amazonaws.directconnect#CreateLagRequest": { @@ -1802,7 +1808,7 @@ "target": "com.amazonaws.directconnect#Count", "traits": { "smithy.api#default": 0, - "smithy.api#documentation": "

The number of physical dedicated connections initially provisioned and bundled by the\n LAG. You can have a maximum of four connections when the port speed is 1G or 10G, or two when the port speed is 100G.

", + "smithy.api#documentation": "

The number of physical dedicated connections initially provisioned and bundled by the LAG.\n You can have a maximum of four connections when the port speed is 1Gbps or 10Gbps, or two when\n the port speed is 100Gbps or 400Gbps.

", "smithy.api#required": {} } }, @@ -1816,7 +1822,7 @@ "connectionsBandwidth": { "target": "com.amazonaws.directconnect#Bandwidth", "traits": { - "smithy.api#documentation": "

The bandwidth of the individual physical dedicated connections bundled by the LAG. The\n possible values are 1Gbps and 10Gbps.

", + "smithy.api#documentation": "

The bandwidth of the individual physical dedicated connections bundled by the LAG. The\n possible values are 1Gbps,10Gbps, 100Gbps, and 400Gbps.

", "smithy.api#required": {} } }, @@ -1885,7 +1891,7 @@ } ], "traits": { - "smithy.api#documentation": "

Creates a private virtual interface. A virtual interface is the VLAN that transports Direct Connect traffic.\n A private virtual interface can be connected to either a Direct Connect gateway or a Virtual Private Gateway (VGW).\n Connecting the private virtual interface to a Direct Connect gateway enables the possibility for connecting to multiple \n VPCs, including VPCs in different Amazon Web Services Regions. Connecting the private virtual interface \n to a VGW only provides access to a single VPC within the same Region.

\n

Setting the MTU of a virtual interface to 9001 (jumbo frames) can cause an update to\n the underlying physical connection if it wasn't updated to support jumbo frames. Updating \n the connection disrupts network connectivity for all virtual interfaces associated with \n the connection for up to 30 seconds. To check whether your connection supports jumbo \n frames, call DescribeConnections. To check whether your virtual \n interface supports jumbo frames, call DescribeVirtualInterfaces.

" + "smithy.api#documentation": "

Creates a private virtual interface. A virtual interface is the VLAN that transports Direct Connect traffic.\n A private virtual interface can be connected to either a Direct Connect gateway or a Virtual Private Gateway (VGW).\n Connecting the private virtual interface to a Direct Connect gateway enables the possibility for connecting to multiple \n VPCs, including VPCs in different Amazon Web Services Regions. Connecting the private virtual interface \n to a VGW only provides access to a single VPC within the same Region.

\n

Setting the MTU of a virtual interface to 8500 (jumbo frames) can cause an update to\n the underlying physical connection if it wasn't updated to support jumbo frames. Updating \n the connection disrupts network connectivity for all virtual interfaces associated with \n the connection for up to 30 seconds. To check whether your connection supports jumbo \n frames, call DescribeConnections. To check whether your virtual \n interface supports jumbo frames, call DescribeVirtualInterfaces.

" } }, "com.amazonaws.directconnect#CreatePrivateVirtualInterfaceRequest": { @@ -2010,7 +2016,10 @@ "type": "structure", "members": { "virtualInterface": { - "target": "com.amazonaws.directconnect#VirtualInterface" + "target": "com.amazonaws.directconnect#VirtualInterface", + "traits": { + "smithy.api#documentation": "

Information about a virtual interface.

" + } } }, "traits": { @@ -2451,7 +2460,7 @@ ], "traits": { "smithy.api#deprecated": {}, - "smithy.api#documentation": "

Deprecated. Use DescribeLoa instead.

\n

Gets the LOA-CFA for a connection.

\n

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that your APN partner or\n service provider uses when establishing your cross connect to Amazon Web Services at the colocation facility. For more information,\n see Requesting Cross Connects\n at Direct Connect Locations in the Direct Connect User Guide.

" + "smithy.api#documentation": "\n

Deprecated. Use DescribeLoa instead.

\n
\n

Gets the LOA-CFA for a connection.

\n

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that your APN partner or\n service provider uses when establishing your cross connect to Amazon Web Services at the colocation facility. For more information,\n see Requesting Cross Connects\n at Direct Connect Locations in the Direct Connect User Guide.

" } }, "com.amazonaws.directconnect#DescribeConnectionLoaRequest": { @@ -2559,7 +2568,7 @@ ], "traits": { "smithy.api#deprecated": {}, - "smithy.api#documentation": "

Deprecated. Use DescribeHostedConnections instead.

\n

Lists the connections that have been provisioned on the specified interconnect.

\n \n

Intended for use by Direct Connect Partners only.

\n
" + "smithy.api#documentation": "\n

Deprecated. Use DescribeHostedConnections instead.

\n
\n

Lists the connections that have been provisioned on the specified interconnect.

\n \n

Intended for use by Direct Connect Partners only.

\n
" } }, "com.amazonaws.directconnect#DescribeConnectionsOnInterconnectRequest": { @@ -2984,7 +2993,7 @@ ], "traits": { "smithy.api#deprecated": {}, - "smithy.api#documentation": "

Deprecated. Use DescribeLoa instead.

\n

Gets the LOA-CFA for the specified interconnect.

\n

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to Amazon Web Services at the colocation facility.\n For more information, see Requesting Cross Connects at Direct Connect Locations\n in the Direct Connect User Guide.

" + "smithy.api#documentation": "\n

Deprecated. Use DescribeLoa instead.

\n
\n

Gets the LOA-CFA for the specified interconnect.

\n

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to Amazon Web Services at the colocation facility.\n For more information, see Requesting Cross Connects at Direct Connect Locations\n in the Direct Connect User Guide.

" } }, "com.amazonaws.directconnect#DescribeInterconnectLoaRequest": { @@ -3303,7 +3312,7 @@ } ], "traits": { - "smithy.api#documentation": "

Lists the virtual private gateways owned by the Amazon Web Services account.

\n

You can create one or more Direct Connect private virtual interfaces linked to a virtual private gateway.

" + "smithy.api#documentation": "\n

Deprecated. Use DescribeVpnGateways instead. See DescribeVPNGateways in the Amazon Elastic Compute Cloud API Reference.

\n
\n

Lists the virtual private gateways owned by the Amazon Web Services account.

\n

You can create one or more Direct Connect private virtual interfaces linked to a virtual private gateway.

" } }, "com.amazonaws.directconnect#DescribeVirtualInterfaces": { @@ -4106,14 +4115,14 @@ "connectionsBandwidth": { "target": "com.amazonaws.directconnect#Bandwidth", "traits": { - "smithy.api#documentation": "

The individual bandwidth of the physical connections bundled by the LAG. The possible\n values are 1Gbps and 10Gbps.

" + "smithy.api#documentation": "

The individual bandwidth of the physical connections bundled by the LAG. The possible\n values are 1Gbps, 10Gbps, 100Gbps, or 400 Gbps..

" } }, "numberOfConnections": { "target": "com.amazonaws.directconnect#Count", "traits": { "smithy.api#default": 0, - "smithy.api#documentation": "

The number of physical dedicated connections bundled by the LAG, up to a maximum of 10.

" + "smithy.api#documentation": "

The number of physical dedicated connections initially provisioned and bundled by the LAG.\n You can have a maximum of four connections when the port speed is 1 Gbps or 10 Gbps, or two\n when the port speed is 100 Gbps or 400 Gbps.

" } }, "lagId": { @@ -4613,7 +4622,7 @@ "mtu": { "target": "com.amazonaws.directconnect#MTU", "traits": { - "smithy.api#documentation": "

The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 9001. The default value is 1500.

" + "smithy.api#documentation": "

The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 8500. The default value is 1500.

" } }, "authKey": { @@ -4698,7 +4707,7 @@ "mtu": { "target": "com.amazonaws.directconnect#MTU", "traits": { - "smithy.api#documentation": "

The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 9001. The default value is 1500.

" + "smithy.api#documentation": "

The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 8500. The default value is 1500.

" } }, "authKey": { @@ -6801,7 +6810,10 @@ "type": "structure", "members": { "directConnectGatewayAssociation": { - "target": "com.amazonaws.directconnect#DirectConnectGatewayAssociation" + "target": "com.amazonaws.directconnect#DirectConnectGatewayAssociation", + "traits": { + "smithy.api#documentation": "

Information about an association between a Direct Connect gateway and a virtual private gateway or transit gateway.

" + } } }, "traits": { @@ -6834,7 +6846,10 @@ "type": "structure", "members": { "directConnectGateway": { - "target": "com.amazonaws.directconnect#DirectConnectGateway" + "target": "com.amazonaws.directconnect#DirectConnectGateway", + "traits": { + "smithy.api#documentation": "

Informaiton about a Direct Connect gateway, which enables you to connect virtual interfaces and virtual private gateways or transit gateways.

" + } } }, "traits": { @@ -6912,7 +6927,7 @@ } ], "traits": { - "smithy.api#documentation": "

Updates the specified attributes of the specified virtual private interface.

\n

Setting the MTU of a virtual interface to 9001 (jumbo frames) can cause an update to\n the underlying physical connection if it wasn't updated to support jumbo frames. Updating \n the connection disrupts network connectivity for all virtual interfaces associated with \n the connection for up to 30 seconds. To check whether your connection supports jumbo \n frames, call DescribeConnections. To check whether your virtual \n interface supports jumbo frames, call DescribeVirtualInterfaces.

" + "smithy.api#documentation": "

Updates the specified attributes of the specified virtual private interface.

\n

Setting the MTU of a virtual interface to 8500 (jumbo frames) can cause an update to\n the underlying physical connection if it wasn't updated to support jumbo frames. Updating \n the connection disrupts network connectivity for all virtual interfaces associated with \n the connection for up to 30 seconds. To check whether your connection supports jumbo \n frames, call DescribeConnections. To check whether your virtual \n interface supports jumbo frames, call DescribeVirtualInterfaces.

" } }, "com.amazonaws.directconnect#UpdateVirtualInterfaceAttributesRequest": { @@ -6928,7 +6943,7 @@ "mtu": { "target": "com.amazonaws.directconnect#MTU", "traits": { - "smithy.api#documentation": "

The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 9001. The default value is 1500.

" + "smithy.api#documentation": "

The maximum transmission unit (MTU), in bytes. The supported values are 1500 and 8500. The default value is 1500.

" } }, "enableSiteLink": { @@ -7036,7 +7051,7 @@ "virtualInterfaceType": { "target": "com.amazonaws.directconnect#VirtualInterfaceType", "traits": { - "smithy.api#documentation": "

The type of virtual interface. The possible values are private and public.

" + "smithy.api#documentation": "

The type of virtual interface. The possible values are private, public and transit.

" } }, "virtualInterfaceName": { diff --git a/codegen/sdk-codegen/aws-models/organizations.json b/codegen/sdk-codegen/aws-models/organizations.json index 5170f46b3c5..9a714a480a1 100644 --- a/codegen/sdk-codegen/aws-models/organizations.json +++ b/codegen/sdk-codegen/aws-models/organizations.json @@ -1750,18 +1750,18 @@ "smithy.api#documentation": "

Attaches a policy to a root, an organizational unit (OU), or an individual account.\n How the policy affects accounts depends on the type of policy. Refer to the\n Organizations User Guide for information about each policy type:

\n \n

This operation can be called only from the organization's\nmanagement account or by a member account that is a delegated administrator for an Amazon Web Services service.

", "smithy.api#examples": [ { - "title": "To attach a policy to an OU", - "documentation": "The following example shows how to attach a service control policy (SCP) to an OU:\n", + "title": "To attach a policy to an account", + "documentation": "The following example shows how to attach a service control policy (SCP) to an account:\n", "input": { - "TargetId": "ou-examplerootid111-exampleouid111", + "TargetId": "333333333333", "PolicyId": "p-examplepolicyid111" } }, { - "title": "To attach a policy to an account", - "documentation": "The following example shows how to attach a service control policy (SCP) to an account:\n", + "title": "To attach a policy to an OU", + "documentation": "The following example shows how to attach a service control policy (SCP) to an OU:\n", "input": { - "TargetId": "333333333333", + "TargetId": "ou-examplerootid111-exampleouid111", "PolicyId": "p-examplepolicyid111" } } @@ -2028,7 +2028,7 @@ } }, "traits": { - "smithy.api#documentation": "

Performing this operation violates a minimum or maximum value limit. For example,\n attempting to remove the last service control policy (SCP) from an OU or root, inviting\n or creating too many accounts to the organization, or attaching too many policies to an\n account, OU, or root. This exception includes a reason that contains additional\n information about the violated limit:

\n \n

Some of the reasons in the following list might not be applicable to this specific\n API or operation.

\n
\n ", + "smithy.api#documentation": "

Performing this operation violates a minimum or maximum value limit. For example,\n attempting to remove the last service control policy (SCP) from an OU or root, inviting\n or creating too many accounts to the organization, or attaching too many policies to an\n account, OU, or root. This exception includes a reason that contains additional\n information about the violated limit:

\n \n

Some of the reasons in the following list might not be applicable to this specific\n API or operation.

\n
\n ", "smithy.api#error": "client", "smithy.api#httpError": 409 } @@ -2239,6 +2239,12 @@ "traits": { "smithy.api#enumValue": "ACCOUNT_CREATION_NOT_COMPLETE" } + }, + "CANNOT_REGISTER_SUSPENDED_ACCOUNT_AS_DELEGATED_ADMINISTRATOR": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "CANNOT_REGISTER_SUSPENDED_ACCOUNT_AS_DELEGATED_ADMINISTRATOR" + } } } }, @@ -2280,7 +2286,7 @@ } ], "traits": { - "smithy.api#documentation": "

Creates an Amazon Web Services account that is automatically a member of the organization whose\n credentials made the request. This is an asynchronous request that Amazon Web Services performs in the\n background. Because CreateAccount operates asynchronously, it can return a\n successful completion message even though account initialization might still be in\n progress. You might need to wait a few minutes before you can successfully access the\n account. To check the status of the request, do one of the following:

\n \n

The user who calls the API to create an account must have the\n organizations:CreateAccount permission. If you enabled all features in\n the organization, Organizations creates the required service-linked role named\n AWSServiceRoleForOrganizations. For more information, see Organizations and service-linked roles in the\n Organizations User Guide.

\n

If the request includes tags, then the requester must have the\n organizations:TagResource permission.

\n

Organizations preconfigures the new member account with a role (named\n OrganizationAccountAccessRole by default) that grants users in the\n management account administrator permissions in the new member account. Principals in\n the management account can assume the role. Organizations clones the company name and address\n information for the new account from the organization's management account.

\n

This operation can be called only from the organization's management account.

\n

For more information about creating accounts, see Creating\n a member account in your organization in the\n Organizations User Guide.

\n \n \n \n \n

When you create a member account with this operation, you can choose whether to\n create the account with the IAM User and Role Access to\n Billing Information switch enabled. If you enable it, IAM users and\n roles that have appropriate permissions can view billing information for the\n account. If you disable it, only the account root user can access billing\n information. For information about how to disable this switch for an account, see\n Granting access to\n your billing information and tools.

\n
", + "smithy.api#documentation": "

Creates an Amazon Web Services account that is automatically a member of the organization whose\n credentials made the request. This is an asynchronous request that Amazon Web Services performs in the\n background. Because CreateAccount operates asynchronously, it can return a\n successful completion message even though account initialization might still be in\n progress. You might need to wait a few minutes before you can successfully access the\n account. To check the status of the request, do one of the following:

\n \n

The user who calls the API to create an account must have the\n organizations:CreateAccount permission. If you enabled all features in\n the organization, Organizations creates the required service-linked role named\n AWSServiceRoleForOrganizations. For more information, see Organizations and service-linked roles in the\n Organizations User Guide.

\n

If the request includes tags, then the requester must have the\n organizations:TagResource permission.

\n

Organizations preconfigures the new member account with a role (named\n OrganizationAccountAccessRole by default) that grants users in the\n management account administrator permissions in the new member account. Principals in\n the management account can assume the role. Organizations clones the company name and address\n information for the new account from the organization's management account.

\n

This operation can be called only from the organization's management account.

\n

For more information about creating accounts, see Creating\n a member account in your organization in the\n Organizations User Guide.

\n \n \n \n \n

When you create a member account with this operation, you can choose whether to\n create the account with the IAM User and Role Access to\n Billing Information switch enabled. If you enable it, IAM users and\n roles that have appropriate permissions can view billing information for the\n account. If you disable it, only the account root user can access billing\n information. For information about how to disable this switch for an account, see\n Granting access to\n your billing information and tools.

\n
", "smithy.api#examples": [ { "title": "To create a new account that is automatically part of the organization", @@ -6015,41 +6021,41 @@ "smithy.api#documentation": "

Lists the account creation requests that match the specified status that is currently\n being tracked for the organization.

\n \n

Always check the NextToken response parameter \nfor a null value when calling a List* operation. These operations can \noccasionally return an empty set of results even when there are more results available. The \nNextToken response parameter value is null\n only \nwhen there are no more results to display.

\n
\n

This operation can be called only from the organization's\nmanagement account or by a member account that is a delegated administrator for an Amazon Web Services service.

", "smithy.api#examples": [ { - "title": "To get a list of completed account creation requests made in the organization", - "documentation": "The following example shows a user requesting a list of only the completed account creation requests made for the current organization:", + "title": "To get a list of all account creation requests made in the organization", + "documentation": "The following example shows a user requesting a list of only the in-progress account creation requests made for the current organization:", "input": { "States": [ - "SUCCEEDED" + "IN_PROGRESS" ] }, "output": { "CreateAccountStatuses": [ { - "Id": "car-exampleaccountcreationrequestid1", - "AccountId": "444444444444", - "AccountName": "Developer Test Account", + "State": "IN_PROGRESS", + "Id": "car-exampleaccountcreationrequestid2", "RequestedTimestamp": "2017-01-15T13:45:23.01Z", - "State": "SUCCEEDED", - "CompletedTimestamp": "2017-01-15T13:45:23.6Z" + "AccountName": "Production Account" } ] } }, { - "title": "To get a list of all account creation requests made in the organization", - "documentation": "The following example shows a user requesting a list of only the in-progress account creation requests made for the current organization:", + "title": "To get a list of completed account creation requests made in the organization", + "documentation": "The following example shows a user requesting a list of only the completed account creation requests made for the current organization:", "input": { "States": [ - "IN_PROGRESS" + "SUCCEEDED" ] }, "output": { "CreateAccountStatuses": [ { - "State": "IN_PROGRESS", - "Id": "car-exampleaccountcreationrequestid2", + "Id": "car-exampleaccountcreationrequestid1", + "AccountId": "444444444444", + "AccountName": "Developer Test Account", "RequestedTimestamp": "2017-01-15T13:45:23.01Z", - "AccountName": "Production Account" + "State": "SUCCEEDED", + "CompletedTimestamp": "2017-01-15T13:45:23.6Z" } ] } @@ -8843,16 +8849,15 @@ "smithy.api#documentation": "

Updates an existing policy with a new name, description, or content. If you don't\n supply any parameter, that value remains unchanged. You can't change a policy's\n type.

\n

This operation can be called only from the organization's\nmanagement account or by a member account that is a delegated administrator for an Amazon Web Services service.

", "smithy.api#examples": [ { - "title": "To update the details of a policy", - "documentation": "The following example shows how to rename a policy and give it a new description and new content. The output confirms the new name and description text:/n/n", + "title": "To update the content of a policy", + "documentation": "The following example shows how to replace the JSON text of the SCP from the preceding example with a new JSON policy text string that allows S3 actions instead of EC2 actions:/n/n", "input": { "PolicyId": "p-examplepolicyid111", - "Name": "Renamed-Policy", - "Description": "This description replaces the original." + "Content": "{ \\\"Version\\\": \\\"2012-10-17\\\", \\\"Statement\\\": {\\\"Effect\\\": \\\"Allow\\\", \\\"Action\\\": \\\"s3:*\\\", \\\"Resource\\\": \\\"*\\\" } }" }, "output": { "Policy": { - "Content": "{ \"Version\": \"2012-10-17\", \"Statement\": { \"Effect\": \"Allow\", \"Action\": \"ec2:*\", \"Resource\": \"*\" } }", + "Content": "{ \\\"Version\\\": \\\"2012-10-17\\\", \\\"Statement\\\": { \\\"Effect\\\": \\\"Allow\\\", \\\"Action\\\": \\\"s3:*\\\", \\\"Resource\\\": \\\"*\\\" } }", "PolicySummary": { "Id": "p-examplepolicyid111", "AwsManaged": false, @@ -8865,15 +8870,16 @@ } }, { - "title": "To update the content of a policy", - "documentation": "The following example shows how to replace the JSON text of the SCP from the preceding example with a new JSON policy text string that allows S3 actions instead of EC2 actions:/n/n", + "title": "To update the details of a policy", + "documentation": "The following example shows how to rename a policy and give it a new description and new content. The output confirms the new name and description text:/n/n", "input": { "PolicyId": "p-examplepolicyid111", - "Content": "{ \\\"Version\\\": \\\"2012-10-17\\\", \\\"Statement\\\": {\\\"Effect\\\": \\\"Allow\\\", \\\"Action\\\": \\\"s3:*\\\", \\\"Resource\\\": \\\"*\\\" } }" + "Name": "Renamed-Policy", + "Description": "This description replaces the original." }, "output": { "Policy": { - "Content": "{ \\\"Version\\\": \\\"2012-10-17\\\", \\\"Statement\\\": { \\\"Effect\\\": \\\"Allow\\\", \\\"Action\\\": \\\"s3:*\\\", \\\"Resource\\\": \\\"*\\\" } }", + "Content": "{ \"Version\": \"2012-10-17\", \"Statement\": { \"Effect\": \"Allow\", \"Action\": \"ec2:*\", \"Resource\": \"*\" } }", "PolicySummary": { "Id": "p-examplepolicyid111", "AwsManaged": false, diff --git a/codegen/sdk-codegen/aws-models/rekognition.json b/codegen/sdk-codegen/aws-models/rekognition.json index dcc61af9ec9..291b9d3a94a 100644 --- a/codegen/sdk-codegen/aws-models/rekognition.json +++ b/codegen/sdk-codegen/aws-models/rekognition.json @@ -1550,6 +1550,12 @@ "smithy.api#documentation": "

\nThe ARN of the Amazon Rekognition Custom Labels project to which you want to asssign the dataset.\n

", "smithy.api#required": {} } + }, + "Tags": { + "target": "com.amazonaws.rekognition#TagMap", + "traits": { + "smithy.api#documentation": "

A set of tags (key-value pairs) that you want to attach to the dataset.

" + } } }, "traits": { @@ -1729,6 +1735,12 @@ "traits": { "smithy.api#documentation": "

Specifies whether automatic retraining should be attempted for the versions of the\n project. Automatic retraining is done as a best effort. Required argument for Content\n Moderation. Applicable only to adapters.

" } + }, + "Tags": { + "target": "com.amazonaws.rekognition#TagMap", + "traits": { + "smithy.api#documentation": "

A set of tags (key-value pairs) that you want to attach to the project.

" + } } }, "traits": { @@ -4326,7 +4338,7 @@ "ModerationLabels": { "target": "com.amazonaws.rekognition#ModerationLabels", "traits": { - "smithy.api#documentation": "

Array of detected Moderation labels and the time, in milliseconds from the start of the\n video, they were detected.

" + "smithy.api#documentation": "

Array of detected Moderation labels. For video operations, this includes the time, \n in milliseconds from the start of the video, they were detected.

" } }, "ModerationModelVersion": { @@ -6311,7 +6323,7 @@ } ], "traits": { - "smithy.api#documentation": "

Gets the label detection results of a Amazon Rekognition Video analysis started by StartLabelDetection.

\n

The label detection operation is started by a call to StartLabelDetection which returns a job identifier (JobId). When\n the label detection operation finishes, Amazon Rekognition publishes a completion status to the\n Amazon Simple Notification Service topic registered in the initial call to StartlabelDetection.

\n

To get the results of the label detection operation, first check that the status value\n published to the Amazon SNS topic is SUCCEEDED. If so, call GetLabelDetection and pass the job identifier (JobId) from the\n initial call to StartLabelDetection.

\n

\n GetLabelDetection returns an array of detected labels\n (Labels) sorted by the time the labels were detected. You can also sort by the\n label name by specifying NAME for the SortBy input parameter. If\n there is no NAME specified, the default sort is by\n timestamp.

\n

You can select how results are aggregated by using the AggregateBy input\n parameter. The default aggregation method is TIMESTAMPS. You can also aggregate\n by SEGMENTS, which aggregates all instances of labels detected in a given\n segment.

\n

The returned Labels array may include the following attributes:

\n \n

Timestamp and Bounding box information are returned for detected Instances, only if\n aggregation is done by TIMESTAMPS. If aggregating by SEGMENTS,\n information about detected instances isn’t returned.

\n

The version of the label model used for the detection is also returned.

\n

\n Note DominantColors isn't returned for Instances,\n although it is shown as part of the response in the sample seen below.\n

\n

Use MaxResults parameter to limit the number of labels returned. If\n there are more results than specified in MaxResults, the value of\n NextToken in the operation response contains a pagination token for getting the\n next set of results. To get the next page of results, call GetlabelDetection and\n populate the NextToken request parameter with the token value returned from the\n previous call to GetLabelDetection.

", + "smithy.api#documentation": "

Gets the label detection results of a Amazon Rekognition Video analysis started by StartLabelDetection.

\n

The label detection operation is started by a call to StartLabelDetection which returns a job identifier (JobId). When\n the label detection operation finishes, Amazon Rekognition publishes a completion status to the\n Amazon Simple Notification Service topic registered in the initial call to StartlabelDetection.

\n

To get the results of the label detection operation, first check that the status value\n published to the Amazon SNS topic is SUCCEEDED. If so, call GetLabelDetection and pass the job identifier (JobId) from the\n initial call to StartLabelDetection.

\n

\n GetLabelDetection returns an array of detected labels\n (Labels) sorted by the time the labels were detected. You can also sort by the\n label name by specifying NAME for the SortBy input parameter. If\n there is no NAME specified, the default sort is by\n timestamp.

\n

You can select how results are aggregated by using the AggregateBy input\n parameter. The default aggregation method is TIMESTAMPS. You can also aggregate\n by SEGMENTS, which aggregates all instances of labels detected in a given\n segment.

\n

The returned Labels array may include the following attributes:

\n \n

Timestamp and Bounding box information are returned for detected Instances, only if\n aggregation is done by TIMESTAMPS. If aggregating by SEGMENTS,\n information about detected instances isn’t returned.

\n

The version of the label model used for the detection is also returned.

\n

\n Note DominantColors isn't returned for Instances,\n although it is shown as part of the response in the sample seen below.\n

\n

Use MaxResults parameter to limit the number of labels returned. If\n there are more results than specified in MaxResults, the value of\n NextToken in the operation response contains a pagination token for getting the\n next set of results. To get the next page of results, call GetlabelDetection and\n populate the NextToken request parameter with the token value returned from the\n previous call to GetLabelDetection.

\n

If you are retrieving results while using the Amazon Simple Notification Service, note that you will receive an\n \"ERROR\" notification if the job encounters an issue.

", "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", diff --git a/codegen/sdk-codegen/aws-models/workspaces.json b/codegen/sdk-codegen/aws-models/workspaces.json index 7cf1241b5a8..96267045856 100644 --- a/codegen/sdk-codegen/aws-models/workspaces.json +++ b/codegen/sdk-codegen/aws-models/workspaces.json @@ -8012,7 +8012,8 @@ "Capacity": { "target": "com.amazonaws.workspaces#NonEmptyString", "traits": { - "smithy.api#documentation": "

The size of the root volume.

" + "smithy.api#documentation": "

The size of the root volume.

", + "smithy.api#required": {} } } }, @@ -9559,7 +9560,8 @@ "Capacity": { "target": "com.amazonaws.workspaces#NonEmptyString", "traits": { - "smithy.api#documentation": "

The size of the user volume.

" + "smithy.api#documentation": "

The size of the user volume.

", + "smithy.api#required": {} } } },