We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 7, 2026 by Pulumi
We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 7, 2026 by Pulumi
Resource Type definition for AWS::Route53::RecordSet.
Create RecordSet Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new RecordSet(name: string, args: RecordSetArgs, opts?: CustomResourceOptions);@overload
def RecordSet(resource_name: str,
args: RecordSetArgs,
opts: Optional[ResourceOptions] = None)
@overload
def RecordSet(resource_name: str,
opts: Optional[ResourceOptions] = None,
type: Optional[str] = None,
multi_value_answer: Optional[bool] = None,
resource_records: Optional[Sequence[str]] = None,
failover: Optional[RecordSetFailover] = None,
geo_location: Optional[RecordSetGeoLocationArgs] = None,
health_check_id: Optional[str] = None,
hosted_zone_id: Optional[str] = None,
comment: Optional[str] = None,
name: Optional[str] = None,
hosted_zone_name: Optional[str] = None,
region: Optional[str] = None,
alias_target: Optional[RecordSetAliasTargetArgs] = None,
set_identifier: Optional[str] = None,
ttl: Optional[str] = None,
cidr_routing_config: Optional[RecordSetCidrRoutingConfigArgs] = None,
weight: Optional[int] = None)func NewRecordSet(ctx *Context, name string, args RecordSetArgs, opts ...ResourceOption) (*RecordSet, error)public RecordSet(string name, RecordSetArgs args, CustomResourceOptions? opts = null)
public RecordSet(String name, RecordSetArgs args)
public RecordSet(String name, RecordSetArgs args, CustomResourceOptions options)
type: aws-native:route53:RecordSet
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "aws-native_route53_record_set" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args RecordSetArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args RecordSetArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args RecordSetArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args RecordSetArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args RecordSetArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
RecordSet Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The RecordSet resource accepts the following input properties:
- Type string
- The DNS record type.
- Alias
Target Pulumi.Aws Native. Route53. Inputs. Record Set Alias Target - Alias resource record sets only: Information about the AWS resource, such as a CloudFront distribution or an Amazon S3 bucket, that you want to route traffic to.
- Cidr
Routing Pulumi.Config Aws Native. Route53. Inputs. Record Set Cidr Routing Config - The object that is specified in resource record set object when you are linking a resource record set to a CIDR location.
- Comment string
- Optional: Any comments you want to include about a change batch request.
- Failover
Pulumi.
Aws Native. Route53. Record Set Failover - To configure failover, you add the Failover element to two resource record sets. For one resource record set, you specify PRIMARY as the value for Failover; for the other resource record set, you specify SECONDARY. In addition, you include the HealthCheckId element and specify the health check that you want Amazon Route 53 to perform for each resource record set.
- Geo
Location Pulumi.Aws Native. Route53. Inputs. Record Set Geo Location - A complex type that lets you control how Amazon Route 53 responds to DNS queries based on the geographic origin of the query.
- Health
Check stringId - If you want Amazon Route 53 to return this resource record set in response to a DNS query only when the status of a health check is healthy, include the HealthCheckId element and specify the ID of the applicable health check.
- Hosted
Zone stringId - The ID of the hosted zone that you want to create records in.
- Hosted
Zone stringName - The name of the hosted zone that you want to create records in. You must include a trailing dot (for example, www.example.com.) as part of the HostedZoneName.
- Multi
Value boolAnswer - To route traffic approximately randomly to multiple resources, such as web servers, create one multivalue answer record for each resource and specify true for MultiValueAnswer.
- Name string
- The name of the record that you want to create, update, or delete.
- Region string
- The Amazon EC2 Region where you created the resource that this resource record set refers to.
- Resource
Records List<string> - One or more values that correspond with the value that you specified for the Type property.
- Set
Identifier string - An identifier that differentiates among multiple resource record sets that have the same combination of name and type.
- Ttl string
- The resource record cache time to live (TTL), in seconds.
- Weight int
- Among resource record sets that have the same combination of DNS name and type, a value that determines the proportion of DNS queries that Amazon Route 53 responds to using the current resource record set. Route 53 calculates the sum of the weights for the resource record sets that have the same combination of DNS name and type. Route 53 then responds to queries based on the ratio of a resource's weight to the total.
- Type string
- The DNS record type.
- Alias
Target RecordSet Alias Target Args - Alias resource record sets only: Information about the AWS resource, such as a CloudFront distribution or an Amazon S3 bucket, that you want to route traffic to.
- Cidr
Routing RecordConfig Set Cidr Routing Config Args - The object that is specified in resource record set object when you are linking a resource record set to a CIDR location.
- Comment string
- Optional: Any comments you want to include about a change batch request.
- Failover
Record
Set Failover - To configure failover, you add the Failover element to two resource record sets. For one resource record set, you specify PRIMARY as the value for Failover; for the other resource record set, you specify SECONDARY. In addition, you include the HealthCheckId element and specify the health check that you want Amazon Route 53 to perform for each resource record set.
- Geo
Location RecordSet Geo Location Args - A complex type that lets you control how Amazon Route 53 responds to DNS queries based on the geographic origin of the query.
- Health
Check stringId - If you want Amazon Route 53 to return this resource record set in response to a DNS query only when the status of a health check is healthy, include the HealthCheckId element and specify the ID of the applicable health check.
- Hosted
Zone stringId - The ID of the hosted zone that you want to create records in.
- Hosted
Zone stringName - The name of the hosted zone that you want to create records in. You must include a trailing dot (for example, www.example.com.) as part of the HostedZoneName.
- Multi
Value boolAnswer - To route traffic approximately randomly to multiple resources, such as web servers, create one multivalue answer record for each resource and specify true for MultiValueAnswer.
- Name string
- The name of the record that you want to create, update, or delete.
- Region string
- The Amazon EC2 Region where you created the resource that this resource record set refers to.
- Resource
Records []string - One or more values that correspond with the value that you specified for the Type property.
- Set
Identifier string - An identifier that differentiates among multiple resource record sets that have the same combination of name and type.
- Ttl string
- The resource record cache time to live (TTL), in seconds.
- Weight int
- Among resource record sets that have the same combination of DNS name and type, a value that determines the proportion of DNS queries that Amazon Route 53 responds to using the current resource record set. Route 53 calculates the sum of the weights for the resource record sets that have the same combination of DNS name and type. Route 53 then responds to queries based on the ratio of a resource's weight to the total.
- type string
- The DNS record type.
- alias_
target object - Alias resource record sets only: Information about the AWS resource, such as a CloudFront distribution or an Amazon S3 bucket, that you want to route traffic to.
- cidr_
routing_ objectconfig - The object that is specified in resource record set object when you are linking a resource record set to a CIDR location.
- comment string
- Optional: Any comments you want to include about a change batch request.
- failover "PRIMARY" | "SECONDARY"
- To configure failover, you add the Failover element to two resource record sets. For one resource record set, you specify PRIMARY as the value for Failover; for the other resource record set, you specify SECONDARY. In addition, you include the HealthCheckId element and specify the health check that you want Amazon Route 53 to perform for each resource record set.
- geo_
location object - A complex type that lets you control how Amazon Route 53 responds to DNS queries based on the geographic origin of the query.
- health_
check_ stringid - If you want Amazon Route 53 to return this resource record set in response to a DNS query only when the status of a health check is healthy, include the HealthCheckId element and specify the ID of the applicable health check.
- hosted_
zone_ stringid - The ID of the hosted zone that you want to create records in.
- hosted_
zone_ stringname - The name of the hosted zone that you want to create records in. You must include a trailing dot (for example, www.example.com.) as part of the HostedZoneName.
- multi_
value_ boolanswer - To route traffic approximately randomly to multiple resources, such as web servers, create one multivalue answer record for each resource and specify true for MultiValueAnswer.
- name string
- The name of the record that you want to create, update, or delete.
- region string
- The Amazon EC2 Region where you created the resource that this resource record set refers to.
- resource_
records list(string) - One or more values that correspond with the value that you specified for the Type property.
- set_
identifier string - An identifier that differentiates among multiple resource record sets that have the same combination of name and type.
- ttl string
- The resource record cache time to live (TTL), in seconds.
- weight number
- Among resource record sets that have the same combination of DNS name and type, a value that determines the proportion of DNS queries that Amazon Route 53 responds to using the current resource record set. Route 53 calculates the sum of the weights for the resource record sets that have the same combination of DNS name and type. Route 53 then responds to queries based on the ratio of a resource's weight to the total.
- type String
- The DNS record type.
- alias
Target RecordSet Alias Target - Alias resource record sets only: Information about the AWS resource, such as a CloudFront distribution or an Amazon S3 bucket, that you want to route traffic to.
- cidr
Routing RecordConfig Set Cidr Routing Config - The object that is specified in resource record set object when you are linking a resource record set to a CIDR location.
- comment String
- Optional: Any comments you want to include about a change batch request.
- failover
Record
Set Failover - To configure failover, you add the Failover element to two resource record sets. For one resource record set, you specify PRIMARY as the value for Failover; for the other resource record set, you specify SECONDARY. In addition, you include the HealthCheckId element and specify the health check that you want Amazon Route 53 to perform for each resource record set.
- geo
Location RecordSet Geo Location - A complex type that lets you control how Amazon Route 53 responds to DNS queries based on the geographic origin of the query.
- health
Check StringId - If you want Amazon Route 53 to return this resource record set in response to a DNS query only when the status of a health check is healthy, include the HealthCheckId element and specify the ID of the applicable health check.
- hosted
Zone StringId - The ID of the hosted zone that you want to create records in.
- hosted
Zone StringName - The name of the hosted zone that you want to create records in. You must include a trailing dot (for example, www.example.com.) as part of the HostedZoneName.
- multi
Value BooleanAnswer - To route traffic approximately randomly to multiple resources, such as web servers, create one multivalue answer record for each resource and specify true for MultiValueAnswer.
- name String
- The name of the record that you want to create, update, or delete.
- region String
- The Amazon EC2 Region where you created the resource that this resource record set refers to.
- resource
Records List<String> - One or more values that correspond with the value that you specified for the Type property.
- set
Identifier String - An identifier that differentiates among multiple resource record sets that have the same combination of name and type.
- ttl String
- The resource record cache time to live (TTL), in seconds.
- weight Integer
- Among resource record sets that have the same combination of DNS name and type, a value that determines the proportion of DNS queries that Amazon Route 53 responds to using the current resource record set. Route 53 calculates the sum of the weights for the resource record sets that have the same combination of DNS name and type. Route 53 then responds to queries based on the ratio of a resource's weight to the total.
- type string
- The DNS record type.
- alias
Target RecordSet Alias Target - Alias resource record sets only: Information about the AWS resource, such as a CloudFront distribution or an Amazon S3 bucket, that you want to route traffic to.
- cidr
Routing RecordConfig Set Cidr Routing Config - The object that is specified in resource record set object when you are linking a resource record set to a CIDR location.
- comment string
- Optional: Any comments you want to include about a change batch request.
- failover
Record
Set Failover - To configure failover, you add the Failover element to two resource record sets. For one resource record set, you specify PRIMARY as the value for Failover; for the other resource record set, you specify SECONDARY. In addition, you include the HealthCheckId element and specify the health check that you want Amazon Route 53 to perform for each resource record set.
- geo
Location RecordSet Geo Location - A complex type that lets you control how Amazon Route 53 responds to DNS queries based on the geographic origin of the query.
- health
Check stringId - If you want Amazon Route 53 to return this resource record set in response to a DNS query only when the status of a health check is healthy, include the HealthCheckId element and specify the ID of the applicable health check.
- hosted
Zone stringId - The ID of the hosted zone that you want to create records in.
- hosted
Zone stringName - The name of the hosted zone that you want to create records in. You must include a trailing dot (for example, www.example.com.) as part of the HostedZoneName.
- multi
Value booleanAnswer - To route traffic approximately randomly to multiple resources, such as web servers, create one multivalue answer record for each resource and specify true for MultiValueAnswer.
- name string
- The name of the record that you want to create, update, or delete.
- region string
- The Amazon EC2 Region where you created the resource that this resource record set refers to.
- resource
Records string[] - One or more values that correspond with the value that you specified for the Type property.
- set
Identifier string - An identifier that differentiates among multiple resource record sets that have the same combination of name and type.
- ttl string
- The resource record cache time to live (TTL), in seconds.
- weight number
- Among resource record sets that have the same combination of DNS name and type, a value that determines the proportion of DNS queries that Amazon Route 53 responds to using the current resource record set. Route 53 calculates the sum of the weights for the resource record sets that have the same combination of DNS name and type. Route 53 then responds to queries based on the ratio of a resource's weight to the total.
- type str
- The DNS record type.
- alias_
target RecordSet Alias Target Args - Alias resource record sets only: Information about the AWS resource, such as a CloudFront distribution or an Amazon S3 bucket, that you want to route traffic to.
- cidr_
routing_ Recordconfig Set Cidr Routing Config Args - The object that is specified in resource record set object when you are linking a resource record set to a CIDR location.
- comment str
- Optional: Any comments you want to include about a change batch request.
- failover
Record
Set Failover - To configure failover, you add the Failover element to two resource record sets. For one resource record set, you specify PRIMARY as the value for Failover; for the other resource record set, you specify SECONDARY. In addition, you include the HealthCheckId element and specify the health check that you want Amazon Route 53 to perform for each resource record set.
- geo_
location RecordSet Geo Location Args - A complex type that lets you control how Amazon Route 53 responds to DNS queries based on the geographic origin of the query.
- health_
check_ strid - If you want Amazon Route 53 to return this resource record set in response to a DNS query only when the status of a health check is healthy, include the HealthCheckId element and specify the ID of the applicable health check.
- hosted_
zone_ strid - The ID of the hosted zone that you want to create records in.
- hosted_
zone_ strname - The name of the hosted zone that you want to create records in. You must include a trailing dot (for example, www.example.com.) as part of the HostedZoneName.
- multi_
value_ boolanswer - To route traffic approximately randomly to multiple resources, such as web servers, create one multivalue answer record for each resource and specify true for MultiValueAnswer.
- name str
- The name of the record that you want to create, update, or delete.
- region str
- The Amazon EC2 Region where you created the resource that this resource record set refers to.
- resource_
records Sequence[str] - One or more values that correspond with the value that you specified for the Type property.
- set_
identifier str - An identifier that differentiates among multiple resource record sets that have the same combination of name and type.
- ttl str
- The resource record cache time to live (TTL), in seconds.
- weight int
- Among resource record sets that have the same combination of DNS name and type, a value that determines the proportion of DNS queries that Amazon Route 53 responds to using the current resource record set. Route 53 calculates the sum of the weights for the resource record sets that have the same combination of DNS name and type. Route 53 then responds to queries based on the ratio of a resource's weight to the total.
- type String
- The DNS record type.
- alias
Target Property Map - Alias resource record sets only: Information about the AWS resource, such as a CloudFront distribution or an Amazon S3 bucket, that you want to route traffic to.
- cidr
Routing Property MapConfig - The object that is specified in resource record set object when you are linking a resource record set to a CIDR location.
- comment String
- Optional: Any comments you want to include about a change batch request.
- failover "PRIMARY" | "SECONDARY"
- To configure failover, you add the Failover element to two resource record sets. For one resource record set, you specify PRIMARY as the value for Failover; for the other resource record set, you specify SECONDARY. In addition, you include the HealthCheckId element and specify the health check that you want Amazon Route 53 to perform for each resource record set.
- geo
Location Property Map - A complex type that lets you control how Amazon Route 53 responds to DNS queries based on the geographic origin of the query.
- health
Check StringId - If you want Amazon Route 53 to return this resource record set in response to a DNS query only when the status of a health check is healthy, include the HealthCheckId element and specify the ID of the applicable health check.
- hosted
Zone StringId - The ID of the hosted zone that you want to create records in.
- hosted
Zone StringName - The name of the hosted zone that you want to create records in. You must include a trailing dot (for example, www.example.com.) as part of the HostedZoneName.
- multi
Value BooleanAnswer - To route traffic approximately randomly to multiple resources, such as web servers, create one multivalue answer record for each resource and specify true for MultiValueAnswer.
- name String
- The name of the record that you want to create, update, or delete.
- region String
- The Amazon EC2 Region where you created the resource that this resource record set refers to.
- resource
Records List<String> - One or more values that correspond with the value that you specified for the Type property.
- set
Identifier String - An identifier that differentiates among multiple resource record sets that have the same combination of name and type.
- ttl String
- The resource record cache time to live (TTL), in seconds.
- weight Number
- Among resource record sets that have the same combination of DNS name and type, a value that determines the proportion of DNS queries that Amazon Route 53 responds to using the current resource record set. Route 53 calculates the sum of the weights for the resource record sets that have the same combination of DNS name and type. Route 53 then responds to queries based on the ratio of a resource's weight to the total.
Outputs
All input properties are implicitly available as output properties. Additionally, the RecordSet resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Supporting Types
RecordSetAliasTarget, RecordSetAliasTargetArgs
- Dns
Name string - The value that you specify depends on where you want to route queries.
- Hosted
Zone stringId - The value used depends on where you want to route traffic.
- Evaluate
Target boolHealth - When EvaluateTargetHealth is true, an alias resource record set inherits the health of the referenced AWS resource, such as an ELB load balancer or another resource record set in the hosted zone.
- Dns
Name string - The value that you specify depends on where you want to route queries.
- Hosted
Zone stringId - The value used depends on where you want to route traffic.
- Evaluate
Target boolHealth - When EvaluateTargetHealth is true, an alias resource record set inherits the health of the referenced AWS resource, such as an ELB load balancer or another resource record set in the hosted zone.
- dns_
name string - The value that you specify depends on where you want to route queries.
- hosted_
zone_ stringid - The value used depends on where you want to route traffic.
- evaluate_
target_ boolhealth - When EvaluateTargetHealth is true, an alias resource record set inherits the health of the referenced AWS resource, such as an ELB load balancer or another resource record set in the hosted zone.
- dns
Name String - The value that you specify depends on where you want to route queries.
- hosted
Zone StringId - The value used depends on where you want to route traffic.
- evaluate
Target BooleanHealth - When EvaluateTargetHealth is true, an alias resource record set inherits the health of the referenced AWS resource, such as an ELB load balancer or another resource record set in the hosted zone.
- dns
Name string - The value that you specify depends on where you want to route queries.
- hosted
Zone stringId - The value used depends on where you want to route traffic.
- evaluate
Target booleanHealth - When EvaluateTargetHealth is true, an alias resource record set inherits the health of the referenced AWS resource, such as an ELB load balancer or another resource record set in the hosted zone.
- dns_
name str - The value that you specify depends on where you want to route queries.
- hosted_
zone_ strid - The value used depends on where you want to route traffic.
- evaluate_
target_ boolhealth - When EvaluateTargetHealth is true, an alias resource record set inherits the health of the referenced AWS resource, such as an ELB load balancer or another resource record set in the hosted zone.
- dns
Name String - The value that you specify depends on where you want to route queries.
- hosted
Zone StringId - The value used depends on where you want to route traffic.
- evaluate
Target BooleanHealth - When EvaluateTargetHealth is true, an alias resource record set inherits the health of the referenced AWS resource, such as an ELB load balancer or another resource record set in the hosted zone.
RecordSetCidrRoutingConfig, RecordSetCidrRoutingConfigArgs
- Collection
Id string - The CIDR collection ID.
- Location
Name string - The CIDR collection location name.
- Collection
Id string - The CIDR collection ID.
- Location
Name string - The CIDR collection location name.
- collection_
id string - The CIDR collection ID.
- location_
name string - The CIDR collection location name.
- collection
Id String - The CIDR collection ID.
- location
Name String - The CIDR collection location name.
- collection
Id string - The CIDR collection ID.
- location
Name string - The CIDR collection location name.
- collection_
id str - The CIDR collection ID.
- location_
name str - The CIDR collection location name.
- collection
Id String - The CIDR collection ID.
- location
Name String - The CIDR collection location name.
RecordSetFailover, RecordSetFailoverArgs
- Primary
PRIMARY- Secondary
SECONDARY
- Record
Set Failover Primary PRIMARY- Record
Set Failover Secondary SECONDARY
- "PRIMARY"
PRIMARY- "SECONDARY"
SECONDARY
- Primary
PRIMARY- Secondary
SECONDARY
- Primary
PRIMARY- Secondary
SECONDARY
- PRIMARY
PRIMARY- SECONDARY
SECONDARY
- "PRIMARY"
PRIMARY- "SECONDARY"
SECONDARY
RecordSetGeoLocation, RecordSetGeoLocationArgs
- Continent
Code string - For geolocation resource record sets, a two-letter abbreviation that identifies a continent.
- Country
Code string - For geolocation resource record sets, the two-letter code for a country.
- Subdivision
Code string - For geolocation resource record sets, the two-letter code for a state of the United States.
- Continent
Code string - For geolocation resource record sets, a two-letter abbreviation that identifies a continent.
- Country
Code string - For geolocation resource record sets, the two-letter code for a country.
- Subdivision
Code string - For geolocation resource record sets, the two-letter code for a state of the United States.
- continent_
code string - For geolocation resource record sets, a two-letter abbreviation that identifies a continent.
- country_
code string - For geolocation resource record sets, the two-letter code for a country.
- subdivision_
code string - For geolocation resource record sets, the two-letter code for a state of the United States.
- continent
Code String - For geolocation resource record sets, a two-letter abbreviation that identifies a continent.
- country
Code String - For geolocation resource record sets, the two-letter code for a country.
- subdivision
Code String - For geolocation resource record sets, the two-letter code for a state of the United States.
- continent
Code string - For geolocation resource record sets, a two-letter abbreviation that identifies a continent.
- country
Code string - For geolocation resource record sets, the two-letter code for a country.
- subdivision
Code string - For geolocation resource record sets, the two-letter code for a state of the United States.
- continent_
code str - For geolocation resource record sets, a two-letter abbreviation that identifies a continent.
- country_
code str - For geolocation resource record sets, the two-letter code for a country.
- subdivision_
code str - For geolocation resource record sets, the two-letter code for a state of the United States.
- continent
Code String - For geolocation resource record sets, a two-letter abbreviation that identifies a continent.
- country
Code String - For geolocation resource record sets, the two-letter code for a country.
- subdivision
Code String - For geolocation resource record sets, the two-letter code for a state of the United States.
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
published on Monday, Sep 7, 2026 by Pulumi