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.
Retrieves a list of your hosted zones in lexicographic order. The response includes
a HostedZones child element for each hosted zone created by the current Amazon
Web Services account.
ListHostedZonesByName sorts hosted zones by name with the labels reversed.
For example:
com.example.www.
Note the trailing dot, which can change the sort order in some circumstances.
If the domain name includes escape characters or Punycode, ListHostedZonesByName
alphabetizes the domain name using the escaped or Punycoded value, which is the format
that Amazon Route 53 saves in its database. For example, to create a hosted zone for
exämple.com, you specify ex\344mple.com for the domain name. ListHostedZonesByName
alphabetizes it as:
com.ex\344mple.
The labels are reversed and alphabetized using the escaped value. For more information about valid domain name formats, including internationalized domain names, see DNS Domain Name Format in the Amazon Route 53 Developer Guide.
Route 53 returns up to 100 items in each response. If you have a lot of hosted zones,
use the MaxItems parameter to list them in groups of up to 100. The response
includes values that help navigate from one group of MaxItems hosted zones
to the next:
The DNSName and HostedZoneId elements in the response contain the values,
if any, specified for the dnsname and hostedzoneid parameters in the
request that produced the current response.
The MaxItems element in the response contains the value, if any, that you specified
for the maxitems parameter in the request that produced the current response.
If the value of IsTruncated in the response is true, there are more hosted
zones associated with the current Amazon Web Services account.
If IsTruncated is false, this response includes the last hosted zone that is
associated with the current account. The NextDNSName element and NextHostedZoneId
elements are omitted from the response.
The NextDNSName and NextHostedZoneId elements in the response contain
the domain name and the hosted zone ID of the next hosted zone that is associated
with the current Amazon Web Services account. If you want to list more hosted zones,
make another call to ListHostedZonesByName, and specify the value of NextDNSName
and NextHostedZoneId in the dnsname and hostedzoneid parameters,
respectively.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginListHostedZonesByName and EndListHostedZonesByName.
Namespace: Amazon.Route53
Assembly: AWSSDK.Route53.dll
Version: 3.x.y.z
public abstract Task<ListHostedZonesByNameResponse> ListHostedZonesByNameAsync( ListHostedZonesByNameRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the ListHostedZonesByName service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| InvalidDomainNameException | The specified domain name is not valid. |
| InvalidInputException | The input is not valid. |
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5