Metadata-Version: 2.1
Name: aws-cdk.aws-route53
Version: 1.10.0
Summary: CDK Constructs for AWS Route53
Home-page: https://github.com/aws/aws-cdk
Author: Amazon Web Services
License: UNKNOWN
Project-URL: Source, https://github.com/aws/aws-cdk.git
Description: ## Amazon Route53 Construct Library
        <!--BEGIN STABILITY BANNER-->
        
        ---
        
        ![Stability: Stable](https://img.shields.io/badge/stability-Stable-success.svg?style=for-the-badge)
        
        
        ---
        <!--END STABILITY BANNER-->
        
        To add a public hosted zone:
        
        ```ts
        import route53 = require('@aws-cdk/aws-route53');
        
        new route53.PublicHostedZone(this, 'HostedZone', {
          zoneName: 'fully.qualified.domain.com'
        });
        ```
        
        To add a private hosted zone, use `PrivateHostedZone`. Note that
        `enableDnsHostnames` and `enableDnsSupport` must have been enabled for the
        VPC you're configuring for private hosted zones.
        
        ```ts
        import ec2 = require('@aws-cdk/aws-ec2');
        import route53 = require('@aws-cdk/aws-route53');
        
        const vpc = new ec2.Vpc(this, 'VPC');
        
        const zone = new route53.PrivateHostedZone(this, 'HostedZone', {
          zoneName: 'fully.qualified.domain.com',
          vpc    // At least one VPC has to be added to a Private Hosted Zone.
        });
        ```
        
        Additional VPCs can be added with `zone.addVpc()`.
        
        ### Adding Records
        
        To add a TXT record to your zone:
        ```ts
        import route53 = require('@aws-cdk/aws-route53');
        
        new route53.TxtRecord(this, 'TXTRecord', {
          zone: myZone,
          recordName: '_foo',  // If the name ends with a ".", it will be used as-is;
                               // if it ends with a "." followed by the zone name, a trailing "." will be added automatically;
                               // otherwise, a ".", the zone name, and a trailing "." will be added automatically.
                               // Defaults to zone root if not specified.
          values: [            // Will be quoted for you, and " will be escaped automatically.
            'Bar!',
            'Baz?'
          ],
          ttl: Duration.minutes(90),       // Optional - default is 30 minutes
        });
        ```
        
        To add a A record to your zone:
        ```ts
        import route53 = require('@aws-cdk/aws-route53');
        
        new route53.ARecord(this, 'ARecord', {
          zone: myZone,
          target: route53.AddressRecordTarget.fromIpAddresses('1.2.3.4', '5.6.7.8')
        });
        ```
        
        To add a AAAA record pointing to a CloudFront distribution:
        ```ts
        import route53 = require('@aws-cdk/aws-route53');
        import targets = require('@aws-cdk/aws-route53-targets');
        
        new route53.AaaaRecord(this, 'Alias', {
          zone: myZone,
          target: route53.AddressRecordTarget.fromAlias(new targets.CloudFrontTarget(distribution))
        });
        ```
        
        Constructs are available for A, AAAA, CAA, CNAME, MX, NS, SRV and TXT records.
        
        Use the `CaaAmazonRecord` construct to easily restrict certificate authorities
        allowed to issue certificates for a domain to Amazon only.
        
        ### Adding records to existing hosted zones
        
        If you know the ID and Name of a Hosted Zone, you can import it directly:
        
        ```ts
        const zone = HostedZone.import(this, 'MyZone', {
          zoneName: 'example.com',
          hostedZoneId: 'ZOJJZC49E0EPZ',
        });
        ```
        
        If you don't know the ID of a Hosted Zone, you can use the `HostedZone.fromLookup`
        to discover and import it:
        
        ```ts
        HostedZone.fromLookup(this, 'MyZone', {
          domainName: 'example.com'
        });
        ```
        
        
Platform: UNKNOWN
Requires-Python: >=3.6
Description-Content-Type: text/markdown
