You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::Route53::Types::Change

  • Object
show all
Defined in:



When passing Change as input to an Aws::Client method, you can use a vanilla Hash:

  action: "CREATE", # required, accepts CREATE, DELETE, UPSERT
  resource_record_set: { # required
    name: "DNSName", # required
    type: "SOA", # required, accepts SOA, A, TXT, NS, CNAME, MX, NAPTR, PTR, SRV, SPF, AAAA, CAA
    set_identifier: "ResourceRecordSetIdentifier",
    weight: 1,
    region: "us-east-1", # accepts us-east-1, us-east-2, us-west-1, us-west-2, ca-central-1, eu-west-1, eu-west-2, eu-central-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, ap-northeast-2, sa-east-1, cn-north-1, ap-south-1
    geo_location: {
      continent_code: "GeoLocationContinentCode",
      country_code: "GeoLocationCountryCode",
      subdivision_code: "GeoLocationSubdivisionCode",
    failover: "PRIMARY", # accepts PRIMARY, SECONDARY
    multi_value_answer: false,
    ttl: 1,
    resource_records: [
        value: "RData", # required
    alias_target: {
      hosted_zone_id: "ResourceId", # required
      dns_name: "DNSName", # required
      evaluate_target_health: false, # required
    health_check_id: "HealthCheckId",
    traffic_policy_instance_id: "TrafficPolicyInstanceId",

The information for each resource record set that you want to change.

Instance Attribute Summary collapse

Instance Attribute Details


The action to perform:

  • CREATE: Creates a resource record set that has the specified values.

  • DELETE: Deletes a existing resource record set.

    To delete the resource record set that is associated with a traffic policy instance, use DeleteTrafficPolicyInstance. Amazon Route 53 will delete the resource record set automatically. If you delete the resource record set by using ChangeResourceRecordSets, Amazon Route 53 doesn\'t automatically delete the traffic policy instance, and you\'ll continue to be charged for it even though it\'s no longer in use.

  • UPSERT: If a resource record set doesn\'t already exist, Amazon Route 53 creates it. If a resource record set does exist, Amazon Route 53 updates it with the values in the request.

The values that you need to include in the request depend on the type of resource record set that you\'re creating, deleting, or updating:

Basic resource record sets (excluding alias, failover, geolocation, latency, and weighted resource record sets)

  • Name

  • Type

  • TTL

Failover, geolocation, latency, or weighted resource record sets (excluding alias resource record sets)

  • Name

  • Type

  • TTL

  • SetIdentifier

Alias resource record sets (including failover alias, geolocation alias, latency alias, and weighted alias resource record sets)

  • Name

  • Type

  • AliasTarget (includes DNSName, EvaluateTargetHealth, and HostedZoneId)

  • SetIdentifier (for failover, geolocation, latency, and weighted resource record sets)

    Possible values:

    • CREATE
    • DELETE
    • UPSERT


  • (String)

    The action to perform:.


Information about the resource record set to create, delete, or update.