feat(client-ec2): Release to allow route table association with a PublicIpv4Pool.

awstools · awstools · commit c62fd1699115 · 2025-08-12T18:12:55.000Z
diff --git a/clients/client-ec2/src/commands/AdvertiseByoipCidrCommand.ts b/clients/client-ec2/src/commands/AdvertiseByoipCidrCommand.ts
@@ -38,7 +38,6 @@ export interface AdvertiseByoipCidrCommandOutput extends AdvertiseByoipCidrResul
  *          location and start advertising it through Amazon Web Services.</p>
  *          <p>It can take a few minutes before traffic to the specified addresses starts routing to Amazon Web Services
  *          because of BGP propagation delays.</p>
- *          <p>To stop advertising the BYOIP CIDR, use <a>WithdrawByoipCidr</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ec2/src/commands/AssociateRouteTableCommand.ts b/clients/client-ec2/src/commands/AssociateRouteTableCommand.ts
@@ -43,6 +43,7 @@ export interface AssociateRouteTableCommandOutput extends AssociateRouteTableRes
  * const client = new EC2Client(config);
  * const input = { // AssociateRouteTableRequest
  *   GatewayId: "STRING_VALUE",
+ *   PublicIpv4Pool: "STRING_VALUE",
  *   DryRun: true || false,
  *   SubnetId: "STRING_VALUE",
  *   RouteTableId: "STRING_VALUE", // required
diff --git a/clients/client-ec2/src/commands/CreateRouteTableCommand.ts b/clients/client-ec2/src/commands/CreateRouteTableCommand.ts
@@ -64,6 +64,7 @@ export interface CreateRouteTableCommandOutput extends CreateRouteTableResult, _
  * //         RouteTableId: "STRING_VALUE",
  * //         SubnetId: "STRING_VALUE",
  * //         GatewayId: "STRING_VALUE",
+ * //         PublicIpv4Pool: "STRING_VALUE",
  * //         AssociationState: { // RouteTableAssociationState
  * //           State: "associating" || "associated" || "disassociating" || "disassociated" || "failed",
  * //           StatusMessage: "STRING_VALUE",
diff --git a/clients/client-ec2/src/commands/DeprovisionByoipCidrCommand.ts b/clients/client-ec2/src/commands/DeprovisionByoipCidrCommand.ts
@@ -30,8 +30,8 @@ export interface DeprovisionByoipCidrCommandOutput extends DeprovisionByoipCidrR
 /**
  * <p>Releases the specified address range that you provisioned for use with your Amazon Web Services resources
  *          through bring your own IP addresses (BYOIP) and deletes the corresponding address pool.</p>
- *          <p>Before you can release an address range, you must stop advertising it using <a>WithdrawByoipCidr</a> and you must not have any IP addresses allocated from its
- *          address range.</p>
+ *          <p>Before you can release an address range, you must stop advertising it and you must not
+ *           have any IP addresses allocated from its address range.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ec2/src/commands/DescribeByoipCidrsCommand.ts b/clients/client-ec2/src/commands/DescribeByoipCidrsCommand.ts
@@ -28,9 +28,8 @@ export interface DescribeByoipCidrsCommandInput extends DescribeByoipCidrsReques
 export interface DescribeByoipCidrsCommandOutput extends DescribeByoipCidrsResult, __MetadataBearer {}
 
 /**
- * <p>Describes the IP address ranges that were specified in calls to <a>ProvisionByoipCidr</a>.</p>
- *          <p>To describe the address pools that were created when you provisioned the address
- *           ranges, use <a>DescribePublicIpv4Pools</a> or <a>DescribeIpv6Pools</a>.</p>
+ * <p>Describes the IP address ranges that were provisioned for use with Amazon Web Services resources
+ *           through through bring your own IP addresses (BYOIP).</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ec2/src/commands/DescribeImagesCommand.ts b/clients/client-ec2/src/commands/DescribeImagesCommand.ts
@@ -41,7 +41,7 @@ export interface DescribeImagesCommandOutput extends DescribeImagesResult, __Met
  *       results, with the <code>imageAllowed</code> field set to <code>true</code> for each image. In
  *         <code>audit-mode</code>, the <code>imageAllowed</code> field is set to <code>true</code> for
  *       images that meet the account's Allowed AMIs criteria, and <code>false</code> for images that
- *       don't meet the criteria. For more information, see <a>EnableAllowedImagesSettings</a>.</p>
+ *       don't meet the criteria. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-allowed-amis.html">Allowed AMIs</a>.</p>
  *          <p>The Amazon EC2 API follows an eventual consistency model. This means that the result of an API
  *       command you run that creates or modifies resources might not be immediately available to all
  *       subsequent commands you run. For guidance on how to manage eventual consistency, see <a href="https://docs.aws.amazon.com/ec2/latest/devguide/eventual-consistency.html">Eventual
diff --git a/clients/client-ec2/src/commands/DescribeManagedPrefixListsCommand.ts b/clients/client-ec2/src/commands/DescribeManagedPrefixListsCommand.ts
@@ -29,7 +29,6 @@ export interface DescribeManagedPrefixListsCommandOutput extends DescribeManaged
 
 /**
  * <p>Describes your managed prefix lists and any Amazon Web Services-managed prefix lists.</p>
- *          <p>To view the entries for your prefix list, use <a>GetManagedPrefixListEntries</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ec2/src/commands/DescribePrefixListsCommand.ts b/clients/client-ec2/src/commands/DescribePrefixListsCommand.ts
@@ -30,7 +30,6 @@ export interface DescribePrefixListsCommandOutput extends DescribePrefixListsRes
 /**
  * <p>Describes available Amazon Web Services services in a prefix list format, which includes the prefix list
  *             name and prefix list ID of the service and the IP address range for the service.</p>
- *          <p>We recommend that you use <a>DescribeManagedPrefixLists</a> instead.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ec2/src/commands/DescribeRouteTablesCommand.ts b/clients/client-ec2/src/commands/DescribeRouteTablesCommand.ts
@@ -68,6 +68,7 @@ export interface DescribeRouteTablesCommandOutput extends DescribeRouteTablesRes
  * //           RouteTableId: "STRING_VALUE",
  * //           SubnetId: "STRING_VALUE",
  * //           GatewayId: "STRING_VALUE",
+ * //           PublicIpv4Pool: "STRING_VALUE",
  * //           AssociationState: { // RouteTableAssociationState
  * //             State: "associating" || "associated" || "disassociating" || "disassociated" || "failed",
  * //             StatusMessage: "STRING_VALUE",
diff --git a/clients/client-ec2/src/commands/EnableImageDeregistrationProtectionCommand.ts b/clients/client-ec2/src/commands/EnableImageDeregistrationProtectionCommand.ts
@@ -38,8 +38,7 @@ export interface EnableImageDeregistrationProtectionCommandOutput
 /**
  * <p>Enables deregistration protection for an AMI. When deregistration protection is enabled,
  *       the AMI can't be deregistered.</p>
- *          <p>To allow the AMI to be deregistered, you must first disable deregistration protection
- *       using <a>DisableImageDeregistrationProtection</a>.</p>
+ *          <p>To allow the AMI to be deregistered, you must first disable deregistration protection.</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deregistration-protection.html">Protect an
  *       Amazon EC2 AMI from deregistration</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
diff --git a/clients/client-ec2/src/commands/MoveAddressToVpcCommand.ts b/clients/client-ec2/src/commands/MoveAddressToVpcCommand.ts
@@ -34,8 +34,7 @@ export interface MoveAddressToVpcCommandOutput extends MoveAddressToVpcResult, _
  *          <p>Moves an Elastic IP address from the EC2-Classic platform to the EC2-VPC platform. The
  *       Elastic IP address must be allocated to your account for more than 24 hours, and it must not
  *       be associated with an instance. After the Elastic IP address is moved, it is no longer
- *       available for use in the EC2-Classic platform, unless you move it back using the
- *         <a>RestoreAddressToClassic</a> request. You cannot move an Elastic IP address that was
+ *       available for use in the EC2-Classic platform. You cannot move an Elastic IP address that was
  *       originally allocated for use in the EC2-VPC platform to the EC2-Classic platform.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-ec2/src/commands/ProvisionByoipCidrCommand.ts b/clients/client-ec2/src/commands/ProvisionByoipCidrCommand.ts
@@ -30,16 +30,14 @@ export interface ProvisionByoipCidrCommandOutput extends ProvisionByoipCidrResul
 /**
  * <p>Provisions an IPv4 or IPv6 address range for use with your Amazon Web Services resources through bring your own IP
  *          addresses (BYOIP) and creates a corresponding address pool. After the address range is
- *          provisioned, it is ready to be advertised using <a>AdvertiseByoipCidr</a>.</p>
+ *          provisioned, it is ready to be advertised.</p>
  *          <p>Amazon Web Services verifies that you own the address range and are authorized to advertise it.
  *          You must ensure that the address range is registered to you and that you created an
  *          RPKI ROA to authorize Amazon ASNs 16509 and 14618 to advertise the address range.
  *          For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html">Bring your own IP addresses (BYOIP)</a> in the <i>Amazon EC2 User Guide</i>.</p>
  *          <p>Provisioning an address range is an asynchronous operation, so the call returns immediately,
  *          but the address range is not ready to use until its status changes from <code>pending-provision</code>
- *          to <code>provisioned</code>. To monitor the status of an address range, use <a>DescribeByoipCidrs</a>.
- *          To allocate an Elastic IP address from your IPv4 address pool, use <a>AllocateAddress</a>
- *          with either the specific address from the address pool or the ID of the address pool.</p>
+ *           to <code>provisioned</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/byoip-onboard.html">Onboard your address range</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ec2/src/commands/RegisterImageCommand.ts b/clients/client-ec2/src/commands/RegisterImageCommand.ts
@@ -32,12 +32,6 @@ export interface RegisterImageCommandOutput extends RegisterImageResult, __Metad
  *       is the final step in the creation process. For more information about creating AMIs, see
  *         <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html#creating-launching-ami-from-snapshot">Create an AMI from a snapshot</a> and <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-instance-store.html">Create an instance-store
  *         backed AMI</a> in the <i>Amazon EC2 User Guide</i>.</p>
- *          <note>
- *             <p>For Amazon EBS-backed instances, <a>CreateImage</a> creates and registers the AMI
- *         in a single request, so you don't have to register the AMI yourself. We recommend that you
- *         always use <a>CreateImage</a> unless you have a specific reason to use
- *         RegisterImage.</p>
- *          </note>
  *          <p>If needed, you can deregister an AMI at any time. Any modifications you make to an AMI
  *       backed by an instance store volume invalidates its registration. If you make changes to an
  *       image, deregister the previous image and register the new image.</p>
@@ -63,12 +57,13 @@ export interface RegisterImageCommandOutput extends RegisterImageResult, __Metad
  *       verify if the correct billing information was applied, check the <code>PlatformDetails</code>
  *       field on the new AMI. If the field is empty or doesn't match the expected operating system
  *       code (for example, Windows, RedHat, SUSE, or SQL), the AMI creation was unsuccessful, and you
- *       should discard the AMI and instead create the AMI from an instance using <a>CreateImage</a>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html#how-to-create-ebs-ami">Create an AMI
+ *       should discard the AMI and instead create the AMI from an instance.
+ *         For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html#how-to-create-ebs-ami">Create an AMI
  *         from an instance </a> in the <i>Amazon EC2 User Guide</i>.</p>
  *          <p>If you purchase a Reserved Instance to apply to an On-Demand Instance that was launched
  *       from an AMI with a billing product code, make sure that the Reserved Instance has the matching
  *       billing product code. If you purchase a Reserved Instance without the matching billing product
- *       code, the Reserved Instance will not be applied to the On-Demand Instance. For information
+ *       code, the Reserved Instance is not applied to the On-Demand Instance. For information
  *       about how to obtain the platform details and billing information of an AMI, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-billing-info.html">Understand AMI
  *         billing information</a> in the <i>Amazon EC2 User Guide</i>.</p>
  * @example
diff --git a/clients/client-ec2/src/commands/ReleaseAddressCommand.ts b/clients/client-ec2/src/commands/ReleaseAddressCommand.ts
@@ -30,16 +30,16 @@ export interface ReleaseAddressCommandOutput extends __MetadataBearer {}
 /**
  * <p>Releases the specified Elastic IP address.</p>
  *          <p>[Default VPC] Releasing an Elastic IP address automatically disassociates it
- * 				from any instance that it's associated with. To disassociate an Elastic IP address without
- * 				releasing it, use <a>DisassociateAddress</a>.</p>
- *          <p>[Nondefault VPC] You must use <a>DisassociateAddress</a> to disassociate the Elastic IP address
+ * 				from any instance that it's associated with. Alternatively, you can disassociate an Elastic IP address without
+ * 				releasing it.</p>
+ *          <p>[Nondefault VPC] You must disassociate the Elastic IP address
  * 			  before you can release it. Otherwise, Amazon EC2 returns an error (<code>InvalidIPAddress.InUse</code>).</p>
  *          <p>After releasing an Elastic IP address, it is released to the IP address pool.
  *         Be sure to update your DNS records and any servers or devices that communicate with the address.
  *         If you attempt to release an Elastic IP address that you already released, you'll get an
  *        <code>AuthFailure</code> error if the address is already allocated to another Amazon Web Services account.</p>
  *          <p>After you release an Elastic IP address, you might be able to recover it.
- *         For more information, see <a>AllocateAddress</a>.</p>
+ *        For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-instance-addressing-eips-releasing.html">Release an Elastic IP address</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ec2/src/commands/StartDeclarativePoliciesReportCommand.ts b/clients/client-ec2/src/commands/StartDeclarativePoliciesReportCommand.ts
@@ -41,10 +41,9 @@ export interface StartDeclarativePoliciesReportCommandOutput
  *             accounts that fall under the specified organizational unit (OU) or root (the entire
  *                 Amazon Web Services Organization).</p>
  *          <p>The report is saved to your specified S3 bucket, using the following path structure
- *             (with the <i>italicized placeholders</i> representing your specific
- *             values):</p>
+ *             (with the capitalized placeholders representing your specific values):</p>
  *          <p>
- *             <code>s3://<i>amzn-s3-demo-bucket</i>/<i>your-optional-s3-prefix</i>/ec2_<i>targetId</i>_<i>reportId</i>_<i>yyyyMMdd</i>T<i>hhmm</i>Z.csv</code>
+ *             <code>s3://AMZN-S3-DEMO-BUCKET/YOUR-OPTIONAL-S3-PREFIX/ec2_TARGETID_REPORTID_YYYYMMDDTHHMMZ.csv</code>
  *          </p>
  *          <p class="title">
  *             <b>Prerequisites for generating a report</b>
diff --git a/clients/client-ec2/src/models/models_0.ts b/clients/client-ec2/src/models/models_0.ts
@@ -5262,6 +5262,12 @@ export interface AssociateRouteTableRequest {
    */
   GatewayId?: string | undefined;
 
+  /**
+   * <p>The ID of a public IPv4 pool. A public IPv4 pool is a pool of IPv4 addresses that you've brought to Amazon Web Services with BYOIP.</p>
+   * @public
+   */
+  PublicIpv4Pool?: string | undefined;
+
   /**
    * <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>.
diff --git a/clients/client-ec2/src/models/models_1.ts b/clients/client-ec2/src/models/models_1.ts
@@ -8247,7 +8247,7 @@ export interface CreateImageRequest {
    *                <p>You can't modify the encryption status of existing volumes or snapshots. To create an
    *           AMI with volumes or snapshots that have a different encryption status (for example, where
    *           the source volume and snapshots are unencrypted, and you want to create an AMI with
-   *           encrypted volumes or snapshots), use the <a>CopyImage</a> action.</p>
+   *           encrypted volumes or snapshots), copy the image instead.</p>
    *             </li>
    *             <li>
    *                <p>The only option that can be changed for existing mappings or snapshots is
diff --git a/clients/client-ec2/src/models/models_2.ts b/clients/client-ec2/src/models/models_2.ts
@@ -5189,6 +5189,12 @@ export interface RouteTableAssociation {
    */
   GatewayId?: string | undefined;
 
+  /**
+   * <p>The ID of a public IPv4 pool. A public IPv4 pool is a pool of IPv4 addresses that you've brought to Amazon Web Services with BYOIP.</p>
+   * @public
+   */
+  PublicIpv4Pool?: string | undefined;
+
   /**
    * <p>The state of the association.</p>
    * @public
diff --git a/clients/client-ec2/src/models/models_4.ts b/clients/client-ec2/src/models/models_4.ts
@@ -5167,7 +5167,7 @@ export interface DescribeImageAttributeRequest {
    *          <p>
    *             <b>Note</b>: The <code>blockDeviceMapping</code> attribute is
    *       deprecated. Using this attribute returns the <code>Client.AuthFailure</code> error. To get
-   *       information about the block device mappings for an AMI, use the <a>DescribeImages</a> action.</p>
+   *       information about the block device mappings for an AMI, describe the image instead.</p>
    * @public
    */
   Attribute: ImageAttributeName | undefined;
@@ -5905,22 +5905,12 @@ export interface Image {
 
   /**
    * <p>The ID of the source AMI from which the AMI was created.</p>
-   *          <p>The ID only appears if the AMI was created using <a>CreateImage</a>, <a>CopyImage</a>, or <a>CreateRestoreImageTask</a>. The ID does not appear
-   *       if the AMI was created using any other API. For some older AMIs, the ID might not be
-   *       available. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/identify-source-ami-used-to-create-new-ami.html">Identify the
-   *         source AMI used to create a new Amazon EC2 AMI</a> in the
-   *         <i>Amazon EC2 User Guide</i>.</p>
    * @public
    */
   SourceImageId?: string | undefined;
 
   /**
-   * <p>The Region of the source AMI. </p>
-   *          <p>The Region only appears if the AMI was created using <a>CreateImage</a>, <a>CopyImage</a>, or <a>CreateRestoreImageTask</a>. The Region does not
-   *       appear if the AMI was created using any other API. For some older AMIs, the Region might not
-   *       be available. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/identify-source-ami-used-to-create-new-ami.html">Identify the
-   *         source AMI used to create a new Amazon EC2 AMI</a> in the
-   *         <i>Amazon EC2 User Guide</i>.</p>
+   * <p>The Region of the source AMI.</p>
    * @public
    */
   SourceImageRegion?: string | undefined;
diff --git a/clients/client-ec2/src/protocols/Aws_ec2.ts b/clients/client-ec2/src/protocols/Aws_ec2.ts
@@ -30968,6 +30968,9 @@ const se_AssociateRouteTableRequest = (input: AssociateRouteTableRequest, contex
   if (input[_GI] != null) {
     entries[_GI] = input[_GI];
   }
+  if (input[_PIP] != null) {
+    entries[_PIP] = input[_PIP];
+  }
   if (input[_DRr] != null) {
     entries[_DRr] = input[_DRr];
   }
@@ -84531,6 +84534,9 @@ const de_RouteTableAssociation = (output: any, context: __SerdeContext): RouteTa
   if (output[_gI] != null) {
     contents[_GI] = __expectString(output[_gI]);
   }
+  if (output[_pIP] != null) {
+    contents[_PIP] = __expectString(output[_pIP]);
+  }
   if (output[_aS] != null) {
     contents[_ASs] = de_RouteTableAssociationState(output[_aS], context);
   }
diff --git a/codegen/sdk-codegen/aws-models/ec2.json b/codegen/sdk-codegen/aws-models/ec2.json
