feat(client-route-53): Add new APIs to support Route 53 IP Based Routing

Author: awstools

clients/client-route-53/README.md

@@ -9,7 +9,8 @@
 
 AWS SDK for JavaScript Route53 Client for Node.js, Browser and React Native.
 
-<p>Amazon Route 53 is a highly available and scalable Domain Name System (DNS) web service.</p>
+<p>Amazon Route 53 is a highly available and scalable Domain Name System (DNS) web
+service.</p>
 
 ## Installing
 

clients/client-route-53/src/Route53.ts

@@ -60,6 +60,10 @@ import {
   AssociateVPCWithHostedZoneCommandInput,
   AssociateVPCWithHostedZoneCommandOutput,
 } from "./commands/AssociateVPCWithHostedZoneCommand";
+import {
+  ChangeCidrCollectionCommandInput,
+  ChangeCidrCollectionCommandOutput,
+} from "./commands/ChangeCidrCollectionCommand";
 import {
   ChangeResourceRecordSetsCommandInput,
   ChangeResourceRecordSetsCommandOutput,
@@ -68,6 +72,10 @@ import {
   ChangeTagsForResourceCommandInput,
   ChangeTagsForResourceCommandOutput,
 } from "./commands/ChangeTagsForResourceCommand";
+import {
+  CreateCidrCollectionCommandInput,
+  CreateCidrCollectionCommandOutput,
+} from "./commands/CreateCidrCollectionCommand";
 import { CreateHealthCheckCommandInput, CreateHealthCheckCommandOutput } from "./commands/CreateHealthCheckCommand";
 import { CreateHostedZoneCommandInput, CreateHostedZoneCommandOutput } from "./commands/CreateHostedZoneCommand";
 import {
@@ -102,6 +110,10 @@ import {
   DeactivateKeySigningKeyCommandInput,
   DeactivateKeySigningKeyCommandOutput,
 } from "./commands/DeactivateKeySigningKeyCommand";
+import {
+  DeleteCidrCollectionCommandInput,
+  DeleteCidrCollectionCommandOutput,
+} from "./commands/DeleteCidrCollectionCommand";
 import { DeleteHealthCheckCommandInput, DeleteHealthCheckCommandOutput } from "./commands/DeleteHealthCheckCommand";
 import { DeleteHostedZoneCommandInput, DeleteHostedZoneCommandOutput } from "./commands/DeleteHostedZoneCommand";
 import {
@@ -182,6 +194,12 @@ import {
   GetTrafficPolicyInstanceCountCommandInput,
   GetTrafficPolicyInstanceCountCommandOutput,
 } from "./commands/GetTrafficPolicyInstanceCountCommand";
+import { ListCidrBlocksCommandInput, ListCidrBlocksCommandOutput } from "./commands/ListCidrBlocksCommand";
+import {
+  ListCidrCollectionsCommandInput,
+  ListCidrCollectionsCommandOutput,
+} from "./commands/ListCidrCollectionsCommand";
+import { ListCidrLocationsCommandInput, ListCidrLocationsCommandOutput } from "./commands/ListCidrLocationsCommand";
 import { ListGeoLocationsCommandInput, ListGeoLocationsCommandOutput } from "./commands/ListGeoLocationsCommand";
 import { ListHealthChecksCommandInput, ListHealthChecksCommandOutput } from "./commands/ListHealthChecksCommand";
 import {
@@ -256,8 +274,10 @@ import { getRuntimeConfig as __getRuntimeConfig } from "./runtimeConfig";
 export type ServiceInputTypes =
   | ActivateKeySigningKeyCommandInput
   | AssociateVPCWithHostedZoneCommandInput
+  | ChangeCidrCollectionCommandInput
   | ChangeResourceRecordSetsCommandInput
   | ChangeTagsForResourceCommandInput
+  | CreateCidrCollectionCommandInput
   | CreateHealthCheckCommandInput
   | CreateHostedZoneCommandInput
   | CreateKeySigningKeyCommandInput
@@ -268,6 +288,7 @@ export type ServiceInputTypes =
   | CreateTrafficPolicyVersionCommandInput
   | CreateVPCAssociationAuthorizationCommandInput
   | DeactivateKeySigningKeyCommandInput
+  | DeleteCidrCollectionCommandInput
   | DeleteHealthCheckCommandInput
   | DeleteHostedZoneCommandInput
   | DeleteKeySigningKeyCommandInput
@@ -297,6 +318,9 @@ export type ServiceInputTypes =
   | GetTrafficPolicyCommandInput
   | GetTrafficPolicyInstanceCommandInput
   | GetTrafficPolicyInstanceCountCommandInput
+  | ListCidrBlocksCommandInput
+  | ListCidrCollectionsCommandInput
+  | ListCidrLocationsCommandInput
   | ListGeoLocationsCommandInput
   | ListHealthChecksCommandInput
   | ListHostedZonesByNameCommandInput
@@ -322,8 +346,10 @@ export type ServiceInputTypes =
 export type ServiceOutputTypes =
   | ActivateKeySigningKeyCommandOutput
   | AssociateVPCWithHostedZoneCommandOutput
+  | ChangeCidrCollectionCommandOutput
   | ChangeResourceRecordSetsCommandOutput
   | ChangeTagsForResourceCommandOutput
+  | CreateCidrCollectionCommandOutput
   | CreateHealthCheckCommandOutput
   | CreateHostedZoneCommandOutput
   | CreateKeySigningKeyCommandOutput
@@ -334,6 +360,7 @@ export type ServiceOutputTypes =
   | CreateTrafficPolicyVersionCommandOutput
   | CreateVPCAssociationAuthorizationCommandOutput
   | DeactivateKeySigningKeyCommandOutput
+  | DeleteCidrCollectionCommandOutput
   | DeleteHealthCheckCommandOutput
   | DeleteHostedZoneCommandOutput
   | DeleteKeySigningKeyCommandOutput
@@ -363,6 +390,9 @@ export type ServiceOutputTypes =
   | GetTrafficPolicyCommandOutput
   | GetTrafficPolicyInstanceCommandOutput
   | GetTrafficPolicyInstanceCountCommandOutput
+  | ListCidrBlocksCommandOutput
+  | ListCidrCollectionsCommandOutput
+  | ListCidrLocationsCommandOutput
   | ListGeoLocationsCommandOutput
   | ListHealthChecksCommandOutput
   | ListHostedZonesByNameCommandOutput
@@ -539,7 +569,8 @@ type Route53ClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandl
 export interface Route53ClientResolvedConfig extends Route53ClientResolvedConfigType {}
 
 /**
- * <p>Amazon Route 53 is a highly available and scalable Domain Name System (DNS) web service.</p>
+ * <p>Amazon Route 53 is a highly available and scalable Domain Name System (DNS) web
+ * 			service.</p>
  */
 export class Route53Client extends __Client<
   __HttpHandlerOptions,

clients/client-route-53/src/Route53Client.ts

@@ -24,8 +24,8 @@ export interface ActivateKeySigningKeyCommandInput extends ActivateKeySigningKey
 export interface ActivateKeySigningKeyCommandOutput extends ActivateKeySigningKeyResponse, __MetadataBearer {}
 
 /**
- * <p>Activates a key-signing key (KSK) so that it can be used for signing by DNSSEC. This operation changes the
- * 			KSK status to <code>ACTIVE</code>.</p>
+ * <p>Activates a key-signing key (KSK) so that it can be used for signing by DNSSEC. This
+ * 			operation changes the KSK status to <code>ACTIVE</code>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-route-53/src/commands/ActivateKeySigningKeyCommand.ts

@@ -26,37 +26,38 @@ export interface AssociateVPCWithHostedZoneCommandOutput extends AssociateVPCWit
 /**
  * <p>Associates an Amazon VPC with a private hosted zone. </p>
  * 		       <important>
- *             <p>To perform the association, the VPC and the private hosted zone must already exist.
- * 			You can't convert a public hosted zone into a private hosted zone.</p>
- *          </important>
+ * 			         <p>To perform the association, the VPC and the private hosted zone must already
+ * 				exist. You can't convert a public hosted zone into a private hosted zone.</p>
+ * 		       </important>
  * 		       <note>
- *             <p>If you want to associate a VPC that was created by using one Amazon Web Services account with a private hosted zone that was created
- * 			by using a different account, the Amazon Web Services account that created the private hosted zone must first submit a
- * 			<code>CreateVPCAssociationAuthorization</code> request. Then the account that created the VPC must submit an
- * 			<code>AssociateVPCWithHostedZone</code> request.</p>
- *          </note>
+ * 			         <p>If you want to associate a VPC that was created by using one Amazon Web Services account with a private hosted zone that was created by using a
+ * 				different account, the Amazon Web Services account that created the private hosted
+ * 				zone must first submit a <code>CreateVPCAssociationAuthorization</code> request.
+ * 				Then the account that created the VPC must submit an
+ * 					<code>AssociateVPCWithHostedZone</code> request.</p>
+ * 		       </note>
  * 		       <note>
- *             <p>When granting access, the hosted zone and the Amazon VPC must belong to the same partition. A
- * 			partition is a group of Amazon Web Services Regions. Each Amazon Web Services account is scoped to one
- * 			partition.</p>
+ * 			         <p>When granting access, the hosted zone and the Amazon VPC must belong to
+ * 				the same partition. A partition is a group of Amazon Web Services Regions. Each
+ * 					Amazon Web Services account is scoped to one partition.</p>
  * 			         <p>The following are the supported partitions:</p>
  * 			         <ul>
  *                <li>
- *                   <p>
+ * 					             <p>
  *                      <code>aws</code> - Amazon Web Services Regions</p>
- *                </li>
+ * 				           </li>
  *                <li>
- *                   <p>
+ * 					             <p>
  *                      <code>aws-cn</code> - China Regions</p>
- *                </li>
+ * 				           </li>
  *                <li>
- *                   <p>
+ * 					             <p>
  *                      <code>aws-us-gov</code> - Amazon Web Services GovCloud (US) Region</p>
- *                </li>
+ * 				           </li>
  *             </ul>
  * 			         <p>For more information, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Access Management</a>
  * 				in the <i>Amazon Web Services General Reference</i>.</p>
- *          </note>
+ * 		       </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-route-53/src/commands/AssociateVPCWithHostedZoneCommand.ts

@@ -0,0 +1,123 @@
+// smithy-typescript generated code
+import { getIdNormalizerPlugin } from "@aws-sdk/middleware-sdk-route53";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import { ChangeCidrCollectionRequest, ChangeCidrCollectionResponse } from "../models/models_0";
+import {
+  deserializeAws_restXmlChangeCidrCollectionCommand,
+  serializeAws_restXmlChangeCidrCollectionCommand,
+} from "../protocols/Aws_restXml";
+import { Route53ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../Route53Client";
+
+export interface ChangeCidrCollectionCommandInput extends ChangeCidrCollectionRequest {}
+export interface ChangeCidrCollectionCommandOutput extends ChangeCidrCollectionResponse, __MetadataBearer {}
+
+/**
+ * <p>Creates, changes, or deletes CIDR blocks within a collection. Contains authoritative
+ * 			IP information mapping blocks to one or multiple locations.</p>
+ * 		       <p>A change request can update multiple locations in a collection at a time, which is
+ * 			helpful if you want to move one or more CIDR blocks from one location to another in one
+ * 			transaction, without downtime. </p>
+ * 		       <p>
+ *             <b>Limits</b>
+ *          </p>
+ * 		       <p>The max number of CIDR blocks included in the request is
+ * 			1000.
+ * 			As a result, big updates require multiple API calls.</p>
+ * 		       <p>
+ *             <b> PUT and DELETE_IF_EXISTS</b>
+ *          </p>
+ * 		       <p>Use <code>ChangeCidrCollection</code> to perform the following actions:</p>
+ * 		       <ul>
+ *             <li>
+ * 				           <p>
+ *                   <code>PUT</code>: Create a CIDR block within the specified collection.</p>
+ * 			         </li>
+ *             <li>
+ * 				           <p>
+ *                   <code> DELETE_IF_EXISTS</code>: Delete an existing CIDR block from the
+ * 					collection.</p>
+ * 			         </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { Route53Client, ChangeCidrCollectionCommand } from "@aws-sdk/client-route-53"; // ES Modules import
+ * // const { Route53Client, ChangeCidrCollectionCommand } = require("@aws-sdk/client-route-53"); // CommonJS import
+ * const client = new Route53Client(config);
+ * const command = new ChangeCidrCollectionCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link ChangeCidrCollectionCommandInput} for command's `input` shape.
+ * @see {@link ChangeCidrCollectionCommandOutput} for command's `response` shape.
+ * @see {@link Route53ClientResolvedConfig | config} for Route53Client's `config` shape.
+ *
+ */
+export class ChangeCidrCollectionCommand extends $Command<
+  ChangeCidrCollectionCommandInput,
+  ChangeCidrCollectionCommandOutput,
+  Route53ClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  constructor(readonly input: ChangeCidrCollectionCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: Route53ClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<ChangeCidrCollectionCommandInput, ChangeCidrCollectionCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(getIdNormalizerPlugin(configuration));
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "Route53Client";
+    const commandName = "ChangeCidrCollectionCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: ChangeCidrCollectionRequest.filterSensitiveLog,
+      outputFilterSensitiveLog: ChangeCidrCollectionResponse.filterSensitiveLog,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  private serialize(input: ChangeCidrCollectionCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return serializeAws_restXmlChangeCidrCollectionCommand(input, context);
+  }
+
+  private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<ChangeCidrCollectionCommandOutput> {
+    return deserializeAws_restXmlChangeCidrCollectionCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}