From b811ea8391353a33585662f5f76d42acb7614bb6 Mon Sep 17 00:00:00 2001 From: aws-sdk-go-automation <43143561+aws-sdk-go-automation@users.noreply.github.com> Date: Thu, 6 Aug 2020 11:16:37 -0700 Subject: [PATCH] Release v1.33.21 (2020-08-06) (#3462) Release v1.33.21 (2020-08-06) === ### Service Client Updates * `service/ec2`: Updates service API, documentation, and paginators * This release supports Wavelength resources, including carrier gateways, and carrier IP addresses. * `service/lex-models`: Updates service API and documentation * `service/personalize`: Updates service API and documentation * `service/personalize-events`: Updates service API and documentation * `service/personalize-runtime`: Updates service API and documentation * `service/runtime.lex`: Updates service API and documentation --- CHANGELOG.md | 12 + aws/endpoints/defaults.go | 1 + aws/version.go | 2 +- models/apis/ec2/2016-11-15/api-2.json | 177 ++++ models/apis/ec2/2016-11-15/docs-2.json | 169 +++- models/apis/ec2/2016-11-15/paginators-1.json | 6 + models/apis/lex-models/2017-04-19/api-2.json | 12 + models/apis/lex-models/2017-04-19/docs-2.json | 12 + .../personalize-events/2018-03-22/api-2.json | 24 +- .../personalize-events/2018-03-22/docs-2.json | 35 +- .../personalize-runtime/2018-05-22/api-2.json | 7 +- .../2018-05-22/docs-2.json | 7 + models/apis/personalize/2018-05-22/api-2.json | 28 +- .../apis/personalize/2018-05-22/docs-2.json | 26 +- models/apis/runtime.lex/2016-11-28/api-2.json | 48 +- .../apis/runtime.lex/2016-11-28/docs-2.json | 38 +- models/endpoints/endpoints.json | 1 + service/ec2/api.go | 919 ++++++++++++++++-- service/ec2/ec2iface/interface.go | 15 + service/lexmodelbuildingservice/api.go | 134 +++ service/lexruntimeservice/api.go | 167 +++- service/personalize/api.go | 121 ++- service/personalizeevents/api.go | 77 +- service/personalizeevents/doc.go | 4 + service/personalizeruntime/api.go | 18 + 25 files changed, 1918 insertions(+), 142 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index cb0a4bc4233..9a87e58310d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,15 @@ +Release v1.33.21 (2020-08-06) +=== + +### Service Client Updates +* `service/ec2`: Updates service API, documentation, and paginators + * This release supports Wavelength resources, including carrier gateways, and carrier IP addresses. +* `service/lex-models`: Updates service API and documentation +* `service/personalize`: Updates service API and documentation +* `service/personalize-events`: Updates service API and documentation +* `service/personalize-runtime`: Updates service API and documentation +* `service/runtime.lex`: Updates service API and documentation + Release v1.33.20 (2020-08-05) === diff --git a/aws/endpoints/defaults.go b/aws/endpoints/defaults.go index 2a4d957f7cc..829923c28cc 100644 --- a/aws/endpoints/defaults.go +++ b/aws/endpoints/defaults.go @@ -839,6 +839,7 @@ var awsPartition = partition{ "ca-central-1": endpoint{}, "eu-central-1": endpoint{}, "eu-north-1": endpoint{}, + "eu-south-1": endpoint{}, "eu-west-1": endpoint{}, "eu-west-2": endpoint{}, "eu-west-3": endpoint{}, diff --git a/aws/version.go b/aws/version.go index 7b2d968fc6b..c3b5b8db296 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.33.20" +const SDKVersion = "1.33.21" diff --git a/models/apis/ec2/2016-11-15/api-2.json b/models/apis/ec2/2016-11-15/api-2.json index 063c5565442..2d233a422fc 100755 --- a/models/apis/ec2/2016-11-15/api-2.json +++ b/models/apis/ec2/2016-11-15/api-2.json @@ -384,6 +384,15 @@ "input":{"shape":"CreateCapacityReservationRequest"}, "output":{"shape":"CreateCapacityReservationResult"} }, + "CreateCarrierGateway":{ + "name":"CreateCarrierGateway", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateCarrierGatewayRequest"}, + "output":{"shape":"CreateCarrierGatewayResult"} + }, "CreateClientVpnEndpoint":{ "name":"CreateClientVpnEndpoint", "http":{ @@ -858,6 +867,15 @@ "input":{"shape":"CreateVpnGatewayRequest"}, "output":{"shape":"CreateVpnGatewayResult"} }, + "DeleteCarrierGateway":{ + "name":"DeleteCarrierGateway", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteCarrierGatewayRequest"}, + "output":{"shape":"DeleteCarrierGatewayResult"} + }, "DeleteClientVpnEndpoint":{ "name":"DeleteClientVpnEndpoint", "http":{ @@ -1377,6 +1395,15 @@ "input":{"shape":"DescribeCapacityReservationsRequest"}, "output":{"shape":"DescribeCapacityReservationsResult"} }, + "DescribeCarrierGateways":{ + "name":"DescribeCarrierGateways", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeCarrierGatewaysRequest"}, + "output":{"shape":"DescribeCarrierGatewaysResult"} + }, "DescribeClassicLinkInstances":{ "name":"DescribeClassicLinkInstances", "http":{ @@ -3912,6 +3939,10 @@ "CustomerOwnedIpv4Pool":{ "shape":"String", "locationName":"customerOwnedIpv4Pool" + }, + "CarrierIp":{ + "shape":"String", + "locationName":"carrierIp" } } }, @@ -3990,6 +4021,10 @@ "CustomerOwnedIpv4Pool":{ "shape":"String", "locationName":"customerOwnedIpv4Pool" + }, + "CarrierIp":{ + "shape":"String", + "locationName":"carrierIp" } } }, @@ -5605,6 +5640,57 @@ "dedicated" ] }, + "CarrierGateway":{ + "type":"structure", + "members":{ + "CarrierGatewayId":{ + "shape":"CarrierGatewayId", + "locationName":"carrierGatewayId" + }, + "VpcId":{ + "shape":"VpcId", + "locationName":"vpcId" + }, + "State":{ + "shape":"CarrierGatewayState", + "locationName":"state" + }, + "OwnerId":{ + "shape":"String", + "locationName":"ownerId" + }, + "Tags":{ + "shape":"TagList", + "locationName":"tagSet" + } + } + }, + "CarrierGatewayId":{"type":"string"}, + "CarrierGatewayIdSet":{ + "type":"list", + "member":{"shape":"CarrierGatewayId"} + }, + "CarrierGatewayMaxResults":{ + "type":"integer", + "max":1000, + "min":5 + }, + "CarrierGatewaySet":{ + "type":"list", + "member":{ + "shape":"CarrierGateway", + "locationName":"item" + } + }, + "CarrierGatewayState":{ + "type":"string", + "enum":[ + "pending", + "available", + "deleting", + "deleted" + ] + }, "CertificateAuthentication":{ "type":"structure", "members":{ @@ -6495,6 +6581,31 @@ } } }, + "CreateCarrierGatewayRequest":{ + "type":"structure", + "required":["VpcId"], + "members":{ + "VpcId":{"shape":"VpcId"}, + "TagSpecifications":{ + "shape":"TagSpecificationList", + "locationName":"TagSpecification" + }, + "DryRun":{"shape":"Boolean"}, + "ClientToken":{ + "shape":"String", + "idempotencyToken":true + } + } + }, + "CreateCarrierGatewayResult":{ + "type":"structure", + "members":{ + "CarrierGateway":{ + "shape":"CarrierGateway", + "locationName":"carrierGateway" + } + } + }, "CreateClientVpnEndpointRequest":{ "type":"structure", "required":[ @@ -7419,6 +7530,7 @@ }, "TransitGatewayId":{"shape":"TransitGatewayId"}, "LocalGatewayId":{"shape":"LocalGatewayId"}, + "CarrierGatewayId":{"shape":"CarrierGatewayId"}, "NetworkInterfaceId":{ "shape":"NetworkInterfaceId", "locationName":"networkInterfaceId" @@ -8320,6 +8432,23 @@ ] }, "DefaultingDhcpOptionsId":{"type":"string"}, + "DeleteCarrierGatewayRequest":{ + "type":"structure", + "required":["CarrierGatewayId"], + "members":{ + "CarrierGatewayId":{"shape":"CarrierGatewayId"}, + "DryRun":{"shape":"Boolean"} + } + }, + "DeleteCarrierGatewayResult":{ + "type":"structure", + "members":{ + "CarrierGateway":{ + "shape":"CarrierGateway", + "locationName":"carrierGateway" + } + } + }, "DeleteClientVpnEndpointRequest":{ "type":"structure", "required":["ClientVpnEndpointId"], @@ -9549,6 +9678,35 @@ } } }, + "DescribeCarrierGatewaysRequest":{ + "type":"structure", + "members":{ + "CarrierGatewayIds":{ + "shape":"CarrierGatewayIdSet", + "locationName":"CarrierGatewayId" + }, + "Filters":{ + "shape":"FilterList", + "locationName":"Filter" + }, + "MaxResults":{"shape":"CarrierGatewayMaxResults"}, + "NextToken":{"shape":"String"}, + "DryRun":{"shape":"Boolean"} + } + }, + "DescribeCarrierGatewaysResult":{ + "type":"structure", + "members":{ + "CarrierGateways":{ + "shape":"CarrierGatewaySet", + "locationName":"carrierGatewaySet" + }, + "NextToken":{ + "shape":"String", + "locationName":"nextToken" + } + } + }, "DescribeClassicLinkInstancesMaxResults":{ "type":"integer", "max":1000, @@ -17892,6 +18050,10 @@ "InstanceNetworkInterfaceAssociation":{ "type":"structure", "members":{ + "CarrierIp":{ + "shape":"String", + "locationName":"carrierIp" + }, "IpOwnerId":{ "shape":"String", "locationName":"ipOwnerId" @@ -17991,6 +18153,7 @@ "shape":"String", "locationName":"subnetId" }, + "AssociateCarrierIpAddress":{"shape":"Boolean"}, "InterfaceType":{"shape":"String"} } }, @@ -19518,6 +19681,10 @@ "LaunchTemplateInstanceNetworkInterfaceSpecification":{ "type":"structure", "members":{ + "AssociateCarrierIpAddress":{ + "shape":"Boolean", + "locationName":"associateCarrierIpAddress" + }, "AssociatePublicIpAddress":{ "shape":"Boolean", "locationName":"associatePublicIpAddress" @@ -19582,6 +19749,7 @@ "LaunchTemplateInstanceNetworkInterfaceSpecificationRequest":{ "type":"structure", "members":{ + "AssociateCarrierIpAddress":{"shape":"Boolean"}, "AssociatePublicIpAddress":{"shape":"Boolean"}, "DeleteOnTermination":{"shape":"Boolean"}, "Description":{"shape":"String"}, @@ -21895,6 +22063,10 @@ "PublicIp":{ "shape":"String", "locationName":"publicIp" + }, + "CarrierIp":{ + "shape":"String", + "locationName":"carrierIp" } } }, @@ -23762,6 +23934,7 @@ }, "TransitGatewayId":{"shape":"TransitGatewayId"}, "LocalGatewayId":{"shape":"LocalGatewayId"}, + "CarrierGatewayId":{"shape":"CarrierGatewayId"}, "NetworkInterfaceId":{ "shape":"NetworkInterfaceId", "locationName":"networkInterfaceId" @@ -25092,6 +25265,10 @@ "shape":"String", "locationName":"localGatewayId" }, + "CarrierGatewayId":{ + "shape":"CarrierGatewayId", + "locationName":"carrierGatewayId" + }, "NetworkInterfaceId":{ "shape":"String", "locationName":"networkInterfaceId" diff --git a/models/apis/ec2/2016-11-15/docs-2.json b/models/apis/ec2/2016-11-15/docs-2.json index d4574ac9e94..a6d977100b6 100755 --- a/models/apis/ec2/2016-11-15/docs-2.json +++ b/models/apis/ec2/2016-11-15/docs-2.json @@ -8,12 +8,12 @@ "AcceptVpcEndpointConnections": "

Accepts one or more interface VPC endpoint connection requests to your VPC endpoint service.

", "AcceptVpcPeeringConnection": "

Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use DescribeVpcPeeringConnections to view your outstanding VPC peering connection requests.

For an inter-Region VPC peering connection request, you must accept the VPC peering connection in the Region of the accepter VPC.

", "AdvertiseByoipCidr": "

Advertises an IPv4 or IPv6 address range that is provisioned for use with your AWS resources through bring your own IP addresses (BYOIP).

You can perform this operation at most once every 10 seconds, even if you specify different address ranges each time.

We recommend that you stop advertising the BYOIP CIDR from other locations when you advertise it from AWS. To minimize down time, you can configure your AWS resources to use an address from a BYOIP CIDR before it is advertised, and then simultaneously stop advertising it from the current location and start advertising it through AWS.

It can take a few minutes before traffic to the specified addresses starts routing to AWS because of BGP propagation delays.

To stop advertising the BYOIP CIDR, use WithdrawByoipCidr.

", - "AllocateAddress": "

Allocates an Elastic IP address to your AWS account. After you allocate the Elastic IP address you can associate it with an instance or network interface. After you release an Elastic IP address, it is released to the IP address pool and can be allocated to a different AWS account.

You can allocate an Elastic IP address from an address pool owned by AWS or from an address pool created from a public IPv4 address range that you have brought to AWS for use with your AWS resources using bring your own IP addresses (BYOIP). For more information, see Bring Your Own IP Addresses (BYOIP) in the Amazon Elastic Compute Cloud User Guide.

[EC2-VPC] If you release an Elastic IP address, you might be able to recover it. You cannot recover an Elastic IP address that you released after it is allocated to another AWS account. You cannot recover an Elastic IP address for EC2-Classic. To attempt to recover an Elastic IP address that you released, specify it in this operation.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. By default, you can allocate 5 Elastic IP addresses for EC2-Classic per Region and 5 Elastic IP addresses for EC2-VPC per Region.

For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

", + "AllocateAddress": "

Allocates an Elastic IP address to your AWS account. After you allocate the Elastic IP address you can associate it with an instance or network interface. After you release an Elastic IP address, it is released to the IP address pool and can be allocated to a different AWS account.

You can allocate an Elastic IP address from an address pool owned by AWS or from an address pool created from a public IPv4 address range that you have brought to AWS for use with your AWS resources using bring your own IP addresses (BYOIP). For more information, see Bring Your Own IP Addresses (BYOIP) in the Amazon Elastic Compute Cloud User Guide.

[EC2-VPC] If you release an Elastic IP address, you might be able to recover it. You cannot recover an Elastic IP address that you released after it is allocated to another AWS account. You cannot recover an Elastic IP address for EC2-Classic. To attempt to recover an Elastic IP address that you released, specify it in this operation.

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. By default, you can allocate 5 Elastic IP addresses for EC2-Classic per Region and 5 Elastic IP addresses for EC2-VPC per Region.

For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

You can allocate a carrier IP address which is a public IP address from a telecommunication carrier, to a network interface which resides in a subnet in a Wavelength Zone (for example an EC2 instance).

", "AllocateHosts": "

Allocates a Dedicated Host to your account. At a minimum, specify the supported instance type or instance family, the Availability Zone in which to allocate the host, and the number of hosts to allocate.

", "ApplySecurityGroupsToClientVpnTargetNetwork": "

Applies a security group to the association between the target network and the Client VPN endpoint. This action replaces the existing security groups with the specified security groups.

", "AssignIpv6Addresses": "

Assigns one or more IPv6 addresses to the specified network interface. You can specify one or more specific IPv6 addresses, or you can specify the number of IPv6 addresses to be automatically assigned from within the subnet's IPv6 CIDR block range. You can assign as many IPv6 addresses to a network interface as you can assign private IPv4 addresses, and the limit varies per instance type. For information, see IP Addresses Per Network Interface Per Instance Type in the Amazon Elastic Compute Cloud User Guide.

You must specify either the IPv6 addresses or the IPv6 address count in the request.

", "AssignPrivateIpAddresses": "

Assigns one or more secondary private IP addresses to the specified network interface.

You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet's CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

When you move a secondary private IP address to another network interface, any Elastic IP address that is associated with the IP address is also moved.

Remapping an IP address is an asynchronous operation. When you move an IP address from one network interface to another, check network/interfaces/macs/mac/local-ipv4s in the instance metadata to confirm that the remapping is complete.

You must specify either the IP addresses or the IP address count in the request.

", - "AssociateAddress": "

Associates an Elastic IP address with an instance or a network interface. Before you can use an Elastic IP address, you must allocate it to your account.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance. If you associate an Elastic IP address with an instance that has an existing Elastic IP address, the existing address is disassociated from the instance, but remains allocated to your account.

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation. You cannot associate an Elastic IP address with an instance or network interface that has an existing Elastic IP address.

You cannot associate an Elastic IP address with an interface in a different network border group.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error, and you may be charged for each time the Elastic IP address is remapped to the same instance. For more information, see the Elastic IP Addresses section of Amazon EC2 Pricing.

", + "AssociateAddress": "

Associates an Elastic IP address, or carrier IP address (for instances that are in subnets in Wavelength Zones) with an instance or a network interface. Before you can use an Elastic IP address, you must allocate it to your account.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance. If you associate an Elastic IP address with an instance that has an existing Elastic IP address, the existing address is disassociated from the instance, but remains allocated to your account.

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation. You cannot associate an Elastic IP address with an instance or network interface that has an existing Elastic IP address.

[Subnets in Wavelength Zones] You can associate an IP address from the telecommunication carrier to the instance or network interface.

You cannot associate an Elastic IP address with an interface in a different network border group.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error, and you may be charged for each time the Elastic IP address is remapped to the same instance. For more information, see the Elastic IP Addresses section of Amazon EC2 Pricing.

", "AssociateClientVpnTargetNetwork": "

Associates a target network with a Client VPN endpoint. A target network is a subnet in a VPC. You can associate multiple subnets from the same VPC with a Client VPN endpoint. You can associate only one subnet in each Availability Zone. We recommend that you associate at least two subnets to provide Availability Zone redundancy.

If you specified a VPC when you created the Client VPN endpoint or if you have previous subnet associations, the specified subnet must be in the same VPC. To specify a subnet that's in a different VPC, you must first modify the Client VPN endpoint (ModifyClientVpnEndpoint) and change the VPC that's associated with it.

", "AssociateDhcpOptions": "

Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

", "AssociateIamInstanceProfile": "

Associates an IAM instance profile with a running or stopped instance. You cannot associate more than one IAM instance profile with an instance.

", @@ -44,6 +44,7 @@ "CopyImage": "

Initiates the copy of an AMI from the specified source Region to the current Region. You specify the destination Region by using its endpoint when making the request.

Copies of encrypted backing snapshots for the AMI are encrypted. Copies of unencrypted backing snapshots remain unencrypted, unless you set Encrypted during the copy operation. You cannot create an unencrypted copy of an encrypted backing snapshot.

For more information about the prerequisites and limits when copying an AMI, see Copying an AMI in the Amazon Elastic Compute Cloud User Guide.

", "CopySnapshot": "

Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy the snapshot within the same Region or from one Region to another. You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs).

Copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted, unless you enable encryption for the snapshot copy operation. By default, encrypted snapshot copies use the default AWS Key Management Service (AWS KMS) customer master key (CMK); however, you can specify a different CMK.

To copy an encrypted snapshot that has been shared from another account, you must have permissions for the CMK used to encrypt the snapshot.

Snapshots created by copying another snapshot have an arbitrary volume ID that should not be used for any purpose.

For more information, see Copying an Amazon EBS Snapshot in the Amazon Elastic Compute Cloud User Guide.

", "CreateCapacityReservation": "

Creates a new Capacity Reservation with the specified attributes.

Capacity Reservations enable you to reserve capacity for your Amazon EC2 instances in a specific Availability Zone for any duration. This gives you the flexibility to selectively add capacity reservations and still get the Regional RI discounts for that usage. By creating Capacity Reservations, you ensure that you always have access to Amazon EC2 capacity when you need it, for as long as you need it. For more information, see Capacity Reservations in the Amazon Elastic Compute Cloud User Guide.

Your request to create a Capacity Reservation could fail if Amazon EC2 does not have sufficient capacity to fulfill the request. If your request fails due to Amazon EC2 capacity constraints, either try again at a later time, try in a different Availability Zone, or request a smaller capacity reservation. If your application is flexible across instance types and sizes, try to create a Capacity Reservation with different instance attributes.

Your request could also fail if the requested quantity exceeds your On-Demand Instance limit for the selected instance type. If your request fails due to limit constraints, increase your On-Demand Instance limit for the required instance type and try again. For more information about increasing your instance limits, see Amazon EC2 Service Limits in the Amazon Elastic Compute Cloud User Guide.

", + "CreateCarrierGateway": "

Creates a carrier gateway. For more information about carrier gateways, see Carrier gateways in the AWS Wavelength Developer Guide.

", "CreateClientVpnEndpoint": "

Creates a Client VPN endpoint. A Client VPN endpoint is the resource you create and configure to enable and manage client VPN sessions. It is the destination endpoint at which all client VPN sessions are terminated.

", "CreateClientVpnRoute": "

Adds a route to a network to a Client VPN endpoint. Each Client VPN endpoint has a route table that describes the available destination network routes. Each route in the route table specifies the path for traffic to specific resources or networks.

", "CreateCustomerGateway": "

Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and can be behind a device performing network address translation (NAT).

For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

Amazon EC2 supports all 2-byte ASN numbers in the range of 1 - 65534, with the exception of 7224, which is reserved in the us-east-1 Region, and 9059, which is reserved in the eu-west-1 Region.

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

To create more than one customer gateway with the same VPN type, IP address, and BGP ASN, specify a unique device name for each customer gateway. Identical requests return information about the existing customer gateway and do not create new customer gateways.

", @@ -97,6 +98,7 @@ "CreateVpnConnection": "

Creates a VPN connection between an existing virtual private gateway and a VPN customer gateway. The supported connection type is ipsec.1.

The response includes information that you need to give to your network administrator to configure your customer gateway.

We strongly recommend that you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway.

If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

", "CreateVpnConnectionRoute": "

Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

", "CreateVpnGateway": "

Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

", + "DeleteCarrierGateway": "

Deletes a carrier gateway.

If you do not delete the route that contains the carrier gateway as the Target, the route is a blackhole route. For information about how to delete a route, see DeleteRoute.

", "DeleteClientVpnEndpoint": "

Deletes the specified Client VPN endpoint. You must disassociate all target networks before you can delete a Client VPN endpoint.

", "DeleteClientVpnRoute": "

Deletes a route from a Client VPN endpoint. You can only delete routes that you manually added using the CreateClientVpnRoute action. You cannot delete routes that were automatically added when associating a subnet. To remove routes that have been automatically added, disassociate the target subnet from the Client VPN endpoint.

", "DeleteCustomerGateway": "

Deletes the specified customer gateway. You must delete the VPN connection before you can delete the customer gateway.

", @@ -153,10 +155,11 @@ "DescribeAccountAttributes": "

Describes attributes of your AWS account. The following are the supported account attributes:

", "DescribeAddresses": "

Describes the specified Elastic IP addresses or all of your Elastic IP addresses.

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

", "DescribeAggregateIdFormat": "

Describes the longer ID format settings for all resource types in a specific Region. This request is useful for performing a quick audit to determine whether a specific Region is fully opted in for longer IDs (17-character IDs).

This request only returns information about resource types that support longer IDs.

The following resource types support longer IDs: bundle | conversion-task | customer-gateway | dhcp-options | elastic-ip-allocation | elastic-ip-association | export-task | flow-log | image | import-task | instance | internet-gateway | network-acl | network-acl-association | network-interface | network-interface-attachment | prefix-list | reservation | route-table | route-table-association | security-group | snapshot | subnet | subnet-cidr-block-association | volume | vpc | vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

", - "DescribeAvailabilityZones": "

Describes the Availability Zones and Local Zones that are available to you. If there is an event impacting an Availability Zone or Local Zone, you can use this request to view the state and any provided messages for that Availability Zone or Local Zone.

For more information about Availability Zones and Local Zones, see Regions and Availability Zones in the Amazon Elastic Compute Cloud User Guide.

", + "DescribeAvailabilityZones": "

Describes the Availability Zones, Local Zones, and Wavelength Zones that are available to you. If there is an event impacting a zone, you can use this request to view the state and any provided messages for that zone.

For more information about Availability Zones, Local Zones, and Wavelength Zones, see Regions, Zones and Outposts in the Amazon Elastic Compute Cloud User Guide.

", "DescribeBundleTasks": "

Describes the specified bundle tasks or all of your bundle tasks.

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

", "DescribeByoipCidrs": "

Describes the IP address ranges that were specified in calls to ProvisionByoipCidr.

To describe the address pools that were created when you provisioned the address ranges, use DescribePublicIpv4Pools or DescribeIpv6Pools.

", "DescribeCapacityReservations": "

Describes one or more of your Capacity Reservations. The results describe only the Capacity Reservations in the AWS Region that you're currently using.

", + "DescribeCarrierGateways": "

Describes one or more of your carrier gateways.

", "DescribeClassicLinkInstances": "

Describes one or more of your linked EC2-Classic instances. This request only returns information about EC2-Classic instances linked to a VPC through ClassicLink. You cannot use this request to return information about other instances.

", "DescribeClientVpnAuthorizationRules": "

Describes the authorization rules for a specified Client VPN endpoint.

", "DescribeClientVpnConnections": "

Describes active client connections and connections that have been terminated within the last 60 minutes for the specified Client VPN endpoint.

", @@ -319,7 +322,7 @@ "ImportKeyPair": "

Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you (AWS keeps a copy of the public key). With ImportKeyPair, you create the key pair and give AWS just the public key. The private key is never transferred between you and AWS.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

", "ImportSnapshot": "

Imports a disk into an EBS snapshot.

", "ImportVolume": "

Creates an import volume task using metadata from the specified disk image.For more information, see Importing Disks to Amazon EBS.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", - "ModifyAvailabilityZoneGroup": "

Enables or disables an Availability Zone group for your account.

Use DescribeAvailabilityZones to view the value for GroupName.

", + "ModifyAvailabilityZoneGroup": "

Changes the opt-in status of the Local Zone and Wavelength Zone group for your account.

Use DescribeAvailabilityZones to view the value for GroupName.

", "ModifyCapacityReservation": "

Modifies a Capacity Reservation's capacity and the conditions under which it is to be released. You cannot change a Capacity Reservation's instance type, EBS optimization, instance store settings, platform, Availability Zone, or instance eligibility. If you need to modify any of these attributes, we recommend that you cancel the Capacity Reservation, and then create a new one with the required attributes.

", "ModifyClientVpnEndpoint": "

Modifies the specified Client VPN endpoint. Modifying the DNS server resets existing client connections.

", "ModifyDefaultCreditSpecification": "

Modifies the default credit option for CPU usage of burstable performance instances. The default credit option is set at the account level per AWS Region, and is specified per instance family. All new burstable performance instances in the account launch using the default credit option.

ModifyDefaultCreditSpecification is an asynchronous operation, which works at an AWS Region level and modifies the credit option for each Availability Zone. All zones in a Region are updated within five minutes. But if instances are launched during this operation, they might not get the new credit option until the zone is updated. To verify whether the update has occurred, you can call GetDefaultCreditSpecification and check DefaultCreditSpecification for updates.

For more information, see Burstable performance instances in the Amazon Elastic Compute Cloud User Guide.

", @@ -534,7 +537,7 @@ } }, "Address": { - "base": "

Describes an Elastic IP address.

", + "base": "

Describes an Elastic IP address, or a carrier IP address.

", "refs": { "AddressList$member": null } @@ -965,7 +968,7 @@ } }, "AvailabilityZone": { - "base": "

Describes a Zone.

", + "base": "

Describes Availability Zones, Local Zones, and Wavelength Zones.

", "refs": { "AvailabilityZoneList$member": null } @@ -973,11 +976,11 @@ "AvailabilityZoneList": { "base": null, "refs": { - "DescribeAvailabilityZonesResult$AvailabilityZones": "

Information about the Zones.

" + "DescribeAvailabilityZonesResult$AvailabilityZones": "

Information about the Availability Zones, Local Zones, and Wavelength Zones.

" } }, "AvailabilityZoneMessage": { - "base": "

Describes a message about a Zone.

", + "base": "

Describes a message about an Availability Zone, Local Zone, or Wavelength Zone.

", "refs": { "AvailabilityZoneMessageList$member": null } @@ -985,19 +988,19 @@ "AvailabilityZoneMessageList": { "base": null, "refs": { - "AvailabilityZone$Messages": "

Any messages about the Zone.

" + "AvailabilityZone$Messages": "

Any messages about the Availability Zone, Local Zone, or Wavelength Zone.

" } }, "AvailabilityZoneOptInStatus": { "base": null, "refs": { - "AvailabilityZone$OptInStatus": "

For Availability Zones, this parameter always has the value of opt-in-not-required.

For Local Zones, this parameter is the opt in status. The possible values are opted-in, and not-opted-in.

" + "AvailabilityZone$OptInStatus": "

For Availability Zones, this parameter always has the value of opt-in-not-required.

For Local Zones and Wavelength Zones, this parameter is the opt-in status. The possible values are opted-in, and not-opted-in.

" } }, "AvailabilityZoneState": { "base": null, "refs": { - "AvailabilityZone$State": "

The state of the Zone.

" + "AvailabilityZone$State": "

The state of the Availability Zone, Local Zone, or Wavelength Zone.

" } }, "AvailabilityZoneStringList": { @@ -1153,6 +1156,7 @@ "CreateCapacityReservationRequest$EbsOptimized": "

Indicates whether the Capacity Reservation supports EBS-optimized instances. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS- optimized instance.

", "CreateCapacityReservationRequest$EphemeralStorage": "

Indicates whether the Capacity Reservation supports instances with temporary, block-level storage.

", "CreateCapacityReservationRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", + "CreateCarrierGatewayRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "CreateClientVpnEndpointRequest$SplitTunnel": "

Indicates whether split-tunnel is enabled on the AWS Client VPN endpoint.

By default, split-tunnel on a VPN endpoint is disabled.

For information about split-tunnel VPN endpoints, see Split-Tunnel AWS Client VPN Endpoint in the AWS Client VPN Administrator Guide.

", "CreateClientVpnEndpointRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "CreateClientVpnRouteRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", @@ -1215,6 +1219,7 @@ "CreateVpcRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "CreateVpnConnectionRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "CreateVpnGatewayRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", + "DeleteCarrierGatewayRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DeleteClientVpnEndpointRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DeleteClientVpnRouteRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DeleteCustomerGatewayRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", @@ -1279,11 +1284,12 @@ "DescribeAddressesRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DescribeAggregateIdFormatRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DescribeAggregateIdFormatResult$UseLongIdsAggregated": "

Indicates whether all resource types in the Region are configured to use longer IDs. This value is only true if all users are configured to use longer IDs for all resources types in the Region.

", - "DescribeAvailabilityZonesRequest$AllAvailabilityZones": "

Include all Availability Zones and Local Zones regardless of your opt in status.

If you do not use this parameter, the results include only the zones for the Regions where you have chosen the option to opt in.

", + "DescribeAvailabilityZonesRequest$AllAvailabilityZones": "

Include all Availability Zones, Local Zones, and Wavelength Zones regardless of your opt-in status.

If you do not use this parameter, the results include only the zones for the Regions where you have chosen the option to opt in.

", "DescribeAvailabilityZonesRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DescribeBundleTasksRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DescribeByoipCidrsRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DescribeCapacityReservationsRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", + "DescribeCarrierGatewaysRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DescribeClassicLinkInstancesRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DescribeClientVpnAuthorizationRulesRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", "DescribeClientVpnConnectionsRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

", @@ -1472,6 +1478,7 @@ "InstanceNetworkInterfaceAttachment$DeleteOnTermination": "

Indicates whether the network interface is deleted when the instance is terminated.

", "InstanceNetworkInterfaceSpecification$AssociatePublicIpAddress": "

Indicates whether to assign a public IPv4 address to an instance you launch in a VPC. The public IP address can only be assigned to a network interface for eth0, and can only be assigned to a new network interface, not an existing one. You cannot specify more than one network interface in the request. If launching into a default subnet, the default value is true.

", "InstanceNetworkInterfaceSpecification$DeleteOnTermination": "

If set to true, the interface is deleted when the instance is terminated. You can specify true only if creating a new network interface when launching an instance.

", + "InstanceNetworkInterfaceSpecification$AssociateCarrierIpAddress": "

Indicates whether to assign a carrier IP address to the network interface.

You can only assign a carrier IP address to a network interface that is in a subnet in a Wavelength Zone. For more information about carrier IP addresses, see Carrier IP addresses in the AWS Wavelength Developer Guide.

", "InstancePrivateIpAddress$Primary": "

Indicates whether this IPv4 address is the primary private IP address of the network interface.

", "InstanceSpecification$ExcludeBootVolume": "

Excludes the root volume from being snapshotted.

", "InstanceTagNotificationAttribute$IncludeAllTagsOfInstance": "

Indicates wheter all tag keys in the current Region are registered to appear in scheduled event notifications. true indicates that all tag keys in the current Region are registered.

", @@ -1482,8 +1489,10 @@ "LaunchTemplateEbsBlockDeviceRequest$DeleteOnTermination": "

Indicates whether the EBS volume is deleted on instance termination.

", "LaunchTemplateHibernationOptions$Configured": "

If this parameter is set to true, the instance is enabled for hibernation; otherwise, it is not enabled for hibernation.

", "LaunchTemplateHibernationOptionsRequest$Configured": "

If you set this parameter to true, the instance is enabled for hibernation.

Default: false

", + "LaunchTemplateInstanceNetworkInterfaceSpecification$AssociateCarrierIpAddress": "

Indicates whether to associate a Carrier IP address with eth0 for a new network interface.

Use this option when you launch an instance in a Wavelength Zone and want to associate a Carrier IP address with the network interface. For more information about Carrier IP addresses, see Carrier IP addresses in the AWS Wavelength Developer Guide.

", "LaunchTemplateInstanceNetworkInterfaceSpecification$AssociatePublicIpAddress": "

Indicates whether to associate a public IPv4 address with eth0 for a new network interface.

", "LaunchTemplateInstanceNetworkInterfaceSpecification$DeleteOnTermination": "

Indicates whether the network interface is deleted when the instance is terminated.

", + "LaunchTemplateInstanceNetworkInterfaceSpecificationRequest$AssociateCarrierIpAddress": "

Associates a Carrier IP address with eth0 for a new network interface.

Use this option when you launch an instance in a Wavelength Zone and want to associate a Carrier IP address with the network interface. For more information about Carrier IP addresses, see Carrier IP addresses in the AWS Wavelength Developer Guide.

", "LaunchTemplateInstanceNetworkInterfaceSpecificationRequest$AssociatePublicIpAddress": "

Associates a public IPv4 address with eth0 for a new network interface.

", "LaunchTemplateInstanceNetworkInterfaceSpecificationRequest$DeleteOnTermination": "

Indicates whether the network interface is deleted when the instance is terminated.

", "LaunchTemplateVersion$DefaultVersion": "

Indicates whether the version is the default version.

", @@ -1995,6 +2004,49 @@ "CreateCapacityReservationRequest$Tenancy": "

Indicates the tenancy of the Capacity Reservation. A Capacity Reservation can have one of the following tenancy settings:

" } }, + "CarrierGateway": { + "base": "

Describes a carrier gateway.

", + "refs": { + "CarrierGatewaySet$member": null, + "CreateCarrierGatewayResult$CarrierGateway": "

Information about the carrier gateway.

", + "DeleteCarrierGatewayResult$CarrierGateway": "

Information about the carrier gateway.

" + } + }, + "CarrierGatewayId": { + "base": null, + "refs": { + "CarrierGateway$CarrierGatewayId": "

The ID of the carrier gateway.

", + "CarrierGatewayIdSet$member": null, + "CreateRouteRequest$CarrierGatewayId": "

The ID of the carrier gateway.

You can only use this option when the VPC contains a subnet which is associated with a Wavelength Zone.

", + "DeleteCarrierGatewayRequest$CarrierGatewayId": "

The ID of the carrier gateway.

", + "ReplaceRouteRequest$CarrierGatewayId": "

[IPv4 traffic only] The ID of a carrier gateway.

", + "Route$CarrierGatewayId": "

The ID of the carrier gateway.

" + } + }, + "CarrierGatewayIdSet": { + "base": null, + "refs": { + "DescribeCarrierGatewaysRequest$CarrierGatewayIds": "

One or more carrier gateway IDs.

" + } + }, + "CarrierGatewayMaxResults": { + "base": null, + "refs": { + "DescribeCarrierGatewaysRequest$MaxResults": "

The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.

" + } + }, + "CarrierGatewaySet": { + "base": null, + "refs": { + "DescribeCarrierGatewaysResult$CarrierGateways": "

Information about the carrier gateway.

" + } + }, + "CarrierGatewayState": { + "base": null, + "refs": { + "CarrierGateway$State": "

The state of the carrier gateway.

" + } + }, "CertificateAuthentication": { "base": "

Information about the client certificate used for authentication.

", "refs": { @@ -2462,6 +2514,16 @@ "refs": { } }, + "CreateCarrierGatewayRequest": { + "base": null, + "refs": { + } + }, + "CreateCarrierGatewayResult": { + "base": null, + "refs": { + } + }, "CreateClientVpnEndpointRequest": { "base": null, "refs": { @@ -3235,6 +3297,16 @@ "AssociateDhcpOptionsRequest$DhcpOptionsId": "

The ID of the DHCP options set, or default to associate no DHCP options with the VPC.

" } }, + "DeleteCarrierGatewayRequest": { + "base": null, + "refs": { + } + }, + "DeleteCarrierGatewayResult": { + "base": null, + "refs": { + } + }, "DeleteClientVpnEndpointRequest": { "base": null, "refs": { @@ -3826,6 +3898,16 @@ "refs": { } }, + "DescribeCarrierGatewaysRequest": { + "base": null, + "refs": { + } + }, + "DescribeCarrierGatewaysResult": { + "base": null, + "refs": { + } + }, "DescribeClassicLinkInstancesMaxResults": { "base": null, "refs": { @@ -6081,10 +6163,11 @@ "FilterList": { "base": null, "refs": { - "DescribeAddressesRequest$Filters": "

One or more filters. Filter names and values are case-sensitive.

", - "DescribeAvailabilityZonesRequest$Filters": "

The filters.

", + "DescribeAddressesRequest$Filters": "

One or more filters. Filter names and values are case-sensitive.

", + "DescribeAvailabilityZonesRequest$Filters": "

The filters.

", "DescribeBundleTasksRequest$Filters": "

The filters.

", "DescribeCapacityReservationsRequest$Filters": "

One or more filters.

", + "DescribeCarrierGatewaysRequest$Filters": "

One or more filters.

", "DescribeClassicLinkInstancesRequest$Filters": "

One or more filters.

", "DescribeClientVpnAuthorizationRulesRequest$Filters": "

One or more filters. Filter names and values are case-sensitive.

", "DescribeClientVpnConnectionsRequest$Filters": "

One or more filters. Filter names and values are case-sensitive.

", @@ -7898,7 +7981,7 @@ "DescribeVpcEndpointServicePermissionsRequest$MaxResults": "

The maximum number of results to return for the request in a single page. The remaining results of the initial request can be seen by sending another request with the returned NextToken value. This value can be between 5 and 1,000; if MaxResults is given a value larger than 1,000, only 1,000 results are returned.

", "DescribeVpcEndpointServicesRequest$MaxResults": "

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1,000, we return only 1,000 items.

", "DescribeVpcEndpointsRequest$MaxResults": "

The maximum number of items to return for this request. The request returns a token that you can specify in a subsequent call to get the next set of results.

Constraint: If the value is greater than 1,000, we return only 1,000 items.

", - "EbsBlockDevice$Iops": "

The number of I/O operations per second (IOPS) that the volume supports. For io1 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information, see Amazon EBS volume types in the Amazon Elastic Compute Cloud User Guide.

Constraints: Range is 100-16,000 IOPS for gp2 volumes and 100 to 64,000IOPS for io1 volumes in most Regions. Maximum io1 IOPS of 64,000 is guaranteed only on Nitro-based instances. Other instance families guarantee performance up to 32,000 IOPS. For more information, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

", + "EbsBlockDevice$Iops": "

The number of I/O operations per second (IOPS) that the volume supports. For io1 volumes, this represents the number of IOPS that are provisioned for the volume. For gp2 volumes, this represents the baseline performance of the volume and the rate at which the volume accumulates I/O credits for bursting. For more information, see Amazon EBS volume types in the Amazon Elastic Compute Cloud User Guide.

Constraints: Range is 100-16,000 IOPS for gp2 volumes and 100 to 64,000 IOPS for io1 volumes in most Regions. Maximum io1 IOPS of 64,000 is guaranteed only on Nitro-based instances. Other instance families guarantee performance up to 32,000 IOPS. For more information, see Amazon EBS Volume Types in the Amazon Elastic Compute Cloud User Guide.

Condition: This parameter is required for requests to create io1 volumes; it is not used in requests to create gp2, st1, sc1, or standard volumes.

", "EbsBlockDevice$VolumeSize": "

The size of the volume, in GiB.

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

Constraints: 1-16384 for General Purpose SSD (gp2), 4-16384 for Provisioned IOPS SSD (io1), 500-16384 for Throughput Optimized HDD (st1), 500-16384 for Cold HDD (sc1), and 1-1024 for Magnetic (standard) volumes. If you specify a snapshot, the volume size must be equal to or larger than the snapshot size.

", "FlowLog$MaxAggregationInterval": "

The maximum interval of time, in seconds, during which a flow of packets is captured and aggregated into a flow log record.

When a network interface is attached to a Nitro-based instance, the aggregation interval is always 60 seconds (1 minute) or less, regardless of the specified value.

Valid Values: 60 | 600

", "GetCapacityReservationUsageResult$TotalInstanceCount": "

The number of instances for which the Capacity Reservation reserves capacity.

", @@ -9203,7 +9286,7 @@ "ModifyAvailabilityZoneOptInStatus": { "base": null, "refs": { - "ModifyAvailabilityZoneGroupRequest$OptInStatus": "

Indicates whether to enable or disable membership. The valid values are opted-in. You must contact AWS Support to disable an Availability Zone group.

" + "ModifyAvailabilityZoneGroupRequest$OptInStatus": "

Indicates whether you are opted in to the Local Zone group or Wavelength Zone group. The only valid value is opted-in. You must contact AWS Support to opt out of a Local Zone group, or Wavelength Zone group.

" } }, "ModifyCapacityReservationRequest": { @@ -9741,7 +9824,7 @@ } }, "NetworkInterfaceAssociation": { - "base": "

Describes association information for an Elastic IP address (IPv4 only).

", + "base": "

Describes association information for an Elastic IP address (IPv4 only), or a Carrier IP address (for a network interface which resides in a subnet in a Wavelength Zone).

", "refs": { "NetworkInterface$Association": "

The association information for an Elastic IP address (IPv4) associated with the network interface.

", "NetworkInterfacePrivateIpAddress$Association": "

The association information for an Elastic IP address (IPv4) associated with the network interface.

" @@ -12220,19 +12303,21 @@ "Address$NetworkInterfaceOwnerId": "

The ID of the AWS account that owns the network interface.

", "Address$PrivateIpAddress": "

The private IP address associated with the Elastic IP address.

", "Address$PublicIpv4Pool": "

The ID of an address pool.

", - "Address$NetworkBorderGroup": "

The name of the location from which the IP address is advertised.

", + "Address$NetworkBorderGroup": "

The name of the unique set of Availability Zones, Local Zones, or Wavelength Zones from which AWS advertises IP addresses.

", "Address$CustomerOwnedIp": "

The customer-owned IP address.

", "Address$CustomerOwnedIpv4Pool": "

The ID of the customer-owned address pool.

", + "Address$CarrierIp": "

The carrier IP address associated. This option is only available for network interfaces which reside in a subnet in a Wavelength Zone (for example an EC2 instance).

", "AdvertiseByoipCidrRequest$Cidr": "

The address range, in CIDR notation. This must be the exact range that you provisioned. You can't advertise only a portion of the provisioned range.

", "AllocateAddressRequest$PublicIpv4Pool": "

The ID of an address pool that you own. Use this parameter to let Amazon EC2 select an address from the address pool. To specify a specific address from the address pool, use the Address parameter instead.

", - "AllocateAddressRequest$NetworkBorderGroup": "

The location from which the IP address is advertised. Use this parameter to limit the address to this location.

A network border group is a unique set of Availability Zones or Local Zones from where AWS advertises IP addresses and limits the addresses to the group. IP addresses cannot move between network border groups.

Use DescribeAvailabilityZones to view the network border groups.

You cannot use a network border group with EC2 Classic. If you attempt this operation on EC2 classic, you will receive an InvalidParameterCombination error. For more information, see Error Codes.

", + "AllocateAddressRequest$NetworkBorderGroup": "

A unique set of Availability Zones, Local Zones, or Wavelength Zones from which AWS advertises IP addresses. Use this parameter to limit the IP address to this location. IP addresses cannot move between network border groups.

Use DescribeAvailabilityZones to view the network border groups.

You cannot use a network border group with EC2 Classic. If you attempt this operation on EC2 classic, you will receive an InvalidParameterCombination error. For more information, see Error Codes.

", "AllocateAddressRequest$CustomerOwnedIpv4Pool": "

The ID of a customer-owned address pool. Use this parameter to let Amazon EC2 select an address from the address pool. Alternatively, specify a specific address from the address pool.

", "AllocateAddressResult$PublicIp": "

The Elastic IP address.

", "AllocateAddressResult$AllocationId": "

[EC2-VPC] The ID that AWS assigns to represent the allocation of the Elastic IP address for use with instances in a VPC.

", "AllocateAddressResult$PublicIpv4Pool": "

The ID of an address pool.

", - "AllocateAddressResult$NetworkBorderGroup": "

The location from which the IP address is advertised.

", + "AllocateAddressResult$NetworkBorderGroup": "

The set of Availability Zones, Local Zones, or Wavelength Zones from which AWS advertises IP addresses.

", "AllocateAddressResult$CustomerOwnedIp": "

The customer-owned IP address.

", "AllocateAddressResult$CustomerOwnedIpv4Pool": "

The ID of the customer-owned address pool.

", + "AllocateAddressResult$CarrierIp": "

The carrier IP address. This option is only available for network interfaces which reside in a subnet in a Wavelength Zone (for example an EC2 instance).

", "AllocateHostsRequest$AvailabilityZone": "

The Availability Zone in which to allocate the Dedicated Host.

", "AllocateHostsRequest$ClientToken": "

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

", "AllocateHostsRequest$InstanceType": "

Specifies the instance type to be supported by the Dedicated Hosts. If you specify an instance type, the Dedicated Hosts support instances of the specified instance type only.

If you want the Dedicated Hosts to support multiple instance types in a specific instance family, omit this parameter and specify InstanceFamily instead. You cannot specify InstanceType and InstanceFamily in the same request.

", @@ -12250,7 +12335,7 @@ "AssociateSubnetCidrBlockRequest$Ipv6CidrBlock": "

The IPv6 CIDR block for your subnet. The subnet must have a /64 prefix length.

", "AssociateSubnetCidrBlockResult$SubnetId": "

The ID of the subnet.

", "AssociateVpcCidrBlockRequest$CidrBlock": "

An IPv4 CIDR block to associate with the VPC.

", - "AssociateVpcCidrBlockRequest$Ipv6CidrBlockNetworkBorderGroup": "

The name of the location from which we advertise the IPV6 CIDR block. Use this parameter to limit the CiDR block to this location.

You must set AmazonProvidedIpv6CidrBlock to true to use this parameter.

You can have one IPv6 CIDR block association per network border group.

", + "AssociateVpcCidrBlockRequest$Ipv6CidrBlockNetworkBorderGroup": "

The name of the location from which we advertise the IPV6 CIDR block. Use this parameter to limit the CIDR block to this location.

You must set AmazonProvidedIpv6CidrBlock to true to use this parameter.

You can have one IPv6 CIDR block association per network border group.

", "AssociateVpcCidrBlockRequest$Ipv6CidrBlock": "

An IPv6 CIDR block from the IPv6 address pool. You must also specify Ipv6Pool in the request.

To let Amazon choose the IPv6 CIDR block for you, omit this parameter.

", "AssociateVpcCidrBlockResult$VpcId": "

The ID of the VPC.

", "AssociatedTargetNetwork$NetworkId": "

The ID of the subnet.

", @@ -12275,14 +12360,14 @@ "AuthorizeSecurityGroupIngressRequest$SourceSecurityGroupName": "

[EC2-Classic, default VPC] The name of the source security group. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the start of the port range, the IP protocol, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead. For EC2-VPC, the source security group must be in the same VPC.

", "AuthorizeSecurityGroupIngressRequest$SourceSecurityGroupOwnerId": "

[nondefault VPC] The AWS account ID for the source security group, if the source security group is in a different account. You can't specify this parameter in combination with the following parameters: the CIDR IP address range, the IP protocol, the start of the port range, and the end of the port range. Creates rules that grant full ICMP, UDP, and TCP access. To create a rule with a specific IP protocol and port range, use a set of IP permissions instead.

", "AvailabilityZone$RegionName": "

The name of the Region.

", - "AvailabilityZone$ZoneName": "

The name of the Zone.

", - "AvailabilityZone$ZoneId": "

The ID of the Zone.

", - "AvailabilityZone$GroupName": "

For Availability Zones, this parameter has the same value as the Region name.

For Local Zones, the name of the associated group, for example us-west-2-lax-1.

", - "AvailabilityZone$NetworkBorderGroup": "

The name of the location from which the address is advertised.

", - "AvailabilityZone$ZoneType": "

The type of zone. The valid values are availability-zone and local-zone.

", - "AvailabilityZone$ParentZoneName": "

The name of the zone that handles some of the Local Zone control plane operations, such as API calls.

", - "AvailabilityZone$ParentZoneId": "

The ID of the zone that handles some of the Local Zone control plane operations, such as API calls.

", - "AvailabilityZoneMessage$Message": "

The message about the Zone.

", + "AvailabilityZone$ZoneName": "

The name of the Availability Zone, Local Zone, or Wavelength Zone.

", + "AvailabilityZone$ZoneId": "

The ID of the Availability Zone, Local Zone, or Wavelength Zone.

", + "AvailabilityZone$GroupName": "

For Availability Zones, this parameter has the same value as the Region name.

For Local Zones, the name of the associated group, for example us-west-2-lax-1.

For Wavelength Zones, the name of the associated group, for example us-east-1-wl1-bos-wlz-1.

", + "AvailabilityZone$NetworkBorderGroup": "

The name of the network border group.

", + "AvailabilityZone$ZoneType": "

The type of zone. The valid values are availability-zone, local-zone, and wavelength-zone.

", + "AvailabilityZone$ParentZoneName": "

The name of the zone that handles some of the Local Zone or Wavelength Zone control plane operations, such as API calls.

", + "AvailabilityZone$ParentZoneId": "

The ID of the zone that handles some of the Local Zone or Wavelength Zone control plane operations, such as API calls.

", + "AvailabilityZoneMessage$Message": "

The message about the Availability Zone, Local Zone, or Wavelength Zone.

", "AvailabilityZoneStringList$member": null, "BillingProductList$member": null, "BlockDeviceMapping$DeviceName": "

The device name (for example, /dev/sdh or xvdh).

", @@ -12316,6 +12401,7 @@ "CapacityReservationTarget$CapacityReservationResourceGroupArn": "

The ARN of the Capacity Reservation resource group in which to run the instance.

", "CapacityReservationTargetResponse$CapacityReservationId": "

The ID of the targeted Capacity Reservation.

", "CapacityReservationTargetResponse$CapacityReservationResourceGroupArn": "

The ARN of the targeted Capacity Reservation group.

", + "CarrierGateway$OwnerId": "

The AWS account ID of the owner of the carrier gateway.

", "CertificateAuthentication$ClientRootCertificateChain": "

The ARN of the client certificate.

", "CertificateAuthenticationRequest$ClientRootCertificateChainArn": "

The ARN of the client certificate. The certificate must be signed by a certificate authority (CA) and it must be provisioned in AWS Certificate Manager (ACM).

", "CidrAuthorizationContext$Message": "

The plain-text authorization message for the prefix and account.

", @@ -12395,6 +12481,7 @@ "CreateCapacityReservationRequest$InstanceType": "

The instance type for which to reserve capacity. For more information, see Instance Types in the Amazon Elastic Compute Cloud User Guide.

", "CreateCapacityReservationRequest$AvailabilityZone": "

The Availability Zone in which to create the Capacity Reservation.

", "CreateCapacityReservationRequest$AvailabilityZoneId": "

The ID of the Availability Zone in which to create the Capacity Reservation.

", + "CreateCarrierGatewayRequest$ClientToken": "

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency.

", "CreateClientVpnEndpointRequest$ClientCidrBlock": "

The IPv4 address range, in CIDR notation, from which to assign client IP addresses. The address range cannot overlap with the local CIDR of the VPC in which the associated subnet is located, or the routes that you add manually. The address range cannot be changed after the Client VPN endpoint has been created. The CIDR block should be /22 or greater.

", "CreateClientVpnEndpointRequest$ServerCertificateArn": "

The ARN of the server certificate. For more information, see the AWS Certificate Manager User Guide.

", "CreateClientVpnEndpointRequest$Description": "

A brief description of the Client VPN endpoint.

", @@ -12534,6 +12621,8 @@ "DescribeByoipCidrsResult$NextToken": "

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", "DescribeCapacityReservationsRequest$NextToken": "

The token to use to retrieve the next page of results.

", "DescribeCapacityReservationsResult$NextToken": "

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", + "DescribeCarrierGatewaysRequest$NextToken": "

The token for the next page of results.

", + "DescribeCarrierGatewaysResult$NextToken": "

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", "DescribeClassicLinkInstancesRequest$NextToken": "

The token for the next page of results.

", "DescribeClassicLinkInstancesResult$NextToken": "

The token to use to retrieve the next page of results. This value is null when there are no more results to return.

", "DescribeCoipPoolsRequest$NextToken": "

The token for the next page of results.

", @@ -12949,7 +13038,7 @@ "Instance$PrivateDnsName": "

(IPv4 only) The private DNS hostname name assigned to the instance. This DNS hostname can only be used inside the Amazon EC2 network. This name is not available until the instance enters the running state.

[EC2-VPC] The Amazon-provided DNS server resolves Amazon-provided private DNS hostnames if you've enabled DNS resolution and DNS hostnames in your VPC. If you are not using the Amazon-provided DNS server in your VPC, your custom domain name servers must resolve the hostname as appropriate.

", "Instance$PrivateIpAddress": "

The private IPv4 address assigned to the instance.

", "Instance$PublicDnsName": "

(IPv4 only) The public DNS name assigned to the instance. This name is not available until the instance enters the running state. For EC2-VPC, this name is only available if you've enabled DNS hostnames for your VPC.

", - "Instance$PublicIpAddress": "

The public IPv4 address assigned to the instance, if applicable.

", + "Instance$PublicIpAddress": "

The public IPv4 address, or the Carrier IP address assigned to the instance, if applicable.

A Carrier IP address only applies to an instance launched in a subnet associated with a Wavelength Zone.

", "Instance$RamdiskId": "

The RAM disk associated with this instance, if applicable.

", "Instance$StateTransitionReason": "

The reason for the most recent state transition. This might be an empty string.

", "Instance$SubnetId": "

[EC2-VPC] The ID of the subnet in which the instance is running.

", @@ -12983,6 +13072,7 @@ "InstanceNetworkInterface$SubnetId": "

The ID of the subnet.

", "InstanceNetworkInterface$VpcId": "

The ID of the VPC.

", "InstanceNetworkInterface$InterfaceType": "

Describes the type of network interface.

Valid values: interface | efa

", + "InstanceNetworkInterfaceAssociation$CarrierIp": "

The carrier IP address associated with the network interface.

", "InstanceNetworkInterfaceAssociation$IpOwnerId": "

The ID of the owner of the Elastic IP address.

", "InstanceNetworkInterfaceAssociation$PublicDnsName": "

The public DNS name.

", "InstanceNetworkInterfaceAssociation$PublicIp": "

The public IP address or Elastic IP address bound to the network interface.

", @@ -13098,7 +13188,7 @@ "ManagedPrefixList$StateMessage": "

The state message.

", "ManagedPrefixList$PrefixListName": "

The name of the prefix list.

", "ManagedPrefixList$OwnerId": "

The ID of the owner of the prefix list.

", - "ModifyAvailabilityZoneGroupRequest$GroupName": "

The name of the Availability Zone Group.

", + "ModifyAvailabilityZoneGroupRequest$GroupName": "

The name of the Availability Zone group, Local Zone group, or Wavelength Zone group.

", "ModifyClientVpnEndpointRequest$ServerCertificateArn": "

The ARN of the server certificate to be used. The server certificate must be provisioned in AWS Certificate Manager (ACM).

", "ModifyClientVpnEndpointRequest$Description": "

A brief description of the Client VPN endpoint.

", "ModifyDefaultCreditSpecificationRequest$CpuCredits": "

The credit option for CPU usage of the instance family.

Valid Values: standard | unlimited

", @@ -13169,7 +13259,8 @@ "NetworkInterfaceAssociation$AssociationId": "

The association ID.

", "NetworkInterfaceAssociation$IpOwnerId": "

The ID of the Elastic IP address owner.

", "NetworkInterfaceAssociation$PublicDnsName": "

The public DNS name.

", - "NetworkInterfaceAssociation$PublicIp": "

The address of the Elastic IP address bound to the network interface.

", + "NetworkInterfaceAssociation$PublicIp": "

The address of the Elastic IP address or Carrier IP address bound to the network interface.

", + "NetworkInterfaceAssociation$CarrierIp": "

The carrier IP address associated with the network interface.

This option is only available when the network interface is in a subnet which is associated with a Wavelength Zone.

", "NetworkInterfaceAttachment$AttachmentId": "

The ID of the network interface attachment.

", "NetworkInterfaceAttachment$InstanceId": "

The ID of the instance.

", "NetworkInterfaceAttachment$InstanceOwnerId": "

The AWS account ID of the owner of the instance.

", @@ -13268,7 +13359,7 @@ "RegisterTransitGatewayMulticastGroupMembersRequest$GroupIpAddress": "

The IP address assigned to the transit gateway multicast group.

", "RegisterTransitGatewayMulticastGroupSourcesRequest$GroupIpAddress": "

The IP address assigned to the transit gateway multicast group.

", "ReleaseAddressRequest$PublicIp": "

[EC2-Classic] The Elastic IP address. Required for EC2-Classic.

", - "ReleaseAddressRequest$NetworkBorderGroup": "

The location that the IP address is released from.

If you provide an incorrect network border group, you will receive an InvalidAddress.NotFound error. For more information, see Error Codes.

You cannot use a network border group with EC2 Classic. If you attempt this operation on EC2 classic, you will receive an InvalidParameterCombination error. For more information, see Error Codes.

", + "ReleaseAddressRequest$NetworkBorderGroup": "

The set of Availability Zones, Local Zones, or Wavelength Zones from which AWS advertises IP addresses.

If you provide an incorrect network border group, you will receive an InvalidAddress.NotFound error. For more information, see Error Codes.

You cannot use a network border group with EC2 Classic. If you attempt this operation on EC2 classic, you will receive an InvalidParameterCombination error. For more information, see Error Codes.

", "RemovePrefixListEntry$Cidr": "

The CIDR block.

", "ReplaceNetworkAclAssociationResult$NewAssociationId": "

The ID of the new association.

", "ReplaceNetworkAclEntryRequest$CidrBlock": "

The IPv4 network range to allow or deny, in CIDR notation (for example 172.16.0.0/24).

", @@ -13641,7 +13732,7 @@ "VolumeStatusItem$OutpostArn": "

The Amazon Resource Name (ARN) of the Outpost.

", "VolumeStatusItem$VolumeId": "

The volume ID.

", "Vpc$CidrBlock": "

The primary IPv4 CIDR block for the VPC.

", - "Vpc$DhcpOptionsId": "

The ID of the set of DHCP options you've associated with the VPC (or default if the default options are associated with the VPC).

", + "Vpc$DhcpOptionsId": "

The ID of the set of DHCP options you've associated with the VPC.

", "Vpc$VpcId": "

The ID of the VPC.

", "Vpc$OwnerId": "

The ID of the AWS account that owns the VPC.

", "VpcAttachment$VpcId": "

The ID of the VPC.

", @@ -13659,7 +13750,7 @@ "VpcEndpointConnection$VpcEndpointOwner": "

The AWS account ID of the owner of the VPC endpoint.

", "VpcIpv6CidrBlockAssociation$AssociationId": "

The association ID for the IPv6 CIDR block.

", "VpcIpv6CidrBlockAssociation$Ipv6CidrBlock": "

The IPv6 CIDR block.

", - "VpcIpv6CidrBlockAssociation$NetworkBorderGroup": "

The name of the location from which we advertise the IPV6 CIDR block.

", + "VpcIpv6CidrBlockAssociation$NetworkBorderGroup": "

The name of the unique set of Availability Zones, Local Zones, or Wavelength Zones from which AWS advertises IP addresses, for example, us-east-1-wl1-bos-wlz-1.

", "VpcIpv6CidrBlockAssociation$Ipv6Pool": "

The ID of the IPv6 address pool from which the IPv6 CIDR block is allocated.

", "VpcPeeringConnection$VpcPeeringConnectionId": "

The ID of the VPC peering connection.

", "VpcPeeringConnectionStateReason$Message": "

A message that provides more information about the status, if applicable.

", @@ -13832,6 +13923,7 @@ "refs": { "Address$Tags": "

Any tags assigned to the Elastic IP address.

", "CapacityReservation$Tags": "

Any tags assigned to the Capacity Reservation.

", + "CarrierGateway$Tags": "

The tags assigned to the carrier gateway.

", "ClassicLinkInstance$Tags": "

Any tags assigned to the instance.

", "ClientVpnEndpoint$Tags": "

Any tags assigned to the Client VPN endpoint.

", "CoipPool$Tags": "

The tags.

", @@ -13921,6 +14013,7 @@ "AllocateHostsRequest$TagSpecifications": "

The tags to apply to the Dedicated Host during creation.

", "CopySnapshotRequest$TagSpecifications": "

The tags to apply to the new snapshot.

", "CreateCapacityReservationRequest$TagSpecifications": "

The tags to apply to the Capacity Reservation during launch.

", + "CreateCarrierGatewayRequest$TagSpecifications": "

The tags to associate with the carrier gateway.

", "CreateClientVpnEndpointRequest$TagSpecifications": "

The tags to apply to the Client VPN endpoint during creation.

", "CreateCustomerGatewayRequest$TagSpecifications": "

The tags to apply to the customer gateway.

", "CreateDhcpOptionsRequest$TagSpecifications": "

The tags to assign to the DHCP option.

", @@ -15444,7 +15537,9 @@ "AttachClassicLinkVpcRequest$VpcId": "

The ID of a ClassicLink-enabled VPC.

", "AttachInternetGatewayRequest$VpcId": "

The ID of the VPC.

", "AttachVpnGatewayRequest$VpcId": "

The ID of the VPC.

", + "CarrierGateway$VpcId": "

The ID of the VPC associated with the carrier gateway.

", "ClientVpnEndpoint$VpcId": "

The ID of the VPC.

", + "CreateCarrierGatewayRequest$VpcId": "

The ID of the VPC to associate with the carrier gateway.

", "CreateClientVpnEndpointRequest$VpcId": "

The ID of the VPC to associate with the Client VPN endpoint. If no security group IDs are specified in the request, the default security group for the VPC is applied.

", "CreateEgressOnlyInternetGatewayRequest$VpcId": "

The ID of the VPC for which to create the egress-only internet gateway.

", "CreateLocalGatewayRouteTableVpcAssociationRequest$VpcId": "

The ID of the VPC.

", @@ -15710,13 +15805,13 @@ "ZoneIdStringList": { "base": null, "refs": { - "DescribeAvailabilityZonesRequest$ZoneIds": "

The IDs of the Zones.

" + "DescribeAvailabilityZonesRequest$ZoneIds": "

The IDs of the Availability Zones, Local Zones, and Wavelength Zones.

" } }, "ZoneNameStringList": { "base": null, "refs": { - "DescribeAvailabilityZonesRequest$ZoneNames": "

The names of the Zones.

" + "DescribeAvailabilityZonesRequest$ZoneNames": "

The names of the Availability Zones, Local Zones, and Wavelength Zones.

" } }, "scope": { diff --git a/models/apis/ec2/2016-11-15/paginators-1.json b/models/apis/ec2/2016-11-15/paginators-1.json index e392ad359be..77cde2e3056 100755 --- a/models/apis/ec2/2016-11-15/paginators-1.json +++ b/models/apis/ec2/2016-11-15/paginators-1.json @@ -24,6 +24,12 @@ "output_token": "NextToken", "result_key": "CapacityReservations" }, + "DescribeCarrierGateways": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "CarrierGateways" + }, "DescribeClassicLinkInstances": { "input_token": "NextToken", "limit_key": "MaxResults", diff --git a/models/apis/lex-models/2017-04-19/api-2.json b/models/apis/lex-models/2017-04-19/api-2.json index 2d65b5a939f..c9533bab5cd 100644 --- a/models/apis/lex-models/2017-04-19/api-2.json +++ b/models/apis/lex-models/2017-04-19/api-2.json @@ -815,6 +815,11 @@ "messageVersion":{"shape":"MessageVersion"} } }, + "ConfidenceThreshold":{ + "type":"double", + "max":1, + "min":0 + }, "ConflictException":{ "type":"structure", "members":{ @@ -885,6 +890,7 @@ "version":{"shape":"Version"}, "locale":{"shape":"Locale"}, "childDirected":{"shape":"Boolean"}, + "enableModelImprovements":{"shape":"Boolean"}, "detectSentiment":{"shape":"Boolean"} } }, @@ -1344,6 +1350,8 @@ "name":{"shape":"BotName"}, "description":{"shape":"Description"}, "intents":{"shape":"IntentList"}, + "enableModelImprovements":{"shape":"Boolean"}, + "nluIntentConfidenceThreshold":{"shape":"ConfidenceThreshold"}, "clarificationPrompt":{"shape":"Prompt"}, "abortStatement":{"shape":"Statement"}, "status":{"shape":"Status"}, @@ -2123,6 +2131,8 @@ }, "description":{"shape":"Description"}, "intents":{"shape":"IntentList"}, + "enableModelImprovements":{"shape":"Boolean"}, + "nluIntentConfidenceThreshold":{"shape":"ConfidenceThreshold"}, "clarificationPrompt":{"shape":"Prompt"}, "abortStatement":{"shape":"Statement"}, "idleSessionTTLInSeconds":{"shape":"SessionTTL"}, @@ -2142,6 +2152,8 @@ "name":{"shape":"BotName"}, "description":{"shape":"Description"}, "intents":{"shape":"IntentList"}, + "enableModelImprovements":{"shape":"Boolean"}, + "nluIntentConfidenceThreshold":{"shape":"ConfidenceThreshold"}, "clarificationPrompt":{"shape":"Prompt"}, "abortStatement":{"shape":"Statement"}, "status":{"shape":"Status"}, diff --git a/models/apis/lex-models/2017-04-19/docs-2.json b/models/apis/lex-models/2017-04-19/docs-2.json index bc5f82278db..d9e246f7588 100644 --- a/models/apis/lex-models/2017-04-19/docs-2.json +++ b/models/apis/lex-models/2017-04-19/docs-2.json @@ -88,12 +88,16 @@ "base": null, "refs": { "CreateBotVersionResponse$childDirected": "

For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA.

If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

", + "CreateBotVersionResponse$enableModelImprovements": "

Indicates whether the bot uses the new natural language understanding (NLU) model or the original NLU. True indicates that the bot is using the new model, otherwise, false.

", "CreateBotVersionResponse$detectSentiment": "

Indicates whether utterances entered by the user should be sent to Amazon Comprehend for sentiment analysis.

", + "GetBotResponse$enableModelImprovements": "

Indicates whether the bot uses the new natural language understanding (NLU) model or the original NLU. True indicates that the bot is using the new model, otherwise, false.

", "GetBotResponse$childDirected": "

For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA.

If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

", "GetBotResponse$detectSentiment": "

Indicates whether user utterances should be sent to Amazon Comprehend for sentiment analysis.

", + "PutBotRequest$enableModelImprovements": "

Set to true to enable the use of a new natural language understanding (NLU) model. Using the new NLU may improve the performance of your bot.

When you set the enableModelImprovements parameter to true you can use the nluIntentConfidenceThreshold parameter to configure confidence scores. For more information, see Confidence Scores.

You can only set the enableModelImprovements parameter in certain Regions. If you set the parameter to true, your bot will use the new NLU. If you set the parameter to false, your bot will continue to use the original NLU. If you set the parameter to false after setting it to true, your bot will return to the original NLU.

The Regions where you can set the enableModelImprovements parameter to true are:

In other Regions, the enableModelImprovements parameter is set to true by default. In these Regions setting the parameter to false throws a ValidationException exception.

", "PutBotRequest$childDirected": "

For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA.

If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

", "PutBotRequest$detectSentiment": "

When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is false.

", "PutBotRequest$createVersion": "

When set to true a new numbered version of the bot is created. This is the same as calling the CreateBotVersion operation. If you don't specify createVersion, the default is false.

", + "PutBotResponse$enableModelImprovements": "

Indicates whether the bot uses the new natural language understanding (NLU) model or the original NLU. True indicates that the bot is using the new model, otherwise, false.

", "PutBotResponse$childDirected": "

For each Amazon Lex bot created with the Amazon Lex Model Building Service, you must specify whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to the Children's Online Privacy Protection Act (COPPA) by specifying true or false in the childDirected field. By specifying true in the childDirected field, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. By specifying false in the childDirected field, you confirm that your use of Amazon Lex is not related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. You may not specify a default value for the childDirected field that does not accurately reflect whether your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA.

If your use of Amazon Lex relates to a website, program, or other application that is directed in whole or in part, to children under age 13, you must obtain any required verifiable parental consent under COPPA. For information regarding the use of Amazon Lex in connection with websites, programs, or other applications that are directed or targeted, in whole or in part, to children under age 13, see the Amazon Lex FAQ.

", "PutBotResponse$createVersion": "

True if a new version of the bot was created. If the createVersion field was not specified in the request, the createVersion field is set to false in the response.

", "PutBotResponse$detectSentiment": "

true if the bot is configured to send user utterances to Amazon Comprehend for sentiment analysis. If the detectSentiment field was not specified in the request, the detectSentiment field is false in the response.

", @@ -272,6 +276,14 @@ "PutIntentResponse$dialogCodeHook": "

If defined in the intent, Amazon Lex invokes this Lambda function for each user input.

" } }, + "ConfidenceThreshold": { + "base": null, + "refs": { + "GetBotResponse$nluIntentConfidenceThreshold": "

The score that determines where Amazon Lex inserts the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot.

", + "PutBotRequest$nluIntentConfidenceThreshold": "

Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot.

You must set the enableModelImprovements parameter to true to use confidence scores.

For example, suppose a bot is configured with the confidence threshold of 0.80 and the AMAZON.FallbackIntent. Amazon Lex returns three alternative intents with the following confidence scores: IntentA (0.70), IntentB (0.60), IntentC (0.50). The response from the PostText operation would be:

", + "PutBotResponse$nluIntentConfidenceThreshold": "

The score that determines where Amazon Lex inserts the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot.

" + } + }, "ConflictException": { "base": "

There was a conflict processing the request. Try your request again.

", "refs": { diff --git a/models/apis/personalize-events/2018-03-22/api-2.json b/models/apis/personalize-events/2018-03-22/api-2.json index 013f9aacedf..2e2c42d58b7 100644 --- a/models/apis/personalize-events/2018-03-22/api-2.json +++ b/models/apis/personalize-events/2018-03-22/api-2.json @@ -31,17 +31,20 @@ "type":"structure", "required":[ "eventType", - "properties", "sentAt" ], "members":{ "eventId":{"shape":"StringType"}, "eventType":{"shape":"StringType"}, + "eventValue":{"shape":"FloatType"}, + "itemId":{"shape":"ItemId"}, "properties":{ "shape":"EventPropertiesJSON", "jsonvalue":true }, - "sentAt":{"shape":"Date"} + "sentAt":{"shape":"Date"}, + "recommendationId":{"shape":"RecommendationId"}, + "impression":{"shape":"Impression"} } }, "EventList":{ @@ -55,6 +58,13 @@ "max":1024, "min":1 }, + "FloatType":{"type":"float"}, + "Impression":{ + "type":"list", + "member":{"shape":"ItemId"}, + "max":25, + "min":1 + }, "InvalidInputException":{ "type":"structure", "members":{ @@ -63,6 +73,11 @@ "error":{"httpStatusCode":400}, "exception":true }, + "ItemId":{ + "type":"string", + "max":256, + "min":1 + }, "PutEventsRequest":{ "type":"structure", "required":[ @@ -77,6 +92,11 @@ "eventList":{"shape":"EventList"} } }, + "RecommendationId":{ + "type":"string", + "max":40, + "min":1 + }, "StringType":{ "type":"string", "max":256, diff --git a/models/apis/personalize-events/2018-03-22/docs-2.json b/models/apis/personalize-events/2018-03-22/docs-2.json index 5dbc734b3d7..99f2c9f71dd 100644 --- a/models/apis/personalize-events/2018-03-22/docs-2.json +++ b/models/apis/personalize-events/2018-03-22/docs-2.json @@ -1,14 +1,14 @@ { "version": "2.0", - "service": "

", + "service": "

Amazon Personalize can consume real-time user event data, such as stream or click data, and use it for model training either alone or combined with historical data. For more information see recording-events.

", "operations": { - "PutEvents": "

Records user interaction event data.

" + "PutEvents": "

Records user interaction event data. For more information see event-record-api.

" }, "shapes": { "Date": { "base": null, "refs": { - "Event$sentAt": "

The timestamp on the client side when the event occurred.

" + "Event$sentAt": "

The timestamp (in Unix time) on the client side when the event occurred.

" } }, "ErrorMessage": { @@ -32,7 +32,19 @@ "EventPropertiesJSON": { "base": null, "refs": { - "Event$properties": "

A string map of event-specific data that you might choose to record. For example, if a user rates a movie on your site, you might send the movie ID and rating, and the number of movie ratings made by the user.

Each item in the map consists of a key-value pair. For example,

{\"itemId\": \"movie1\"}

{\"itemId\": \"movie2\", \"eventValue\": \"4.5\"}

{\"itemId\": \"movie3\", \"eventValue\": \"3\", \"numberOfRatings\": \"12\"}

The keys use camel case names that match the fields in the Interactions schema. The itemId and eventValue keys correspond to the ITEM_ID and EVENT_VALUE fields. In the above example, the eventType might be 'MovieRating' with eventValue being the rating. The numberOfRatings would match the 'NUMBER_OF_RATINGS' field defined in the Interactions schema.

" + "Event$properties": "

A string map of event-specific data that you might choose to record. For example, if a user rates a movie on your site, other than movie ID (itemId) and rating (eventValue) , you might also send the number of movie ratings made by the user.

Each item in the map consists of a key-value pair. For example,

{\"numberOfRatings\": \"12\"}

The keys use camel case names that match the fields in the Interactions schema. In the above example, the numberOfRatings would match the 'NUMBER_OF_RATINGS' field defined in the Interactions schema.

" + } + }, + "FloatType": { + "base": null, + "refs": { + "Event$eventValue": "

The event value that corresponds to the EVENT_VALUE field of the Interactions schema.

" + } + }, + "Impression": { + "base": null, + "refs": { + "Event$impression": "

A list of item IDs that represents the sequence of items you have shown the user. For example, [\"itemId1\", \"itemId2\", \"itemId3\"].

" } }, "InvalidInputException": { @@ -40,18 +52,31 @@ "refs": { } }, + "ItemId": { + "base": null, + "refs": { + "Event$itemId": "

The item ID key that corresponds to the ITEM_ID field of the Interactions schema.

", + "Impression$member": null + } + }, "PutEventsRequest": { "base": null, "refs": { } }, + "RecommendationId": { + "base": null, + "refs": { + "Event$recommendationId": "

The ID of the recommendation.

" + } + }, "StringType": { "base": null, "refs": { "Event$eventId": "

An ID associated with the event. If an event ID is not provided, Amazon Personalize generates a unique ID for the event. An event ID is not used as an input to the model. Amazon Personalize uses the event ID to distinquish unique events. Any subsequent events after the first with the same event ID are not used in model training.

", "Event$eventType": "

The type of event. This property corresponds to the EVENT_TYPE field of the Interactions schema.

", "PutEventsRequest$trackingId": "

The tracking ID for the event. The ID is generated by a call to the CreateEventTracker API.

", - "PutEventsRequest$sessionId": "

The session ID associated with the user's visit.

" + "PutEventsRequest$sessionId": "

The session ID associated with the user's visit. Your application generates the sessionId when a user first visits your website or uses your application. Amazon Personalize uses the sessionId to associate events with the user before they log in. For more information see event-record-api.

" } }, "UserId": { diff --git a/models/apis/personalize-runtime/2018-05-22/api-2.json b/models/apis/personalize-runtime/2018-05-22/api-2.json index db398b9a920..6184597e161 100644 --- a/models/apis/personalize-runtime/2018-05-22/api-2.json +++ b/models/apis/personalize-runtime/2018-05-22/api-2.json @@ -82,7 +82,8 @@ "GetPersonalizedRankingResponse":{ "type":"structure", "members":{ - "personalizedRanking":{"shape":"ItemList"} + "personalizedRanking":{"shape":"ItemList"}, + "recommendationId":{"shape":"RecommendationID"} } }, "GetRecommendationsRequest":{ @@ -100,7 +101,8 @@ "GetRecommendationsResponse":{ "type":"structure", "members":{ - "itemList":{"shape":"ItemList"} + "itemList":{"shape":"ItemList"}, + "recommendationId":{"shape":"RecommendationID"} } }, "InputList":{ @@ -134,6 +136,7 @@ "score":{"shape":"Score"} } }, + "RecommendationID":{"type":"string"}, "ResourceNotFoundException":{ "type":"structure", "members":{ diff --git a/models/apis/personalize-runtime/2018-05-22/docs-2.json b/models/apis/personalize-runtime/2018-05-22/docs-2.json index 945868793dd..1578fe6932d 100644 --- a/models/apis/personalize-runtime/2018-05-22/docs-2.json +++ b/models/apis/personalize-runtime/2018-05-22/docs-2.json @@ -99,6 +99,13 @@ "ItemList$member": null } }, + "RecommendationID": { + "base": null, + "refs": { + "GetPersonalizedRankingResponse$recommendationId": "

The ID of the recommendation.

", + "GetRecommendationsResponse$recommendationId": "

The ID of the recommendation.

" + } + }, "ResourceNotFoundException": { "base": "

The specified resource does not exist.

", "refs": { diff --git a/models/apis/personalize/2018-05-22/api-2.json b/models/apis/personalize/2018-05-22/api-2.json index daa3ac3b072..4d6bd415a80 100644 --- a/models/apis/personalize/2018-05-22/api-2.json +++ b/models/apis/personalize/2018-05-22/api-2.json @@ -167,6 +167,7 @@ "errors":[ {"shape":"InvalidInputException"}, {"shape":"ResourceNotFoundException"}, + {"shape":"LimitExceededException"}, {"shape":"ResourceInUseException"} ] }, @@ -235,7 +236,8 @@ "input":{"shape":"DeleteFilterRequest"}, "errors":[ {"shape":"InvalidInputException"}, - {"shape":"ResourceNotFoundException"} + {"shape":"ResourceNotFoundException"}, + {"shape":"ResourceInUseException"} ] }, "DeleteSchema":{ @@ -696,12 +698,19 @@ "numResults":{"shape":"NumBatchResults"}, "jobInput":{"shape":"BatchInferenceJobInput"}, "jobOutput":{"shape":"BatchInferenceJobOutput"}, + "batchInferenceJobConfig":{"shape":"BatchInferenceJobConfig"}, "roleArn":{"shape":"RoleArn"}, "status":{"shape":"Status"}, "creationDateTime":{"shape":"Date"}, "lastUpdatedDateTime":{"shape":"Date"} } }, + "BatchInferenceJobConfig":{ + "type":"structure", + "members":{ + "itemExplorationConfig":{"shape":"HyperParameters"} + } + }, "BatchInferenceJobInput":{ "type":"structure", "required":["s3DataSource"], @@ -741,6 +750,7 @@ "campaignArn":{"shape":"Arn"}, "solutionVersionArn":{"shape":"Arn"}, "minProvisionedTPS":{"shape":"TransactionsPerSecond"}, + "campaignConfig":{"shape":"CampaignConfig"}, "status":{"shape":"Status"}, "failureReason":{"shape":"FailureReason"}, "creationDateTime":{"shape":"Date"}, @@ -748,6 +758,12 @@ "latestCampaignUpdate":{"shape":"CampaignUpdateSummary"} } }, + "CampaignConfig":{ + "type":"structure", + "members":{ + "itemExplorationConfig":{"shape":"HyperParameters"} + } + }, "CampaignSummary":{ "type":"structure", "members":{ @@ -764,6 +780,7 @@ "members":{ "solutionVersionArn":{"shape":"Arn"}, "minProvisionedTPS":{"shape":"TransactionsPerSecond"}, + "campaignConfig":{"shape":"CampaignConfig"}, "status":{"shape":"Status"}, "failureReason":{"shape":"FailureReason"}, "creationDateTime":{"shape":"Date"}, @@ -833,7 +850,8 @@ "numResults":{"shape":"NumBatchResults"}, "jobInput":{"shape":"BatchInferenceJobInput"}, "jobOutput":{"shape":"BatchInferenceJobOutput"}, - "roleArn":{"shape":"RoleArn"} + "roleArn":{"shape":"RoleArn"}, + "batchInferenceJobConfig":{"shape":"BatchInferenceJobConfig"} } }, "CreateBatchInferenceJobResponse":{ @@ -852,7 +870,8 @@ "members":{ "name":{"shape":"Name"}, "solutionVersionArn":{"shape":"Arn"}, - "minProvisionedTPS":{"shape":"TransactionsPerSecond"} + "minProvisionedTPS":{"shape":"TransactionsPerSecond"}, + "campaignConfig":{"shape":"CampaignConfig"} } }, "CreateCampaignResponse":{ @@ -2005,7 +2024,8 @@ "members":{ "campaignArn":{"shape":"Arn"}, "solutionVersionArn":{"shape":"Arn"}, - "minProvisionedTPS":{"shape":"TransactionsPerSecond"} + "minProvisionedTPS":{"shape":"TransactionsPerSecond"}, + "campaignConfig":{"shape":"CampaignConfig"} } }, "UpdateCampaignResponse":{ diff --git a/models/apis/personalize/2018-05-22/docs-2.json b/models/apis/personalize/2018-05-22/docs-2.json index bd29d8f22c3..8fed21c900d 100644 --- a/models/apis/personalize/2018-05-22/docs-2.json +++ b/models/apis/personalize/2018-05-22/docs-2.json @@ -6,9 +6,9 @@ "CreateCampaign": "

Creates a campaign by deploying a solution version. When a client calls the GetRecommendations and GetPersonalizedRanking APIs, a campaign is specified in the request.

Minimum Provisioned TPS and Auto-Scaling

A transaction is a single GetRecommendations or GetPersonalizedRanking call. Transactions per second (TPS) is the throughput and unit of billing for Amazon Personalize. The minimum provisioned TPS (minProvisionedTPS) specifies the baseline throughput provisioned by Amazon Personalize, and thus, the minimum billing charge. If your TPS increases beyond minProvisionedTPS, Amazon Personalize auto-scales the provisioned capacity up and down, but never below minProvisionedTPS, to maintain a 70% utilization. There's a short time delay while the capacity is increased that might cause loss of transactions. It's recommended to start with a low minProvisionedTPS, track your usage using Amazon CloudWatch metrics, and then increase the minProvisionedTPS as necessary.

Status

A campaign can be in one of the following states:

To get the campaign status, call DescribeCampaign.

Wait until the status of the campaign is ACTIVE before asking the campaign for recommendations.

Related APIs

", "CreateDataset": "

Creates an empty dataset and adds it to the specified dataset group. Use CreateDatasetImportJob to import your training data to a dataset.

There are three types of datasets:

Each dataset type has an associated schema with required field types. Only the Interactions dataset is required in order to train a model (also referred to as creating a solution).

A dataset can be in one of the following states:

To get the status of the dataset, call DescribeDataset.

Related APIs

", "CreateDatasetGroup": "

Creates an empty dataset group. A dataset group contains related datasets that supply data for training a model. A dataset group can contain at most three datasets, one for each type of dataset:

To train a model (create a solution), a dataset group that contains an Interactions dataset is required. Call CreateDataset to add a dataset to the group.

A dataset group can be in one of the following states:

To get the status of the dataset group, call DescribeDatasetGroup. If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the creation failed.

You must wait until the status of the dataset group is ACTIVE before adding a dataset to the group.

You can specify an AWS Key Management Service (KMS) key to encrypt the datasets in the group. If you specify a KMS key, you must also include an AWS Identity and Access Management (IAM) role that has permission to access the key.

APIs that require a dataset group ARN in the request

Related APIs

", - "CreateDatasetImportJob": "

Creates a job that imports training data from your data source (an Amazon S3 bucket) to an Amazon Personalize dataset. To allow Amazon Personalize to import the training data, you must specify an AWS Identity and Access Management (IAM) role that has permission to read from the data source.

The dataset import job replaces any previous data in the dataset.

Status

A dataset import job can be in one of the following states:

To get the status of the import job, call DescribeDatasetImportJob, providing the Amazon Resource Name (ARN) of the dataset import job. The dataset import is complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the job failed.

Importing takes time. You must wait until the status shows as ACTIVE before training a model using the dataset.

Related APIs

", + "CreateDatasetImportJob": "

Creates a job that imports training data from your data source (an Amazon S3 bucket) to an Amazon Personalize dataset. To allow Amazon Personalize to import the training data, you must specify an AWS Identity and Access Management (IAM) role that has permission to read from the data source, as Amazon Personalize makes a copy of your data and processes it in an internal AWS system.

The dataset import job replaces any previous data in the dataset.

Status

A dataset import job can be in one of the following states:

To get the status of the import job, call DescribeDatasetImportJob, providing the Amazon Resource Name (ARN) of the dataset import job. The dataset import is complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the job failed.

Importing takes time. You must wait until the status shows as ACTIVE before training a model using the dataset.

Related APIs

", "CreateEventTracker": "

Creates an event tracker that you use when sending event data to the specified dataset group using the PutEvents API.

When Amazon Personalize creates an event tracker, it also creates an event-interactions dataset in the dataset group associated with the event tracker. The event-interactions dataset stores the event data from the PutEvents call. The contents of this dataset are not available to the user.

Only one event tracker can be associated with a dataset group. You will get an error if you call CreateEventTracker using the same dataset group as an existing event tracker.

When you send event data you include your tracking ID. The tracking ID identifies the customer and authorizes the customer to send the data.

The event tracker can be in one of the following states:

To get the status of the event tracker, call DescribeEventTracker.

The event tracker must be in the ACTIVE state before using the tracking ID.

Related APIs

", - "CreateFilter": "

Creates a recommendation filter. For more information, see Using Filters with Amazon Personalize.

", + "CreateFilter": "

Creates a recommendation filter. For more information, see Using Filters with Amazon Personalize.

", "CreateSchema": "

Creates an Amazon Personalize schema from the specified schema string. The schema you create must be in Avro JSON format.

Amazon Personalize recognizes three schema variants. Each schema is associated with a dataset type and has a set of required field and keywords. You specify a schema when you call CreateDataset.

Related APIs

", "CreateSolution": "

Creates the configuration for training a model. A trained model is known as a solution. After the configuration is created, you train the model (create a solution) by calling the CreateSolutionVersion operation. Every time you call CreateSolutionVersion, a new version of the solution is created.

After creating a solution version, you check its accuracy by calling GetSolutionMetrics. When you are satisfied with the version, you deploy it using CreateCampaign. The campaign provides recommendations to a client through the GetRecommendations API.

To train a model, Amazon Personalize requires training data and a recipe. The training data comes from the dataset group that you provide in the request. A recipe specifies the training algorithm and a feature transformation. You can specify one of the predefined recipes provided by Amazon Personalize. Alternatively, you can specify performAutoML and Amazon Personalize will analyze your data and select the optimum USER_PERSONALIZATION recipe for you.

Status

A solution can be in one of the following states:

To get the status of the solution, call DescribeSolution. Wait until the status shows as ACTIVE before calling CreateSolutionVersion.

Related APIs

", "CreateSolutionVersion": "

Trains or retrains an active solution. A solution is created using the CreateSolution operation and must be in the ACTIVE state before calling CreateSolutionVersion. A new version of the solution is created every time you call this operation.

Status

A solution version can be in one of the following states:

To get the status of the version, call DescribeSolutionVersion. Wait until the status shows as ACTIVE before calling CreateCampaign.

If the status shows as CREATE FAILED, the response includes a failureReason key, which describes why the job failed.

Related APIs

", @@ -201,6 +201,13 @@ "DescribeBatchInferenceJobResponse$batchInferenceJob": "

Information on the specified batch inference job.

" } }, + "BatchInferenceJobConfig": { + "base": "

The configuration details of a batch inference job.

", + "refs": { + "BatchInferenceJob$batchInferenceJobConfig": "

A string to string map of the configuration details of a batch inference job.

", + "CreateBatchInferenceJobRequest$batchInferenceJobConfig": "

The configuration details of a batch inference job.

" + } + }, "BatchInferenceJobInput": { "base": "

The input configuration of a batch inference job.

", "refs": { @@ -239,6 +246,15 @@ "DescribeCampaignResponse$campaign": "

The properties of the campaign.

" } }, + "CampaignConfig": { + "base": "

The configuration details of a campaign.

", + "refs": { + "Campaign$campaignConfig": "

The configuration details of a campaign.

", + "CampaignUpdateSummary$campaignConfig": null, + "CreateCampaignRequest$campaignConfig": "

The configuration details of a campaign.

", + "UpdateCampaignRequest$campaignConfig": "

The configuration details of a campaign.

" + } + }, "CampaignSummary": { "base": "

Provides a summary of the properties of a campaign. For a complete listing, call the DescribeCampaign API.

", "refs": { @@ -851,8 +867,8 @@ "FilterExpression": { "base": null, "refs": { - "CreateFilterRequest$filterExpression": "

The filter expression that designates the interaction types that the filter will filter out. A filter expression must follow the following format:

EXCLUDE itemId WHERE INTERACTIONS.event_type in (\"EVENT_TYPE\")

Where \"EVENT_TYPE\" is the type of event to filter out. To filter out all items with any interactions history, set \"*\" as the EVENT_TYPE. For more information, see Using Filters with Amazon Personalize.

", - "Filter$filterExpression": "

Specifies the type of item interactions to filter out of recommendation results. The filter expression must follow the following format:

EXCLUDE itemId WHERE INTERACTIONS.event_type in (\"EVENT_TYPE\")

Where \"EVENT_TYPE\" is the type of event to filter out. For more information, see Using Filters with Amazon Personalize.

" + "CreateFilterRequest$filterExpression": "

The filter expression that designates the interaction types that the filter will filter out. A filter expression must follow the following format:

EXCLUDE itemId WHERE INTERACTIONS.event_type in (\"EVENT_TYPE\")

Where \"EVENT_TYPE\" is the type of event to filter out. To filter out all items with any interactions history, set \"*\" as the EVENT_TYPE. For more information, see Using Filters with Amazon Personalize.

", + "Filter$filterExpression": "

Specifies the type of item interactions to filter out of recommendation results. The filter expression must follow the following format:

EXCLUDE itemId WHERE INTERACTIONS.event_type in (\"EVENT_TYPE\")

Where \"EVENT_TYPE\" is the type of event to filter out. For more information, see Using Filters with Amazon Personalize.

" } }, "FilterSummary": { @@ -918,6 +934,8 @@ "base": null, "refs": { "Algorithm$defaultHyperParameters": "

Specifies the default hyperparameters.

", + "BatchInferenceJobConfig$itemExplorationConfig": "

A string to string map specifying the inference hyperparameters you wish to use for hyperparameter optimization. See customizing-solution-config-hpo.

", + "CampaignConfig$itemExplorationConfig": "

A string to string map specifying the inference hyperparameters you wish to use for hyperparameter optimization. See customizing-solution-config-hpo.

", "SolutionConfig$algorithmHyperParameters": "

Lists the hyperparameter names and ranges.

", "TunedHPOParams$algorithmHyperParameters": "

A list of the hyperparameter values of the best performing model.

" } diff --git a/models/apis/runtime.lex/2016-11-28/api-2.json b/models/apis/runtime.lex/2016-11-28/api-2.json index 883ed0558ed..238b40fd327 100644 --- a/models/apis/runtime.lex/2016-11-28/api-2.json +++ b/models/apis/runtime.lex/2016-11-28/api-2.json @@ -133,6 +133,12 @@ }, "BotAlias":{"type":"string"}, "BotName":{"type":"string"}, + "BotVersion":{ + "type":"string", + "max":64, + "min":1, + "pattern":"[0-9]+|\\$LATEST" + }, "Button":{ "type":"structure", "required":[ @@ -250,6 +256,7 @@ "Failed" ] }, + "Double":{"type":"double"}, "ErrorMessage":{"type":"string"}, "FulfillmentState":{ "type":"string", @@ -309,6 +316,17 @@ } }, "HttpContentType":{"type":"string"}, + "IntentConfidence":{ + "type":"structure", + "members":{ + "score":{"shape":"Double"} + } + }, + "IntentList":{ + "type":"list", + "member":{"shape":"PredictedIntent"}, + "max":4 + }, "IntentName":{"type":"string"}, "IntentSummary":{ "type":"structure", @@ -454,6 +472,18 @@ "location":"header", "locationName":"x-amz-lex-intent-name" }, + "nluIntentConfidence":{ + "shape":"String", + "jsonvalue":true, + "location":"header", + "locationName":"x-amz-lex-nlu-intent-confidence" + }, + "alternativeIntents":{ + "shape":"String", + "jsonvalue":true, + "location":"header", + "locationName":"x-amz-lex-alternative-intents" + }, "slots":{ "shape":"String", "jsonvalue":true, @@ -497,6 +527,11 @@ "locationName":"x-amz-lex-input-transcript" }, "audioStream":{"shape":"BlobStream"}, + "botVersion":{ + "shape":"BotVersion", + "location":"header", + "locationName":"x-amz-lex-bot-version" + }, "sessionId":{ "shape":"String", "location":"header", @@ -538,6 +573,8 @@ "type":"structure", "members":{ "intentName":{"shape":"IntentName"}, + "nluIntentConfidence":{"shape":"IntentConfidence"}, + "alternativeIntents":{"shape":"IntentList"}, "slots":{"shape":"StringMap"}, "sessionAttributes":{"shape":"StringMap"}, "message":{"shape":"Text"}, @@ -546,7 +583,16 @@ "dialogState":{"shape":"DialogState"}, "slotToElicit":{"shape":"String"}, "responseCard":{"shape":"ResponseCard"}, - "sessionId":{"shape":"String"} + "sessionId":{"shape":"String"}, + "botVersion":{"shape":"BotVersion"} + } + }, + "PredictedIntent":{ + "type":"structure", + "members":{ + "intentName":{"shape":"IntentName"}, + "nluIntentConfidence":{"shape":"IntentConfidence"}, + "slots":{"shape":"StringMap"} } }, "PutSessionRequest":{ diff --git a/models/apis/runtime.lex/2016-11-28/docs-2.json b/models/apis/runtime.lex/2016-11-28/docs-2.json index b1f44defd10..2f9bf32a92c 100644 --- a/models/apis/runtime.lex/2016-11-28/docs-2.json +++ b/models/apis/runtime.lex/2016-11-28/docs-2.json @@ -63,6 +63,13 @@ "PutSessionRequest$botName": "

The name of the bot that contains the session data.

" } }, + "BotVersion": { + "base": null, + "refs": { + "PostContentResponse$botVersion": "

The version of the bot that responded to the conversation. You can use this information to help determine if one version of a bot is performing better than another version.

If you have enabled the new natural language understanding (NLU) model, you can use this to determine if the improvement is due to changes to the bot or changes to the NLU.

For more information about enabling the new NLU, see the enableModelImprovements parameter of the PutBot operation.

", + "PostTextResponse$botVersion": "

The version of the bot that responded to the conversation. You can use this information to help determine if one version of a bot is performing better than another version.

If you have enabled the new natural language understanding (NLU) model, you can use this to determine if the improvement is due to changes to the bot or changes to the NLU.

For more information about enabling the new NLU, see the enableModelImprovements parameter of the PutBot operation.

" + } + }, "Button": { "base": "

Represents an option to be shown on the client platform (Facebook, Slack, etc.)

", "refs": { @@ -135,6 +142,12 @@ "PutSessionResponse$dialogState": "

" } }, + "Double": { + "base": null, + "refs": { + "IntentConfidence$score": "

A score that indicates how confident Amazon Lex is that an intent satisfies the user's intent. Ranges between 0.00 and 1.00. Higher scores indicate higher confidence.

" + } + }, "ErrorMessage": { "base": null, "refs": { @@ -174,6 +187,19 @@ "PutSessionResponse$contentType": "

Content type as specified in the Accept HTTP header in the request.

" } }, + "IntentConfidence": { + "base": "

Provides a score that indicates the confidence that Amazon Lex has that an intent is the one that satisfies the user's intent.

", + "refs": { + "PostTextResponse$nluIntentConfidence": "

Provides a score that indicates how confident Amazon Lex is that the returned intent is the one that matches the user's intent. The score is between 0.0 and 1.0. For more information, see Confidence Scores.

The score is a relative score, not an absolute score. The score may change based on improvements to the Amazon Lex natural language understanding (NLU) model.

", + "PredictedIntent$nluIntentConfidence": "

Indicates how confident Amazon Lex is that an intent satisfies the user's intent.

" + } + }, + "IntentList": { + "base": null, + "refs": { + "PostTextResponse$alternativeIntents": "

One to four alternative intents that may be applicable to the user's intent.

Each alternative includes a score that indicates how confident Amazon Lex is that the intent matches the user's intent. The intents are sorted by the confidence score.

" + } + }, "IntentName": { "base": null, "refs": { @@ -181,6 +207,7 @@ "IntentSummary$intentName": "

The name of the intent.

", "PostContentResponse$intentName": "

Current user intent that Amazon Lex is aware of.

", "PostTextResponse$intentName": "

The current user intent that Amazon Lex is aware of.

", + "PredictedIntent$intentName": "

The name of the intent that Amazon Lex suggests satisfies the user's intent.

", "PutSessionResponse$intentName": "

The name of the current intent.

" } }, @@ -258,6 +285,12 @@ "refs": { } }, + "PredictedIntent": { + "base": "

An intent that Amazon Lex suggests satisfies the user's intent. Includes the name of the intent, the confidence that Amazon Lex has that the user's intent is satisfied, and the slots defined for the intent.

", + "refs": { + "IntentList$member": null + } + }, "PutSessionRequest": { "base": null, "refs": { @@ -311,9 +344,11 @@ "LimitExceededException$message": null, "NotAcceptableException$message": null, "NotFoundException$message": null, + "PostContentResponse$nluIntentConfidence": "

Provides a score that indicates how confident Amazon Lex is that the returned intent is the one that matches the user's intent. The score is between 0.0 and 1.0.

The score is a relative score, not an absolute score. The score may change based on improvements to the Amazon Lex NLU.

", + "PostContentResponse$alternativeIntents": "

One to four alternative intents that may be applicable to the user's intent.

Each alternative includes a score that indicates how confident Amazon Lex is that the intent matches the user's intent. The intents are sorted by the confidence score.

", "PostContentResponse$slots": "

Map of zero or more intent slots (name/value pairs) Amazon Lex detected from the user input during the conversation. The field is base-64 encoded.

Amazon Lex creates a resolution list containing likely values for a slot. The value that it returns is determined by the valueSelectionStrategy selected when the slot type was created or updated. If valueSelectionStrategy is set to ORIGINAL_VALUE, the value provided by the user is returned, if the user value is similar to the slot values. If valueSelectionStrategy is set to TOP_RESOLUTION Amazon Lex returns the first value in the resolution list or, if there is no resolution list, null. If you don't specify a valueSelectionStrategy, the default is ORIGINAL_VALUE.

", "PostContentResponse$sessionAttributes": "

Map of key/value pairs representing the session-specific context information.

", - "PostContentResponse$sentimentResponse": "

The sentiment expressed in and utterance.

When the bot is configured to send utterances to Amazon Comprehend for sentiment analysis, this field contains the result of the analysis.

", + "PostContentResponse$sentimentResponse": "

The sentiment expressed in an utterance.

When the bot is configured to send utterances to Amazon Comprehend for sentiment analysis, this field contains the result of the analysis.

", "PostContentResponse$slotToElicit": "

If the dialogState value is ElicitSlot, returns the name of the slot for which Amazon Lex is eliciting a value.

", "PostContentResponse$inputTranscript": "

The text used to process the request.

If the input was an audio stream, the inputTranscript field contains the text extracted from the audio stream. This is the text that is actually processed to recognize intents and slot values. You can use this information to determine if Amazon Lex is correctly processing the audio that you send.

", "PostContentResponse$sessionId": "

The unique identifier for the session.

", @@ -340,6 +375,7 @@ "PostTextRequest$requestAttributes": "

Request-specific information passed between Amazon Lex and a client application.

The namespace x-amz-lex: is reserved for special attributes. Don't create any request attributes with the prefix x-amz-lex:.

For more information, see Setting Request Attributes.

", "PostTextResponse$slots": "

The intent slots that Amazon Lex detected from the user input in the conversation.

Amazon Lex creates a resolution list containing likely values for a slot. The value that it returns is determined by the valueSelectionStrategy selected when the slot type was created or updated. If valueSelectionStrategy is set to ORIGINAL_VALUE, the value provided by the user is returned, if the user value is similar to the slot values. If valueSelectionStrategy is set to TOP_RESOLUTION Amazon Lex returns the first value in the resolution list or, if there is no resolution list, null. If you don't specify a valueSelectionStrategy, the default is ORIGINAL_VALUE.

", "PostTextResponse$sessionAttributes": "

A map of key-value pairs representing the session-specific context information.

", + "PredictedIntent$slots": "

The slot and slot values associated with the predicted intent.

", "PutSessionRequest$sessionAttributes": "

Map of key/value pairs representing the session-specific context information. It contains application information passed between Amazon Lex and a client application.

" } }, diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index b17536ceb45..e06302ffb12 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -727,6 +727,7 @@ "ca-central-1" : { }, "eu-central-1" : { }, "eu-north-1" : { }, + "eu-south-1" : { }, "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, diff --git a/service/ec2/api.go b/service/ec2/api.go index 69dc3dd6c85..b20ea843819 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -554,6 +554,10 @@ func (c *EC2) AllocateAddressRequest(input *AllocateAddressInput) (req *request. // For more information, see Elastic IP Addresses (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html) // in the Amazon Elastic Compute Cloud User Guide. // +// You can allocate a carrier IP address which is a public IP address from a +// telecommunication carrier, to a network interface which resides in a subnet +// in a Wavelength Zone (for example an EC2 instance). +// // 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. @@ -955,7 +959,8 @@ func (c *EC2) AssociateAddressRequest(input *AssociateAddressInput) (req *reques // AssociateAddress API operation for Amazon Elastic Compute Cloud. // -// Associates an Elastic IP address with an instance or a network interface. +// Associates an Elastic IP address, or carrier IP address (for instances that +// are in subnets in Wavelength Zones) with an instance or a network interface. // Before you can use an Elastic IP address, you must allocate it to your account. // // An Elastic IP address is for use in either the EC2-Classic platform or in @@ -976,6 +981,9 @@ func (c *EC2) AssociateAddressRequest(input *AssociateAddressInput) (req *reques // an Elastic IP address with an instance or network interface that has an existing // Elastic IP address. // +// [Subnets in Wavelength Zones] You can associate an IP address from the telecommunication +// carrier to the instance or network interface. +// // You cannot associate an Elastic IP address with an interface in a different // network border group. // @@ -3453,6 +3461,82 @@ func (c *EC2) CreateCapacityReservationWithContext(ctx aws.Context, input *Creat return out, req.Send() } +const opCreateCarrierGateway = "CreateCarrierGateway" + +// CreateCarrierGatewayRequest generates a "aws/request.Request" representing the +// client's request for the CreateCarrierGateway operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See CreateCarrierGateway for more information on using the CreateCarrierGateway +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the CreateCarrierGatewayRequest method. +// req, resp := client.CreateCarrierGatewayRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateCarrierGateway +func (c *EC2) CreateCarrierGatewayRequest(input *CreateCarrierGatewayInput) (req *request.Request, output *CreateCarrierGatewayOutput) { + op := &request.Operation{ + Name: opCreateCarrierGateway, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &CreateCarrierGatewayInput{} + } + + output = &CreateCarrierGatewayOutput{} + req = c.newRequest(op, input, output) + return +} + +// CreateCarrierGateway API operation for Amazon Elastic Compute Cloud. +// +// Creates a carrier gateway. For more information about carrier gateways, see +// Carrier gateways (https://docs.aws.amazon.com/wavelength/latest/developerguide/how-wavelengths-work.html#wavelength-carrier-gateway) +// in the AWS Wavelength Developer 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 Amazon Elastic Compute Cloud's +// API operation CreateCarrierGateway for usage and error information. +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateCarrierGateway +func (c *EC2) CreateCarrierGateway(input *CreateCarrierGatewayInput) (*CreateCarrierGatewayOutput, error) { + req, out := c.CreateCarrierGatewayRequest(input) + return out, req.Send() +} + +// CreateCarrierGatewayWithContext is the same as CreateCarrierGateway with the addition of +// the ability to pass a context and additional request options. +// +// See CreateCarrierGateway for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *EC2) CreateCarrierGatewayWithContext(ctx aws.Context, input *CreateCarrierGatewayInput, opts ...request.Option) (*CreateCarrierGatewayOutput, error) { + req, out := c.CreateCarrierGatewayRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opCreateClientVpnEndpoint = "CreateClientVpnEndpoint" // CreateClientVpnEndpointRequest generates a "aws/request.Request" representing the @@ -7903,6 +7987,84 @@ func (c *EC2) CreateVpnGatewayWithContext(ctx aws.Context, input *CreateVpnGatew return out, req.Send() } +const opDeleteCarrierGateway = "DeleteCarrierGateway" + +// DeleteCarrierGatewayRequest generates a "aws/request.Request" representing the +// client's request for the DeleteCarrierGateway operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DeleteCarrierGateway for more information on using the DeleteCarrierGateway +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the DeleteCarrierGatewayRequest method. +// req, resp := client.DeleteCarrierGatewayRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DeleteCarrierGateway +func (c *EC2) DeleteCarrierGatewayRequest(input *DeleteCarrierGatewayInput) (req *request.Request, output *DeleteCarrierGatewayOutput) { + op := &request.Operation{ + Name: opDeleteCarrierGateway, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &DeleteCarrierGatewayInput{} + } + + output = &DeleteCarrierGatewayOutput{} + req = c.newRequest(op, input, output) + return +} + +// DeleteCarrierGateway API operation for Amazon Elastic Compute Cloud. +// +// Deletes a carrier gateway. +// +// If you do not delete the route that contains the carrier gateway as the Target, +// the route is a blackhole route. For information about how to delete a route, +// see DeleteRoute (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteRoute.html). +// +// 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 Amazon Elastic Compute Cloud's +// API operation DeleteCarrierGateway for usage and error information. +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DeleteCarrierGateway +func (c *EC2) DeleteCarrierGateway(input *DeleteCarrierGatewayInput) (*DeleteCarrierGatewayOutput, error) { + req, out := c.DeleteCarrierGatewayRequest(input) + return out, req.Send() +} + +// DeleteCarrierGatewayWithContext is the same as DeleteCarrierGateway with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteCarrierGateway for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *EC2) DeleteCarrierGatewayWithContext(ctx aws.Context, input *DeleteCarrierGatewayInput, opts ...request.Option) (*DeleteCarrierGatewayOutput, error) { + req, out := c.DeleteCarrierGatewayRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDeleteClientVpnEndpoint = "DeleteClientVpnEndpoint" // DeleteClientVpnEndpointRequest generates a "aws/request.Request" representing the @@ -12271,13 +12433,12 @@ func (c *EC2) DescribeAvailabilityZonesRequest(input *DescribeAvailabilityZonesI // DescribeAvailabilityZones API operation for Amazon Elastic Compute Cloud. // -// Describes the Availability Zones and Local Zones that are available to you. -// If there is an event impacting an Availability Zone or Local Zone, you can -// use this request to view the state and any provided messages for that Availability -// Zone or Local Zone. +// Describes the Availability Zones, Local Zones, and Wavelength Zones that +// are available to you. If there is an event impacting a zone, you can use +// this request to view the state and any provided messages for that zone. // -// For more information about Availability Zones and Local Zones, see Regions -// and Availability Zones (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html) +// For more information about Availability Zones, Local Zones, and Wavelength +// Zones, see Regions, Zones and Outposts (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html) // in the Amazon Elastic Compute Cloud User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -12655,6 +12816,138 @@ func (c *EC2) DescribeCapacityReservationsPagesWithContext(ctx aws.Context, inpu return p.Err() } +const opDescribeCarrierGateways = "DescribeCarrierGateways" + +// DescribeCarrierGatewaysRequest generates a "aws/request.Request" representing the +// client's request for the DescribeCarrierGateways operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See DescribeCarrierGateways for more information on using the DescribeCarrierGateways +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the DescribeCarrierGatewaysRequest method. +// req, resp := client.DescribeCarrierGatewaysRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeCarrierGateways +func (c *EC2) DescribeCarrierGatewaysRequest(input *DescribeCarrierGatewaysInput) (req *request.Request, output *DescribeCarrierGatewaysOutput) { + op := &request.Operation{ + Name: opDescribeCarrierGateways, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, + } + + if input == nil { + input = &DescribeCarrierGatewaysInput{} + } + + output = &DescribeCarrierGatewaysOutput{} + req = c.newRequest(op, input, output) + return +} + +// DescribeCarrierGateways API operation for Amazon Elastic Compute Cloud. +// +// Describes one or more of your carrier gateways. +// +// 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 Amazon Elastic Compute Cloud's +// API operation DescribeCarrierGateways for usage and error information. +// See also, https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeCarrierGateways +func (c *EC2) DescribeCarrierGateways(input *DescribeCarrierGatewaysInput) (*DescribeCarrierGatewaysOutput, error) { + req, out := c.DescribeCarrierGatewaysRequest(input) + return out, req.Send() +} + +// DescribeCarrierGatewaysWithContext is the same as DescribeCarrierGateways with the addition of +// the ability to pass a context and additional request options. +// +// See DescribeCarrierGateways for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *EC2) DescribeCarrierGatewaysWithContext(ctx aws.Context, input *DescribeCarrierGatewaysInput, opts ...request.Option) (*DescribeCarrierGatewaysOutput, error) { + req, out := c.DescribeCarrierGatewaysRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// DescribeCarrierGatewaysPages iterates over the pages of a DescribeCarrierGateways operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See DescribeCarrierGateways method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a DescribeCarrierGateways operation. +// pageNum := 0 +// err := client.DescribeCarrierGatewaysPages(params, +// func(page *ec2.DescribeCarrierGatewaysOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *EC2) DescribeCarrierGatewaysPages(input *DescribeCarrierGatewaysInput, fn func(*DescribeCarrierGatewaysOutput, bool) bool) error { + return c.DescribeCarrierGatewaysPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// DescribeCarrierGatewaysPagesWithContext same as DescribeCarrierGatewaysPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *EC2) DescribeCarrierGatewaysPagesWithContext(ctx aws.Context, input *DescribeCarrierGatewaysInput, fn func(*DescribeCarrierGatewaysOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *DescribeCarrierGatewaysInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.DescribeCarrierGatewaysRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + for p.Next() { + if !fn(p.Page().(*DescribeCarrierGatewaysOutput), !p.HasNextPage()) { + break + } + } + + return p.Err() +} + const opDescribeClassicLinkInstances = "DescribeClassicLinkInstances" // DescribeClassicLinkInstancesRequest generates a "aws/request.Request" representing the @@ -30294,7 +30587,8 @@ func (c *EC2) ModifyAvailabilityZoneGroupRequest(input *ModifyAvailabilityZoneGr // ModifyAvailabilityZoneGroup API operation for Amazon Elastic Compute Cloud. // -// Enables or disables an Availability Zone group for your account. +// Changes the opt-in status of the Local Zone and Wavelength Zone group for +// your account. // // Use DescribeAvailabilityZones (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeAvailabilityZones.html) // to view the value for GroupName. @@ -38744,7 +39038,7 @@ func (s *AddPrefixListEntry) SetDescription(v string) *AddPrefixListEntry { return s } -// Describes an Elastic IP address. +// Describes an Elastic IP address, or a carrier IP address. type Address struct { _ struct{} `type:"structure"` @@ -38755,6 +39049,11 @@ type Address struct { // VPC. AssociationId *string `locationName:"associationId" type:"string"` + // The carrier IP address associated. This option is only available for network + // interfaces which reside in a subnet in a Wavelength Zone (for example an + // EC2 instance). + CarrierIp *string `locationName:"carrierIp" type:"string"` + // The customer-owned IP address. CustomerOwnedIp *string `locationName:"customerOwnedIp" type:"string"` @@ -38768,7 +39067,8 @@ type Address struct { // The ID of the instance that the address is associated with (if any). InstanceId *string `locationName:"instanceId" type:"string"` - // The name of the location from which the IP address is advertised. + // The name of the unique set of Availability Zones, Local Zones, or Wavelength + // Zones from which AWS advertises IP addresses. NetworkBorderGroup *string `locationName:"networkBorderGroup" type:"string"` // The ID of the network interface. @@ -38812,6 +39112,12 @@ func (s *Address) SetAssociationId(v string) *Address { return s } +// SetCarrierIp sets the CarrierIp field's value. +func (s *Address) SetCarrierIp(v string) *Address { + s.CarrierIp = &v + return s +} + // SetCustomerOwnedIp sets the CustomerOwnedIp field's value. func (s *Address) SetCustomerOwnedIp(v string) *Address { s.CustomerOwnedIp = &v @@ -38977,12 +39283,9 @@ type AllocateAddressInput struct { // it is UnauthorizedOperation. DryRun *bool `locationName:"dryRun" type:"boolean"` - // The location from which the IP address is advertised. Use this parameter - // to limit the address to this location. - // - // A network border group is a unique set of Availability Zones or Local Zones - // from where AWS advertises IP addresses and limits the addresses to the group. - // IP addresses cannot move between network border groups. + // A unique set of Availability Zones, Local Zones, or Wavelength Zones from + // which AWS advertises IP addresses. Use this parameter to limit the IP address + // to this location. IP addresses cannot move between network border groups. // // Use DescribeAvailabilityZones (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeAvailabilityZones.html) // to view the network border groups. @@ -39051,6 +39354,10 @@ type AllocateAddressOutput struct { // IP address for use with instances in a VPC. AllocationId *string `locationName:"allocationId" type:"string"` + // The carrier IP address. This option is only available for network interfaces + // which reside in a subnet in a Wavelength Zone (for example an EC2 instance). + CarrierIp *string `locationName:"carrierIp" type:"string"` + // The customer-owned IP address. CustomerOwnedIp *string `locationName:"customerOwnedIp" type:"string"` @@ -39061,7 +39368,8 @@ type AllocateAddressOutput struct { // (vpc) or instances in EC2-Classic (standard). Domain *string `locationName:"domain" type:"string" enum:"DomainType"` - // The location from which the IP address is advertised. + // The set of Availability Zones, Local Zones, or Wavelength Zones from which + // AWS advertises IP addresses. NetworkBorderGroup *string `locationName:"networkBorderGroup" type:"string"` // The Elastic IP address. @@ -39087,6 +39395,12 @@ func (s *AllocateAddressOutput) SetAllocationId(v string) *AllocateAddressOutput return s } +// SetCarrierIp sets the CarrierIp field's value. +func (s *AllocateAddressOutput) SetCarrierIp(v string) *AllocateAddressOutput { + s.CarrierIp = &v + return s +} + // SetCustomerOwnedIp sets the CustomerOwnedIp field's value. func (s *AllocateAddressOutput) SetCustomerOwnedIp(v string) *AllocateAddressOutput { s.CustomerOwnedIp = &v @@ -40379,7 +40693,7 @@ type AssociateVpcCidrBlockInput struct { Ipv6CidrBlock *string `type:"string"` // The name of the location from which we advertise the IPV6 CIDR block. Use - // this parameter to limit the CiDR block to this location. + // this parameter to limit the CIDR block to this location. // // You must set AmazonProvidedIpv6CidrBlock to true to use this parameter. // @@ -41550,48 +41864,51 @@ func (s AuthorizeSecurityGroupIngressOutput) GoString() string { return s.String() } -// Describes a Zone. +// Describes Availability Zones, Local Zones, and Wavelength Zones. type AvailabilityZone struct { _ struct{} `type:"structure"` // For Availability Zones, this parameter has the same value as the Region name. // // For Local Zones, the name of the associated group, for example us-west-2-lax-1. + // + // For Wavelength Zones, the name of the associated group, for example us-east-1-wl1-bos-wlz-1. GroupName *string `locationName:"groupName" type:"string"` - // Any messages about the Zone. + // Any messages about the Availability Zone, Local Zone, or Wavelength Zone. Messages []*AvailabilityZoneMessage `locationName:"messageSet" locationNameList:"item" type:"list"` - // The name of the location from which the address is advertised. + // The name of the network border group. NetworkBorderGroup *string `locationName:"networkBorderGroup" type:"string"` // For Availability Zones, this parameter always has the value of opt-in-not-required. // - // For Local Zones, this parameter is the opt in status. The possible values - // are opted-in, and not-opted-in. + // For Local Zones and Wavelength Zones, this parameter is the opt-in status. + // The possible values are opted-in, and not-opted-in. OptInStatus *string `locationName:"optInStatus" type:"string" enum:"AvailabilityZoneOptInStatus"` - // The ID of the zone that handles some of the Local Zone control plane operations, - // such as API calls. + // The ID of the zone that handles some of the Local Zone or Wavelength Zone + // control plane operations, such as API calls. ParentZoneId *string `locationName:"parentZoneId" type:"string"` - // The name of the zone that handles some of the Local Zone control plane operations, - // such as API calls. + // The name of the zone that handles some of the Local Zone or Wavelength Zone + // control plane operations, such as API calls. ParentZoneName *string `locationName:"parentZoneName" type:"string"` // The name of the Region. RegionName *string `locationName:"regionName" type:"string"` - // The state of the Zone. + // The state of the Availability Zone, Local Zone, or Wavelength Zone. State *string `locationName:"zoneState" type:"string" enum:"AvailabilityZoneState"` - // The ID of the Zone. + // The ID of the Availability Zone, Local Zone, or Wavelength Zone. ZoneId *string `locationName:"zoneId" type:"string"` - // The name of the Zone. + // The name of the Availability Zone, Local Zone, or Wavelength Zone. ZoneName *string `locationName:"zoneName" type:"string"` - // The type of zone. The valid values are availability-zone and local-zone. + // The type of zone. The valid values are availability-zone, local-zone, and + // wavelength-zone. ZoneType *string `locationName:"zoneType" type:"string"` } @@ -41671,11 +41988,12 @@ func (s *AvailabilityZone) SetZoneType(v string) *AvailabilityZone { return s } -// Describes a message about a Zone. +// Describes a message about an Availability Zone, Local Zone, or Wavelength +// Zone. type AvailabilityZoneMessage struct { _ struct{} `type:"structure"` - // The message about the Zone. + // The message about the Availability Zone, Local Zone, or Wavelength Zone. Message *string `locationName:"message" type:"string"` } @@ -43343,6 +43661,66 @@ func (s *CapacityReservationTargetResponse) SetCapacityReservationResourceGroupA return s } +// Describes a carrier gateway. +type CarrierGateway struct { + _ struct{} `type:"structure"` + + // The ID of the carrier gateway. + CarrierGatewayId *string `locationName:"carrierGatewayId" type:"string"` + + // The AWS account ID of the owner of the carrier gateway. + OwnerId *string `locationName:"ownerId" type:"string"` + + // The state of the carrier gateway. + State *string `locationName:"state" type:"string" enum:"CarrierGatewayState"` + + // The tags assigned to the carrier gateway. + Tags []*Tag `locationName:"tagSet" locationNameList:"item" type:"list"` + + // The ID of the VPC associated with the carrier gateway. + VpcId *string `locationName:"vpcId" type:"string"` +} + +// String returns the string representation +func (s CarrierGateway) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CarrierGateway) GoString() string { + return s.String() +} + +// SetCarrierGatewayId sets the CarrierGatewayId field's value. +func (s *CarrierGateway) SetCarrierGatewayId(v string) *CarrierGateway { + s.CarrierGatewayId = &v + return s +} + +// SetOwnerId sets the OwnerId field's value. +func (s *CarrierGateway) SetOwnerId(v string) *CarrierGateway { + s.OwnerId = &v + return s +} + +// SetState sets the State field's value. +func (s *CarrierGateway) SetState(v string) *CarrierGateway { + s.State = &v + return s +} + +// SetTags sets the Tags field's value. +func (s *CarrierGateway) SetTags(v []*Tag) *CarrierGateway { + s.Tags = v + return s +} + +// SetVpcId sets the VpcId field's value. +func (s *CarrierGateway) SetVpcId(v string) *CarrierGateway { + s.VpcId = &v + return s +} + // Information about the client certificate used for authentication. type CertificateAuthentication struct { _ struct{} `type:"structure"` @@ -45610,6 +45988,98 @@ func (s *CreateCapacityReservationOutput) SetCapacityReservation(v *CapacityRese return s } +type CreateCarrierGatewayInput struct { + _ struct{} `type:"structure"` + + // Unique, case-sensitive identifier that you provide to ensure the idempotency + // of the request. For more information, see How to Ensure Idempotency (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Run_Instance_Idempotency.html). + ClientToken *string `type:"string" idempotencyToken:"true"` + + // Checks whether you have the required permissions for the action, without + // actually making the request, and provides an error response. If you have + // the required permissions, the error response is DryRunOperation. Otherwise, + // it is UnauthorizedOperation. + DryRun *bool `type:"boolean"` + + // The tags to associate with the carrier gateway. + TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` + + // The ID of the VPC to associate with the carrier gateway. + // + // VpcId is a required field + VpcId *string `type:"string" required:"true"` +} + +// String returns the string representation +func (s CreateCarrierGatewayInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateCarrierGatewayInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CreateCarrierGatewayInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CreateCarrierGatewayInput"} + if s.VpcId == nil { + invalidParams.Add(request.NewErrParamRequired("VpcId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetClientToken sets the ClientToken field's value. +func (s *CreateCarrierGatewayInput) SetClientToken(v string) *CreateCarrierGatewayInput { + s.ClientToken = &v + return s +} + +// SetDryRun sets the DryRun field's value. +func (s *CreateCarrierGatewayInput) SetDryRun(v bool) *CreateCarrierGatewayInput { + s.DryRun = &v + return s +} + +// SetTagSpecifications sets the TagSpecifications field's value. +func (s *CreateCarrierGatewayInput) SetTagSpecifications(v []*TagSpecification) *CreateCarrierGatewayInput { + s.TagSpecifications = v + return s +} + +// SetVpcId sets the VpcId field's value. +func (s *CreateCarrierGatewayInput) SetVpcId(v string) *CreateCarrierGatewayInput { + s.VpcId = &v + return s +} + +type CreateCarrierGatewayOutput struct { + _ struct{} `type:"structure"` + + // Information about the carrier gateway. + CarrierGateway *CarrierGateway `locationName:"carrierGateway" type:"structure"` +} + +// String returns the string representation +func (s CreateCarrierGatewayOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CreateCarrierGatewayOutput) GoString() string { + return s.String() +} + +// SetCarrierGateway sets the CarrierGateway field's value. +func (s *CreateCarrierGatewayOutput) SetCarrierGateway(v *CarrierGateway) *CreateCarrierGatewayOutput { + s.CarrierGateway = v + return s +} + type CreateClientVpnEndpointInput struct { _ struct{} `type:"structure"` @@ -49027,6 +49497,12 @@ func (s *CreateReservedInstancesListingOutput) SetReservedInstancesListings(v [] type CreateRouteInput struct { _ struct{} `type:"structure"` + // The ID of the carrier gateway. + // + // You can only use this option when the VPC contains a subnet which is associated + // with a Wavelength Zone. + CarrierGatewayId *string `type:"string"` + // The IPv4 CIDR address block used for the destination match. Routing decisions // are based on the most specific match. We modify the specified CIDR block // to its canonical form; for example, if you specify 100.68.0.18/18, we modify @@ -49101,6 +49577,12 @@ func (s *CreateRouteInput) Validate() error { return nil } +// SetCarrierGatewayId sets the CarrierGatewayId field's value. +func (s *CreateRouteInput) SetCarrierGatewayId(v string) *CreateRouteInput { + s.CarrierGatewayId = &v + return s +} + // SetDestinationCidrBlock sets the DestinationCidrBlock field's value. func (s *CreateRouteInput) SetDestinationCidrBlock(v string) *CreateRouteInput { s.DestinationCidrBlock = &v @@ -52485,6 +52967,79 @@ func (s *CustomerGateway) SetType(v string) *CustomerGateway { return s } +type DeleteCarrierGatewayInput struct { + _ struct{} `type:"structure"` + + // The ID of the carrier gateway. + // + // CarrierGatewayId is a required field + CarrierGatewayId *string `type:"string" required:"true"` + + // Checks whether you have the required permissions for the action, without + // actually making the request, and provides an error response. If you have + // the required permissions, the error response is DryRunOperation. Otherwise, + // it is UnauthorizedOperation. + DryRun *bool `type:"boolean"` +} + +// String returns the string representation +func (s DeleteCarrierGatewayInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteCarrierGatewayInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeleteCarrierGatewayInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteCarrierGatewayInput"} + if s.CarrierGatewayId == nil { + invalidParams.Add(request.NewErrParamRequired("CarrierGatewayId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetCarrierGatewayId sets the CarrierGatewayId field's value. +func (s *DeleteCarrierGatewayInput) SetCarrierGatewayId(v string) *DeleteCarrierGatewayInput { + s.CarrierGatewayId = &v + return s +} + +// SetDryRun sets the DryRun field's value. +func (s *DeleteCarrierGatewayInput) SetDryRun(v bool) *DeleteCarrierGatewayInput { + s.DryRun = &v + return s +} + +type DeleteCarrierGatewayOutput struct { + _ struct{} `type:"structure"` + + // Information about the carrier gateway. + CarrierGateway *CarrierGateway `locationName:"carrierGateway" type:"structure"` +} + +// String returns the string representation +func (s DeleteCarrierGatewayOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DeleteCarrierGatewayOutput) GoString() string { + return s.String() +} + +// SetCarrierGateway sets the CarrierGateway field's value. +func (s *DeleteCarrierGatewayOutput) SetCarrierGateway(v *CarrierGateway) *DeleteCarrierGatewayOutput { + s.CarrierGateway = v + return s +} + type DeleteClientVpnEndpointInput struct { _ struct{} `type:"structure"` @@ -56705,7 +57260,8 @@ type DescribeAddressesInput struct { // * instance-id - The ID of the instance the address is associated with, // if any. // - // * network-border-group - The location from where the IP address is advertised. + // * network-border-group - A unique set of Availability Zones, Local Zones, + // or Wavelength Zones from where AWS advertises IP addresses. // // * network-interface-id - [EC2-VPC] The ID of the network interface that // the address is associated with, if any. @@ -56715,7 +57271,7 @@ type DescribeAddressesInput struct { // * private-ip-address - [EC2-VPC] The private IP address associated with // the Elastic IP address. // - // * public-ip - The Elastic IP address. + // * public-ip - The Elastic IP address, or the carrier IP address. // // * tag: - The key/value combination of a tag assigned to the resource. // Use the tag key in the filter name and the tag value as the filter value. @@ -56854,8 +57410,8 @@ func (s *DescribeAggregateIdFormatOutput) SetUseLongIdsAggregated(v bool) *Descr type DescribeAvailabilityZonesInput struct { _ struct{} `type:"structure"` - // Include all Availability Zones and Local Zones regardless of your opt in - // status. + // Include all Availability Zones, Local Zones, and Wavelength Zones regardless + // of your opt-in status. // // If you do not use this parameter, the results include only the zones for // the Regions where you have chosen the option to opt in. @@ -56871,35 +57427,41 @@ type DescribeAvailabilityZonesInput struct { // // * group-name - For Availability Zones, use the Region name. For Local // Zones, use the name of the group associated with the Local Zone (for example, - // us-west-2-lax-1). + // us-west-2-lax-1) For Wavelength Zones, use the name of the group associated + // with the Wavelength Zone (for example, us-east-1-wl1-bos-wlz-1). // // * message - The Zone message. // - // * opt-in-status - The opt in status (opted-in, and not-opted-in | opt-in-not-required). + // * opt-in-status - The opt-in status (opted-in, and not-opted-in | opt-in-not-required). // - // * The ID of the zone that handles some of the Local Zone control plane - // operations, such as API calls. + // * parent-zoneID - The ID of the zone that handles some of the Local Zone + // and Wavelength Zone control plane operations, such as API calls. + // + // * parent-zoneName - The ID of the zone that handles some of the Local + // Zone and Wavelength Zone control plane operations, such as API calls. // // * region-name - The name of the Region for the Zone (for example, us-east-1). // - // * state - The state of the Availability Zone or Local Zone (available - // | information | impaired | unavailable). + // * state - The state of the Availability Zone, the Local Zone, or the Wavelength + // Zone (available | information | impaired | unavailable). // - // * zone-id - The ID of the Availability Zone (for example, use1-az1) or - // the Local Zone (for example, use usw2-lax1-az1). + // * zone-id - The ID of the Availability Zone (for example, use1-az1), the + // Local Zone (for example, usw2-lax1-az1), or the Wavelength Zone (for example, + // us-east-1-wl1-bos-wlz-1). // // * zone-type - The type of zone, for example, local-zone. // - // * zone-name - The name of the Availability Zone (for example, us-east-1a) - // or the Local Zone (for example, use us-west-2-lax-1a). + // * zone-name - The name of the Availability Zone (for example, us-east-1a), + // the Local Zone (for example, us-west-2-lax-1a), or the Wavelength Zone + // (for example, us-east-1-wl1-bos-wlz-1). // // * zone-type - The type of zone, for example, local-zone. Filters []*Filter `locationName:"Filter" locationNameList:"Filter" type:"list"` - // The IDs of the Zones. + // The IDs of the Availability Zones, Local Zones, and Wavelength Zones. ZoneIds []*string `locationName:"ZoneId" locationNameList:"ZoneId" type:"list"` - // The names of the Zones. + // The names of the Availability Zones, Local Zones, and Wavelength Zones. ZoneNames []*string `locationName:"ZoneName" locationNameList:"ZoneName" type:"list"` } @@ -56946,7 +57508,7 @@ func (s *DescribeAvailabilityZonesInput) SetZoneNames(v []*string) *DescribeAvai type DescribeAvailabilityZonesOutput struct { _ struct{} `type:"structure"` - // Information about the Zones. + // Information about the Availability Zones, Local Zones, and Wavelength Zones. AvailabilityZones []*AvailabilityZone `locationName:"availabilityZoneInfo" locationNameList:"item" type:"list"` } @@ -57315,6 +57877,134 @@ func (s *DescribeCapacityReservationsOutput) SetNextToken(v string) *DescribeCap return s } +type DescribeCarrierGatewaysInput struct { + _ struct{} `type:"structure"` + + // One or more carrier gateway IDs. + CarrierGatewayIds []*string `locationName:"CarrierGatewayId" type:"list"` + + // Checks whether you have the required permissions for the action, without + // actually making the request, and provides an error response. If you have + // the required permissions, the error response is DryRunOperation. Otherwise, + // it is UnauthorizedOperation. + DryRun *bool `type:"boolean"` + + // One or more filters. + // + // * carrier-gateway-id - The ID of the carrier gateway. + // + // * state - The state of the carrier gateway (pending | failed | available + // | deleting | deleted). + // + // * owner-id - The AWS account ID of the owner of the carrier gateway. + // + // * tag: - The key/value combination of a tag assigned to the resource. + // Use the tag key in the filter name and the tag value as the filter value. + // For example, to find all resources that have a tag with the key Owner + // and the value TeamA, specify tag:Owner for the filter name and TeamA for + // the filter value. + // + // * tag-key - The key of a tag assigned to the resource. Use this filter + // to find all resources assigned a tag with a specific key, regardless of + // the tag value. + // + // * vpc-id - The ID of the VPC associated with the carrier gateway. + Filters []*Filter `locationName:"Filter" locationNameList:"Filter" type:"list"` + + // The maximum number of results to return with a single call. To retrieve the + // remaining results, make another call with the returned nextToken value. + MaxResults *int64 `min:"5" type:"integer"` + + // The token for the next page of results. + NextToken *string `type:"string"` +} + +// String returns the string representation +func (s DescribeCarrierGatewaysInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeCarrierGatewaysInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DescribeCarrierGatewaysInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DescribeCarrierGatewaysInput"} + if s.MaxResults != nil && *s.MaxResults < 5 { + invalidParams.Add(request.NewErrParamMinValue("MaxResults", 5)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetCarrierGatewayIds sets the CarrierGatewayIds field's value. +func (s *DescribeCarrierGatewaysInput) SetCarrierGatewayIds(v []*string) *DescribeCarrierGatewaysInput { + s.CarrierGatewayIds = v + return s +} + +// SetDryRun sets the DryRun field's value. +func (s *DescribeCarrierGatewaysInput) SetDryRun(v bool) *DescribeCarrierGatewaysInput { + s.DryRun = &v + return s +} + +// SetFilters sets the Filters field's value. +func (s *DescribeCarrierGatewaysInput) SetFilters(v []*Filter) *DescribeCarrierGatewaysInput { + s.Filters = v + return s +} + +// SetMaxResults sets the MaxResults field's value. +func (s *DescribeCarrierGatewaysInput) SetMaxResults(v int64) *DescribeCarrierGatewaysInput { + s.MaxResults = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *DescribeCarrierGatewaysInput) SetNextToken(v string) *DescribeCarrierGatewaysInput { + s.NextToken = &v + return s +} + +type DescribeCarrierGatewaysOutput struct { + _ struct{} `type:"structure"` + + // Information about the carrier gateway. + CarrierGateways []*CarrierGateway `locationName:"carrierGatewaySet" locationNameList:"item" type:"list"` + + // The token to use to retrieve the next page of results. This value is null + // when there are no more results to return. + NextToken *string `locationName:"nextToken" type:"string"` +} + +// String returns the string representation +func (s DescribeCarrierGatewaysOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s DescribeCarrierGatewaysOutput) GoString() string { + return s.String() +} + +// SetCarrierGateways sets the CarrierGateways field's value. +func (s *DescribeCarrierGatewaysOutput) SetCarrierGateways(v []*CarrierGateway) *DescribeCarrierGatewaysOutput { + s.CarrierGateways = v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *DescribeCarrierGatewaysOutput) SetNextToken(v string) *DescribeCarrierGatewaysOutput { + s.NextToken = &v + return s +} + type DescribeClassicLinkInstancesInput struct { _ struct{} `type:"structure"` @@ -73073,7 +73763,7 @@ type EbsBlockDevice struct { // bursting. For more information, see Amazon EBS volume types (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) // in the Amazon Elastic Compute Cloud User Guide. // - // Constraints: Range is 100-16,000 IOPS for gp2 volumes and 100 to 64,000IOPS + // Constraints: Range is 100-16,000 IOPS for gp2 volumes and 100 to 64,000 IOPS // for io1 volumes in most Regions. Maximum io1 IOPS of 64,000 is guaranteed // only on Nitro-based instances (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances). // Other instance families guarantee performance up to 32,000 IOPS. For more @@ -81809,7 +82499,11 @@ type Instance struct { // name is only available if you've enabled DNS hostnames for your VPC. PublicDnsName *string `locationName:"dnsName" type:"string"` - // The public IPv4 address assigned to the instance, if applicable. + // The public IPv4 address, or the Carrier IP address assigned to the instance, + // if applicable. + // + // A Carrier IP address only applies to an instance launched in a subnet associated + // with a Wavelength Zone. PublicIpAddress *string `locationName:"ipAddress" type:"string"` // The RAM disk associated with this instance, if applicable. @@ -82874,6 +83568,9 @@ func (s *InstanceNetworkInterface) SetVpcId(v string) *InstanceNetworkInterface type InstanceNetworkInterfaceAssociation struct { _ struct{} `type:"structure"` + // The carrier IP address associated with the network interface. + CarrierIp *string `locationName:"carrierIp" type:"string"` + // The ID of the owner of the Elastic IP address. IpOwnerId *string `locationName:"ipOwnerId" type:"string"` @@ -82894,6 +83591,12 @@ func (s InstanceNetworkInterfaceAssociation) GoString() string { return s.String() } +// SetCarrierIp sets the CarrierIp field's value. +func (s *InstanceNetworkInterfaceAssociation) SetCarrierIp(v string) *InstanceNetworkInterfaceAssociation { + s.CarrierIp = &v + return s +} + // SetIpOwnerId sets the IpOwnerId field's value. func (s *InstanceNetworkInterfaceAssociation) SetIpOwnerId(v string) *InstanceNetworkInterfaceAssociation { s.IpOwnerId = &v @@ -82976,6 +83679,13 @@ func (s *InstanceNetworkInterfaceAttachment) SetStatus(v string) *InstanceNetwor type InstanceNetworkInterfaceSpecification struct { _ struct{} `type:"structure"` + // Indicates whether to assign a carrier IP address to the network interface. + // + // You can only assign a carrier IP address to a network interface that is in + // a subnet in a Wavelength Zone. For more information about carrier IP addresses, + // see Carrier IP addresses in the AWS Wavelength Developer Guide. + AssociateCarrierIpAddress *bool `type:"boolean"` + // Indicates whether to assign a public IPv4 address to an instance you launch // in a VPC. The public IP address can only be assigned to a network interface // for eth0, and can only be assigned to a new network interface, not an existing @@ -83066,6 +83776,12 @@ func (s InstanceNetworkInterfaceSpecification) GoString() string { return s.String() } +// SetAssociateCarrierIpAddress sets the AssociateCarrierIpAddress field's value. +func (s *InstanceNetworkInterfaceSpecification) SetAssociateCarrierIpAddress(v bool) *InstanceNetworkInterfaceSpecification { + s.AssociateCarrierIpAddress = &v + return s +} + // SetAssociatePublicIpAddress sets the AssociatePublicIpAddress field's value. func (s *InstanceNetworkInterfaceSpecification) SetAssociatePublicIpAddress(v bool) *InstanceNetworkInterfaceSpecification { s.AssociatePublicIpAddress = &v @@ -85620,6 +86336,15 @@ func (s *LaunchTemplateInstanceMetadataOptionsRequest) SetHttpTokens(v string) * type LaunchTemplateInstanceNetworkInterfaceSpecification struct { _ struct{} `type:"structure"` + // Indicates whether to associate a Carrier IP address with eth0 for a new network + // interface. + // + // Use this option when you launch an instance in a Wavelength Zone and want + // to associate a Carrier IP address with the network interface. For more information + // about Carrier IP addresses, see Carrier IP addresses (https://docs.aws.amazon.com/wavelength/latest/developerguide/how-wavelengths-work.html#provider-owned-ip) + // in the AWS Wavelength Developer Guide. + AssociateCarrierIpAddress *bool `locationName:"associateCarrierIpAddress" type:"boolean"` + // Indicates whether to associate a public IPv4 address with eth0 for a new // network interface. AssociatePublicIpAddress *bool `locationName:"associatePublicIpAddress" type:"boolean"` @@ -85671,6 +86396,12 @@ func (s LaunchTemplateInstanceNetworkInterfaceSpecification) GoString() string { return s.String() } +// SetAssociateCarrierIpAddress sets the AssociateCarrierIpAddress field's value. +func (s *LaunchTemplateInstanceNetworkInterfaceSpecification) SetAssociateCarrierIpAddress(v bool) *LaunchTemplateInstanceNetworkInterfaceSpecification { + s.AssociateCarrierIpAddress = &v + return s +} + // SetAssociatePublicIpAddress sets the AssociatePublicIpAddress field's value. func (s *LaunchTemplateInstanceNetworkInterfaceSpecification) SetAssociatePublicIpAddress(v bool) *LaunchTemplateInstanceNetworkInterfaceSpecification { s.AssociatePublicIpAddress = &v @@ -85753,6 +86484,14 @@ func (s *LaunchTemplateInstanceNetworkInterfaceSpecification) SetSubnetId(v stri type LaunchTemplateInstanceNetworkInterfaceSpecificationRequest struct { _ struct{} `type:"structure"` + // Associates a Carrier IP address with eth0 for a new network interface. + // + // Use this option when you launch an instance in a Wavelength Zone and want + // to associate a Carrier IP address with the network interface. For more information + // about Carrier IP addresses, see Carrier IP addresses (https://docs.aws.amazon.com/wavelength/latest/developerguide/how-wavelengths-work.html#provider-owned-ip) + // in the AWS Wavelength Developer Guide. + AssociateCarrierIpAddress *bool `type:"boolean"` + // Associates a public IPv4 address with eth0 for a new network interface. AssociatePublicIpAddress *bool `type:"boolean"` @@ -85812,6 +86551,12 @@ func (s LaunchTemplateInstanceNetworkInterfaceSpecificationRequest) GoString() s return s.String() } +// SetAssociateCarrierIpAddress sets the AssociateCarrierIpAddress field's value. +func (s *LaunchTemplateInstanceNetworkInterfaceSpecificationRequest) SetAssociateCarrierIpAddress(v bool) *LaunchTemplateInstanceNetworkInterfaceSpecificationRequest { + s.AssociateCarrierIpAddress = &v + return s +} + // SetAssociatePublicIpAddress sets the AssociatePublicIpAddress field's value. func (s *LaunchTemplateInstanceNetworkInterfaceSpecificationRequest) SetAssociatePublicIpAddress(v bool) *LaunchTemplateInstanceNetworkInterfaceSpecificationRequest { s.AssociatePublicIpAddress = &v @@ -87370,14 +88115,16 @@ type ModifyAvailabilityZoneGroupInput struct { // it is UnauthorizedOperation. DryRun *bool `type:"boolean"` - // The name of the Availability Zone Group. + // The name of the Availability Zone group, Local Zone group, or Wavelength + // Zone group. // // GroupName is a required field GroupName *string `type:"string" required:"true"` - // Indicates whether to enable or disable membership. The valid values are opted-in. - // You must contact AWS Support (https://console.aws.amazon.com/support/home#/case/create%3FissueType=customer-service%26serviceCode=general-info%26getting-started%26categoryCode=using-aws%26services) - // to disable an Availability Zone group. + // Indicates whether you are opted in to the Local Zone group or Wavelength + // Zone group. The only valid value is opted-in. You must contact AWS Support + // (https://console.aws.amazon.com/support/home#/case/create%3FissueType=customer-service%26serviceCode=general-info%26getting-started%26categoryCode=using-aws%26services) + // to opt out of a Local Zone group, or Wavelength Zone group. // // OptInStatus is a required field OptInStatus *string `type:"string" required:"true" enum:"ModifyAvailabilityZoneOptInStatus"` @@ -92974,7 +93721,9 @@ func (s *NetworkInterface) SetVpcId(v string) *NetworkInterface { return s } -// Describes association information for an Elastic IP address (IPv4 only). +// Describes association information for an Elastic IP address (IPv4 only), +// or a Carrier IP address (for a network interface which resides in a subnet +// in a Wavelength Zone). type NetworkInterfaceAssociation struct { _ struct{} `type:"structure"` @@ -92984,13 +93733,20 @@ type NetworkInterfaceAssociation struct { // The association ID. AssociationId *string `locationName:"associationId" type:"string"` + // The carrier IP address associated with the network interface. + // + // This option is only available when the network interface is in a subnet which + // is associated with a Wavelength Zone. + CarrierIp *string `locationName:"carrierIp" type:"string"` + // The ID of the Elastic IP address owner. IpOwnerId *string `locationName:"ipOwnerId" type:"string"` // The public DNS name. PublicDnsName *string `locationName:"publicDnsName" type:"string"` - // The address of the Elastic IP address bound to the network interface. + // The address of the Elastic IP address or Carrier IP address bound to the + // network interface. PublicIp *string `locationName:"publicIp" type:"string"` } @@ -93016,6 +93772,12 @@ func (s *NetworkInterfaceAssociation) SetAssociationId(v string) *NetworkInterfa return s } +// SetCarrierIp sets the CarrierIp field's value. +func (s *NetworkInterfaceAssociation) SetCarrierIp(v string) *NetworkInterfaceAssociation { + s.CarrierIp = &v + return s +} + // SetIpOwnerId sets the IpOwnerId field's value. func (s *NetworkInterfaceAssociation) SetIpOwnerId(v string) *NetworkInterfaceAssociation { s.IpOwnerId = &v @@ -96543,7 +97305,8 @@ type ReleaseAddressInput struct { // it is UnauthorizedOperation. DryRun *bool `locationName:"dryRun" type:"boolean"` - // The location that the IP address is released from. + // The set of Availability Zones, Local Zones, or Wavelength Zones from which + // AWS advertises IP addresses. // // If you provide an incorrect network border group, you will receive an InvalidAddress.NotFound // error. For more information, see Error Codes (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/errors-overview.html). @@ -97047,6 +97810,9 @@ func (s ReplaceNetworkAclEntryOutput) GoString() string { type ReplaceRouteInput struct { _ struct{} `type:"structure"` + // [IPv4 traffic only] The ID of a carrier gateway. + CarrierGatewayId *string `type:"string"` + // The IPv4 CIDR address block used for the destination match. The value that // you provide must match the CIDR of an existing route in the table. DestinationCidrBlock *string `locationName:"destinationCidrBlock" type:"string"` @@ -97120,6 +97886,12 @@ func (s *ReplaceRouteInput) Validate() error { return nil } +// SetCarrierGatewayId sets the CarrierGatewayId field's value. +func (s *ReplaceRouteInput) SetCarrierGatewayId(v string) *ReplaceRouteInput { + s.CarrierGatewayId = &v + return s +} + // SetDestinationCidrBlock sets the DestinationCidrBlock field's value. func (s *ReplaceRouteInput) SetDestinationCidrBlock(v string) *ReplaceRouteInput { s.DestinationCidrBlock = &v @@ -100524,6 +101296,9 @@ func (s RevokeSecurityGroupIngressOutput) GoString() string { type Route struct { _ struct{} `type:"structure"` + // The ID of the carrier gateway. + CarrierGatewayId *string `locationName:"carrierGatewayId" type:"string"` + // The IPv4 CIDR block used for the destination match. DestinationCidrBlock *string `locationName:"destinationCidrBlock" type:"string"` @@ -100586,6 +101361,12 @@ func (s Route) GoString() string { return s.String() } +// SetCarrierGatewayId sets the CarrierGatewayId field's value. +func (s *Route) SetCarrierGatewayId(v string) *Route { + s.CarrierGatewayId = &v + return s +} + // SetDestinationCidrBlock sets the DestinationCidrBlock field's value. func (s *Route) SetDestinationCidrBlock(v string) *Route { s.DestinationCidrBlock = &v @@ -110853,8 +111634,7 @@ type Vpc struct { // Information about the IPv4 CIDR blocks associated with the VPC. CidrBlockAssociationSet []*VpcCidrBlockAssociation `locationName:"cidrBlockAssociationSet" locationNameList:"item" type:"list"` - // The ID of the set of DHCP options you've associated with the VPC (or default - // if the default options are associated with the VPC). + // The ID of the set of DHCP options you've associated with the VPC. DhcpOptionsId *string `locationName:"dhcpOptionsId" type:"string"` // The allowed tenancy of instances launched into the VPC. @@ -111363,7 +112143,8 @@ type VpcIpv6CidrBlockAssociation struct { // The ID of the IPv6 address pool from which the IPv6 CIDR block is allocated. Ipv6Pool *string `locationName:"ipv6Pool" type:"string"` - // The name of the location from which we advertise the IPV6 CIDR block. + // The name of the unique set of Availability Zones, Local Zones, or Wavelength + // Zones from which AWS advertises IP addresses, for example, us-east-1-wl1-bos-wlz-1. NetworkBorderGroup *string `locationName:"networkBorderGroup" type:"string"` } @@ -112611,6 +113392,20 @@ const ( CapacityReservationTenancyDedicated = "dedicated" ) +const ( + // CarrierGatewayStatePending is a CarrierGatewayState enum value + CarrierGatewayStatePending = "pending" + + // CarrierGatewayStateAvailable is a CarrierGatewayState enum value + CarrierGatewayStateAvailable = "available" + + // CarrierGatewayStateDeleting is a CarrierGatewayState enum value + CarrierGatewayStateDeleting = "deleting" + + // CarrierGatewayStateDeleted is a CarrierGatewayState enum value + CarrierGatewayStateDeleted = "deleted" +) + const ( // ClientCertificateRevocationListStatusCodePending is a ClientCertificateRevocationListStatusCode enum value ClientCertificateRevocationListStatusCodePending = "pending" diff --git a/service/ec2/ec2iface/interface.go b/service/ec2/ec2iface/interface.go index 07bcd0ef2e3..d9f51695705 100644 --- a/service/ec2/ec2iface/interface.go +++ b/service/ec2/ec2iface/interface.go @@ -228,6 +228,10 @@ type EC2API interface { CreateCapacityReservationWithContext(aws.Context, *ec2.CreateCapacityReservationInput, ...request.Option) (*ec2.CreateCapacityReservationOutput, error) CreateCapacityReservationRequest(*ec2.CreateCapacityReservationInput) (*request.Request, *ec2.CreateCapacityReservationOutput) + CreateCarrierGateway(*ec2.CreateCarrierGatewayInput) (*ec2.CreateCarrierGatewayOutput, error) + CreateCarrierGatewayWithContext(aws.Context, *ec2.CreateCarrierGatewayInput, ...request.Option) (*ec2.CreateCarrierGatewayOutput, error) + CreateCarrierGatewayRequest(*ec2.CreateCarrierGatewayInput) (*request.Request, *ec2.CreateCarrierGatewayOutput) + CreateClientVpnEndpoint(*ec2.CreateClientVpnEndpointInput) (*ec2.CreateClientVpnEndpointOutput, error) CreateClientVpnEndpointWithContext(aws.Context, *ec2.CreateClientVpnEndpointInput, ...request.Option) (*ec2.CreateClientVpnEndpointOutput, error) CreateClientVpnEndpointRequest(*ec2.CreateClientVpnEndpointInput) (*request.Request, *ec2.CreateClientVpnEndpointOutput) @@ -440,6 +444,10 @@ type EC2API interface { CreateVpnGatewayWithContext(aws.Context, *ec2.CreateVpnGatewayInput, ...request.Option) (*ec2.CreateVpnGatewayOutput, error) CreateVpnGatewayRequest(*ec2.CreateVpnGatewayInput) (*request.Request, *ec2.CreateVpnGatewayOutput) + DeleteCarrierGateway(*ec2.DeleteCarrierGatewayInput) (*ec2.DeleteCarrierGatewayOutput, error) + DeleteCarrierGatewayWithContext(aws.Context, *ec2.DeleteCarrierGatewayInput, ...request.Option) (*ec2.DeleteCarrierGatewayOutput, error) + DeleteCarrierGatewayRequest(*ec2.DeleteCarrierGatewayInput) (*request.Request, *ec2.DeleteCarrierGatewayOutput) + DeleteClientVpnEndpoint(*ec2.DeleteClientVpnEndpointInput) (*ec2.DeleteClientVpnEndpointOutput, error) DeleteClientVpnEndpointWithContext(aws.Context, *ec2.DeleteClientVpnEndpointInput, ...request.Option) (*ec2.DeleteClientVpnEndpointOutput, error) DeleteClientVpnEndpointRequest(*ec2.DeleteClientVpnEndpointInput) (*request.Request, *ec2.DeleteClientVpnEndpointOutput) @@ -686,6 +694,13 @@ type EC2API interface { DescribeCapacityReservationsPages(*ec2.DescribeCapacityReservationsInput, func(*ec2.DescribeCapacityReservationsOutput, bool) bool) error DescribeCapacityReservationsPagesWithContext(aws.Context, *ec2.DescribeCapacityReservationsInput, func(*ec2.DescribeCapacityReservationsOutput, bool) bool, ...request.Option) error + DescribeCarrierGateways(*ec2.DescribeCarrierGatewaysInput) (*ec2.DescribeCarrierGatewaysOutput, error) + DescribeCarrierGatewaysWithContext(aws.Context, *ec2.DescribeCarrierGatewaysInput, ...request.Option) (*ec2.DescribeCarrierGatewaysOutput, error) + DescribeCarrierGatewaysRequest(*ec2.DescribeCarrierGatewaysInput) (*request.Request, *ec2.DescribeCarrierGatewaysOutput) + + DescribeCarrierGatewaysPages(*ec2.DescribeCarrierGatewaysInput, func(*ec2.DescribeCarrierGatewaysOutput, bool) bool) error + DescribeCarrierGatewaysPagesWithContext(aws.Context, *ec2.DescribeCarrierGatewaysInput, func(*ec2.DescribeCarrierGatewaysOutput, bool) bool, ...request.Option) error + DescribeClassicLinkInstances(*ec2.DescribeClassicLinkInstancesInput) (*ec2.DescribeClassicLinkInstancesOutput, error) DescribeClassicLinkInstancesWithContext(aws.Context, *ec2.DescribeClassicLinkInstancesInput, ...request.Option) (*ec2.DescribeClassicLinkInstancesOutput, error) DescribeClassicLinkInstancesRequest(*ec2.DescribeClassicLinkInstancesInput) (*request.Request, *ec2.DescribeClassicLinkInstancesOutput) diff --git a/service/lexmodelbuildingservice/api.go b/service/lexmodelbuildingservice/api.go index 9aff5ee16e5..87573569bf9 100644 --- a/service/lexmodelbuildingservice/api.go +++ b/service/lexmodelbuildingservice/api.go @@ -5288,6 +5288,11 @@ type CreateBotVersionOutput struct { // Comprehend for sentiment analysis. DetectSentiment *bool `locationName:"detectSentiment" type:"boolean"` + // Indicates whether the bot uses the new natural language understanding (NLU) + // model or the original NLU. True indicates that the bot is using the new model, + // otherwise, false. + EnableModelImprovements *bool `locationName:"enableModelImprovements" type:"boolean"` + // If status is FAILED, Amazon Lex provides the reason that it failed to build // the bot. FailureReason *string `locationName:"failureReason" type:"string"` @@ -5374,6 +5379,12 @@ func (s *CreateBotVersionOutput) SetDetectSentiment(v bool) *CreateBotVersionOut return s } +// SetEnableModelImprovements sets the EnableModelImprovements field's value. +func (s *CreateBotVersionOutput) SetEnableModelImprovements(v bool) *CreateBotVersionOutput { + s.EnableModelImprovements = &v + return s +} + // SetFailureReason sets the FailureReason field's value. func (s *CreateBotVersionOutput) SetFailureReason(v string) *CreateBotVersionOutput { s.FailureReason = &v @@ -7314,6 +7325,11 @@ type GetBotOutput struct { // sentiment analysis. DetectSentiment *bool `locationName:"detectSentiment" type:"boolean"` + // Indicates whether the bot uses the new natural language understanding (NLU) + // model or the original NLU. True indicates that the bot is using the new model, + // otherwise, false. + EnableModelImprovements *bool `locationName:"enableModelImprovements" type:"boolean"` + // If status is FAILED, Amazon Lex explains why it failed to build the bot. FailureReason *string `locationName:"failureReason" type:"string"` @@ -7334,6 +7350,14 @@ type GetBotOutput struct { // The name of the bot. Name *string `locationName:"name" min:"2" type:"string"` + // The score that determines where Amazon Lex inserts the AMAZON.FallbackIntent, + // AMAZON.KendraSearchIntent, or both when returning alternative intents in + // a PostContent (https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html) + // or PostText (https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) + // response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted + // if they are configured for the bot. + NluIntentConfidenceThreshold *float64 `locationName:"nluIntentConfidenceThreshold" type:"double"` + // The status of the bot. // // When the status is BUILDING Amazon Lex is building the bot for testing and @@ -7409,6 +7433,12 @@ func (s *GetBotOutput) SetDetectSentiment(v bool) *GetBotOutput { return s } +// SetEnableModelImprovements sets the EnableModelImprovements field's value. +func (s *GetBotOutput) SetEnableModelImprovements(v bool) *GetBotOutput { + s.EnableModelImprovements = &v + return s +} + // SetFailureReason sets the FailureReason field's value. func (s *GetBotOutput) SetFailureReason(v string) *GetBotOutput { s.FailureReason = &v @@ -7445,6 +7475,12 @@ func (s *GetBotOutput) SetName(v string) *GetBotOutput { return s } +// SetNluIntentConfidenceThreshold sets the NluIntentConfidenceThreshold field's value. +func (s *GetBotOutput) SetNluIntentConfidenceThreshold(v float64) *GetBotOutput { + s.NluIntentConfidenceThreshold = &v + return s +} + // SetStatus sets the Status field's value. func (s *GetBotOutput) SetStatus(v string) *GetBotOutput { s.Status = &v @@ -10281,6 +10317,43 @@ type PutBotInput struct { // analysis. If you don't specify detectSentiment, the default is false. DetectSentiment *bool `locationName:"detectSentiment" type:"boolean"` + // Set to true to enable the use of a new natural language understanding (NLU) + // model. Using the new NLU may improve the performance of your bot. + // + // When you set the enableModelImprovements parameter to true you can use the + // nluIntentConfidenceThreshold parameter to configure confidence scores. For + // more information, see Confidence Scores (https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html). + // + // You can only set the enableModelImprovements parameter in certain Regions. + // If you set the parameter to true, your bot will use the new NLU. If you set + // the parameter to false, your bot will continue to use the original NLU. If + // you set the parameter to false after setting it to true, your bot will return + // to the original NLU. + // + // The Regions where you can set the enableModelImprovements parameter to true + // are: + // + // * US East (N. Virginia) (us-east-1) + // + // * US West (Oregon) (us-west-2) + // + // * Asia Pacific (Sydney) (ap-southeast-2) + // + // * EU (Ireland) (eu-west-1) + // + // In other Regions, the enableModelImprovements parameter is set to true by + // default. In these Regions setting the parameter to false throws a ValidationException + // exception. + // + // * Asia Pacific (Singapore) (ap-southeast-1) + // + // * Asia Pacific (Tokyo) (ap-northeast-1) + // + // * EU (Frankfurt) (eu-central-1) + // + // * EU (London) (eu-west-2) + EnableModelImprovements *bool `locationName:"enableModelImprovements" type:"boolean"` + // The maximum time in seconds that Amazon Lex retains the data gathered in // a conversation. // @@ -10318,6 +10391,30 @@ type PutBotInput struct { // Name is a required field Name *string `location:"uri" locationName:"name" min:"2" type:"string" required:"true"` + // Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, + // AMAZON.KendraSearchIntent, or both when returning alternative intents in + // a PostContent (https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html) + // or PostText (https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) + // response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted + // if they are configured for the bot. + // + // You must set the enableModelImprovements parameter to true to use confidence + // scores. + // + // For example, suppose a bot is configured with the confidence threshold of + // 0.80 and the AMAZON.FallbackIntent. Amazon Lex returns three alternative + // intents with the following confidence scores: IntentA (0.70), IntentB (0.60), + // IntentC (0.50). The response from the PostText operation would be: + // + // * AMAZON.FallbackIntent + // + // * IntentA + // + // * IntentB + // + // * IntentC + NluIntentConfidenceThreshold *float64 `locationName:"nluIntentConfidenceThreshold" type:"double"` + // If you set the processBehavior element to BUILD, Amazon Lex builds the bot // so that it can be run. If you set the element to SAVE Amazon Lex saves the // bot, but doesn't build it. @@ -10444,6 +10541,12 @@ func (s *PutBotInput) SetDetectSentiment(v bool) *PutBotInput { return s } +// SetEnableModelImprovements sets the EnableModelImprovements field's value. +func (s *PutBotInput) SetEnableModelImprovements(v bool) *PutBotInput { + s.EnableModelImprovements = &v + return s +} + // SetIdleSessionTTLInSeconds sets the IdleSessionTTLInSeconds field's value. func (s *PutBotInput) SetIdleSessionTTLInSeconds(v int64) *PutBotInput { s.IdleSessionTTLInSeconds = &v @@ -10468,6 +10571,12 @@ func (s *PutBotInput) SetName(v string) *PutBotInput { return s } +// SetNluIntentConfidenceThreshold sets the NluIntentConfidenceThreshold field's value. +func (s *PutBotInput) SetNluIntentConfidenceThreshold(v float64) *PutBotInput { + s.NluIntentConfidenceThreshold = &v + return s +} + // SetProcessBehavior sets the ProcessBehavior field's value. func (s *PutBotInput) SetProcessBehavior(v string) *PutBotInput { s.ProcessBehavior = &v @@ -10541,6 +10650,11 @@ type PutBotOutput struct { // the request, the detectSentiment field is false in the response. DetectSentiment *bool `locationName:"detectSentiment" type:"boolean"` + // Indicates whether the bot uses the new natural language understanding (NLU) + // model or the original NLU. True indicates that the bot is using the new model, + // otherwise, false. + EnableModelImprovements *bool `locationName:"enableModelImprovements" type:"boolean"` + // If status is FAILED, Amazon Lex provides the reason that it failed to build // the bot. FailureReason *string `locationName:"failureReason" type:"string"` @@ -10562,6 +10676,14 @@ type PutBotOutput struct { // The name of the bot. Name *string `locationName:"name" min:"2" type:"string"` + // The score that determines where Amazon Lex inserts the AMAZON.FallbackIntent, + // AMAZON.KendraSearchIntent, or both when returning alternative intents in + // a PostContent (https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostContent.html) + // or PostText (https://docs.aws.amazon.com/lex/latest/dg/API_runtime_PostText.html) + // response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted + // if they are configured for the bot. + NluIntentConfidenceThreshold *float64 `locationName:"nluIntentConfidenceThreshold" type:"double"` + // When you send a request to create a bot with processBehavior set to BUILD, // Amazon Lex sets the status response element to BUILDING. // @@ -10647,6 +10769,12 @@ func (s *PutBotOutput) SetDetectSentiment(v bool) *PutBotOutput { return s } +// SetEnableModelImprovements sets the EnableModelImprovements field's value. +func (s *PutBotOutput) SetEnableModelImprovements(v bool) *PutBotOutput { + s.EnableModelImprovements = &v + return s +} + // SetFailureReason sets the FailureReason field's value. func (s *PutBotOutput) SetFailureReason(v string) *PutBotOutput { s.FailureReason = &v @@ -10683,6 +10811,12 @@ func (s *PutBotOutput) SetName(v string) *PutBotOutput { return s } +// SetNluIntentConfidenceThreshold sets the NluIntentConfidenceThreshold field's value. +func (s *PutBotOutput) SetNluIntentConfidenceThreshold(v float64) *PutBotOutput { + s.NluIntentConfidenceThreshold = &v + return s +} + // SetStatus sets the Status field's value. func (s *PutBotOutput) SetStatus(v string) *PutBotOutput { s.Status = &v diff --git a/service/lexruntimeservice/api.go b/service/lexruntimeservice/api.go index daec9409296..f68a79cb60e 100644 --- a/service/lexruntimeservice/api.go +++ b/service/lexruntimeservice/api.go @@ -1378,6 +1378,33 @@ func (s *GetSessionOutput) SetSessionId(v string) *GetSessionOutput { return s } +// Provides a score that indicates the confidence that Amazon Lex has that an +// intent is the one that satisfies the user's intent. +type IntentConfidence struct { + _ struct{} `type:"structure"` + + // A score that indicates how confident Amazon Lex is that an intent satisfies + // the user's intent. Ranges between 0.00 and 1.00. Higher scores indicate higher + // confidence. + Score *float64 `locationName:"score" type:"double"` +} + +// String returns the string representation +func (s IntentConfidence) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s IntentConfidence) GoString() string { + return s.String() +} + +// SetScore sets the Score field's value. +func (s *IntentConfidence) SetScore(v float64) *IntentConfidence { + s.Score = &v + return s +} + // Provides information about the state of an intent. You can use this information // to get the current state of an intent so that you can process the intent, // or so that you can return the intent to its previous state. @@ -2010,6 +2037,13 @@ func (s *PostContentInput) SetUserId(v string) *PostContentInput { type PostContentOutput struct { _ struct{} `type:"structure" payload:"AudioStream"` + // One to four alternative intents that may be applicable to the user's intent. + // + // Each alternative includes a score that indicates how confident Amazon Lex + // is that the intent matches the user's intent. The intents are sorted by the + // confidence score. + AlternativeIntents aws.JSONValue `location:"header" locationName:"x-amz-lex-alternative-intents" type:"jsonvalue"` + // The prompt (or statement) to convey to the user. This is based on the bot // configuration and context. For example, if Amazon Lex did not understand // the user intent, it sends the clarificationPrompt configured for the bot. @@ -2019,6 +2053,19 @@ type PostContentOutput struct { // to the user. Then Amazon Lex sends that message in the response. AudioStream io.ReadCloser `locationName:"audioStream" type:"blob"` + // The version of the bot that responded to the conversation. You can use this + // information to help determine if one version of a bot is performing better + // than another version. + // + // If you have enabled the new natural language understanding (NLU) model, you + // can use this to determine if the improvement is due to changes to the bot + // or changes to the NLU. + // + // For more information about enabling the new NLU, see the enableModelImprovements + // (https://docs.aws.amazon.com/lex/latest/dg/API_PutBot.html#lex-PutBot-request-enableModelImprovements) + // parameter of the PutBot operation. + BotVersion *string `location:"header" locationName:"x-amz-lex-bot-version" min:"1" type:"string"` + // Content type as specified in the Accept HTTP header in the request. ContentType *string `location:"header" locationName:"Content-Type" type:"string"` @@ -2102,7 +2149,15 @@ type PostContentOutput struct { // intent was created. MessageFormat *string `location:"header" locationName:"x-amz-lex-message-format" type:"string" enum:"MessageFormatType"` - // The sentiment expressed in and utterance. + // Provides a score that indicates how confident Amazon Lex is that the returned + // intent is the one that matches the user's intent. The score is between 0.0 + // and 1.0. + // + // The score is a relative score, not an absolute score. The score may change + // based on improvements to the Amazon Lex NLU. + NluIntentConfidence aws.JSONValue `location:"header" locationName:"x-amz-lex-nlu-intent-confidence" type:"jsonvalue"` + + // The sentiment expressed in an utterance. // // When the bot is configured to send utterances to Amazon Comprehend for sentiment // analysis, this field contains the result of the analysis. @@ -2142,12 +2197,24 @@ func (s PostContentOutput) GoString() string { return s.String() } +// SetAlternativeIntents sets the AlternativeIntents field's value. +func (s *PostContentOutput) SetAlternativeIntents(v aws.JSONValue) *PostContentOutput { + s.AlternativeIntents = v + return s +} + // SetAudioStream sets the AudioStream field's value. func (s *PostContentOutput) SetAudioStream(v io.ReadCloser) *PostContentOutput { s.AudioStream = v return s } +// SetBotVersion sets the BotVersion field's value. +func (s *PostContentOutput) SetBotVersion(v string) *PostContentOutput { + s.BotVersion = &v + return s +} + // SetContentType sets the ContentType field's value. func (s *PostContentOutput) SetContentType(v string) *PostContentOutput { s.ContentType = &v @@ -2184,6 +2251,12 @@ func (s *PostContentOutput) SetMessageFormat(v string) *PostContentOutput { return s } +// SetNluIntentConfidence sets the NluIntentConfidence field's value. +func (s *PostContentOutput) SetNluIntentConfidence(v aws.JSONValue) *PostContentOutput { + s.NluIntentConfidence = v + return s +} + // SetSentimentResponse sets the SentimentResponse field's value. func (s *PostContentOutput) SetSentimentResponse(v string) *PostContentOutput { s.SentimentResponse = &v @@ -2356,6 +2429,26 @@ func (s *PostTextInput) SetUserId(v string) *PostTextInput { type PostTextOutput struct { _ struct{} `type:"structure"` + // One to four alternative intents that may be applicable to the user's intent. + // + // Each alternative includes a score that indicates how confident Amazon Lex + // is that the intent matches the user's intent. The intents are sorted by the + // confidence score. + AlternativeIntents []*PredictedIntent `locationName:"alternativeIntents" type:"list"` + + // The version of the bot that responded to the conversation. You can use this + // information to help determine if one version of a bot is performing better + // than another version. + // + // If you have enabled the new natural language understanding (NLU) model, you + // can use this to determine if the improvement is due to changes to the bot + // or changes to the NLU. + // + // For more information about enabling the new NLU, see the enableModelImprovements + // (https://docs.aws.amazon.com/lex/latest/dg/API_PutBot.html#lex-PutBot-request-enableModelImprovements) + // parameter of the PutBot operation. + BotVersion *string `locationName:"botVersion" min:"1" type:"string"` + // Identifies the current state of the user interaction. Amazon Lex returns // one of the following values as dialogState. The client can optionally use // this information to customize the user interface. @@ -2429,6 +2522,15 @@ type PostTextOutput struct { // intent was created. MessageFormat *string `locationName:"messageFormat" type:"string" enum:"MessageFormatType"` + // Provides a score that indicates how confident Amazon Lex is that the returned + // intent is the one that matches the user's intent. The score is between 0.0 + // and 1.0. For more information, see Confidence Scores (https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html). + // + // The score is a relative score, not an absolute score. The score may change + // based on improvements to the Amazon Lex natural language understanding (NLU) + // model. + NluIntentConfidence *IntentConfidence `locationName:"nluIntentConfidence" type:"structure"` + // Represents the options that the user has to respond to the current prompt. // Response Card can come from the bot configuration (in the Amazon Lex console, // choose the settings button next to a slot) or from a code hook (Lambda function). @@ -2473,6 +2575,18 @@ func (s PostTextOutput) GoString() string { return s.String() } +// SetAlternativeIntents sets the AlternativeIntents field's value. +func (s *PostTextOutput) SetAlternativeIntents(v []*PredictedIntent) *PostTextOutput { + s.AlternativeIntents = v + return s +} + +// SetBotVersion sets the BotVersion field's value. +func (s *PostTextOutput) SetBotVersion(v string) *PostTextOutput { + s.BotVersion = &v + return s +} + // SetDialogState sets the DialogState field's value. func (s *PostTextOutput) SetDialogState(v string) *PostTextOutput { s.DialogState = &v @@ -2497,6 +2611,12 @@ func (s *PostTextOutput) SetMessageFormat(v string) *PostTextOutput { return s } +// SetNluIntentConfidence sets the NluIntentConfidence field's value. +func (s *PostTextOutput) SetNluIntentConfidence(v *IntentConfidence) *PostTextOutput { + s.NluIntentConfidence = v + return s +} + // SetResponseCard sets the ResponseCard field's value. func (s *PostTextOutput) SetResponseCard(v *ResponseCard) *PostTextOutput { s.ResponseCard = v @@ -2533,6 +2653,51 @@ func (s *PostTextOutput) SetSlots(v map[string]*string) *PostTextOutput { return s } +// An intent that Amazon Lex suggests satisfies the user's intent. Includes +// the name of the intent, the confidence that Amazon Lex has that the user's +// intent is satisfied, and the slots defined for the intent. +type PredictedIntent struct { + _ struct{} `type:"structure"` + + // The name of the intent that Amazon Lex suggests satisfies the user's intent. + IntentName *string `locationName:"intentName" type:"string"` + + // Indicates how confident Amazon Lex is that an intent satisfies the user's + // intent. + NluIntentConfidence *IntentConfidence `locationName:"nluIntentConfidence" type:"structure"` + + // The slot and slot values associated with the predicted intent. + Slots map[string]*string `locationName:"slots" type:"map" sensitive:"true"` +} + +// String returns the string representation +func (s PredictedIntent) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s PredictedIntent) GoString() string { + return s.String() +} + +// SetIntentName sets the IntentName field's value. +func (s *PredictedIntent) SetIntentName(v string) *PredictedIntent { + s.IntentName = &v + return s +} + +// SetNluIntentConfidence sets the NluIntentConfidence field's value. +func (s *PredictedIntent) SetNluIntentConfidence(v *IntentConfidence) *PredictedIntent { + s.NluIntentConfidence = v + return s +} + +// SetSlots sets the Slots field's value. +func (s *PredictedIntent) SetSlots(v map[string]*string) *PredictedIntent { + s.Slots = v + return s +} + type PutSessionInput struct { _ struct{} `type:"structure"` diff --git a/service/personalize/api.go b/service/personalize/api.go index 958551035d5..529049077c4 100644 --- a/service/personalize/api.go +++ b/service/personalize/api.go @@ -534,7 +534,9 @@ func (c *Personalize) CreateDatasetImportJobRequest(input *CreateDatasetImportJo // Creates a job that imports training data from your data source (an Amazon // S3 bucket) to an Amazon Personalize dataset. To allow Amazon Personalize // to import the training data, you must specify an AWS Identity and Access -// Management (IAM) role that has permission to read from the data source. +// Management (IAM) role that has permission to read from the data source, as +// Amazon Personalize makes a copy of your data and processes it in an internal +// AWS system. // // The dataset import job replaces any previous data in the dataset. // @@ -772,7 +774,7 @@ func (c *Personalize) CreateFilterRequest(input *CreateFilterInput) (req *reques // CreateFilter API operation for Amazon Personalize. // // Creates a recommendation filter. For more information, see Using Filters -// with Amazon Personalize. +// with Amazon Personalize (https://docs.aws.amazon.com/personalize/latest/dg/filters.html). // // 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 @@ -1135,6 +1137,9 @@ func (c *Personalize) CreateSolutionVersionRequest(input *CreateSolutionVersionI // * ResourceNotFoundException // Could not find the specified resource. // +// * LimitExceededException +// The limit on the number of requests per second has been exceeded. +// // * ResourceInUseException // The specified resource is in use. // @@ -1579,6 +1584,9 @@ func (c *Personalize) DeleteFilterRequest(input *DeleteFilterInput) (req *reques // * ResourceNotFoundException // Could not find the specified resource. // +// * ResourceInUseException +// The specified resource is in use. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DeleteFilter func (c *Personalize) DeleteFilter(input *DeleteFilterInput) (*DeleteFilterOutput, error) { req, out := c.DeleteFilterRequest(input) @@ -4767,6 +4775,10 @@ type BatchInferenceJob struct { // The Amazon Resource Name (ARN) of the batch inference job. BatchInferenceJobArn *string `locationName:"batchInferenceJobArn" type:"string"` + // A string to string map of the configuration details of a batch inference + // job. + BatchInferenceJobConfig *BatchInferenceJobConfig `locationName:"batchInferenceJobConfig" type:"structure"` + // The time at which the batch inference job was created. CreationDateTime *time.Time `locationName:"creationDateTime" type:"timestamp"` @@ -4831,6 +4843,12 @@ func (s *BatchInferenceJob) SetBatchInferenceJobArn(v string) *BatchInferenceJob return s } +// SetBatchInferenceJobConfig sets the BatchInferenceJobConfig field's value. +func (s *BatchInferenceJob) SetBatchInferenceJobConfig(v *BatchInferenceJobConfig) *BatchInferenceJob { + s.BatchInferenceJobConfig = v + return s +} + // SetCreationDateTime sets the CreationDateTime field's value. func (s *BatchInferenceJob) SetCreationDateTime(v time.Time) *BatchInferenceJob { s.CreationDateTime = &v @@ -4897,6 +4915,31 @@ func (s *BatchInferenceJob) SetStatus(v string) *BatchInferenceJob { return s } +// The configuration details of a batch inference job. +type BatchInferenceJobConfig struct { + _ struct{} `type:"structure"` + + // A string to string map specifying the inference hyperparameters you wish + // to use for hyperparameter optimization. See customizing-solution-config-hpo. + ItemExplorationConfig map[string]*string `locationName:"itemExplorationConfig" type:"map"` +} + +// String returns the string representation +func (s BatchInferenceJobConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s BatchInferenceJobConfig) GoString() string { + return s.String() +} + +// SetItemExplorationConfig sets the ItemExplorationConfig field's value. +func (s *BatchInferenceJobConfig) SetItemExplorationConfig(v map[string]*string) *BatchInferenceJobConfig { + s.ItemExplorationConfig = v + return s +} + // The input configuration of a batch inference job. type BatchInferenceJobInput struct { _ struct{} `type:"structure"` @@ -5083,6 +5126,9 @@ type Campaign struct { // The Amazon Resource Name (ARN) of the campaign. CampaignArn *string `locationName:"campaignArn" type:"string"` + // The configuration details of a campaign. + CampaignConfig *CampaignConfig `locationName:"campaignConfig" type:"structure"` + // The date and time (in Unix format) that the campaign was created. CreationDateTime *time.Time `locationName:"creationDateTime" type:"timestamp"` @@ -5132,6 +5178,12 @@ func (s *Campaign) SetCampaignArn(v string) *Campaign { return s } +// SetCampaignConfig sets the CampaignConfig field's value. +func (s *Campaign) SetCampaignConfig(v *CampaignConfig) *Campaign { + s.CampaignConfig = v + return s +} + // SetCreationDateTime sets the CreationDateTime field's value. func (s *Campaign) SetCreationDateTime(v time.Time) *Campaign { s.CreationDateTime = &v @@ -5180,6 +5232,31 @@ func (s *Campaign) SetStatus(v string) *Campaign { return s } +// The configuration details of a campaign. +type CampaignConfig struct { + _ struct{} `type:"structure"` + + // A string to string map specifying the inference hyperparameters you wish + // to use for hyperparameter optimization. See customizing-solution-config-hpo. + ItemExplorationConfig map[string]*string `locationName:"itemExplorationConfig" type:"map"` +} + +// String returns the string representation +func (s CampaignConfig) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CampaignConfig) GoString() string { + return s.String() +} + +// SetItemExplorationConfig sets the ItemExplorationConfig field's value. +func (s *CampaignConfig) SetItemExplorationConfig(v map[string]*string) *CampaignConfig { + s.ItemExplorationConfig = v + return s +} + // Provides a summary of the properties of a campaign. For a complete listing, // call the DescribeCampaign API. type CampaignSummary struct { @@ -5261,6 +5338,9 @@ func (s *CampaignSummary) SetStatus(v string) *CampaignSummary { type CampaignUpdateSummary struct { _ struct{} `type:"structure"` + // The configuration details of a campaign. + CampaignConfig *CampaignConfig `locationName:"campaignConfig" type:"structure"` + // The date and time (in Unix time) that the campaign update was created. CreationDateTime *time.Time `locationName:"creationDateTime" type:"timestamp"` @@ -5297,6 +5377,12 @@ func (s CampaignUpdateSummary) GoString() string { return s.String() } +// SetCampaignConfig sets the CampaignConfig field's value. +func (s *CampaignUpdateSummary) SetCampaignConfig(v *CampaignConfig) *CampaignUpdateSummary { + s.CampaignConfig = v + return s +} + // SetCreationDateTime sets the CreationDateTime field's value. func (s *CampaignUpdateSummary) SetCreationDateTime(v time.Time) *CampaignUpdateSummary { s.CreationDateTime = &v @@ -5427,6 +5513,9 @@ func (s *ContinuousHyperParameterRange) SetName(v string) *ContinuousHyperParame type CreateBatchInferenceJobInput struct { _ struct{} `type:"structure"` + // The configuration details of a batch inference job. + BatchInferenceJobConfig *BatchInferenceJobConfig `locationName:"batchInferenceJobConfig" type:"structure"` + // The ARN of the filter to apply to the batch inference job. For more information // on using filters, see Using Filters with Amazon Personalize. FilterArn *string `locationName:"filterArn" type:"string"` @@ -5511,6 +5600,12 @@ func (s *CreateBatchInferenceJobInput) Validate() error { return nil } +// SetBatchInferenceJobConfig sets the BatchInferenceJobConfig field's value. +func (s *CreateBatchInferenceJobInput) SetBatchInferenceJobConfig(v *BatchInferenceJobConfig) *CreateBatchInferenceJobInput { + s.BatchInferenceJobConfig = v + return s +} + // SetFilterArn sets the FilterArn field's value. func (s *CreateBatchInferenceJobInput) SetFilterArn(v string) *CreateBatchInferenceJobInput { s.FilterArn = &v @@ -5579,6 +5674,9 @@ func (s *CreateBatchInferenceJobOutput) SetBatchInferenceJobArn(v string) *Creat type CreateCampaignInput struct { _ struct{} `type:"structure"` + // The configuration details of a campaign. + CampaignConfig *CampaignConfig `locationName:"campaignConfig" type:"structure"` + // Specifies the requested minimum provisioned transactions (recommendations) // per second that Amazon Personalize will support. // @@ -5632,6 +5730,12 @@ func (s *CreateCampaignInput) Validate() error { return nil } +// SetCampaignConfig sets the CampaignConfig field's value. +func (s *CreateCampaignInput) SetCampaignConfig(v *CampaignConfig) *CreateCampaignInput { + s.CampaignConfig = v + return s +} + // SetMinProvisionedTPS sets the MinProvisionedTPS field's value. func (s *CreateCampaignInput) SetMinProvisionedTPS(v int64) *CreateCampaignInput { s.MinProvisionedTPS = &v @@ -6083,7 +6187,7 @@ type CreateFilterInput struct { // // Where "EVENT_TYPE" is the type of event to filter out. To filter out all // items with any interactions history, set "*" as the EVENT_TYPE. For more - // information, see Using Filters with Amazon Personalize. + // information, see Using Filters with Amazon Personalize (https://docs.aws.amazon.com/personalize/latest/dg/filters.html). // // FilterExpression is a required field FilterExpression *string `locationName:"filterExpression" min:"1" type:"string" required:"true" sensitive:"true"` @@ -8773,7 +8877,7 @@ type Filter struct { // EXCLUDE itemId WHERE INTERACTIONS.event_type in ("EVENT_TYPE") // // Where "EVENT_TYPE" is the type of event to filter out. For more information, - // see Using Filters with Amazon Personalize. + // see Using Filters with Amazon Personalize (https://docs.aws.amazon.com/personalize/latest/dg/filters.html). FilterExpression *string `locationName:"filterExpression" min:"1" type:"string" sensitive:"true"` // The time at which the filter was last updated. @@ -11317,6 +11421,9 @@ type UpdateCampaignInput struct { // CampaignArn is a required field CampaignArn *string `locationName:"campaignArn" type:"string" required:"true"` + // The configuration details of a campaign. + CampaignConfig *CampaignConfig `locationName:"campaignConfig" type:"structure"` + // Specifies the requested minimum provisioned transactions (recommendations) // per second that Amazon Personalize will support. MinProvisionedTPS *int64 `locationName:"minProvisionedTPS" min:"1" type:"integer"` @@ -11357,6 +11464,12 @@ func (s *UpdateCampaignInput) SetCampaignArn(v string) *UpdateCampaignInput { return s } +// SetCampaignConfig sets the CampaignConfig field's value. +func (s *UpdateCampaignInput) SetCampaignConfig(v *CampaignConfig) *UpdateCampaignInput { + s.CampaignConfig = v + return s +} + // SetMinProvisionedTPS sets the MinProvisionedTPS field's value. func (s *UpdateCampaignInput) SetMinProvisionedTPS(v int64) *UpdateCampaignInput { s.MinProvisionedTPS = &v diff --git a/service/personalizeevents/api.go b/service/personalizeevents/api.go index 854f7496033..57bc448c1ae 100644 --- a/service/personalizeevents/api.go +++ b/service/personalizeevents/api.go @@ -58,7 +58,7 @@ func (c *PersonalizeEvents) PutEventsRequest(input *PutEventsInput) (req *reques // PutEvents API operation for Amazon Personalize Events. // -// Records user interaction event data. +// Records user interaction event data. For more information see event-record-api. // // 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 @@ -110,28 +110,36 @@ type Event struct { // EventType is a required field EventType *string `locationName:"eventType" min:"1" type:"string" required:"true"` + // The event value that corresponds to the EVENT_VALUE field of the Interactions + // schema. + EventValue *float64 `locationName:"eventValue" type:"float"` + + // A list of item IDs that represents the sequence of items you have shown the + // user. For example, ["itemId1", "itemId2", "itemId3"]. + Impression []*string `locationName:"impression" min:"1" type:"list"` + + // The item ID key that corresponds to the ITEM_ID field of the Interactions + // schema. + ItemId *string `locationName:"itemId" min:"1" type:"string"` + // A string map of event-specific data that you might choose to record. For - // example, if a user rates a movie on your site, you might send the movie ID - // and rating, and the number of movie ratings made by the user. + // example, if a user rates a movie on your site, other than movie ID (itemId) + // and rating (eventValue) , you might also send the number of movie ratings + // made by the user. // // Each item in the map consists of a key-value pair. For example, // - // {"itemId": "movie1"} - // - // {"itemId": "movie2", "eventValue": "4.5"} - // - // {"itemId": "movie3", "eventValue": "3", "numberOfRatings": "12"} + // {"numberOfRatings": "12"} // // The keys use camel case names that match the fields in the Interactions schema. - // The itemId and eventValue keys correspond to the ITEM_ID and EVENT_VALUE - // fields. In the above example, the eventType might be 'MovieRating' with eventValue - // being the rating. The numberOfRatings would match the 'NUMBER_OF_RATINGS' + // In the above example, the numberOfRatings would match the 'NUMBER_OF_RATINGS' // field defined in the Interactions schema. - // - // Properties is a required field - Properties aws.JSONValue `locationName:"properties" type:"jsonvalue" required:"true"` + Properties aws.JSONValue `locationName:"properties" type:"jsonvalue"` - // The timestamp on the client side when the event occurred. + // The ID of the recommendation. + RecommendationId *string `locationName:"recommendationId" min:"1" type:"string"` + + // The timestamp (in Unix time) on the client side when the event occurred. // // SentAt is a required field SentAt *time.Time `locationName:"sentAt" type:"timestamp" required:"true"` @@ -159,8 +167,14 @@ func (s *Event) Validate() error { if s.EventType != nil && len(*s.EventType) < 1 { invalidParams.Add(request.NewErrParamMinLen("EventType", 1)) } - if s.Properties == nil { - invalidParams.Add(request.NewErrParamRequired("Properties")) + if s.Impression != nil && len(s.Impression) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Impression", 1)) + } + if s.ItemId != nil && len(*s.ItemId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ItemId", 1)) + } + if s.RecommendationId != nil && len(*s.RecommendationId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("RecommendationId", 1)) } if s.SentAt == nil { invalidParams.Add(request.NewErrParamRequired("SentAt")) @@ -184,12 +198,36 @@ func (s *Event) SetEventType(v string) *Event { return s } +// SetEventValue sets the EventValue field's value. +func (s *Event) SetEventValue(v float64) *Event { + s.EventValue = &v + return s +} + +// SetImpression sets the Impression field's value. +func (s *Event) SetImpression(v []*string) *Event { + s.Impression = v + return s +} + +// SetItemId sets the ItemId field's value. +func (s *Event) SetItemId(v string) *Event { + s.ItemId = &v + return s +} + // SetProperties sets the Properties field's value. func (s *Event) SetProperties(v aws.JSONValue) *Event { s.Properties = v return s } +// SetRecommendationId sets the RecommendationId field's value. +func (s *Event) SetRecommendationId(v string) *Event { + s.RecommendationId = &v + return s +} + // SetSentAt sets the SentAt field's value. func (s *Event) SetSentAt(v time.Time) *Event { s.SentAt = &v @@ -260,7 +298,10 @@ type PutEventsInput struct { // EventList is a required field EventList []*Event `locationName:"eventList" min:"1" type:"list" required:"true"` - // The session ID associated with the user's visit. + // The session ID associated with the user's visit. Your application generates + // the sessionId when a user first visits your website or uses your application. + // Amazon Personalize uses the sessionId to associate events with the user before + // they log in. For more information see event-record-api. // // SessionId is a required field SessionId *string `locationName:"sessionId" min:"1" type:"string" required:"true"` diff --git a/service/personalizeevents/doc.go b/service/personalizeevents/doc.go index e8343675aef..959056163a3 100644 --- a/service/personalizeevents/doc.go +++ b/service/personalizeevents/doc.go @@ -3,6 +3,10 @@ // Package personalizeevents provides the client and types for making API // requests to Amazon Personalize Events. // +// Amazon Personalize can consume real-time user event data, such as stream +// or click data, and use it for model training either alone or combined with +// historical data. For more information see recording-events. +// // See https://docs.aws.amazon.com/goto/WebAPI/personalize-events-2018-03-22 for more information on this service. // // See personalizeevents package documentation for more information. diff --git a/service/personalizeruntime/api.go b/service/personalizeruntime/api.go index fea41d482bd..1c1ddb924f5 100644 --- a/service/personalizeruntime/api.go +++ b/service/personalizeruntime/api.go @@ -283,6 +283,9 @@ type GetPersonalizedRankingOutput struct { // A list of items in order of most likely interest to the user. The maximum // is 500. PersonalizedRanking []*PredictedItem `locationName:"personalizedRanking" type:"list"` + + // The ID of the recommendation. + RecommendationId *string `locationName:"recommendationId" type:"string"` } // String returns the string representation @@ -301,6 +304,12 @@ func (s *GetPersonalizedRankingOutput) SetPersonalizedRanking(v []*PredictedItem return s } +// SetRecommendationId sets the RecommendationId field's value. +func (s *GetPersonalizedRankingOutput) SetRecommendationId(v string) *GetPersonalizedRankingOutput { + s.RecommendationId = &v + return s +} + type GetRecommendationsInput struct { _ struct{} `type:"structure"` @@ -399,6 +408,9 @@ type GetRecommendationsOutput struct { // A list of recommendations sorted in ascending order by prediction score. // There can be a maximum of 500 items in the list. ItemList []*PredictedItem `locationName:"itemList" type:"list"` + + // The ID of the recommendation. + RecommendationId *string `locationName:"recommendationId" type:"string"` } // String returns the string representation @@ -417,6 +429,12 @@ func (s *GetRecommendationsOutput) SetItemList(v []*PredictedItem) *GetRecommend return s } +// SetRecommendationId sets the RecommendationId field's value. +func (s *GetRecommendationsOutput) SetRecommendationId(v string) *GetRecommendationsOutput { + s.RecommendationId = &v + return s +} + // Provide a valid value for the field or parameter. type InvalidInputException struct { _ struct{} `type:"structure"`