@aws-sdk/client-route-53 3.288.0 → 3.289.0

package/dist-types/commands/AssociateVPCWithHostedZoneCommand.d.ts

@@ -62,6 +62,32 @@ export interface AssociateVPCWithHostedZoneCommandOutput extends AssociateVPCWit
  * @see {@link AssociateVPCWithHostedZoneCommandOutput} for command's `response` shape.
  * @see {@link Route53ClientResolvedConfig | config} for Route53Client's `config` shape.
  *
+ * @example To associate a VPC with a hosted zone
+ * ```javascript
+ * // The following example associates the VPC with ID vpc-1a2b3c4d with the hosted zone with ID Z3M3LMPEXAMPLE.
+ * const input = {
+ *   "Comment": "",
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE",
+ *   "VPC": {
+ *     "VPCId": "vpc-1a2b3c4d",
+ *     "VPCRegion": "us-east-2"
+ *   }
+ * };
+ * const command = new AssociateVPCWithHostedZoneCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "",
+ *     "Id": "/change/C3HC6WDB2UANE2",
+ *     "Status": "INSYNC",
+ *     "SubmittedAt": "2017-01-31T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-associate-a-vpc-with-a-hosted-zone-1484069228699
+ * ```
+ *
  */
 export declare class AssociateVPCWithHostedZoneCommand extends $Command<AssociateVPCWithHostedZoneCommandInput, AssociateVPCWithHostedZoneCommandOutput, Route53ClientResolvedConfig> {
     readonly input: AssociateVPCWithHostedZoneCommandInput;

package/dist-types/commands/ChangeResourceRecordSetsCommand.d.ts

@@ -118,6 +118,603 @@ export interface ChangeResourceRecordSetsCommandOutput extends ChangeResourceRec
  * @see {@link ChangeResourceRecordSetsCommandOutput} for command's `response` shape.
  * @see {@link Route53ClientResolvedConfig | config} for Route53Client's `config` shape.
  *
+ * @example To create a basic resource record set
+ * ```javascript
+ * // The following example creates a resource record set that routes Internet traffic to a resource with an IP address of 192.0.2.44.
+ * const input = {
+ *   "ChangeBatch": {
+ *     "Changes": [
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "Name": "example.com",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.44"
+ *             }
+ *           ],
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       }
+ *     ],
+ *     "Comment": "Web server for example.com"
+ *   },
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new ChangeResourceRecordSetsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "Web server for example.com",
+ *     "Id": "/change/C2682N5HXP0BZ4",
+ *     "Status": "PENDING",
+ *     "SubmittedAt": "2017-02-10T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-update-or-delete-resource-record-sets-1484344703668
+ * ```
+ *
+ * @example To create weighted resource record sets
+ * ```javascript
+ * // The following example creates two weighted resource record sets. The resource with a Weight of 100 will get 1/3rd of traffic (100/100+200), and the other resource will get the rest of the traffic for example.com.
+ * const input = {
+ *   "ChangeBatch": {
+ *     "Changes": [
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "HealthCheckId": "abcdef11-2222-3333-4444-555555fedcba",
+ *           "Name": "example.com",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.44"
+ *             }
+ *           ],
+ *           "SetIdentifier": "Seattle data center",
+ *           "TTL": 60,
+ *           "Type": "A",
+ *           "Weight": 100
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "HealthCheckId": "abcdef66-7777-8888-9999-000000fedcba",
+ *           "Name": "example.com",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.45"
+ *             }
+ *           ],
+ *           "SetIdentifier": "Portland data center",
+ *           "TTL": 60,
+ *           "Type": "A",
+ *           "Weight": 200
+ *         }
+ *       }
+ *     ],
+ *     "Comment": "Web servers for example.com"
+ *   },
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new ChangeResourceRecordSetsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "Web servers for example.com",
+ *     "Id": "/change/C2682N5HXP0BZ4",
+ *     "Status": "PENDING",
+ *     "SubmittedAt": "2017-02-10T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-weighted-resource-record-sets-1484348208522
+ * ```
+ *
+ * @example To create an alias resource record set
+ * ```javascript
+ * // The following example creates an alias resource record set that routes traffic to a CloudFront distribution.
+ * const input = {
+ *   "ChangeBatch": {
+ *     "Changes": [
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "d123rk29d0stfj.cloudfront.net",
+ *             "EvaluateTargetHealth": false,
+ *             "HostedZoneId": "Z2FDTNDATAQYW2"
+ *           },
+ *           "Name": "example.com",
+ *           "Type": "A"
+ *         }
+ *       }
+ *     ],
+ *     "Comment": "CloudFront distribution for example.com"
+ *   },
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new ChangeResourceRecordSetsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "CloudFront distribution for example.com",
+ *     "Id": "/change/C2682N5HXP0BZ4",
+ *     "Status": "PENDING",
+ *     "SubmittedAt": "2017-02-10T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-an-alias-resource-record-set-1484348404062
+ * ```
+ *
+ * @example To create weighted alias resource record sets
+ * ```javascript
+ * // The following example creates two weighted alias resource record sets that route traffic to ELB load balancers. The resource with a Weight of 100 will get 1/3rd of traffic (100/100+200), and the other resource will get the rest of the traffic for example.com.
+ * const input = {
+ *   "ChangeBatch": {
+ *     "Changes": [
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "example-com-123456789.us-east-2.elb.amazonaws.com ",
+ *             "EvaluateTargetHealth": true,
+ *             "HostedZoneId": "Z3AADJGX6KTTL2"
+ *           },
+ *           "Name": "example.com",
+ *           "SetIdentifier": "Ohio region",
+ *           "Type": "A",
+ *           "Weight": 100
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "example-com-987654321.us-west-2.elb.amazonaws.com ",
+ *             "EvaluateTargetHealth": true,
+ *             "HostedZoneId": "Z1H1FL5HABSF5"
+ *           },
+ *           "Name": "example.com",
+ *           "SetIdentifier": "Oregon region",
+ *           "Type": "A",
+ *           "Weight": 200
+ *         }
+ *       }
+ *     ],
+ *     "Comment": "ELB load balancers for example.com"
+ *   },
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new ChangeResourceRecordSetsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "ELB load balancers for example.com",
+ *     "Id": "/change/C2682N5HXP0BZ4",
+ *     "Status": "PENDING",
+ *     "SubmittedAt": "2017-02-10T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-weighted-alias-resource-record-sets-1484349467416
+ * ```
+ *
+ * @example To create latency resource record sets
+ * ```javascript
+ * // The following example creates two latency resource record sets that route traffic to EC2 instances. Traffic for example.com is routed either to the Ohio region or the Oregon region, depending on the latency between the user and those regions.
+ * const input = {
+ *   "ChangeBatch": {
+ *     "Changes": [
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "HealthCheckId": "abcdef11-2222-3333-4444-555555fedcba",
+ *           "Name": "example.com",
+ *           "Region": "us-east-2",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.44"
+ *             }
+ *           ],
+ *           "SetIdentifier": "Ohio region",
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "HealthCheckId": "abcdef66-7777-8888-9999-000000fedcba",
+ *           "Name": "example.com",
+ *           "Region": "us-west-2",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.45"
+ *             }
+ *           ],
+ *           "SetIdentifier": "Oregon region",
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       }
+ *     ],
+ *     "Comment": "EC2 instances for example.com"
+ *   },
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new ChangeResourceRecordSetsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "EC2 instances for example.com",
+ *     "Id": "/change/C2682N5HXP0BZ4",
+ *     "Status": "PENDING",
+ *     "SubmittedAt": "2017-02-10T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-latency-resource-record-sets-1484350219917
+ * ```
+ *
+ * @example To create latency alias resource record sets
+ * ```javascript
+ * // The following example creates two latency alias resource record sets that route traffic for example.com to ELB load balancers. Requests are routed either to the Ohio region or the Oregon region, depending on the latency between the user and those regions.
+ * const input = {
+ *   "ChangeBatch": {
+ *     "Changes": [
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "example-com-123456789.us-east-2.elb.amazonaws.com ",
+ *             "EvaluateTargetHealth": true,
+ *             "HostedZoneId": "Z3AADJGX6KTTL2"
+ *           },
+ *           "Name": "example.com",
+ *           "Region": "us-east-2",
+ *           "SetIdentifier": "Ohio region",
+ *           "Type": "A"
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "example-com-987654321.us-west-2.elb.amazonaws.com ",
+ *             "EvaluateTargetHealth": true,
+ *             "HostedZoneId": "Z1H1FL5HABSF5"
+ *           },
+ *           "Name": "example.com",
+ *           "Region": "us-west-2",
+ *           "SetIdentifier": "Oregon region",
+ *           "Type": "A"
+ *         }
+ *       }
+ *     ],
+ *     "Comment": "ELB load balancers for example.com"
+ *   },
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new ChangeResourceRecordSetsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "ELB load balancers for example.com",
+ *     "Id": "/change/C2682N5HXP0BZ4",
+ *     "Status": "PENDING",
+ *     "SubmittedAt": "2017-02-10T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-latency-alias-resource-record-sets-1484601774179
+ * ```
+ *
+ * @example To create failover resource record sets
+ * ```javascript
+ * // The following example creates primary and secondary failover resource record sets that route traffic to EC2 instances. Traffic is generally routed to the primary resource, in the Ohio region. If that resource is unavailable, traffic is routed to the secondary resource, in the Oregon region.
+ * const input = {
+ *   "ChangeBatch": {
+ *     "Changes": [
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "Failover": "PRIMARY",
+ *           "HealthCheckId": "abcdef11-2222-3333-4444-555555fedcba",
+ *           "Name": "example.com",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.44"
+ *             }
+ *           ],
+ *           "SetIdentifier": "Ohio region",
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "Failover": "SECONDARY",
+ *           "HealthCheckId": "abcdef66-7777-8888-9999-000000fedcba",
+ *           "Name": "example.com",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.45"
+ *             }
+ *           ],
+ *           "SetIdentifier": "Oregon region",
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       }
+ *     ],
+ *     "Comment": "Failover configuration for example.com"
+ *   },
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new ChangeResourceRecordSetsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "Failover configuration for example.com",
+ *     "Id": "/change/C2682N5HXP0BZ4",
+ *     "Status": "PENDING",
+ *     "SubmittedAt": "2017-02-10T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-failover-resource-record-sets-1484604541740
+ * ```
+ *
+ * @example To create failover alias resource record sets
+ * ```javascript
+ * // The following example creates primary and secondary failover alias resource record sets that route traffic to ELB load balancers. Traffic is generally routed to the primary resource, in the Ohio region. If that resource is unavailable, traffic is routed to the secondary resource, in the Oregon region.
+ * const input = {
+ *   "ChangeBatch": {
+ *     "Changes": [
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "example-com-123456789.us-east-2.elb.amazonaws.com ",
+ *             "EvaluateTargetHealth": true,
+ *             "HostedZoneId": "Z3AADJGX6KTTL2"
+ *           },
+ *           "Failover": "PRIMARY",
+ *           "Name": "example.com",
+ *           "SetIdentifier": "Ohio region",
+ *           "Type": "A"
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "example-com-987654321.us-west-2.elb.amazonaws.com ",
+ *             "EvaluateTargetHealth": true,
+ *             "HostedZoneId": "Z1H1FL5HABSF5"
+ *           },
+ *           "Failover": "SECONDARY",
+ *           "Name": "example.com",
+ *           "SetIdentifier": "Oregon region",
+ *           "Type": "A"
+ *         }
+ *       }
+ *     ],
+ *     "Comment": "Failover alias configuration for example.com"
+ *   },
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new ChangeResourceRecordSetsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "Failover alias configuration for example.com",
+ *     "Id": "/change/C2682N5HXP0BZ4",
+ *     "Status": "PENDING",
+ *     "SubmittedAt": "2017-02-10T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-failover-alias-resource-record-sets-1484607497724
+ * ```
+ *
+ * @example To create geolocation resource record sets
+ * ```javascript
+ * // The following example creates four geolocation resource record sets that use IPv4 addresses to route traffic to resources such as web servers running on EC2 instances. Traffic is routed to one of four IP addresses, for North America (NA), for South America (SA), for Europe (EU), and for all other locations (*).
+ * const input = {
+ *   "ChangeBatch": {
+ *     "Changes": [
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "GeoLocation": {
+ *             "ContinentCode": "NA"
+ *           },
+ *           "Name": "example.com",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.44"
+ *             }
+ *           ],
+ *           "SetIdentifier": "North America",
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "GeoLocation": {
+ *             "ContinentCode": "SA"
+ *           },
+ *           "Name": "example.com",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.45"
+ *             }
+ *           ],
+ *           "SetIdentifier": "South America",
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "GeoLocation": {
+ *             "ContinentCode": "EU"
+ *           },
+ *           "Name": "example.com",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.46"
+ *             }
+ *           ],
+ *           "SetIdentifier": "Europe",
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "GeoLocation": {
+ *             "CountryCode": "*"
+ *           },
+ *           "Name": "example.com",
+ *           "ResourceRecords": [
+ *             {
+ *               "Value": "192.0.2.47"
+ *             }
+ *           ],
+ *           "SetIdentifier": "Other locations",
+ *           "TTL": 60,
+ *           "Type": "A"
+ *         }
+ *       }
+ *     ],
+ *     "Comment": "Geolocation configuration for example.com"
+ *   },
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new ChangeResourceRecordSetsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "Geolocation configuration for example.com",
+ *     "Id": "/change/C2682N5HXP0BZ4",
+ *     "Status": "PENDING",
+ *     "SubmittedAt": "2017-02-10T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-geolocation-resource-record-sets-1484612462466
+ * ```
+ *
+ * @example To create geolocation alias resource record sets
+ * ```javascript
+ * // The following example creates four geolocation alias resource record sets that route traffic to ELB load balancers. Traffic is routed to one of four IP addresses, for North America (NA), for South America (SA), for Europe (EU), and for all other locations (*).
+ * const input = {
+ *   "ChangeBatch": {
+ *     "Changes": [
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "example-com-123456789.us-east-2.elb.amazonaws.com ",
+ *             "EvaluateTargetHealth": true,
+ *             "HostedZoneId": "Z3AADJGX6KTTL2"
+ *           },
+ *           "GeoLocation": {
+ *             "ContinentCode": "NA"
+ *           },
+ *           "Name": "example.com",
+ *           "SetIdentifier": "North America",
+ *           "Type": "A"
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "example-com-234567890.sa-east-1.elb.amazonaws.com ",
+ *             "EvaluateTargetHealth": true,
+ *             "HostedZoneId": "Z2P70J7HTTTPLU"
+ *           },
+ *           "GeoLocation": {
+ *             "ContinentCode": "SA"
+ *           },
+ *           "Name": "example.com",
+ *           "SetIdentifier": "South America",
+ *           "Type": "A"
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "example-com-234567890.eu-central-1.elb.amazonaws.com ",
+ *             "EvaluateTargetHealth": true,
+ *             "HostedZoneId": "Z215JYRZR1TBD5"
+ *           },
+ *           "GeoLocation": {
+ *             "ContinentCode": "EU"
+ *           },
+ *           "Name": "example.com",
+ *           "SetIdentifier": "Europe",
+ *           "Type": "A"
+ *         }
+ *       },
+ *       {
+ *         "Action": "CREATE",
+ *         "ResourceRecordSet": {
+ *           "AliasTarget": {
+ *             "DNSName": "example-com-234567890.ap-southeast-1.elb.amazonaws.com ",
+ *             "EvaluateTargetHealth": true,
+ *             "HostedZoneId": "Z1LMS91P8CMLE5"
+ *           },
+ *           "GeoLocation": {
+ *             "CountryCode": "*"
+ *           },
+ *           "Name": "example.com",
+ *           "SetIdentifier": "Other locations",
+ *           "Type": "A"
+ *         }
+ *       }
+ *     ],
+ *     "Comment": "Geolocation alias configuration for example.com"
+ *   },
+ *   "HostedZoneId": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new ChangeResourceRecordSetsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ChangeInfo": {
+ *     "Comment": "Geolocation alias configuration for example.com",
+ *     "Id": "/change/C2682N5HXP0BZ4",
+ *     "Status": "PENDING",
+ *     "SubmittedAt": "2017-02-10T01:36:41.958Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-create-geolocation-alias-resource-record-sets-1484612871203
+ * ```
+ *
  */
 export declare class ChangeResourceRecordSetsCommand extends $Command<ChangeResourceRecordSetsCommandInput, ChangeResourceRecordSetsCommandOutput, Route53ClientResolvedConfig> {
     readonly input: ChangeResourceRecordSetsCommandInput;

package/dist-types/commands/ChangeTagsForResourceCommand.d.ts

@@ -31,6 +31,31 @@ export interface ChangeTagsForResourceCommandOutput extends ChangeTagsForResourc
  * @see {@link ChangeTagsForResourceCommandOutput} for command's `response` shape.
  * @see {@link Route53ClientResolvedConfig | config} for Route53Client's `config` shape.
  *
+ * @example To add or remove tags from a hosted zone or health check
+ * ```javascript
+ * // The following example adds two tags and removes one tag from the hosted zone with ID Z3M3LMPEXAMPLE.
+ * const input = {
+ *   "AddTags": [
+ *     {
+ *       "Key": "apex",
+ *       "Value": "3874"
+ *     },
+ *     {
+ *       "Key": "acme",
+ *       "Value": "4938"
+ *     }
+ *   ],
+ *   "RemoveTagKeys": [
+ *     "Nadir"
+ *   ],
+ *   "ResourceId": "Z3M3LMPEXAMPLE",
+ *   "ResourceType": "hostedzone"
+ * };
+ * const command = new ChangeTagsForResourceCommand(input);
+ * await client.send(command);
+ * // example id: to-add-or-remove-tags-from-a-hosted-zone-or-health-check-1484084752409
+ * ```
+ *
  */
 export declare class ChangeTagsForResourceCommand extends $Command<ChangeTagsForResourceCommandInput, ChangeTagsForResourceCommandOutput, Route53ClientResolvedConfig> {
     readonly input: ChangeTagsForResourceCommandInput;

package/dist-types/commands/GetHostedZoneCommand.d.ts

@@ -30,6 +30,38 @@ export interface GetHostedZoneCommandOutput extends GetHostedZoneResponse, __Met
  * @see {@link GetHostedZoneCommandOutput} for command's `response` shape.
  * @see {@link Route53ClientResolvedConfig | config} for Route53Client's `config` shape.
  *
+ * @example To get information about a hosted zone
+ * ```javascript
+ * // The following example gets information about the Z3M3LMPEXAMPLE hosted zone.
+ * const input = {
+ *   "Id": "Z3M3LMPEXAMPLE"
+ * };
+ * const command = new GetHostedZoneCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DelegationSet": {
+ *     "NameServers": [
+ *       "ns-2048.awsdns-64.com",
+ *       "ns-2049.awsdns-65.net",
+ *       "ns-2050.awsdns-66.org",
+ *       "ns-2051.awsdns-67.co.uk"
+ *     ]
+ *   },
+ *   "HostedZone": {
+ *     "CallerReference": "C741617D-04E4-F8DE-B9D7-0D150FC61C2E",
+ *     "Config": {
+ *       "PrivateZone": false
+ *     },
+ *     "Id": "/hostedzone/Z3M3LMPEXAMPLE",
+ *     "Name": "myawsbucket.com.",
+ *     "ResourceRecordSetCount": 8
+ *   }
+ * }
+ * *\/
+ * // example id: to-get-information-about-a-hosted-zone-1481752361124
+ * ```
+ *
  */
 export declare class GetHostedZoneCommand extends $Command<GetHostedZoneCommandInput, GetHostedZoneCommandOutput, Route53ClientResolvedConfig> {
     readonly input: GetHostedZoneCommandInput;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-route-53",
   "description": "AWS SDK for JavaScript Route 53 Client for Node.js, Browser and React Native",
-  "version": "3.288.0",
+  "version": "3.289.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -20,40 +20,40 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.288.0",
-    "@aws-sdk/config-resolver": "3.287.0",
-    "@aws-sdk/credential-provider-node": "3.288.0",
-    "@aws-sdk/fetch-http-handler": "3.282.0",
-    "@aws-sdk/hash-node": "3.272.0",
-    "@aws-sdk/invalid-dependency": "3.272.0",
-    "@aws-sdk/middleware-content-length": "3.282.0",
-    "@aws-sdk/middleware-endpoint": "3.282.0",
-    "@aws-sdk/middleware-host-header": "3.282.0",
-    "@aws-sdk/middleware-logger": "3.288.0",
-    "@aws-sdk/middleware-recursion-detection": "3.282.0",
-    "@aws-sdk/middleware-retry": "3.287.0",
-    "@aws-sdk/middleware-sdk-route53": "3.272.0",
-    "@aws-sdk/middleware-serde": "3.272.0",
-    "@aws-sdk/middleware-signing": "3.282.0",
-    "@aws-sdk/middleware-stack": "3.272.0",
-    "@aws-sdk/middleware-user-agent": "3.282.0",
-    "@aws-sdk/node-config-provider": "3.287.0",
-    "@aws-sdk/node-http-handler": "3.282.0",
-    "@aws-sdk/protocol-http": "3.282.0",
-    "@aws-sdk/smithy-client": "3.279.0",
-    "@aws-sdk/types": "3.272.0",
-    "@aws-sdk/url-parser": "3.272.0",
+    "@aws-sdk/client-sts": "3.289.0",
+    "@aws-sdk/config-resolver": "3.289.0",
+    "@aws-sdk/credential-provider-node": "3.289.0",
+    "@aws-sdk/fetch-http-handler": "3.289.0",
+    "@aws-sdk/hash-node": "3.289.0",
+    "@aws-sdk/invalid-dependency": "3.289.0",
+    "@aws-sdk/middleware-content-length": "3.289.0",
+    "@aws-sdk/middleware-endpoint": "3.289.0",
+    "@aws-sdk/middleware-host-header": "3.289.0",
+    "@aws-sdk/middleware-logger": "3.289.0",
+    "@aws-sdk/middleware-recursion-detection": "3.289.0",
+    "@aws-sdk/middleware-retry": "3.289.0",
+    "@aws-sdk/middleware-sdk-route53": "3.289.0",
+    "@aws-sdk/middleware-serde": "3.289.0",
+    "@aws-sdk/middleware-signing": "3.289.0",
+    "@aws-sdk/middleware-stack": "3.289.0",
+    "@aws-sdk/middleware-user-agent": "3.289.0",
+    "@aws-sdk/node-config-provider": "3.289.0",
+    "@aws-sdk/node-http-handler": "3.289.0",
+    "@aws-sdk/protocol-http": "3.289.0",
+    "@aws-sdk/smithy-client": "3.289.0",
+    "@aws-sdk/types": "3.289.0",
+    "@aws-sdk/url-parser": "3.289.0",
     "@aws-sdk/util-base64": "3.208.0",
     "@aws-sdk/util-body-length-browser": "3.188.0",
     "@aws-sdk/util-body-length-node": "3.208.0",
-    "@aws-sdk/util-defaults-mode-browser": "3.279.0",
-    "@aws-sdk/util-defaults-mode-node": "3.287.0",
-    "@aws-sdk/util-endpoints": "3.272.0",
-    "@aws-sdk/util-retry": "3.272.0",
-    "@aws-sdk/util-user-agent-browser": "3.282.0",
-    "@aws-sdk/util-user-agent-node": "3.287.0",
+    "@aws-sdk/util-defaults-mode-browser": "3.289.0",
+    "@aws-sdk/util-defaults-mode-node": "3.289.0",
+    "@aws-sdk/util-endpoints": "3.289.0",
+    "@aws-sdk/util-retry": "3.289.0",
+    "@aws-sdk/util-user-agent-browser": "3.289.0",
+    "@aws-sdk/util-user-agent-node": "3.289.0",
     "@aws-sdk/util-utf8": "3.254.0",
-    "@aws-sdk/util-waiter": "3.272.0",
+    "@aws-sdk/util-waiter": "3.289.0",
     "@aws-sdk/xml-builder": "3.201.0",
     "fast-xml-parser": "4.1.2",
     "tslib": "^2.3.1"