public class ListResourceRecordSetsRequest extends AmazonWebServiceRequest implements java.io.Serializable
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 "com.amazon.www" 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.
| コンストラクタと説明 |
|---|
ListResourceRecordSetsRequest()
Default constructor for a new ListResourceRecordSetsRequest object.
|
ListResourceRecordSetsRequest(java.lang.String hostedZoneId)
Constructs a new ListResourceRecordSetsRequest object.
|
| 修飾子とタイプ | メソッドと説明 |
|---|---|
boolean |
equals(java.lang.Object obj) |
java.lang.String |
getHostedZoneId()
The ID of the hosted zone that contains the resource record sets that
you want to get.
|
java.lang.String |
getMaxItems()
The maximum number of records you want in the response body.
|
java.lang.String |
getStartRecordIdentifier()
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. |
java.lang.String |
getStartRecordName()
The first name in the lexicographic ordering of domain names that you
want the
ListResourceRecordSets request to list. |
java.lang.String |
getStartRecordType()
The DNS type at which to begin the listing of resource record sets.
|
java.lang.String |
getVersion()
Specify the api version.
|
int |
hashCode() |
void |
setHostedZoneId(java.lang.String hostedZoneId)
The ID of the hosted zone that contains the resource record sets that
you want to get.
|
void |
setMaxItems(java.lang.String maxItems)
The maximum number of records you want in the response body.
|
void |
setStartRecordIdentifier(java.lang.String 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. |
void |
setStartRecordName(java.lang.String startRecordName)
The first name in the lexicographic ordering of domain names that you
want the
ListResourceRecordSets request to list. |
void |
setStartRecordType(RRType startRecordType)
The DNS type at which to begin the listing of resource record sets.
|
void |
setStartRecordType(java.lang.String startRecordType)
The DNS type at which to begin the listing of resource record sets.
|
void |
setVersion(java.lang.String version)
Specify the api version.
|
java.lang.String |
toString()
Returns a string representation of this object; useful for testing and
debugging.
|
ListResourceRecordSetsRequest |
withHostedZoneId(java.lang.String hostedZoneId)
The ID of the hosted zone that contains the resource record sets that
you want to get.
|
ListResourceRecordSetsRequest |
withMaxItems(java.lang.String maxItems)
The maximum number of records you want in the response body.
|
ListResourceRecordSetsRequest |
withStartRecordIdentifier(java.lang.String 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. |
ListResourceRecordSetsRequest |
withStartRecordName(java.lang.String startRecordName)
The first name in the lexicographic ordering of domain names that you
want the
ListResourceRecordSets request to list. |
ListResourceRecordSetsRequest |
withStartRecordType(RRType startRecordType)
The DNS type at which to begin the listing of resource record sets.
|
ListResourceRecordSetsRequest |
withStartRecordType(java.lang.String startRecordType)
The DNS type at which to begin the listing of resource record sets.
|
copyPrivateRequestParameters, getRequestClientOptions, getRequestCredentials, setRequestCredentialspublic ListResourceRecordSetsRequest()
public ListResourceRecordSetsRequest(java.lang.String hostedZoneId)
hostedZoneId - The ID of the hosted zone that contains the
resource record sets that you want to get.public java.lang.String getVersion()
public void setVersion(java.lang.String version)
public java.lang.String getHostedZoneId()
Constraints:
Length: 0 - 32
public void setHostedZoneId(java.lang.String hostedZoneId)
Constraints:
Length: 0 - 32
hostedZoneId - The ID of the hosted zone that contains the resource record sets that
you want to get.public ListResourceRecordSetsRequest withHostedZoneId(java.lang.String hostedZoneId)
Returns a reference to this object so that method calls can be chained together.
Constraints:
Length: 0 - 32
hostedZoneId - The ID of the hosted zone that contains the resource record sets that
you want to get.public java.lang.String getStartRecordName()
ListResourceRecordSets request to list.
Constraints:
Length: 0 - 1024
ListResourceRecordSets request to list.public void setStartRecordName(java.lang.String startRecordName)
ListResourceRecordSets request to list.
Constraints:
Length: 0 - 1024
startRecordName - The first name in the lexicographic ordering of domain names that you
want the ListResourceRecordSets request to list.public ListResourceRecordSetsRequest withStartRecordName(java.lang.String startRecordName)
ListResourceRecordSets request to list.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Length: 0 - 1024
startRecordName - The first name in the lexicographic ordering of domain names that you
want the ListResourceRecordSets request to list.public java.lang.String getStartRecordType()
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.
Constraints:
Allowed Values: SOA, A, TXT, NS, CNAME, MX, PTR, SRV, SPF, AAAA
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.
RRTypepublic void setStartRecordType(java.lang.String startRecordType)
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.
Constraints:
Allowed Values: SOA, A, TXT, NS, CNAME, MX, PTR, SRV, SPF, AAAA
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.
RRTypepublic ListResourceRecordSetsRequest withStartRecordType(java.lang.String startRecordType)
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.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Allowed Values: SOA, A, TXT, NS, CNAME, MX, PTR, SRV, SPF, AAAA
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.
RRTypepublic void setStartRecordType(RRType startRecordType)
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.
Constraints:
Allowed Values: SOA, A, TXT, NS, CNAME, MX, PTR, SRV, SPF, AAAA
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.
RRTypepublic ListResourceRecordSetsRequest withStartRecordType(RRType startRecordType)
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.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Allowed Values: SOA, A, TXT, NS, CNAME, MX, PTR, SRV, SPF, AAAA
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.
RRTypepublic java.lang.String getStartRecordIdentifier()
ListResourceRecordSetsResponse$NextRecordIdentifier from
the previous response to get the next resource record set that has the
current DNS name and type.
Constraints:
Length: 1 - 128
ListResourceRecordSetsResponse$NextRecordIdentifier from
the previous response to get the next resource record set that has the
current DNS name and type.public void setStartRecordIdentifier(java.lang.String startRecordIdentifier)
ListResourceRecordSetsResponse$NextRecordIdentifier from
the previous response to get the next resource record set that has the
current DNS name and type.
Constraints:
Length: 1 - 128
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 ListResourceRecordSetsRequest withStartRecordIdentifier(java.lang.String startRecordIdentifier)
ListResourceRecordSetsResponse$NextRecordIdentifier from
the previous response to get the next resource record set that has the
current DNS name and type.
Returns a reference to this object so that method calls can be chained together.
Constraints:
Length: 1 - 128
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 java.lang.String getMaxItems()
public void setMaxItems(java.lang.String maxItems)
maxItems - The maximum number of records you want in the response body.public ListResourceRecordSetsRequest withMaxItems(java.lang.String maxItems)
Returns a reference to this object so that method calls can be chained together.
maxItems - The maximum number of records you want in the response body.public java.lang.String toString()
toString クラス内 java.lang.ObjectObject.toString()public int hashCode()
hashCode クラス内 java.lang.Objectpublic boolean equals(java.lang.Object obj)
equals クラス内 java.lang.Object