route53_list_hosted_zones_by_name: Retrieves a list of your hosted zones in lexicographic order

Description Usage Arguments Value Request syntax

View source: R/route53_operations.R

Description

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 AWS account.

list_hosted_zones_by_name 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, list_hosted_zones_by_name 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. list_hosted_zones_by_name 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:

Usage

1
route53_list_hosted_zones_by_name(DNSName, HostedZoneId, MaxItems)

Arguments

DNSName

(Optional) For your first request to list_hosted_zones_by_name, include the dnsname parameter only if you want to specify the name of the first hosted zone in the response. If you don't include the dnsname parameter, Amazon Route 53 returns all of the hosted zones that were created by the current AWS account, in ASCII order. For subsequent requests, include both dnsname and hostedzoneid parameters. For dnsname, specify the value of NextDNSName from the previous response.

HostedZoneId

(Optional) For your first request to list_hosted_zones_by_name, do not include the hostedzoneid parameter.

If you have more hosted zones than the value of maxitems, list_hosted_zones_by_name returns only the first maxitems hosted zones. To get the next group of maxitems hosted zones, submit another request to list_hosted_zones_by_name and include both dnsname and hostedzoneid parameters. For the value of hostedzoneid, specify the value of the NextHostedZoneId element from the previous response.

MaxItems

The maximum number of hosted zones to be included in the response body for this request. If you have more than maxitems hosted zones, then the value of the IsTruncated element in the response is true, and the values of NextDNSName and NextHostedZoneId specify the first hosted zone in the next group of maxitems hosted zones.

Value

A list with the following syntax:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
list(
  HostedZones = list(
    list(
      Id = "string",
      Name = "string",
      CallerReference = "string",
      Config = list(
        Comment = "string",
        PrivateZone = TRUE|FALSE
      ),
      ResourceRecordSetCount = 123,
      LinkedService = list(
        ServicePrincipal = "string",
        Description = "string"
      )
    )
  ),
  DNSName = "string",
  HostedZoneId = "string",
  IsTruncated = TRUE|FALSE,
  NextDNSName = "string",
  NextHostedZoneId = "string",
  MaxItems = "string"
)

Request syntax

1
2
3
4
5
svc$list_hosted_zones_by_name(
  DNSName = "string",
  HostedZoneId = "string",
  MaxItems = "string"
)

paws.networking documentation built on March 7, 2021, 5:08 p.m.