List Records
route53.list_resource_record_sets
ActionAmazon Web Servicesconnection required
Calls the AWS route53 API (SigV4).
List a zone's DNS records.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Amazon Route 53
- Secret shape
- {"access_key_id", "secret_access_key"}
- Config it needs
- region
- Resolved by
- config.connection_id, else node.connection_id
Configuration
5 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
region AWS region (overrides the connection). | string | No | — | — | — |
hosted_zone_id Hosted zone id (Z…). | string | Yes | — | — | — |
next_token Continue a previous run of this node from where it stopped: the next_token value that run emitted. | string | No | — | — | — |
next_record_type The record type that pairs with next_token when continuing a previous run of this node: the next_record_type value that run emitted. | string | No | — | — | — |
next_record_identifier Only for zones with weighted, latency, geolocation or failover records: the next_record_identifier value the previous run emitted, so this run resumes inside that group rather than at the first record of it. | string | No | — | — | — |
Output
One shape.
result
| Field | Type | Example |
|---|---|---|
records[].name Record name, e.g. api.example.com. | string | — |
records[].type A | AAAA | CNAME | TXT | MX | …. | string | — |
records[].ttl TTL seconds. Null for an alias record. | number | — |
records[].values Record values. Empty for an alias record. | array | — |
records[].alias_target For an alias record: {hosted_zone_id, dns_name, evaluate_target_health}. Null for an ordinary record — this is how the two are told apart. | object | — |
records[].set_identifier Names one record within a group sharing a name and type; a change or delete step must send it back. Null for a simple record. | string | — |
records[].weight Weighted routing: this record's share. | number | — |
records[].region Latency routing: the region served. | string | — |
records[].failover Failover routing: PRIMARY or SECONDARY. | string | — |
records[].multi_value_answer Multivalue-answer routing: true when this record takes part. | boolean | — |
records[].geo_location Geolocation routing: {continent_code, country_code, subdivision_code}. | object | — |
records[].geo_proximity_location Geoproximity routing: {aws_region, local_zone_group, bias, latitude, longitude}. | object | — |
records[].cidr_routing_config IP-based routing: {collection_id, location_name}. | object | — |
records[].health_check_id Health check this record is associated with, if any. | string | — |
records[].traffic_policy_instance_id Traffic policy instance that owns this record, if any. | string | — |
count | number | — |
next_token Cursor for the next page; empty when there are no further pages. | string | — |
next_record_type The record type to resume at, paired with next_token; empty when there are no further pages. | string | — |
next_record_identifier The record within a same-name, same-type group to resume at; empty unless the page stopped inside such a group. | string | — |
is_truncated True when Route 53 has more records for this zone; null on the rare response that does not say. | boolean | — |
{
"count": 0,
"is_truncated": false,
"next_record_identifier": "",
"next_record_type": "",
"next_token": "",
"records": [
{
"alias_target": {},
"cidr_routing_config": {},
"failover": "",
"geo_location": {},
"geo_proximity_location": {},
"health_check_id": "",
"multi_value_answer": false,
"name": "",
"region": "",
"set_identifier": "",
"traffic_policy_instance_id": "",
"ttl": 0,
"type": "",
"values": [],
"weight": 0
}
]
}Related Amazon Route 53 nodes
See List Records run in a workflow.
In a technical demo we add the Amazon Route 53 connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.