AWS SDK Version 2 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

.NET Framework 4.5
Container for the parameters to the ListResourceRecordSets operation. Imagine all the resource record sets in a zone listed out in front of you. Imagine them sorted lexicographically first by DNS name (with the labels reversed, like "" for example), and secondarily, lexicographically by record type. This operation retrieves at most MaxItems resource record sets from this list, in order, starting at a position specified by the Name and Type arguments:

Use ListResourceRecordSets to retrieve a single known record set by specifying the record set's name and type, and setting MaxItems = 1

To retrieve all the records in a HostedZone, first pause any processes making calls to ChangeResourceRecordSets. Initially call ListResourceRecordSets without a Name and Type to get the first page of record sets. For subsequent calls, set Name and Type to the NextName and NextType values returned by the previous response.

In the presence of concurrent ChangeResourceRecordSets calls, there is no consistency of results across calls to ListResourceRecordSets. The only way to get a consistent multi-page snapshot of all RRSETs in a zone is to stop making changes while pagination is in progress.

However, the results from ListResourceRecordSets are consistent within a page. If MakeChange calls are taking place concurrently, the result of each one will either be completely visible in your results or not at all. You will not see partial changes, or changes that do not ultimately succeed. (This follows from the fact that MakeChange is atomic)

The results from ListResourceRecordSets are strongly consistent with ChangeResourceRecordSets. To be precise, if a single process makes a call to ChangeResourceRecordSets and receives a successful response, the effects of that change will be visible in a subsequent call to ListResourceRecordSets by that process.

Inheritance Hierarchy


Namespace: Amazon.Route53.Model
Assembly: AWSSDK.dll
Version: (assembly version)


public class ListResourceRecordSetsRequest : AmazonRoute53Request

The ListResourceRecordSetsRequest type exposes the following members


Public Method ListResourceRecordSetsRequest() Empty constructor used to set properties independently even when a simple constructor is available
Public Method ListResourceRecordSetsRequest(string) Instantiates ListResourceRecordSetsRequest with the parameterized properties


Public Property HostedZoneId System.String Gets and sets the property HostedZoneId.

The ID of the hosted zone that contains the resource record sets that you want to get.

Public Property MaxItems System.String Gets and sets the property MaxItems.

The maximum number of records you want in the response body.

Public Property StartRecordIdentifier System.String Gets and sets the property StartRecordIdentifier.

Weighted resource record sets only: If results were truncated for a given DNS name and type, specify the value of ListResourceRecordSetsResponse$NextRecordIdentifier from the previous response to get the next resource record set that has the current DNS name and type.

Public Property StartRecordName System.String Gets and sets the property StartRecordName.

The first name in the lexicographic ordering of domain names that you want the ListResourceRecordSets request to list.

Public Property StartRecordType Amazon.Route53.RRType Gets and sets the property StartRecordType.

The DNS type at which to begin the listing of resource record sets.

Valid values: A | AAAA | CNAME | MX | NS | PTR | SOA | SPF | SRV | TXT

Values for Weighted Resource Record Sets: A | AAAA | CNAME | TXT

Values for Regional Resource Record Sets: A | AAAA | CNAME | TXT

Values for Alias Resource Record Sets: A | AAAA

Constraint: Specifying type without specifying name returns an InvalidInput error.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

.NET for Windows Store apps:
Supported in: Windows 8