types.go (91358B)
1 // Code generated by smithy-go-codegen DO NOT EDIT. 2 3 package types 4 5 import ( 6 smithydocument "github.com/aws/smithy-go/document" 7 "time" 8 ) 9 10 // A complex type that contains the type of limit that you specified in the 11 // request and the current value for that limit. 12 type AccountLimit struct { 13 14 // The limit that you requested. Valid values include the following: 15 // - MAX_HEALTH_CHECKS_BY_OWNER: The maximum number of health checks that you 16 // can create using the current account. 17 // - MAX_HOSTED_ZONES_BY_OWNER: The maximum number of hosted zones that you can 18 // create using the current account. 19 // - MAX_REUSABLE_DELEGATION_SETS_BY_OWNER: The maximum number of reusable 20 // delegation sets that you can create using the current account. 21 // - MAX_TRAFFIC_POLICIES_BY_OWNER: The maximum number of traffic policies that 22 // you can create using the current account. 23 // - MAX_TRAFFIC_POLICY_INSTANCES_BY_OWNER: The maximum number of traffic policy 24 // instances that you can create using the current account. (Traffic policy 25 // instances are referred to as traffic flow policy records in the Amazon Route 53 26 // console.) 27 // 28 // This member is required. 29 Type AccountLimitType 30 31 // The current value for the limit that is specified by Type (https://docs.aws.amazon.com/Route53/latest/APIReference/API_AccountLimit.html#Route53-Type-AccountLimit-Type) 32 // . 33 // 34 // This member is required. 35 Value *int64 36 37 noSmithyDocumentSerde 38 } 39 40 // A complex type that identifies the CloudWatch alarm that you want Amazon Route 41 // 53 health checkers to use to determine whether the specified health check is 42 // healthy. 43 type AlarmIdentifier struct { 44 45 // The name of the CloudWatch alarm that you want Amazon Route 53 health checkers 46 // to use to determine whether this health check is healthy. Route 53 supports 47 // CloudWatch alarms with the following features: 48 // - Standard-resolution metrics. High-resolution metrics aren't supported. For 49 // more information, see High-Resolution Metrics (https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/publishingMetrics.html#high-resolution-metrics) 50 // in the Amazon CloudWatch User Guide. 51 // - Statistics: Average, Minimum, Maximum, Sum, and SampleCount. Extended 52 // statistics aren't supported. 53 // 54 // This member is required. 55 Name *string 56 57 // For the CloudWatch alarm that you want Route 53 health checkers to use to 58 // determine whether this health check is healthy, the region that the alarm was 59 // created in. For the current list of CloudWatch regions, see Amazon CloudWatch 60 // endpoints and quotas (https://docs.aws.amazon.com/general/latest/gr/cw_region.html) 61 // in the Amazon Web Services General Reference. 62 // 63 // This member is required. 64 Region CloudWatchRegion 65 66 noSmithyDocumentSerde 67 } 68 69 // Alias resource record sets only: Information about the Amazon Web Services 70 // resource, such as a CloudFront distribution or an Amazon S3 bucket, that you 71 // want to route traffic to. When creating resource record sets for a private 72 // hosted zone, note the following: 73 // - For information about creating failover resource record sets in a private 74 // hosted zone, see Configuring Failover in a Private Hosted Zone (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html) 75 // . 76 type AliasTarget struct { 77 78 // Alias resource record sets only: The value that you specify depends on where 79 // you want to route queries: Amazon API Gateway custom regional APIs and 80 // edge-optimized APIs Specify the applicable domain name for your API. You can get 81 // the applicable value using the CLI command get-domain-names (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-domain-names.html) 82 // : 83 // - For regional APIs, specify the value of regionalDomainName . 84 // - For edge-optimized APIs, specify the value of distributionDomainName . This 85 // is the name of the associated CloudFront distribution, such as 86 // da1b2c3d4e5.cloudfront.net . 87 // The name of the record that you're creating must match a custom domain name for 88 // your API, such as api.example.com . Amazon Virtual Private Cloud interface VPC 89 // endpoint Enter the API endpoint for the interface endpoint, such as 90 // vpce-123456789abcdef01-example-us-east-1a.elasticloadbalancing.us-east-1.vpce.amazonaws.com 91 // . For edge-optimized APIs, this is the domain name for the corresponding 92 // CloudFront distribution. You can get the value of DnsName using the CLI command 93 // describe-vpc-endpoints (https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html) 94 // . CloudFront distribution Specify the domain name that CloudFront assigned when 95 // you created your distribution. Your CloudFront distribution must include an 96 // alternate domain name that matches the name of the resource record set. For 97 // example, if the name of the resource record set is acme.example.com, your 98 // CloudFront distribution must include acme.example.com as one of the alternate 99 // domain names. For more information, see Using Alternate Domain Names (CNAMEs) (https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/CNAMEs.html) 100 // in the Amazon CloudFront Developer Guide. You can't create a resource record set 101 // in a private hosted zone to route traffic to a CloudFront distribution. For 102 // failover alias records, you can't specify a CloudFront distribution for both the 103 // primary and secondary records. A distribution must include an alternate domain 104 // name that matches the name of the record. However, the primary and secondary 105 // records have the same name, and you can't include the same alternate domain name 106 // in more than one distribution. Elastic Beanstalk environment If the domain name 107 // for your Elastic Beanstalk environment includes the region that you deployed the 108 // environment in, you can create an alias record that routes traffic to the 109 // environment. For example, the domain name 110 // my-environment.us-west-2.elasticbeanstalk.com is a regionalized domain name. For 111 // environments that were created before early 2016, the domain name doesn't 112 // include the region. To route traffic to these environments, you must create a 113 // CNAME record instead of an alias record. Note that you can't create a CNAME 114 // record for the root domain name. For example, if your domain name is 115 // example.com, you can create a record that routes traffic for acme.example.com to 116 // your Elastic Beanstalk environment, but you can't create a record that routes 117 // traffic for example.com to your Elastic Beanstalk environment. For Elastic 118 // Beanstalk environments that have regionalized subdomains, specify the CNAME 119 // attribute for the environment. You can use the following methods to get the 120 // value of the CNAME attribute: 121 // - Amazon Web Services Management Console: For information about how to get 122 // the value by using the console, see Using Custom Domains with Elastic 123 // Beanstalk (https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/customdomains.html) 124 // in the Elastic Beanstalk Developer Guide. 125 // - Elastic Beanstalk API: Use the DescribeEnvironments action to get the value 126 // of the CNAME attribute. For more information, see DescribeEnvironments (https://docs.aws.amazon.com/elasticbeanstalk/latest/api/API_DescribeEnvironments.html) 127 // in the Elastic Beanstalk API Reference. 128 // - CLI: Use the describe-environments command to get the value of the CNAME 129 // attribute. For more information, see describe-environments (https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/describe-environments.html) 130 // in the CLI Command Reference. 131 // ELB load balancer Specify the DNS name that is associated with the load 132 // balancer. Get the DNS name by using the Amazon Web Services Management Console, 133 // the ELB API, or the CLI. 134 // - Amazon Web Services Management Console: Go to the EC2 page, choose Load 135 // Balancers in the navigation pane, choose the load balancer, choose the 136 // Description tab, and get the value of the DNS name field. If you're routing 137 // traffic to a Classic Load Balancer, get the value that begins with dualstack. If 138 // you're routing traffic to another type of load balancer, get the value that 139 // applies to the record type, A or AAAA. 140 // - Elastic Load Balancing API: Use DescribeLoadBalancers to get the value of 141 // DNSName . For more information, see the applicable guide: 142 // - Classic Load Balancers: DescribeLoadBalancers (https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_DescribeLoadBalancers.html) 143 // - Application and Network Load Balancers: DescribeLoadBalancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html) 144 // - CLI: Use describe-load-balancers to get the value of DNSName . For more 145 // information, see the applicable guide: 146 // - Classic Load Balancers: describe-load-balancers (http://docs.aws.amazon.com/cli/latest/reference/elb/describe-load-balancers.html) 147 // - Application and Network Load Balancers: describe-load-balancers (http://docs.aws.amazon.com/cli/latest/reference/elbv2/describe-load-balancers.html) 148 // Global Accelerator accelerator Specify the DNS name for your accelerator: 149 // - Global Accelerator API: To get the DNS name, use DescribeAccelerator (https://docs.aws.amazon.com/global-accelerator/latest/api/API_DescribeAccelerator.html) 150 // . 151 // - CLI: To get the DNS name, use describe-accelerator (https://docs.aws.amazon.com/cli/latest/reference/globalaccelerator/describe-accelerator.html) 152 // . 153 // Amazon S3 bucket that is configured as a static website Specify the domain name 154 // of the Amazon S3 website endpoint that you created the bucket in, for example, 155 // s3-website.us-east-2.amazonaws.com . For more information about valid values, 156 // see the table Amazon S3 Website Endpoints (https://docs.aws.amazon.com/general/latest/gr/s3.html#s3_website_region_endpoints) 157 // in the Amazon Web Services General Reference. For more information about using 158 // S3 buckets for websites, see Getting Started with Amazon Route 53 (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/getting-started.html) 159 // in the Amazon Route 53 Developer Guide. Another Route 53 resource record set 160 // Specify the value of the Name element for a resource record set in the current 161 // hosted zone. If you're creating an alias record that has the same name as the 162 // hosted zone (known as the zone apex), you can't specify the domain name for a 163 // record for which the value of Type is CNAME . This is because the alias record 164 // must have the same type as the record that you're routing traffic to, and 165 // creating a CNAME record for the zone apex isn't supported even for an alias 166 // record. 167 // 168 // This member is required. 169 DNSName *string 170 171 // Applies only to alias, failover alias, geolocation alias, latency alias, and 172 // weighted alias resource record sets: When EvaluateTargetHealth is true , an 173 // alias resource record set inherits the health of the referenced Amazon Web 174 // Services resource, such as an ELB load balancer or another resource record set 175 // in the hosted zone. Note the following: CloudFront distributions You can't set 176 // EvaluateTargetHealth to true when the alias target is a CloudFront 177 // distribution. Elastic Beanstalk environments that have regionalized subdomains 178 // If you specify an Elastic Beanstalk environment in DNSName and the environment 179 // contains an ELB load balancer, Elastic Load Balancing routes queries only to the 180 // healthy Amazon EC2 instances that are registered with the load balancer. (An 181 // environment automatically contains an ELB load balancer if it includes more than 182 // one Amazon EC2 instance.) If you set EvaluateTargetHealth to true and either no 183 // Amazon EC2 instances are healthy or the load balancer itself is unhealthy, Route 184 // 53 routes queries to other available resources that are healthy, if any. If the 185 // environment contains a single Amazon EC2 instance, there are no special 186 // requirements. ELB load balancers Health checking behavior depends on the type of 187 // load balancer: 188 // - Classic Load Balancers: If you specify an ELB Classic Load Balancer in 189 // DNSName , Elastic Load Balancing routes queries only to the healthy Amazon EC2 190 // instances that are registered with the load balancer. If you set 191 // EvaluateTargetHealth to true and either no EC2 instances are healthy or the 192 // load balancer itself is unhealthy, Route 53 routes queries to other resources. 193 // - Application and Network Load Balancers: If you specify an ELB Application 194 // or Network Load Balancer and you set EvaluateTargetHealth to true , Route 53 195 // routes queries to the load balancer based on the health of the target groups 196 // that are associated with the load balancer: 197 // - For an Application or Network Load Balancer to be considered healthy, every 198 // target group that contains targets must contain at least one healthy target. If 199 // any target group contains only unhealthy targets, the load balancer is 200 // considered unhealthy, and Route 53 routes queries to other resources. 201 // - A target group that has no registered targets is considered unhealthy. 202 // When you create a load balancer, you configure settings for Elastic Load 203 // Balancing health checks; they're not Route 53 health checks, but they perform a 204 // similar function. Do not create Route 53 health checks for the EC2 instances 205 // that you register with an ELB load balancer. S3 buckets There are no special 206 // requirements for setting EvaluateTargetHealth to true when the alias target is 207 // an S3 bucket. Other records in the same hosted zone If the Amazon Web Services 208 // resource that you specify in DNSName is a record or a group of records (for 209 // example, a group of weighted records) but is not another alias record, we 210 // recommend that you associate a health check with all of the records in the alias 211 // target. For more information, see What Happens When You Omit Health Checks? (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-complex-configs.html#dns-failover-complex-configs-hc-omitting) 212 // in the Amazon Route 53 Developer Guide. For more information and examples, see 213 // Amazon Route 53 Health Checks and DNS Failover (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html) 214 // in the Amazon Route 53 Developer Guide. 215 // 216 // This member is required. 217 EvaluateTargetHealth bool 218 219 // Alias resource records sets only: The value used depends on where you want to 220 // route traffic: Amazon API Gateway custom regional APIs and edge-optimized APIs 221 // Specify the hosted zone ID for your API. You can get the applicable value using 222 // the CLI command get-domain-names (https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-domain-names.html) 223 // : 224 // - For regional APIs, specify the value of regionalHostedZoneId . 225 // - For edge-optimized APIs, specify the value of distributionHostedZoneId . 226 // Amazon Virtual Private Cloud interface VPC endpoint Specify the hosted zone ID 227 // for your interface endpoint. You can get the value of HostedZoneId using the 228 // CLI command describe-vpc-endpoints (https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html) 229 // . CloudFront distribution Specify Z2FDTNDATAQYW2 . Alias resource record sets 230 // for CloudFront can't be created in a private zone. Elastic Beanstalk environment 231 // Specify the hosted zone ID for the region that you created the environment in. 232 // The environment must have a regionalized subdomain. For a list of regions and 233 // the corresponding hosted zone IDs, see Elastic Beanstalk endpoints and quotas (https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) 234 // in the Amazon Web Services General Reference. ELB load balancer Specify the 235 // value of the hosted zone ID for the load balancer. Use the following methods to 236 // get the hosted zone ID: 237 // - Elastic Load Balancing endpoints and quotas (https://docs.aws.amazon.com/general/latest/gr/elb.html) 238 // topic in the Amazon Web Services General Reference: Use the value that 239 // corresponds with the region that you created your load balancer in. Note that 240 // there are separate columns for Application and Classic Load Balancers and for 241 // Network Load Balancers. 242 // - Amazon Web Services Management Console: Go to the Amazon EC2 page, choose 243 // Load Balancers in the navigation pane, select the load balancer, and get the 244 // value of the Hosted zone field on the Description tab. 245 // - Elastic Load Balancing API: Use DescribeLoadBalancers to get the applicable 246 // value. For more information, see the applicable guide: 247 // - Classic Load Balancers: Use DescribeLoadBalancers (https://docs.aws.amazon.com/elasticloadbalancing/2012-06-01/APIReference/API_DescribeLoadBalancers.html) 248 // to get the value of CanonicalHostedZoneNameId . 249 // - Application and Network Load Balancers: Use DescribeLoadBalancers (https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_DescribeLoadBalancers.html) 250 // to get the value of CanonicalHostedZoneId . 251 // - CLI: Use describe-load-balancers to get the applicable value. For more 252 // information, see the applicable guide: 253 // - Classic Load Balancers: Use describe-load-balancers (http://docs.aws.amazon.com/cli/latest/reference/elb/describe-load-balancers.html) 254 // to get the value of CanonicalHostedZoneNameId . 255 // - Application and Network Load Balancers: Use describe-load-balancers (http://docs.aws.amazon.com/cli/latest/reference/elbv2/describe-load-balancers.html) 256 // to get the value of CanonicalHostedZoneId . 257 // Global Accelerator accelerator Specify Z2BJ6XQ5FK7U4H . An Amazon S3 bucket 258 // configured as a static website Specify the hosted zone ID for the region that 259 // you created the bucket in. For more information about valid values, see the 260 // table Amazon S3 Website Endpoints (https://docs.aws.amazon.com/general/latest/gr/s3.html#s3_website_region_endpoints) 261 // in the Amazon Web Services General Reference. Another Route 53 resource record 262 // set in your hosted zone Specify the hosted zone ID of your hosted zone. (An 263 // alias resource record set can't reference a resource record set in a different 264 // hosted zone.) 265 // 266 // This member is required. 267 HostedZoneId *string 268 269 noSmithyDocumentSerde 270 } 271 272 // The information for each resource record set that you want to change. 273 type Change struct { 274 275 // The action to perform: 276 // - CREATE : Creates a resource record set that has the specified values. 277 // - DELETE : Deletes a existing resource record set. To delete the resource 278 // record set that is associated with a traffic policy instance, use 279 // DeleteTrafficPolicyInstance (https://docs.aws.amazon.com/Route53/latest/APIReference/API_DeleteTrafficPolicyInstance.html) 280 // . Amazon Route 53 will delete the resource record set automatically. If you 281 // delete the resource record set by using ChangeResourceRecordSets , Route 53 282 // doesn't automatically delete the traffic policy instance, and you'll continue to 283 // be charged for it even though it's no longer in use. 284 // - UPSERT : If a resource record set doesn't already exist, Route 53 creates 285 // it. If a resource record set does exist, Route 53 updates it with the values in 286 // the request. 287 // 288 // This member is required. 289 Action ChangeAction 290 291 // Information about the resource record set to create, delete, or update. 292 // 293 // This member is required. 294 ResourceRecordSet *ResourceRecordSet 295 296 noSmithyDocumentSerde 297 } 298 299 // The information for a change request. 300 type ChangeBatch struct { 301 302 // Information about the changes to make to the record sets. 303 // 304 // This member is required. 305 Changes []Change 306 307 // Optional: Any comments you want to include about a change batch request. 308 Comment *string 309 310 noSmithyDocumentSerde 311 } 312 313 // A complex type that describes change information about changes made to your 314 // hosted zone. 315 type ChangeInfo struct { 316 317 // This element contains an ID that you use when performing a GetChange (https://docs.aws.amazon.com/Route53/latest/APIReference/API_GetChange.html) 318 // action to get detailed information about the change. 319 // 320 // This member is required. 321 Id *string 322 323 // The current state of the request. PENDING indicates that this request has not 324 // yet been applied to all Amazon Route 53 DNS servers. 325 // 326 // This member is required. 327 Status ChangeStatus 328 329 // The date and time that the change request was submitted in ISO 8601 format (https://en.wikipedia.org/wiki/ISO_8601) 330 // and Coordinated Universal Time (UTC). For example, the value 331 // 2017-03-27T17:48:16.751Z represents March 27, 2017 at 17:48:16.751 UTC. 332 // 333 // This member is required. 334 SubmittedAt *time.Time 335 336 // A comment you can provide. 337 Comment *string 338 339 noSmithyDocumentSerde 340 } 341 342 // A complex type that lists the CIDR blocks. 343 type CidrBlockSummary struct { 344 345 // Value for the CIDR block. 346 CidrBlock *string 347 348 // The location name of the CIDR block. 349 LocationName *string 350 351 noSmithyDocumentSerde 352 } 353 354 // A complex type that identifies a CIDR collection. 355 type CidrCollection struct { 356 357 // The ARN of the collection. Can be used to reference the collection in IAM 358 // policy or in another Amazon Web Services account. 359 Arn *string 360 361 // The unique ID of the CIDR collection. 362 Id *string 363 364 // The name of a CIDR collection. 365 Name *string 366 367 // A sequential counter that Route 53 sets to 1 when you create a CIDR collection 368 // and increments by 1 each time you update settings for the CIDR collection. 369 Version *int64 370 371 noSmithyDocumentSerde 372 } 373 374 // A complex type that contains information about the CIDR collection change. 375 type CidrCollectionChange struct { 376 377 // CIDR collection change action. 378 // 379 // This member is required. 380 Action CidrCollectionChangeAction 381 382 // List of CIDR blocks. 383 // 384 // This member is required. 385 CidrList []string 386 387 // Name of the location that is associated with the CIDR collection. 388 // 389 // This member is required. 390 LocationName *string 391 392 noSmithyDocumentSerde 393 } 394 395 // The object that is specified in resource record set object when you are linking 396 // a resource record set to a CIDR location. A LocationName with an asterisk “*” 397 // can be used to create a default CIDR record. CollectionId is still required for 398 // default record. 399 type CidrRoutingConfig struct { 400 401 // The CIDR collection ID. 402 // 403 // This member is required. 404 CollectionId *string 405 406 // The CIDR collection location name. 407 // 408 // This member is required. 409 LocationName *string 410 411 noSmithyDocumentSerde 412 } 413 414 // A complex type that contains information about the CloudWatch alarm that Amazon 415 // Route 53 is monitoring for this health check. 416 type CloudWatchAlarmConfiguration struct { 417 418 // For the metric that the CloudWatch alarm is associated with, the arithmetic 419 // operation that is used for the comparison. 420 // 421 // This member is required. 422 ComparisonOperator ComparisonOperator 423 424 // For the metric that the CloudWatch alarm is associated with, the number of 425 // periods that the metric is compared to the threshold. 426 // 427 // This member is required. 428 EvaluationPeriods *int32 429 430 // The name of the CloudWatch metric that the alarm is associated with. 431 // 432 // This member is required. 433 MetricName *string 434 435 // The namespace of the metric that the alarm is associated with. For more 436 // information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference (https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CW_Support_For_AWS.html) 437 // in the Amazon CloudWatch User Guide. 438 // 439 // This member is required. 440 Namespace *string 441 442 // For the metric that the CloudWatch alarm is associated with, the duration of 443 // one evaluation period in seconds. 444 // 445 // This member is required. 446 Period *int32 447 448 // For the metric that the CloudWatch alarm is associated with, the statistic that 449 // is applied to the metric. 450 // 451 // This member is required. 452 Statistic Statistic 453 454 // For the metric that the CloudWatch alarm is associated with, the value the 455 // metric is compared with. 456 // 457 // This member is required. 458 Threshold *float64 459 460 // For the metric that the CloudWatch alarm is associated with, a complex type 461 // that contains information about the dimensions for the metric. For information, 462 // see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference (https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CW_Support_For_AWS.html) 463 // in the Amazon CloudWatch User Guide. 464 Dimensions []Dimension 465 466 noSmithyDocumentSerde 467 } 468 469 // A complex type that is an entry in an CidrCollection (https://docs.aws.amazon.com/Route53/latest/APIReference/API_CidrCollection.html) 470 // array. 471 type CollectionSummary struct { 472 473 // The ARN of the collection summary. Can be used to reference the collection in 474 // IAM policy or cross-account. 475 Arn *string 476 477 // Unique ID for the CIDR collection. 478 Id *string 479 480 // The name of a CIDR collection. 481 Name *string 482 483 // A sequential counter that Route 53 sets to 1 when you create a CIDR collection 484 // and increments by 1 each time you update settings for the CIDR collection. 485 Version *int64 486 487 noSmithyDocumentSerde 488 } 489 490 // A complex type that lists the coordinates for a geoproximity resource record. 491 type Coordinates struct { 492 493 // Specifies a coordinate of the north–south position of a geographic point on the 494 // surface of the Earth (-90 - 90). 495 // 496 // This member is required. 497 Latitude *string 498 499 // Specifies a coordinate of the east–west position of a geographic point on the 500 // surface of the Earth (-180 - 180). 501 // 502 // This member is required. 503 Longitude *string 504 505 noSmithyDocumentSerde 506 } 507 508 // A complex type that lists the name servers in a delegation set, as well as the 509 // CallerReference and the ID for the delegation set. 510 type DelegationSet struct { 511 512 // A complex type that contains a list of the authoritative name servers for a 513 // hosted zone or for a reusable delegation set. 514 // 515 // This member is required. 516 NameServers []string 517 518 // The value that you specified for CallerReference when you created the reusable 519 // delegation set. 520 CallerReference *string 521 522 // The ID that Amazon Route 53 assigns to a reusable delegation set. 523 Id *string 524 525 noSmithyDocumentSerde 526 } 527 528 // For the metric that the CloudWatch alarm is associated with, a complex type 529 // that contains information about one dimension. 530 type Dimension struct { 531 532 // For the metric that the CloudWatch alarm is associated with, the name of one 533 // dimension. 534 // 535 // This member is required. 536 Name *string 537 538 // For the metric that the CloudWatch alarm is associated with, the value of one 539 // dimension. 540 // 541 // This member is required. 542 Value *string 543 544 noSmithyDocumentSerde 545 } 546 547 // A string representing the status of DNSSEC signing. 548 type DNSSECStatus struct { 549 550 // A string that represents the current hosted zone signing status. Status can 551 // have one of the following values: SIGNING DNSSEC signing is enabled for the 552 // hosted zone. NOT_SIGNING DNSSEC signing is not enabled for the hosted zone. 553 // DELETING DNSSEC signing is in the process of being removed for the hosted zone. 554 // ACTION_NEEDED There is a problem with signing in the hosted zone that requires 555 // you to take action to resolve. For example, the customer managed key might have 556 // been deleted, or the permissions for the customer managed key might have been 557 // changed. INTERNAL_FAILURE There was an error during a request. Before you can 558 // continue to work with DNSSEC signing, including with key-signing keys (KSKs), 559 // you must correct the problem by enabling or disabling DNSSEC signing for the 560 // hosted zone. 561 ServeSignature *string 562 563 // The status message provided for the following DNSSEC signing status: 564 // INTERNAL_FAILURE . The status message includes information about what the 565 // problem might be and steps that you can take to correct the issue. 566 StatusMessage *string 567 568 noSmithyDocumentSerde 569 } 570 571 // A complex type that contains information about a geographic location. 572 type GeoLocation struct { 573 574 // The two-letter code for the continent. Amazon Route 53 supports the following 575 // continent codes: 576 // - AF: Africa 577 // - AN: Antarctica 578 // - AS: Asia 579 // - EU: Europe 580 // - OC: Oceania 581 // - NA: North America 582 // - SA: South America 583 // Constraint: Specifying ContinentCode with either CountryCode or SubdivisionCode 584 // returns an InvalidInput error. 585 ContinentCode *string 586 587 // For geolocation resource record sets, the two-letter code for a country. Amazon 588 // Route 53 uses the two-letter country codes that are specified in ISO standard 589 // 3166-1 alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) . Route 53 590 // also supports the country code UA for Ukraine. 591 CountryCode *string 592 593 // For geolocation resource record sets, the two-letter code for a state of the 594 // United States. Route 53 doesn't support any other values for SubdivisionCode . 595 // For a list of state abbreviations, see Appendix B: Two–Letter State and 596 // Possession Abbreviations (https://pe.usps.com/text/pub28/28apb.htm) on the 597 // United States Postal Service website. If you specify subdivisioncode , you must 598 // also specify US for CountryCode . 599 SubdivisionCode *string 600 601 noSmithyDocumentSerde 602 } 603 604 // A complex type that contains the codes and full continent, country, and 605 // subdivision names for the specified geolocation code. 606 type GeoLocationDetails struct { 607 608 // The two-letter code for the continent. 609 ContinentCode *string 610 611 // The full name of the continent. 612 ContinentName *string 613 614 // The two-letter code for the country. 615 CountryCode *string 616 617 // The name of the country. 618 CountryName *string 619 620 // The code for the subdivision, such as a particular state within the United 621 // States. For a list of US state abbreviations, see Appendix B: Two–Letter State 622 // and Possession Abbreviations (https://pe.usps.com/text/pub28/28apb.htm) on the 623 // United States Postal Service website. For a list of all supported subdivision 624 // codes, use the ListGeoLocations (https://docs.aws.amazon.com/Route53/latest/APIReference/API_ListGeoLocations.html) 625 // API. 626 SubdivisionCode *string 627 628 // The full name of the subdivision. Route 53 currently supports only states in 629 // the United States. 630 SubdivisionName *string 631 632 noSmithyDocumentSerde 633 } 634 635 // (Resource record sets only): A complex type that lets you specify where your 636 // resources are located. Only one of LocalZoneGroup , Coordinates , or Amazon Web 637 // ServicesRegion is allowed per request at a time. For more information about 638 // geoproximity routing, see Geoproximity routing (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy-geoproximity.html) 639 // in the Amazon Route 53 Developer Guide. 640 type GeoProximityLocation struct { 641 642 // The Amazon Web Services Region the resource you are directing DNS traffic to, 643 // is in. 644 AWSRegion *string 645 646 // The bias increases or decreases the size of the geographic region from which 647 // Route 53 routes traffic to a resource. To use Bias to change the size of the 648 // geographic region, specify the applicable value for the bias: 649 // - To expand the size of the geographic region from which Route 53 routes 650 // traffic to a resource, specify a positive integer from 1 to 99 for the bias. 651 // Route 53 shrinks the size of adjacent regions. 652 // - To shrink the size of the geographic region from which Route 53 routes 653 // traffic to a resource, specify a negative bias of -1 to -99. Route 53 expands 654 // the size of adjacent regions. 655 Bias *int32 656 657 // Contains the longitude and latitude for a geographic region. 658 Coordinates *Coordinates 659 660 // Specifies an Amazon Web Services Local Zone Group. A local Zone Group is 661 // usually the Local Zone code without the ending character. For example, if the 662 // Local Zone is us-east-1-bue-1a the Local Zone Group is us-east-1-bue-1 . You can 663 // identify the Local Zones Group for a specific Local Zone by using the 664 // describe-availability-zones (https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-availability-zones.html) 665 // CLI command: This command returns: "GroupName": "us-west-2-den-1" , specifying 666 // that the Local Zone us-west-2-den-1a belongs to the Local Zone Group 667 // us-west-2-den-1 . 668 LocalZoneGroup *string 669 670 noSmithyDocumentSerde 671 } 672 673 // A complex type that contains information about one health check that is 674 // associated with the current Amazon Web Services account. 675 type HealthCheck struct { 676 677 // A unique string that you specified when you created the health check. 678 // 679 // This member is required. 680 CallerReference *string 681 682 // A complex type that contains detailed information about one health check. 683 // 684 // This member is required. 685 HealthCheckConfig *HealthCheckConfig 686 687 // The version of the health check. You can optionally pass this value in a call 688 // to UpdateHealthCheck to prevent overwriting another change to the health check. 689 // 690 // This member is required. 691 HealthCheckVersion *int64 692 693 // The identifier that Amazon Route 53 assigned to the health check when you 694 // created it. When you add or update a resource record set, you use this value to 695 // specify which health check to use. The value can be up to 64 characters long. 696 // 697 // This member is required. 698 Id *string 699 700 // A complex type that contains information about the CloudWatch alarm that Amazon 701 // Route 53 is monitoring for this health check. 702 CloudWatchAlarmConfiguration *CloudWatchAlarmConfiguration 703 704 // If the health check was created by another service, the service that created 705 // the health check. When a health check is created by another service, you can't 706 // edit or delete it using Amazon Route 53. 707 LinkedService *LinkedService 708 709 noSmithyDocumentSerde 710 } 711 712 // A complex type that contains information about the health check. 713 type HealthCheckConfig struct { 714 715 // The type of health check that you want to create, which indicates how Amazon 716 // Route 53 determines whether an endpoint is healthy. You can't change the value 717 // of Type after you create a health check. You can create the following types of 718 // health checks: 719 // - HTTP: Route 53 tries to establish a TCP connection. If successful, Route 53 720 // submits an HTTP request and waits for an HTTP status code of 200 or greater and 721 // less than 400. 722 // - HTTPS: Route 53 tries to establish a TCP connection. If successful, Route 723 // 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater 724 // and less than 400. If you specify HTTPS for the value of Type , the endpoint 725 // must support TLS v1.0 or later. 726 // - HTTP_STR_MATCH: Route 53 tries to establish a TCP connection. If 727 // successful, Route 53 submits an HTTP request and searches the first 5,120 bytes 728 // of the response body for the string that you specify in SearchString . 729 // - HTTPS_STR_MATCH: Route 53 tries to establish a TCP connection. If 730 // successful, Route 53 submits an HTTPS request and searches the first 5,120 731 // bytes of the response body for the string that you specify in SearchString . 732 // - TCP: Route 53 tries to establish a TCP connection. 733 // - CLOUDWATCH_METRIC: The health check is associated with a CloudWatch alarm. 734 // If the state of the alarm is OK , the health check is considered healthy. If 735 // the state is ALARM , the health check is considered unhealthy. If CloudWatch 736 // doesn't have sufficient data to determine whether the state is OK or ALARM , 737 // the health check status depends on the setting for 738 // InsufficientDataHealthStatus : Healthy , Unhealthy , or LastKnownStatus . 739 // - CALCULATED: For health checks that monitor the status of other health 740 // checks, Route 53 adds up the number of health checks that Route 53 health 741 // checkers consider to be healthy and compares that number with the value of 742 // HealthThreshold . 743 // - RECOVERY_CONTROL: The health check is associated with a Route53 Application 744 // Recovery Controller routing control. If the routing control state is ON , the 745 // health check is considered healthy. If the state is OFF , the health check is 746 // considered unhealthy. 747 // For more information, see How Route 53 Determines Whether an Endpoint Is Healthy (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-determining-health-of-endpoints.html) 748 // in the Amazon Route 53 Developer Guide. 749 // 750 // This member is required. 751 Type HealthCheckType 752 753 // A complex type that identifies the CloudWatch alarm that you want Amazon Route 754 // 53 health checkers to use to determine whether the specified health check is 755 // healthy. 756 AlarmIdentifier *AlarmIdentifier 757 758 // (CALCULATED Health Checks Only) A complex type that contains one 759 // ChildHealthCheck element for each health check that you want to associate with a 760 // CALCULATED health check. 761 ChildHealthChecks []string 762 763 // Stops Route 53 from performing health checks. When you disable a health check, 764 // here's what happens: 765 // - Health checks that check the health of endpoints: Route 53 stops submitting 766 // requests to your application, server, or other resource. 767 // - Calculated health checks: Route 53 stops aggregating the status of the 768 // referenced health checks. 769 // - Health checks that monitor CloudWatch alarms: Route 53 stops monitoring the 770 // corresponding CloudWatch metrics. 771 // After you disable a health check, Route 53 considers the status of the health 772 // check to always be healthy. If you configured DNS failover, Route 53 continues 773 // to route traffic to the corresponding resources. If you want to stop routing 774 // traffic to a resource, change the value of Inverted (https://docs.aws.amazon.com/Route53/latest/APIReference/API_UpdateHealthCheck.html#Route53-UpdateHealthCheck-request-Inverted) 775 // . Charges for a health check still apply when the health check is disabled. For 776 // more information, see Amazon Route 53 Pricing (http://aws.amazon.com/route53/pricing/) 777 // . 778 Disabled *bool 779 780 // Specify whether you want Amazon Route 53 to send the value of 781 // FullyQualifiedDomainName to the endpoint in the client_hello message during TLS 782 // negotiation. This allows the endpoint to respond to HTTPS health check requests 783 // with the applicable SSL/TLS certificate. Some endpoints require that HTTPS 784 // requests include the host name in the client_hello message. If you don't enable 785 // SNI, the status of the health check will be SSL alert handshake_failure . A 786 // health check can also have that status for other reasons. If SNI is enabled and 787 // you're still getting the error, check the SSL/TLS configuration on your endpoint 788 // and confirm that your certificate is valid. The SSL/TLS certificate on your 789 // endpoint includes a domain name in the Common Name field and possibly several 790 // more in the Subject Alternative Names field. One of the domain names in the 791 // certificate should match the value that you specify for FullyQualifiedDomainName 792 // . If the endpoint responds to the client_hello message with a certificate that 793 // does not include the domain name that you specified in FullyQualifiedDomainName 794 // , a health checker will retry the handshake. In the second attempt, the health 795 // checker will omit FullyQualifiedDomainName from the client_hello message. 796 EnableSNI *bool 797 798 // The number of consecutive health checks that an endpoint must pass or fail for 799 // Amazon Route 53 to change the current status of the endpoint from unhealthy to 800 // healthy or vice versa. For more information, see How Amazon Route 53 Determines 801 // Whether an Endpoint Is Healthy (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-determining-health-of-endpoints.html) 802 // in the Amazon Route 53 Developer Guide. If you don't specify a value for 803 // FailureThreshold , the default value is three health checks. 804 FailureThreshold *int32 805 806 // Amazon Route 53 behavior depends on whether you specify a value for IPAddress . 807 // If you specify a value for IPAddress : Amazon Route 53 sends health check 808 // requests to the specified IPv4 or IPv6 address and passes the value of 809 // FullyQualifiedDomainName in the Host header for all health checks except TCP 810 // health checks. This is typically the fully qualified DNS name of the endpoint on 811 // which you want Route 53 to perform health checks. When Route 53 checks the 812 // health of an endpoint, here is how it constructs the Host header: 813 // - If you specify a value of 80 for Port and HTTP or HTTP_STR_MATCH for Type , 814 // Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the 815 // Host header. 816 // - If you specify a value of 443 for Port and HTTPS or HTTPS_STR_MATCH for Type 817 // , Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the 818 // Host header. 819 // - If you specify another value for Port and any value except TCP for Type , 820 // Route 53 passes FullyQualifiedDomainName:Port to the endpoint in the Host 821 // header. 822 // If you don't specify a value for FullyQualifiedDomainName , Route 53 substitutes 823 // the value of IPAddress in the Host header in each of the preceding cases. If 824 // you don't specify a value for IPAddress : Route 53 sends a DNS request to the 825 // domain that you specify for FullyQualifiedDomainName at the interval that you 826 // specify for RequestInterval . Using an IPv4 address that DNS returns, Route 53 827 // then checks the health of the endpoint. If you don't specify a value for 828 // IPAddress , Route 53 uses only IPv4 to send health checks to the endpoint. If 829 // there's no resource record set with a type of A for the name that you specify 830 // for FullyQualifiedDomainName , the health check fails with a "DNS resolution 831 // failed" error. If you want to check the health of weighted, latency, or failover 832 // resource record sets and you choose to specify the endpoint only by 833 // FullyQualifiedDomainName , we recommend that you create a separate health check 834 // for each endpoint. For example, create a health check for each HTTP server that 835 // is serving content for www.example.com. For the value of 836 // FullyQualifiedDomainName , specify the domain name of the server (such as 837 // us-east-2-www.example.com), not the name of the resource record sets 838 // (www.example.com). In this configuration, if you create a health check for which 839 // the value of FullyQualifiedDomainName matches the name of the resource record 840 // sets and you then associate the health check with those resource record sets, 841 // health check results will be unpredictable. In addition, if the value that you 842 // specify for Type is HTTP , HTTPS , HTTP_STR_MATCH , or HTTPS_STR_MATCH , Route 843 // 53 passes the value of FullyQualifiedDomainName in the Host header, as it does 844 // when you specify a value for IPAddress . If the value of Type is TCP , Route 53 845 // doesn't pass a Host header. 846 FullyQualifiedDomainName *string 847 848 // The number of child health checks that are associated with a CALCULATED health 849 // check that Amazon Route 53 must consider healthy for the CALCULATED health 850 // check to be considered healthy. To specify the child health checks that you want 851 // to associate with a CALCULATED health check, use the ChildHealthChecks (https://docs.aws.amazon.com/Route53/latest/APIReference/API_UpdateHealthCheck.html#Route53-UpdateHealthCheck-request-ChildHealthChecks) 852 // element. Note the following: 853 // - If you specify a number greater than the number of child health checks, 854 // Route 53 always considers this health check to be unhealthy. 855 // - If you specify 0 , Route 53 always considers this health check to be 856 // healthy. 857 HealthThreshold *int32 858 859 // The IPv4 or IPv6 IP address of the endpoint that you want Amazon Route 53 to 860 // perform health checks on. If you don't specify a value for IPAddress , Route 53 861 // sends a DNS request to resolve the domain name that you specify in 862 // FullyQualifiedDomainName at the interval that you specify in RequestInterval . 863 // Using an IP address returned by DNS, Route 53 then checks the health of the 864 // endpoint. Use one of the following formats for the value of IPAddress : 865 // - IPv4 address: four values between 0 and 255, separated by periods (.), for 866 // example, 192.0.2.44 . 867 // - IPv6 address: eight groups of four hexadecimal values, separated by colons 868 // (:), for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345 . You can also 869 // shorten IPv6 addresses as described in RFC 5952, for example, 870 // 2001:db8:85a3::abcd:1:2345 . 871 // If the endpoint is an EC2 instance, we recommend that you create an Elastic IP 872 // address, associate it with your EC2 instance, and specify the Elastic IP address 873 // for IPAddress . This ensures that the IP address of your instance will never 874 // change. For more information, see FullyQualifiedDomainName (https://docs.aws.amazon.com/Route53/latest/APIReference/API_UpdateHealthCheck.html#Route53-UpdateHealthCheck-request-FullyQualifiedDomainName) 875 // . Constraints: Route 53 can't check the health of endpoints for which the IP 876 // address is in local, private, non-routable, or multicast ranges. For more 877 // information about IP addresses for which you can't create health checks, see the 878 // following documents: 879 // - RFC 5735, Special Use IPv4 Addresses (https://tools.ietf.org/html/rfc5735) 880 // - RFC 6598, IANA-Reserved IPv4 Prefix for Shared Address Space (https://tools.ietf.org/html/rfc6598) 881 // - RFC 5156, Special-Use IPv6 Addresses (https://tools.ietf.org/html/rfc5156) 882 // When the value of Type is CALCULATED or CLOUDWATCH_METRIC , omit IPAddress . 883 IPAddress *string 884 885 // When CloudWatch has insufficient data about the metric to determine the alarm 886 // state, the status that you want Amazon Route 53 to assign to the health check: 887 // - Healthy : Route 53 considers the health check to be healthy. 888 // - Unhealthy : Route 53 considers the health check to be unhealthy. 889 // - LastKnownStatus : Route 53 uses the status of the health check from the last 890 // time that CloudWatch had sufficient data to determine the alarm state. For new 891 // health checks that have no last known status, the default status for the health 892 // check is healthy. 893 InsufficientDataHealthStatus InsufficientDataHealthStatus 894 895 // Specify whether you want Amazon Route 53 to invert the status of a health 896 // check, for example, to consider a health check unhealthy when it otherwise would 897 // be considered healthy. 898 Inverted *bool 899 900 // Specify whether you want Amazon Route 53 to measure the latency between health 901 // checkers in multiple Amazon Web Services regions and your endpoint, and to 902 // display CloudWatch latency graphs on the Health Checks page in the Route 53 903 // console. You can't change the value of MeasureLatency after you create a health 904 // check. 905 MeasureLatency *bool 906 907 // The port on the endpoint that you want Amazon Route 53 to perform health checks 908 // on. Don't specify a value for Port when you specify a value for Type of 909 // CLOUDWATCH_METRIC or CALCULATED . 910 Port *int32 911 912 // A complex type that contains one Region element for each region from which you 913 // want Amazon Route 53 health checkers to check the specified endpoint. If you 914 // don't specify any regions, Route 53 health checkers automatically performs 915 // checks from all of the regions that are listed under Valid Values. If you update 916 // a health check to remove a region that has been performing health checks, Route 917 // 53 will briefly continue to perform checks from that region to ensure that some 918 // health checkers are always checking the endpoint (for example, if you replace 919 // three regions with four different regions). 920 Regions []HealthCheckRegion 921 922 // The number of seconds between the time that Amazon Route 53 gets a response 923 // from your endpoint and the time that it sends the next health check request. 924 // Each Route 53 health checker makes requests at this interval. You can't change 925 // the value of RequestInterval after you create a health check. If you don't 926 // specify a value for RequestInterval , the default value is 30 seconds. 927 RequestInterval *int32 928 929 // The path, if any, that you want Amazon Route 53 to request when performing 930 // health checks. The path can be any value for which your endpoint will return an 931 // HTTP status code of 2xx or 3xx when the endpoint is healthy, for example, the 932 // file /docs/route53-health-check.html. You can also include query string 933 // parameters, for example, /welcome.html?language=jp&login=y . 934 ResourcePath *string 935 936 // The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller 937 // routing control. For more information about Route 53 Application Recovery 938 // Controller, see Route 53 Application Recovery Controller Developer Guide. (https://docs.aws.amazon.com/r53recovery/latest/dg/what-is-route-53-recovery.html) 939 // . 940 RoutingControlArn *string 941 942 // If the value of Type is HTTP_STR_MATCH or HTTPS_STR_MATCH , the string that you 943 // want Amazon Route 53 to search for in the response body from the specified 944 // resource. If the string appears in the response body, Route 53 considers the 945 // resource healthy. Route 53 considers case when searching for SearchString in 946 // the response body. 947 SearchString *string 948 949 noSmithyDocumentSerde 950 } 951 952 // A complex type that contains the last failure reason as reported by one Amazon 953 // Route 53 health checker. 954 type HealthCheckObservation struct { 955 956 // The IP address of the Amazon Route 53 health checker that provided the failure 957 // reason in StatusReport . 958 IPAddress *string 959 960 // The region of the Amazon Route 53 health checker that provided the status in 961 // StatusReport . 962 Region HealthCheckRegion 963 964 // A complex type that contains the last failure reason as reported by one Amazon 965 // Route 53 health checker and the time of the failed health check. 966 StatusReport *StatusReport 967 968 noSmithyDocumentSerde 969 } 970 971 // A complex type that contains general information about the hosted zone. 972 type HostedZone struct { 973 974 // The value that you specified for CallerReference when you created the hosted 975 // zone. 976 // 977 // This member is required. 978 CallerReference *string 979 980 // The ID that Amazon Route 53 assigned to the hosted zone when you created it. 981 // 982 // This member is required. 983 Id *string 984 985 // The name of the domain. For public hosted zones, this is the name that you have 986 // registered with your DNS registrar. For information about how to specify 987 // characters other than a-z , 0-9 , and - (hyphen) and how to specify 988 // internationalized domain names, see CreateHostedZone (https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateHostedZone.html) 989 // . 990 // 991 // This member is required. 992 Name *string 993 994 // A complex type that includes the Comment and PrivateZone elements. If you 995 // omitted the HostedZoneConfig and Comment elements from the request, the Config 996 // and Comment elements don't appear in the response. 997 Config *HostedZoneConfig 998 999 // If the hosted zone was created by another service, the service that created the 1000 // hosted zone. When a hosted zone is created by another service, you can't edit or 1001 // delete it using Route 53. 1002 LinkedService *LinkedService 1003 1004 // The number of resource record sets in the hosted zone. 1005 ResourceRecordSetCount *int64 1006 1007 noSmithyDocumentSerde 1008 } 1009 1010 // A complex type that contains an optional comment about your hosted zone. If you 1011 // don't want to specify a comment, omit both the HostedZoneConfig and Comment 1012 // elements. 1013 type HostedZoneConfig struct { 1014 1015 // Any comments that you want to include about the hosted zone. 1016 Comment *string 1017 1018 // A value that indicates whether this is a private hosted zone. 1019 PrivateZone bool 1020 1021 noSmithyDocumentSerde 1022 } 1023 1024 // A complex type that contains the type of limit that you specified in the 1025 // request and the current value for that limit. 1026 type HostedZoneLimit struct { 1027 1028 // The limit that you requested. Valid values include the following: 1029 // - MAX_RRSETS_BY_ZONE: The maximum number of records that you can create in 1030 // the specified hosted zone. 1031 // - MAX_VPCS_ASSOCIATED_BY_ZONE: The maximum number of Amazon VPCs that you can 1032 // associate with the specified private hosted zone. 1033 // 1034 // This member is required. 1035 Type HostedZoneLimitType 1036 1037 // The current value for the limit that is specified by Type . 1038 // 1039 // This member is required. 1040 Value *int64 1041 1042 noSmithyDocumentSerde 1043 } 1044 1045 // A complex type that identifies a hosted zone that a specified Amazon VPC is 1046 // associated with and the owner of the hosted zone. If there is a value for 1047 // OwningAccount , there is no value for OwningService , and vice versa. 1048 type HostedZoneOwner struct { 1049 1050 // If the hosted zone was created by an Amazon Web Services account, or was 1051 // created by an Amazon Web Services service that creates hosted zones using the 1052 // current account, OwningAccount contains the account ID of that account. For 1053 // example, when you use Cloud Map to create a hosted zone, Cloud Map creates the 1054 // hosted zone using the current Amazon Web Services account. 1055 OwningAccount *string 1056 1057 // If an Amazon Web Services service uses its own account to create a hosted zone 1058 // and associate the specified VPC with that hosted zone, OwningService contains 1059 // an abbreviation that identifies the service. For example, if Amazon Elastic File 1060 // System (Amazon EFS) created a hosted zone and associated a VPC with the hosted 1061 // zone, the value of OwningService is efs.amazonaws.com . 1062 OwningService *string 1063 1064 noSmithyDocumentSerde 1065 } 1066 1067 // In the response to a ListHostedZonesByVPC request, the HostedZoneSummaries 1068 // element contains one HostedZoneSummary element for each hosted zone that the 1069 // specified Amazon VPC is associated with. Each HostedZoneSummary element 1070 // contains the hosted zone name and ID, and information about who owns the hosted 1071 // zone. 1072 type HostedZoneSummary struct { 1073 1074 // The Route 53 hosted zone ID of a private hosted zone that the specified VPC is 1075 // associated with. 1076 // 1077 // This member is required. 1078 HostedZoneId *string 1079 1080 // The name of the private hosted zone, such as example.com . 1081 // 1082 // This member is required. 1083 Name *string 1084 1085 // The owner of a private hosted zone that the specified VPC is associated with. 1086 // The owner can be either an Amazon Web Services account or an Amazon Web Services 1087 // service. 1088 // 1089 // This member is required. 1090 Owner *HostedZoneOwner 1091 1092 noSmithyDocumentSerde 1093 } 1094 1095 // A key-signing key (KSK) is a complex type that represents a public/private key 1096 // pair. The private key is used to generate a digital signature for the zone 1097 // signing key (ZSK). The public key is stored in the DNS and is used to 1098 // authenticate the ZSK. A KSK is always associated with a hosted zone; it cannot 1099 // exist by itself. 1100 type KeySigningKey struct { 1101 1102 // The date when the key-signing key (KSK) was created. 1103 CreatedDate *time.Time 1104 1105 // A string that represents a DNSKEY record. 1106 DNSKEYRecord *string 1107 1108 // A string that represents a delegation signer (DS) record. 1109 DSRecord *string 1110 1111 // A string used to represent the delegation signer digest algorithm. This value 1112 // must follow the guidelines provided by RFC-8624 Section 3.3 (https://tools.ietf.org/html/rfc8624#section-3.3) 1113 // . 1114 DigestAlgorithmMnemonic *string 1115 1116 // An integer used to represent the delegation signer digest algorithm. This value 1117 // must follow the guidelines provided by RFC-8624 Section 3.3 (https://tools.ietf.org/html/rfc8624#section-3.3) 1118 // . 1119 DigestAlgorithmType int32 1120 1121 // A cryptographic digest of a DNSKEY resource record (RR). DNSKEY records are 1122 // used to publish the public key that resolvers can use to verify DNSSEC 1123 // signatures that are used to secure certain kinds of information provided by the 1124 // DNS system. 1125 DigestValue *string 1126 1127 // An integer that specifies how the key is used. For key-signing key (KSK), this 1128 // value is always 257. 1129 Flag int32 1130 1131 // An integer used to identify the DNSSEC record for the domain name. The process 1132 // used to calculate the value is described in RFC-4034 Appendix B (https://tools.ietf.org/rfc/rfc4034.txt) 1133 // . 1134 KeyTag int32 1135 1136 // The Amazon resource name (ARN) used to identify the customer managed key in Key 1137 // Management Service (KMS). The KmsArn must be unique for each key-signing key 1138 // (KSK) in a single hosted zone. You must configure the customer managed key as 1139 // follows: Status Enabled Key spec ECC_NIST_P256 Key usage Sign and verify Key 1140 // policy The key policy must give permission for the following actions: 1141 // - DescribeKey 1142 // - GetPublicKey 1143 // - Sign 1144 // The key policy must also include the Amazon Route 53 service in the principal 1145 // for your account. Specify the following: 1146 // - "Service": "dnssec-route53.amazonaws.com" 1147 // For more information about working with the customer managed key in KMS, see 1148 // Key Management Service concepts (https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html) 1149 // . 1150 KmsArn *string 1151 1152 // The last time that the key-signing key (KSK) was changed. 1153 LastModifiedDate *time.Time 1154 1155 // A string used to identify a key-signing key (KSK). Name can include numbers, 1156 // letters, and underscores (_). Name must be unique for each key-signing key in 1157 // the same hosted zone. 1158 Name *string 1159 1160 // The public key, represented as a Base64 encoding, as required by RFC-4034 Page 1161 // 5 (https://tools.ietf.org/rfc/rfc4034.txt) . 1162 PublicKey *string 1163 1164 // A string used to represent the signing algorithm. This value must follow the 1165 // guidelines provided by RFC-8624 Section 3.1 (https://tools.ietf.org/html/rfc8624#section-3.1) 1166 // . 1167 SigningAlgorithmMnemonic *string 1168 1169 // An integer used to represent the signing algorithm. This value must follow the 1170 // guidelines provided by RFC-8624 Section 3.1 (https://tools.ietf.org/html/rfc8624#section-3.1) 1171 // . 1172 SigningAlgorithmType int32 1173 1174 // A string that represents the current key-signing key (KSK) status. Status can 1175 // have one of the following values: ACTIVE The KSK is being used for signing. 1176 // INACTIVE The KSK is not being used for signing. DELETING The KSK is in the 1177 // process of being deleted. ACTION_NEEDED There is a problem with the KSK that 1178 // requires you to take action to resolve. For example, the customer managed key 1179 // might have been deleted, or the permissions for the customer managed key might 1180 // have been changed. INTERNAL_FAILURE There was an error during a request. Before 1181 // you can continue to work with DNSSEC signing, including actions that involve 1182 // this KSK, you must correct the problem. For example, you may need to activate or 1183 // deactivate the KSK. 1184 Status *string 1185 1186 // The status message provided for the following key-signing key (KSK) statuses: 1187 // ACTION_NEEDED or INTERNAL_FAILURE . The status message includes information 1188 // about what the problem might be and steps that you can take to correct the 1189 // issue. 1190 StatusMessage *string 1191 1192 noSmithyDocumentSerde 1193 } 1194 1195 // If a health check or hosted zone was created by another service, LinkedService 1196 // is a complex type that describes the service that created the resource. When a 1197 // resource is created by another service, you can't edit or delete it using Amazon 1198 // Route 53. 1199 type LinkedService struct { 1200 1201 // If the health check or hosted zone was created by another service, an optional 1202 // description that can be provided by the other service. When a resource is 1203 // created by another service, you can't edit or delete it using Amazon Route 53. 1204 Description *string 1205 1206 // If the health check or hosted zone was created by another service, the service 1207 // that created the resource. When a resource is created by another service, you 1208 // can't edit or delete it using Amazon Route 53. 1209 ServicePrincipal *string 1210 1211 noSmithyDocumentSerde 1212 } 1213 1214 // A complex type that contains information about the CIDR location. 1215 type LocationSummary struct { 1216 1217 // A string that specifies a location name. 1218 LocationName *string 1219 1220 noSmithyDocumentSerde 1221 } 1222 1223 // A complex type that contains information about a configuration for DNS query 1224 // logging. 1225 type QueryLoggingConfig struct { 1226 1227 // The Amazon Resource Name (ARN) of the CloudWatch Logs log group that Amazon 1228 // Route 53 is publishing logs to. 1229 // 1230 // This member is required. 1231 CloudWatchLogsLogGroupArn *string 1232 1233 // The ID of the hosted zone that CloudWatch Logs is logging queries for. 1234 // 1235 // This member is required. 1236 HostedZoneId *string 1237 1238 // The ID for a configuration for DNS query logging. 1239 // 1240 // This member is required. 1241 Id *string 1242 1243 noSmithyDocumentSerde 1244 } 1245 1246 // Information specific to the resource record. If you're creating an alias 1247 // resource record set, omit ResourceRecord . 1248 type ResourceRecord struct { 1249 1250 // The current or new DNS record value, not to exceed 4,000 characters. In the 1251 // case of a DELETE action, if the current value does not match the actual value, 1252 // an error is returned. For descriptions about how to format Value for different 1253 // record types, see Supported DNS Resource Record Types (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html) 1254 // in the Amazon Route 53 Developer Guide. You can specify more than one value for 1255 // all record types except CNAME and SOA . If you're creating an alias resource 1256 // record set, omit Value . 1257 // 1258 // This member is required. 1259 Value *string 1260 1261 noSmithyDocumentSerde 1262 } 1263 1264 // Information about the resource record set to create or delete. 1265 type ResourceRecordSet struct { 1266 1267 // For ChangeResourceRecordSets requests, the name of the record that you want to 1268 // create, update, or delete. For ListResourceRecordSets responses, the name of a 1269 // record in the specified hosted zone. ChangeResourceRecordSets Only Enter a fully 1270 // qualified domain name, for example, www.example.com . You can optionally include 1271 // a trailing dot. If you omit the trailing dot, Amazon Route 53 assumes that the 1272 // domain name that you specify is fully qualified. This means that Route 53 treats 1273 // www.example.com (without a trailing dot) and www.example.com. (with a trailing 1274 // dot) as identical. For information about how to specify characters other than 1275 // a-z , 0-9 , and - (hyphen) and how to specify internationalized domain names, 1276 // see DNS Domain Name Format (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.html) 1277 // in the Amazon Route 53 Developer Guide. You can use the asterisk (*) wildcard to 1278 // replace the leftmost label in a domain name, for example, *.example.com . Note 1279 // the following: 1280 // - The * must replace the entire label. For example, you can't specify 1281 // *prod.example.com or prod*.example.com . 1282 // - The * can't replace any of the middle labels, for example, 1283 // marketing.*.example.com. 1284 // - If you include * in any position other than the leftmost label in a domain 1285 // name, DNS treats it as an * character (ASCII 42), not as a wildcard. You can't 1286 // use the * wildcard for resource records sets that have a type of NS. 1287 // 1288 // This member is required. 1289 Name *string 1290 1291 // The DNS record type. For information about different record types and how data 1292 // is encoded for them, see Supported DNS Resource Record Types (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html) 1293 // in the Amazon Route 53 Developer Guide. Valid values for basic resource record 1294 // sets: A | AAAA | CAA | CNAME | DS | MX | NAPTR | NS | PTR | SOA | SPF | SRV | 1295 // TXT Values for weighted, latency, geolocation, and failover resource record 1296 // sets: A | AAAA | CAA | CNAME | MX | NAPTR | PTR | SPF | SRV | TXT . When 1297 // creating a group of weighted, latency, geolocation, or failover resource record 1298 // sets, specify the same value for all of the resource record sets in the group. 1299 // Valid values for multivalue answer resource record sets: A | AAAA | MX | NAPTR 1300 // | PTR | SPF | SRV | TXT SPF records were formerly used to verify the identity 1301 // of the sender of email messages. However, we no longer recommend that you create 1302 // resource record sets for which the value of Type is SPF . RFC 7208, Sender 1303 // Policy Framework (SPF) for Authorizing Use of Domains in Email, Version 1, has 1304 // been updated to say, "...[I]ts existence and mechanism defined in [RFC4408] have 1305 // led to some interoperability issues. Accordingly, its use is no longer 1306 // appropriate for SPF version 1; implementations are not to use it." In RFC 7208, 1307 // see section 14.1, The SPF DNS Record Type (http://tools.ietf.org/html/rfc7208#section-14.1) 1308 // . Values for alias resource record sets: 1309 // - Amazon API Gateway custom regional APIs and edge-optimized APIs: A 1310 // - CloudFront distributions: A If IPv6 is enabled for the distribution, create 1311 // two resource record sets to route traffic to your distribution, one with a value 1312 // of A and one with a value of AAAA . 1313 // - Amazon API Gateway environment that has a regionalized subdomain: A 1314 // - ELB load balancers: A | AAAA 1315 // - Amazon S3 buckets: A 1316 // - Amazon Virtual Private Cloud interface VPC endpoints A 1317 // - Another resource record set in this hosted zone: Specify the type of the 1318 // resource record set that you're creating the alias for. All values are supported 1319 // except NS and SOA . If you're creating an alias record that has the same name 1320 // as the hosted zone (known as the zone apex), you can't route traffic to a record 1321 // for which the value of Type is CNAME . This is because the alias record must 1322 // have the same type as the record you're routing traffic to, and creating a CNAME 1323 // record for the zone apex isn't supported even for an alias record. 1324 // 1325 // This member is required. 1326 Type RRType 1327 1328 // Alias resource record sets only: Information about the Amazon Web Services 1329 // resource, such as a CloudFront distribution or an Amazon S3 bucket, that you 1330 // want to route traffic to. If you're creating resource records sets for a private 1331 // hosted zone, note the following: 1332 // - You can't create an alias resource record set in a private hosted zone to 1333 // route traffic to a CloudFront distribution. 1334 // - For information about creating failover resource record sets in a private 1335 // hosted zone, see Configuring Failover in a Private Hosted Zone (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html) 1336 // in the Amazon Route 53 Developer Guide. 1337 AliasTarget *AliasTarget 1338 1339 // The object that is specified in resource record set object when you are linking 1340 // a resource record set to a CIDR location. A LocationName with an asterisk “*” 1341 // can be used to create a default CIDR record. CollectionId is still required for 1342 // default record. 1343 CidrRoutingConfig *CidrRoutingConfig 1344 1345 // Failover resource record sets only: To configure failover, you add the Failover 1346 // element to two resource record sets. For one resource record set, you specify 1347 // PRIMARY as the value for Failover ; for the other resource record set, you 1348 // specify SECONDARY . In addition, you include the HealthCheckId element and 1349 // specify the health check that you want Amazon Route 53 to perform for each 1350 // resource record set. Except where noted, the following failover behaviors assume 1351 // that you have included the HealthCheckId element in both resource record sets: 1352 // - When the primary resource record set is healthy, Route 53 responds to DNS 1353 // queries with the applicable value from the primary resource record set 1354 // regardless of the health of the secondary resource record set. 1355 // - When the primary resource record set is unhealthy and the secondary 1356 // resource record set is healthy, Route 53 responds to DNS queries with the 1357 // applicable value from the secondary resource record set. 1358 // - When the secondary resource record set is unhealthy, Route 53 responds to 1359 // DNS queries with the applicable value from the primary resource record set 1360 // regardless of the health of the primary resource record set. 1361 // - If you omit the HealthCheckId element for the secondary resource record set, 1362 // and if the primary resource record set is unhealthy, Route 53 always responds to 1363 // DNS queries with the applicable value from the secondary resource record set. 1364 // This is true regardless of the health of the associated endpoint. 1365 // You can't create non-failover resource record sets that have the same values 1366 // for the Name and Type elements as failover resource record sets. For failover 1367 // alias resource record sets, you must also include the EvaluateTargetHealth 1368 // element and set the value to true. For more information about configuring 1369 // failover for Route 53, see the following topics in the Amazon Route 53 Developer 1370 // Guide: 1371 // - Route 53 Health Checks and DNS Failover (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html) 1372 // - Configuring Failover in a Private Hosted Zone (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html) 1373 Failover ResourceRecordSetFailover 1374 1375 // Geolocation resource record sets only: A complex type that lets you control how 1376 // Amazon Route 53 responds to DNS queries based on the geographic origin of the 1377 // query. For example, if you want all queries from Africa to be routed to a web 1378 // server with an IP address of 192.0.2.111 , create a resource record set with a 1379 // Type of A and a ContinentCode of AF . If you create separate resource record 1380 // sets for overlapping geographic regions (for example, one resource record set 1381 // for a continent and one for a country on the same continent), priority goes to 1382 // the smallest geographic region. This allows you to route most queries for a 1383 // continent to one resource and to route queries for a country on that continent 1384 // to a different resource. You can't create two geolocation resource record sets 1385 // that specify the same geographic location. The value * in the CountryCode 1386 // element matches all geographic locations that aren't specified in other 1387 // geolocation resource record sets that have the same values for the Name and Type 1388 // elements. Geolocation works by mapping IP addresses to locations. However, some 1389 // IP addresses aren't mapped to geographic locations, so even if you create 1390 // geolocation resource record sets that cover all seven continents, Route 53 will 1391 // receive some DNS queries from locations that it can't identify. We recommend 1392 // that you create a resource record set for which the value of CountryCode is * . 1393 // Two groups of queries are routed to the resource that you specify in this 1394 // record: queries that come from locations for which you haven't created 1395 // geolocation resource record sets and queries from IP addresses that aren't 1396 // mapped to a location. If you don't create a * resource record set, Route 53 1397 // returns a "no answer" response for queries from those locations. You can't 1398 // create non-geolocation resource record sets that have the same values for the 1399 // Name and Type elements as geolocation resource record sets. 1400 GeoLocation *GeoLocation 1401 1402 // GeoproximityLocation resource record sets only: A complex type that lets you 1403 // control how Route 53 responds to DNS queries based on the geographic origin of 1404 // the query and your resources. 1405 GeoProximityLocation *GeoProximityLocation 1406 1407 // If you want Amazon Route 53 to return this resource record set in response to a 1408 // DNS query only when the status of a health check is healthy, include the 1409 // HealthCheckId element and specify the ID of the applicable health check. Route 1410 // 53 determines whether a resource record set is healthy based on one of the 1411 // following: 1412 // - By periodically sending a request to the endpoint that is specified in the 1413 // health check 1414 // - By aggregating the status of a specified group of health checks (calculated 1415 // health checks) 1416 // - By determining the current state of a CloudWatch alarm (CloudWatch metric 1417 // health checks) 1418 // Route 53 doesn't check the health of the endpoint that is specified in the 1419 // resource record set, for example, the endpoint specified by the IP address in 1420 // the Value element. When you add a HealthCheckId element to a resource record 1421 // set, Route 53 checks the health of the endpoint that you specified in the health 1422 // check. For more information, see the following topics in the Amazon Route 53 1423 // Developer Guide: 1424 // - How Amazon Route 53 Determines Whether an Endpoint Is Healthy (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-determining-health-of-endpoints.html) 1425 // - Route 53 Health Checks and DNS Failover (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover.html) 1426 // - Configuring Failover in a Private Hosted Zone (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-private-hosted-zones.html) 1427 // When to Specify HealthCheckId Specifying a value for HealthCheckId is useful 1428 // only when Route 53 is choosing between two or more resource record sets to 1429 // respond to a DNS query, and you want Route 53 to base the choice in part on the 1430 // status of a health check. Configuring health checks makes sense only in the 1431 // following configurations: 1432 // - Non-alias resource record sets: You're checking the health of a group of 1433 // non-alias resource record sets that have the same routing policy, name, and type 1434 // (such as multiple weighted records named www.example.com with a type of A) and 1435 // you specify health check IDs for all the resource record sets. If the health 1436 // check status for a resource record set is healthy, Route 53 includes the record 1437 // among the records that it responds to DNS queries with. If the health check 1438 // status for a resource record set is unhealthy, Route 53 stops responding to DNS 1439 // queries using the value for that resource record set. If the health check status 1440 // for all resource record sets in the group is unhealthy, Route 53 considers all 1441 // resource record sets in the group healthy and responds to DNS queries 1442 // accordingly. 1443 // - Alias resource record sets: You specify the following settings: 1444 // - You set EvaluateTargetHealth to true for an alias resource record set in a 1445 // group of resource record sets that have the same routing policy, name, and type 1446 // (such as multiple weighted records named www.example.com with a type of A). 1447 // - You configure the alias resource record set to route traffic to a non-alias 1448 // resource record set in the same hosted zone. 1449 // - You specify a health check ID for the non-alias resource record set. If the 1450 // health check status is healthy, Route 53 considers the alias resource record set 1451 // to be healthy and includes the alias record among the records that it responds 1452 // to DNS queries with. If the health check status is unhealthy, Route 53 stops 1453 // responding to DNS queries using the alias resource record set. The alias 1454 // resource record set can also route traffic to a group of non-alias resource 1455 // record sets that have the same routing policy, name, and type. In that 1456 // configuration, associate health checks with all of the resource record sets in 1457 // the group of non-alias resource record sets. 1458 // Geolocation Routing For geolocation resource record sets, if an endpoint is 1459 // unhealthy, Route 53 looks for a resource record set for the larger, associated 1460 // geographic region. For example, suppose you have resource record sets for a 1461 // state in the United States, for the entire United States, for North America, and 1462 // a resource record set that has * for CountryCode is * , which applies to all 1463 // locations. If the endpoint for the state resource record set is unhealthy, Route 1464 // 53 checks for healthy resource record sets in the following order until it finds 1465 // a resource record set for which the endpoint is healthy: 1466 // - The United States 1467 // - North America 1468 // - The default resource record set 1469 // Specifying the Health Check Endpoint by Domain Name If your health checks 1470 // specify the endpoint only by domain name, we recommend that you create a 1471 // separate health check for each endpoint. For example, create a health check for 1472 // each HTTP server that is serving content for www.example.com . For the value of 1473 // FullyQualifiedDomainName , specify the domain name of the server (such as 1474 // us-east-2-www.example.com ), not the name of the resource record sets ( 1475 // www.example.com ). Health check results will be unpredictable if you do the 1476 // following: 1477 // - Create a health check that has the same value for FullyQualifiedDomainName 1478 // as the name of a resource record set. 1479 // - Associate that health check with the resource record set. 1480 HealthCheckId *string 1481 1482 // Multivalue answer resource record sets only: To route traffic approximately 1483 // randomly to multiple resources, such as web servers, create one multivalue 1484 // answer record for each resource and specify true for MultiValueAnswer . Note the 1485 // following: 1486 // - If you associate a health check with a multivalue answer resource record 1487 // set, Amazon Route 53 responds to DNS queries with the corresponding IP address 1488 // only when the health check is healthy. 1489 // - If you don't associate a health check with a multivalue answer record, 1490 // Route 53 always considers the record to be healthy. 1491 // - Route 53 responds to DNS queries with up to eight healthy records; if you 1492 // have eight or fewer healthy records, Route 53 responds to all DNS queries with 1493 // all the healthy records. 1494 // - If you have more than eight healthy records, Route 53 responds to different 1495 // DNS resolvers with different combinations of healthy records. 1496 // - When all records are unhealthy, Route 53 responds to DNS queries with up to 1497 // eight unhealthy records. 1498 // - If a resource becomes unavailable after a resolver caches a response, 1499 // client software typically tries another of the IP addresses in the response. 1500 // You can't create multivalue answer alias records. 1501 MultiValueAnswer *bool 1502 1503 // Latency-based resource record sets only: The Amazon EC2 Region where you 1504 // created the resource that this resource record set refers to. The resource 1505 // typically is an Amazon Web Services resource, such as an EC2 instance or an ELB 1506 // load balancer, and is referred to by an IP address or a DNS domain name, 1507 // depending on the record type. When Amazon Route 53 receives a DNS query for a 1508 // domain name and type for which you have created latency resource record sets, 1509 // Route 53 selects the latency resource record set that has the lowest latency 1510 // between the end user and the associated Amazon EC2 Region. Route 53 then returns 1511 // the value that is associated with the selected resource record set. Note the 1512 // following: 1513 // - You can only specify one ResourceRecord per latency resource record set. 1514 // - You can only create one latency resource record set for each Amazon EC2 1515 // Region. 1516 // - You aren't required to create latency resource record sets for all Amazon 1517 // EC2 Regions. Route 53 will choose the region with the best latency from among 1518 // the regions that you create latency resource record sets for. 1519 // - You can't create non-latency resource record sets that have the same values 1520 // for the Name and Type elements as latency resource record sets. 1521 Region ResourceRecordSetRegion 1522 1523 // Information about the resource records to act upon. If you're creating an alias 1524 // resource record set, omit ResourceRecords . 1525 ResourceRecords []ResourceRecord 1526 1527 // Resource record sets that have a routing policy other than simple: An 1528 // identifier that differentiates among multiple resource record sets that have the 1529 // same combination of name and type, such as multiple weighted resource record 1530 // sets named acme.example.com that have a type of A. In a group of resource record 1531 // sets that have the same name and type, the value of SetIdentifier must be 1532 // unique for each resource record set. For information about routing policies, see 1533 // Choosing a Routing Policy (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html) 1534 // in the Amazon Route 53 Developer Guide. 1535 SetIdentifier *string 1536 1537 // The resource record cache time to live (TTL), in seconds. Note the following: 1538 // - If you're creating or updating an alias resource record set, omit TTL . 1539 // Amazon Route 53 uses the value of TTL for the alias target. 1540 // - If you're associating this resource record set with a health check (if 1541 // you're adding a HealthCheckId element), we recommend that you specify a TTL of 1542 // 60 seconds or less so clients respond quickly to changes in health status. 1543 // - All of the resource record sets in a group of weighted resource record sets 1544 // must have the same value for TTL . 1545 // - If a group of weighted resource record sets includes one or more weighted 1546 // alias resource record sets for which the alias target is an ELB load balancer, 1547 // we recommend that you specify a TTL of 60 seconds for all of the non-alias 1548 // weighted resource record sets that have the same name and type. Values other 1549 // than 60 seconds (the TTL for load balancers) will change the effect of the 1550 // values that you specify for Weight . 1551 TTL *int64 1552 1553 // When you create a traffic policy instance, Amazon Route 53 automatically 1554 // creates a resource record set. TrafficPolicyInstanceId is the ID of the traffic 1555 // policy instance that Route 53 created this resource record set for. To delete 1556 // the resource record set that is associated with a traffic policy instance, use 1557 // DeleteTrafficPolicyInstance . Route 53 will delete the resource record set 1558 // automatically. If you delete the resource record set by using 1559 // ChangeResourceRecordSets , Route 53 doesn't automatically delete the traffic 1560 // policy instance, and you'll continue to be charged for it even though it's no 1561 // longer in use. 1562 TrafficPolicyInstanceId *string 1563 1564 // Weighted resource record sets only: Among resource record sets that have the 1565 // same combination of DNS name and type, a value that determines the proportion of 1566 // DNS queries that Amazon Route 53 responds to using the current resource record 1567 // set. Route 53 calculates the sum of the weights for the resource record sets 1568 // that have the same combination of DNS name and type. Route 53 then responds to 1569 // queries based on the ratio of a resource's weight to the total. Note the 1570 // following: 1571 // - You must specify a value for the Weight element for every weighted resource 1572 // record set. 1573 // - You can only specify one ResourceRecord per weighted resource record set. 1574 // - You can't create latency, failover, or geolocation resource record sets 1575 // that have the same values for the Name and Type elements as weighted resource 1576 // record sets. 1577 // - You can create a maximum of 100 weighted resource record sets that have the 1578 // same values for the Name and Type elements. 1579 // - For weighted (but not weighted alias) resource record sets, if you set 1580 // Weight to 0 for a resource record set, Route 53 never responds to queries with 1581 // the applicable value for that resource record set. However, if you set Weight 1582 // to 0 for all resource record sets that have the same combination of DNS name 1583 // and type, traffic is routed to all resources with equal probability. The effect 1584 // of setting Weight to 0 is different when you associate health checks with 1585 // weighted resource record sets. For more information, see Options for 1586 // Configuring Route 53 Active-Active and Active-Passive Failover (https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-configuring-options.html) 1587 // in the Amazon Route 53 Developer Guide. 1588 Weight *int64 1589 1590 noSmithyDocumentSerde 1591 } 1592 1593 // A complex type containing a resource and its associated tags. 1594 type ResourceTagSet struct { 1595 1596 // The ID for the specified resource. 1597 ResourceId *string 1598 1599 // The type of the resource. 1600 // - The resource type for health checks is healthcheck . 1601 // - The resource type for hosted zones is hostedzone . 1602 ResourceType TagResourceType 1603 1604 // The tags associated with the specified resource. 1605 Tags []Tag 1606 1607 noSmithyDocumentSerde 1608 } 1609 1610 // A complex type that contains the type of limit that you specified in the 1611 // request and the current value for that limit. 1612 type ReusableDelegationSetLimit struct { 1613 1614 // The limit that you requested: MAX_ZONES_BY_REUSABLE_DELEGATION_SET , the maximum 1615 // number of hosted zones that you can associate with the specified reusable 1616 // delegation set. 1617 // 1618 // This member is required. 1619 Type ReusableDelegationSetLimitType 1620 1621 // The current value for the MAX_ZONES_BY_REUSABLE_DELEGATION_SET limit. 1622 // 1623 // This member is required. 1624 Value *int64 1625 1626 noSmithyDocumentSerde 1627 } 1628 1629 // A complex type that contains the status that one Amazon Route 53 health checker 1630 // reports and the time of the health check. 1631 type StatusReport struct { 1632 1633 // The date and time that the health checker performed the health check in ISO 1634 // 8601 format (https://en.wikipedia.org/wiki/ISO_8601) and Coordinated Universal 1635 // Time (UTC). For example, the value 2017-03-27T17:48:16.751Z represents March 1636 // 27, 2017 at 17:48:16.751 UTC. 1637 CheckedTime *time.Time 1638 1639 // A description of the status of the health check endpoint as reported by one of 1640 // the Amazon Route 53 health checkers. 1641 Status *string 1642 1643 noSmithyDocumentSerde 1644 } 1645 1646 // A complex type that contains information about a tag that you want to add or 1647 // edit for the specified health check or hosted zone. 1648 type Tag struct { 1649 1650 // The value of Key depends on the operation that you want to perform: 1651 // - Add a tag to a health check or hosted zone: Key is the name that you want to 1652 // give the new tag. 1653 // - Edit a tag: Key is the name of the tag that you want to change the Value 1654 // for. 1655 // - Delete a key: Key is the name of the tag you want to remove. 1656 // - Give a name to a health check: Edit the default Name tag. In the Amazon 1657 // Route 53 console, the list of your health checks includes a Name column that 1658 // lets you see the name that you've given to each health check. 1659 Key *string 1660 1661 // The value of Value depends on the operation that you want to perform: 1662 // - Add a tag to a health check or hosted zone: Value is the value that you want 1663 // to give the new tag. 1664 // - Edit a tag: Value is the new value that you want to assign the tag. 1665 Value *string 1666 1667 noSmithyDocumentSerde 1668 } 1669 1670 // A complex type that contains settings for a traffic policy. 1671 type TrafficPolicy struct { 1672 1673 // The definition of a traffic policy in JSON format. You specify the JSON 1674 // document to use for a new traffic policy in the CreateTrafficPolicy request. 1675 // For more information about the JSON format, see Traffic Policy Document Format (https://docs.aws.amazon.com/Route53/latest/APIReference/api-policies-traffic-policy-document-format.html) 1676 // . 1677 // 1678 // This member is required. 1679 Document *string 1680 1681 // The ID that Amazon Route 53 assigned to a traffic policy when you created it. 1682 // 1683 // This member is required. 1684 Id *string 1685 1686 // The name that you specified when you created the traffic policy. 1687 // 1688 // This member is required. 1689 Name *string 1690 1691 // The DNS type of the resource record sets that Amazon Route 53 creates when you 1692 // use a traffic policy to create a traffic policy instance. 1693 // 1694 // This member is required. 1695 Type RRType 1696 1697 // The version number that Amazon Route 53 assigns to a traffic policy. For a new 1698 // traffic policy, the value of Version is always 1. 1699 // 1700 // This member is required. 1701 Version *int32 1702 1703 // The comment that you specify in the CreateTrafficPolicy request, if any. 1704 Comment *string 1705 1706 noSmithyDocumentSerde 1707 } 1708 1709 // A complex type that contains settings for the new traffic policy instance. 1710 type TrafficPolicyInstance struct { 1711 1712 // The ID of the hosted zone that Amazon Route 53 created resource record sets in. 1713 // 1714 // This member is required. 1715 HostedZoneId *string 1716 1717 // The ID that Amazon Route 53 assigned to the new traffic policy instance. 1718 // 1719 // This member is required. 1720 Id *string 1721 1722 // If State is Failed , an explanation of the reason for the failure. If State is 1723 // another value, Message is empty. 1724 // 1725 // This member is required. 1726 Message *string 1727 1728 // The DNS name, such as www.example.com, for which Amazon Route 53 responds to 1729 // queries by using the resource record sets that are associated with this traffic 1730 // policy instance. 1731 // 1732 // This member is required. 1733 Name *string 1734 1735 // The value of State is one of the following values: Applied Amazon Route 53 has 1736 // finished creating resource record sets, and changes have propagated to all Route 1737 // 53 edge locations. Creating Route 53 is creating the resource record sets. Use 1738 // GetTrafficPolicyInstance to confirm that the CreateTrafficPolicyInstance 1739 // request completed successfully. Failed Route 53 wasn't able to create or update 1740 // the resource record sets. When the value of State is Failed , see Message for 1741 // an explanation of what caused the request to fail. 1742 // 1743 // This member is required. 1744 State *string 1745 1746 // The TTL that Amazon Route 53 assigned to all of the resource record sets that 1747 // it created in the specified hosted zone. 1748 // 1749 // This member is required. 1750 TTL *int64 1751 1752 // The ID of the traffic policy that Amazon Route 53 used to create resource 1753 // record sets in the specified hosted zone. 1754 // 1755 // This member is required. 1756 TrafficPolicyId *string 1757 1758 // The DNS type that Amazon Route 53 assigned to all of the resource record sets 1759 // that it created for this traffic policy instance. 1760 // 1761 // This member is required. 1762 TrafficPolicyType RRType 1763 1764 // The version of the traffic policy that Amazon Route 53 used to create resource 1765 // record sets in the specified hosted zone. 1766 // 1767 // This member is required. 1768 TrafficPolicyVersion *int32 1769 1770 noSmithyDocumentSerde 1771 } 1772 1773 // A complex type that contains information about the latest version of one 1774 // traffic policy that is associated with the current Amazon Web Services account. 1775 type TrafficPolicySummary struct { 1776 1777 // The ID that Amazon Route 53 assigned to the traffic policy when you created it. 1778 // 1779 // This member is required. 1780 Id *string 1781 1782 // The version number of the latest version of the traffic policy. 1783 // 1784 // This member is required. 1785 LatestVersion *int32 1786 1787 // The name that you specified for the traffic policy when you created it. 1788 // 1789 // This member is required. 1790 Name *string 1791 1792 // The number of traffic policies that are associated with the current Amazon Web 1793 // Services account. 1794 // 1795 // This member is required. 1796 TrafficPolicyCount *int32 1797 1798 // The DNS type of the resource record sets that Amazon Route 53 creates when you 1799 // use a traffic policy to create a traffic policy instance. 1800 // 1801 // This member is required. 1802 Type RRType 1803 1804 noSmithyDocumentSerde 1805 } 1806 1807 // (Private hosted zones only) A complex type that contains information about an 1808 // Amazon VPC. If you associate a private hosted zone with an Amazon VPC when you 1809 // make a CreateHostedZone (https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateHostedZone.html) 1810 // request, the following parameters are also required. 1811 type VPC struct { 1812 1813 // (Private hosted zones only) The ID of an Amazon VPC. 1814 VPCId *string 1815 1816 // (Private hosted zones only) The region that an Amazon VPC was created in. 1817 VPCRegion VPCRegion 1818 1819 noSmithyDocumentSerde 1820 } 1821 1822 type noSmithyDocumentSerde = smithydocument.NoSerde