Class: AWS.Route53

Examples:

/* The following example associates the VPC with ID vpc-1a2b3c4d with the hosted zone with ID Z3M3LMPEXAMPLE. */

 var params = {
  Comment: "", 
  HostedZoneId: "Z3M3LMPEXAMPLE", 
  VPC: {
   VPCId: "vpc-1a2b3c4d", 
   VPCRegion: "us-east-2"
  }
 };
 route53.associateVPCWithHostedZone(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "", 
     Id: "/change/C3HC6WDB2UANE2", 
     Status: "INSYNC", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

var params = {
  HostedZoneId: 'STRING_VALUE', /* required */
  VPC: { /* required */
    VPCId: 'STRING_VALUE',
    VPCRegion: us-east-1 | us-east-2 | us-west-1 | us-west-2 | eu-west-1 | eu-west-2 | eu-west-3 | eu-central-1 | eu-central-2 | ap-east-1 | me-south-1 | us-gov-west-1 | us-gov-east-1 | us-iso-east-1 | us-iso-west-1 | us-isob-east-1 | me-central-1 | ap-southeast-1 | ap-southeast-2 | ap-southeast-3 | ap-south-1 | ap-south-2 | ap-northeast-1 | ap-northeast-2 | ap-northeast-3 | eu-north-1 | sa-east-1 | ca-central-1 | cn-north-1 | af-south-1 | eu-south-1 | eu-south-2 | ap-southeast-4 | il-central-1 | ca-west-1 | ap-southeast-5
  },
  Comment: 'STRING_VALUE'
};
route53.associateVPCWithHostedZone(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Examples:

var params = {
  Changes: [ /* required */
    {
      Action: PUT | DELETE_IF_EXISTS, /* required */
      CidrList: [ /* required */
        'STRING_VALUE',
        /* more items */
      ],
      LocationName: 'STRING_VALUE' /* required */
    },
    /* more items */
  ],
  Id: 'STRING_VALUE', /* required */
  CollectionVersion: 'NUMBER_VALUE'
};
route53.changeCidrCollection(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Examples:

/* The following example creates a resource record set that routes Internet traffic to a resource with an IP address of 192.0.2.44. */

 var params = {
  ChangeBatch: {
   Changes: [
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      Name: "example.com", 
      ResourceRecords: [
         {
        Value: "192.0.2.44"
       }
      ], 
      TTL: 60, 
      Type: "A"
     }
    }
   ], 
   Comment: "Web server for example.com"
  }, 
  HostedZoneId: "Z3M3LMPEXAMPLE"
 };
 route53.changeResourceRecordSets(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "Web server for example.com", 
     Id: "/change/C2682N5HXP0BZ4", 
     Status: "PENDING", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

/* The following example creates two weighted resource record sets. The resource with a Weight of 100 will get 1/3rd of traffic (100/100+200), and the other resource will get the rest of the traffic for example.com. */

 var params = {
  ChangeBatch: {
   Changes: [
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      HealthCheckId: "abcdef11-2222-3333-4444-555555fedcba", 
      Name: "example.com", 
      ResourceRecords: [
         {
        Value: "192.0.2.44"
       }
      ], 
      SetIdentifier: "Seattle data center", 
      TTL: 60, 
      Type: "A", 
      Weight: 100
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      HealthCheckId: "abcdef66-7777-8888-9999-000000fedcba", 
      Name: "example.com", 
      ResourceRecords: [
         {
        Value: "192.0.2.45"
       }
      ], 
      SetIdentifier: "Portland data center", 
      TTL: 60, 
      Type: "A", 
      Weight: 200
     }
    }
   ], 
   Comment: "Web servers for example.com"
  }, 
  HostedZoneId: "Z3M3LMPEXAMPLE"
 };
 route53.changeResourceRecordSets(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "Web servers for example.com", 
     Id: "/change/C2682N5HXP0BZ4", 
     Status: "PENDING", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

/* The following example creates an alias resource record set that routes traffic to a CloudFront distribution. */

 var params = {
  ChangeBatch: {
   Changes: [
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "d123rk29d0stfj.cloudfront.net", 
       EvaluateTargetHealth: false, 
       HostedZoneId: "Z2FDTNDATAQYW2"
      }, 
      Name: "example.com", 
      Type: "A"
     }
    }
   ], 
   Comment: "CloudFront distribution for example.com"
  }, 
  HostedZoneId: "Z3M3LMPEXAMPLE"// Depends on the type of resource that you want to route traffic to
 };
 route53.changeResourceRecordSets(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "CloudFront distribution for example.com", 
     Id: "/change/C2682N5HXP0BZ4", 
     Status: "PENDING", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

/* The following example creates two weighted alias resource record sets that route traffic to ELB load balancers. The resource with a Weight of 100 will get 1/3rd of traffic (100/100+200), and the other resource will get the rest of the traffic for example.com. */

 var params = {
  ChangeBatch: {
   Changes: [
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "example-com-123456789.us-east-2.elb.amazonaws.com ", 
       EvaluateTargetHealth: true, 
       HostedZoneId: "Z3AADJGX6KTTL2"
      }, 
      Name: "example.com", 
      SetIdentifier: "Ohio region", 
      Type: "A", 
      Weight: 100
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "example-com-987654321.us-west-2.elb.amazonaws.com ", 
       EvaluateTargetHealth: true, 
       HostedZoneId: "Z1H1FL5HABSF5"
      }, 
      Name: "example.com", 
      SetIdentifier: "Oregon region", 
      Type: "A", 
      Weight: 200
     }
    }
   ], 
   Comment: "ELB load balancers for example.com"
  }, 
  HostedZoneId: "Z3M3LMPEXAMPLE"// Depends on the type of resource that you want to route traffic to
 };
 route53.changeResourceRecordSets(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "ELB load balancers for example.com", 
     Id: "/change/C2682N5HXP0BZ4", 
     Status: "PENDING", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

/* The following example creates two latency resource record sets that route traffic to EC2 instances. Traffic for example.com is routed either to the Ohio region or the Oregon region, depending on the latency between the user and those regions. */

 var params = {
  ChangeBatch: {
   Changes: [
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      HealthCheckId: "abcdef11-2222-3333-4444-555555fedcba", 
      Name: "example.com", 
      Region: "us-east-2", 
      ResourceRecords: [
         {
        Value: "192.0.2.44"
       }
      ], 
      SetIdentifier: "Ohio region", 
      TTL: 60, 
      Type: "A"
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      HealthCheckId: "abcdef66-7777-8888-9999-000000fedcba", 
      Name: "example.com", 
      Region: "us-west-2", 
      ResourceRecords: [
         {
        Value: "192.0.2.45"
       }
      ], 
      SetIdentifier: "Oregon region", 
      TTL: 60, 
      Type: "A"
     }
    }
   ], 
   Comment: "EC2 instances for example.com"
  }, 
  HostedZoneId: "Z3M3LMPEXAMPLE"
 };
 route53.changeResourceRecordSets(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "EC2 instances for example.com", 
     Id: "/change/C2682N5HXP0BZ4", 
     Status: "PENDING", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

/* The following example creates two latency alias resource record sets that route traffic for example.com to ELB load balancers. Requests are routed either to the Ohio region or the Oregon region, depending on the latency between the user and those regions. */

 var params = {
  ChangeBatch: {
   Changes: [
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "example-com-123456789.us-east-2.elb.amazonaws.com ", 
       EvaluateTargetHealth: true, 
       HostedZoneId: "Z3AADJGX6KTTL2"
      }, 
      Name: "example.com", 
      Region: "us-east-2", 
      SetIdentifier: "Ohio region", 
      Type: "A"
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "example-com-987654321.us-west-2.elb.amazonaws.com ", 
       EvaluateTargetHealth: true, 
       HostedZoneId: "Z1H1FL5HABSF5"
      }, 
      Name: "example.com", 
      Region: "us-west-2", 
      SetIdentifier: "Oregon region", 
      Type: "A"
     }
    }
   ], 
   Comment: "ELB load balancers for example.com"
  }, 
  HostedZoneId: "Z3M3LMPEXAMPLE"// Depends on the type of resource that you want to route traffic to
 };
 route53.changeResourceRecordSets(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "ELB load balancers for example.com", 
     Id: "/change/C2682N5HXP0BZ4", 
     Status: "PENDING", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

/* The following example creates primary and secondary failover resource record sets that route traffic to EC2 instances. Traffic is generally routed to the primary resource, in the Ohio region. If that resource is unavailable, traffic is routed to the secondary resource, in the Oregon region. */

 var params = {
  ChangeBatch: {
   Changes: [
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      Failover: "PRIMARY", 
      HealthCheckId: "abcdef11-2222-3333-4444-555555fedcba", 
      Name: "example.com", 
      ResourceRecords: [
         {
        Value: "192.0.2.44"
       }
      ], 
      SetIdentifier: "Ohio region", 
      TTL: 60, 
      Type: "A"
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      Failover: "SECONDARY", 
      HealthCheckId: "abcdef66-7777-8888-9999-000000fedcba", 
      Name: "example.com", 
      ResourceRecords: [
         {
        Value: "192.0.2.45"
       }
      ], 
      SetIdentifier: "Oregon region", 
      TTL: 60, 
      Type: "A"
     }
    }
   ], 
   Comment: "Failover configuration for example.com"
  }, 
  HostedZoneId: "Z3M3LMPEXAMPLE"
 };
 route53.changeResourceRecordSets(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "Failover configuration for example.com", 
     Id: "/change/C2682N5HXP0BZ4", 
     Status: "PENDING", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

/* The following example creates primary and secondary failover alias resource record sets that route traffic to ELB load balancers. Traffic is generally routed to the primary resource, in the Ohio region. If that resource is unavailable, traffic is routed to the secondary resource, in the Oregon region. */

 var params = {
  ChangeBatch: {
   Changes: [
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "example-com-123456789.us-east-2.elb.amazonaws.com ", 
       EvaluateTargetHealth: true, 
       HostedZoneId: "Z3AADJGX6KTTL2"
      }, 
      Failover: "PRIMARY", 
      Name: "example.com", 
      SetIdentifier: "Ohio region", 
      Type: "A"
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "example-com-987654321.us-west-2.elb.amazonaws.com ", 
       EvaluateTargetHealth: true, 
       HostedZoneId: "Z1H1FL5HABSF5"
      }, 
      Failover: "SECONDARY", 
      Name: "example.com", 
      SetIdentifier: "Oregon region", 
      Type: "A"
     }
    }
   ], 
   Comment: "Failover alias configuration for example.com"
  }, 
  HostedZoneId: "Z3M3LMPEXAMPLE"// Depends on the type of resource that you want to route traffic to
 };
 route53.changeResourceRecordSets(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "Failover alias configuration for example.com", 
     Id: "/change/C2682N5HXP0BZ4", 
     Status: "PENDING", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

/* The following example creates four geolocation resource record sets that use IPv4 addresses to route traffic to resources such as web servers running on EC2 instances. Traffic is routed to one of four IP addresses, for North America (NA), for South America (SA), for Europe (EU), and for all other locations (*). */

 var params = {
  ChangeBatch: {
   Changes: [
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      GeoLocation: {
       ContinentCode: "NA"
      }, 
      Name: "example.com", 
      ResourceRecords: [
         {
        Value: "192.0.2.44"
       }
      ], 
      SetIdentifier: "North America", 
      TTL: 60, 
      Type: "A"
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      GeoLocation: {
       ContinentCode: "SA"
      }, 
      Name: "example.com", 
      ResourceRecords: [
         {
        Value: "192.0.2.45"
       }
      ], 
      SetIdentifier: "South America", 
      TTL: 60, 
      Type: "A"
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      GeoLocation: {
       ContinentCode: "EU"
      }, 
      Name: "example.com", 
      ResourceRecords: [
         {
        Value: "192.0.2.46"
       }
      ], 
      SetIdentifier: "Europe", 
      TTL: 60, 
      Type: "A"
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      GeoLocation: {
       CountryCode: "*"
      }, 
      Name: "example.com", 
      ResourceRecords: [
         {
        Value: "192.0.2.47"
       }
      ], 
      SetIdentifier: "Other locations", 
      TTL: 60, 
      Type: "A"
     }
    }
   ], 
   Comment: "Geolocation configuration for example.com"
  }, 
  HostedZoneId: "Z3M3LMPEXAMPLE"
 };
 route53.changeResourceRecordSets(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "Geolocation configuration for example.com", 
     Id: "/change/C2682N5HXP0BZ4", 
     Status: "PENDING", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

/* The following example creates four geolocation alias resource record sets that route traffic to ELB load balancers. Traffic is routed to one of four IP addresses, for North America (NA), for South America (SA), for Europe (EU), and for all other locations (*). */

 var params = {
  ChangeBatch: {
   Changes: [
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "example-com-123456789.us-east-2.elb.amazonaws.com ", 
       EvaluateTargetHealth: true, 
       HostedZoneId: "Z3AADJGX6KTTL2"
      }, 
      GeoLocation: {
       ContinentCode: "NA"
      }, 
      Name: "example.com", 
      SetIdentifier: "North America", 
      Type: "A"
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "example-com-234567890.sa-east-1.elb.amazonaws.com ", 
       EvaluateTargetHealth: true, 
       HostedZoneId: "Z2P70J7HTTTPLU"
      }, 
      GeoLocation: {
       ContinentCode: "SA"
      }, 
      Name: "example.com", 
      SetIdentifier: "South America", 
      Type: "A"
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "example-com-234567890.eu-central-1.elb.amazonaws.com ", 
       EvaluateTargetHealth: true, 
       HostedZoneId: "Z215JYRZR1TBD5"
      }, 
      GeoLocation: {
       ContinentCode: "EU"
      }, 
      Name: "example.com", 
      SetIdentifier: "Europe", 
      Type: "A"
     }
    }, 
      {
     Action: "CREATE", 
     ResourceRecordSet: {
      AliasTarget: {
       DNSName: "example-com-234567890.ap-southeast-1.elb.amazonaws.com ", 
       EvaluateTargetHealth: true, 
       HostedZoneId: "Z1LMS91P8CMLE5"
      }, 
      GeoLocation: {
       CountryCode: "*"
      }, 
      Name: "example.com", 
      SetIdentifier: "Other locations", 
      Type: "A"
     }
    }
   ], 
   Comment: "Geolocation alias configuration for example.com"
  }, 
  HostedZoneId: "Z3M3LMPEXAMPLE"// Depends on the type of resource that you want to route traffic to
 };
 route53.changeResourceRecordSets(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
   /*
   data = {
    ChangeInfo: {
     Comment: "Geolocation alias configuration for example.com", 
     Id: "/change/C2682N5HXP0BZ4", 
     Status: "PENDING", 
     SubmittedAt: <Date Representation>
    }
   }
   */
 });

var params = {
  ChangeBatch: { /* required */
    Changes: [ /* required */
      {
        Action: CREATE | DELETE | UPSERT, /* required */
        ResourceRecordSet: { /* required */
          Name: 'STRING_VALUE', /* required */
          Type: SOA | A | TXT | NS | CNAME | MX | NAPTR | PTR | SRV | SPF | AAAA | CAA | DS, /* required */
          AliasTarget: {
            DNSName: 'STRING_VALUE', /* required */
            EvaluateTargetHealth: true || false, /* required */
            HostedZoneId: 'STRING_VALUE' /* required */
          },
          CidrRoutingConfig: {
            CollectionId: 'STRING_VALUE', /* required */
            LocationName: 'STRING_VALUE' /* required */
          },
          Failover: PRIMARY | SECONDARY,
          GeoLocation: {
            ContinentCode: 'STRING_VALUE',
            CountryCode: 'STRING_VALUE',
            SubdivisionCode: 'STRING_VALUE'
          },
          GeoProximityLocation: {
            AWSRegion: 'STRING_VALUE',
            Bias: 'NUMBER_VALUE',
            Coordinates: {
              Latitude: 'STRING_VALUE', /* required */
              Longitude: 'STRING_VALUE' /* required */
            },
            LocalZoneGroup: 'STRING_VALUE'
          },
          HealthCheckId: 'STRING_VALUE',
          MultiValueAnswer: true || false,
          Region: us-east-1 | us-east-2 | us-west-1 | us-west-2 | ca-central-1 | eu-west-1 | eu-west-2 | eu-west-3 | eu-central-1 | eu-central-2 | ap-southeast-1 | ap-southeast-2 | ap-southeast-3 | ap-northeast-1 | ap-northeast-2 | ap-northeast-3 | eu-north-1 | sa-east-1 | cn-north-1 | cn-northwest-1 | ap-east-1 | me-south-1 | me-central-1 | ap-south-1 | ap-south-2 | af-south-1 | eu-south-1 | eu-south-2 | ap-southeast-4 | il-central-1 | ca-west-1 | ap-southeast-5,
          ResourceRecords: [
            {
              Value: 'STRING_VALUE' /* required */
            },
            /* more items */
          ],
          SetIdentifier: 'STRING_VALUE',
          TTL: 'NUMBER_VALUE',
          TrafficPolicyInstanceId: 'STRING_VALUE',
          Weight: 'NUMBER_VALUE'
        }
      },
      /* more items */
    ],
    Comment: 'STRING_VALUE'
  },
  HostedZoneId: 'STRING_VALUE' /* required */
};
route53.changeResourceRecordSets(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});