aws_sdk_ec2/client/
associate_nat_gateway_address.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`AssociateNatGatewayAddress`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`nat_gateway_id(impl Into<String>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::nat_gateway_id) / [`set_nat_gateway_id(Option<String>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::set_nat_gateway_id):<br>required: **true**<br><p>The ID of the NAT gateway.</p><br>
7    ///   - [`allocation_ids(impl Into<String>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::allocation_ids) / [`set_allocation_ids(Option<Vec::<String>>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::set_allocation_ids):<br>required: **true**<br><p>The allocation IDs of EIPs that you want to associate with your NAT gateway.</p><br>
8    ///   - [`private_ip_addresses(impl Into<String>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::private_ip_addresses) / [`set_private_ip_addresses(Option<Vec::<String>>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::set_private_ip_addresses):<br>required: **false**<br><p>The private IPv4 addresses that you want to assign to the NAT gateway.</p><br>
9    ///   - [`dry_run(bool)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::dry_run) / [`set_dry_run(Option<bool>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::set_dry_run):<br>required: **false**<br><p>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 <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p><br>
10    ///   - [`availability_zone(impl Into<String>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::availability_zone) / [`set_availability_zone(Option<String>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::set_availability_zone):<br>required: **false**<br><p>For regional NAT gateways only: The Availability Zone where you want to associate an Elastic IP address (EIP). The regional NAT gateway uses a separate EIP in each AZ to handle outbound NAT traffic from that AZ.</p> <p>A regional NAT gateway is a single NAT Gateway that works across multiple availability zones (AZs) in your VPC, providing redundancy, scalability and availability across all the AZs in a Region.</p><br>
11    ///   - [`availability_zone_id(impl Into<String>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::availability_zone_id) / [`set_availability_zone_id(Option<String>)`](crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::set_availability_zone_id):<br>required: **false**<br><p>For regional NAT gateways only: The ID of the Availability Zone where you want to associate an Elastic IP address (EIP). The regional NAT gateway uses a separate EIP in each AZ to handle outbound NAT traffic from that AZ. Use this instead of AvailabilityZone for consistent identification of AZs across Amazon Web Services Regions.</p> <p>A regional NAT gateway is a single NAT Gateway that works across multiple availability zones (AZs) in your VPC, providing redundancy, scalability and availability across all the AZs in a Region.</p><br>
12    /// - On success, responds with [`AssociateNatGatewayAddressOutput`](crate::operation::associate_nat_gateway_address::AssociateNatGatewayAddressOutput) with field(s):
13    ///   - [`nat_gateway_id(Option<String>)`](crate::operation::associate_nat_gateway_address::AssociateNatGatewayAddressOutput::nat_gateway_id): <p>The ID of the NAT gateway.</p>
14    ///   - [`nat_gateway_addresses(Option<Vec::<NatGatewayAddress>>)`](crate::operation::associate_nat_gateway_address::AssociateNatGatewayAddressOutput::nat_gateway_addresses): <p>The IP addresses.</p>
15    /// - On failure, responds with [`SdkError<AssociateNatGatewayAddressError>`](crate::operation::associate_nat_gateway_address::AssociateNatGatewayAddressError)
16    pub fn associate_nat_gateway_address(
17        &self,
18    ) -> crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder {
19        crate::operation::associate_nat_gateway_address::builders::AssociateNatGatewayAddressFluentBuilder::new(self.handle.clone())
20    }
21}