Struct aws_sdk_route53::operation::list_hosted_zones_by_name::builders::ListHostedZonesByNameFluentBuilder
source · pub struct ListHostedZonesByNameFluentBuilder { /* private fields */ }
Expand description
Fluent builder constructing a request to ListHostedZonesByName
.
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
andHostedZoneId
elements in the response contain the values, if any, specified for thednsname
andhostedzoneid
parameters in the request that produced the current response. -
The
MaxItems
element in the response contains the value, if any, that you specified for themaxitems
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. TheNextDNSName
element andNextHostedZoneId
elements are omitted from the response. -
The
NextDNSName
andNextHostedZoneId
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 toListHostedZonesByName
, and specify the value ofNextDNSName
andNextHostedZoneId
in thednsname
andhostedzoneid
parameters, respectively.
Implementations§
source§impl ListHostedZonesByNameFluentBuilder
impl ListHostedZonesByNameFluentBuilder
sourcepub fn as_input(&self) -> &ListHostedZonesByNameInputBuilder
pub fn as_input(&self) -> &ListHostedZonesByNameInputBuilder
Access the ListHostedZonesByName as a reference.
sourcepub async fn send(
self
) -> Result<ListHostedZonesByNameOutput, SdkError<ListHostedZonesByNameError, HttpResponse>>
pub async fn send( self ) -> Result<ListHostedZonesByNameOutput, SdkError<ListHostedZonesByNameError, HttpResponse>>
Sends the request and returns the response.
If an error occurs, an SdkError
will be returned with additional details that
can be matched against.
By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.
sourcepub fn customize(
self
) -> CustomizableOperation<ListHostedZonesByNameOutput, ListHostedZonesByNameError, Self>
pub fn customize( self ) -> CustomizableOperation<ListHostedZonesByNameOutput, ListHostedZonesByNameError, Self>
Consumes this builder, creating a customizable operation that can be modified before being sent.
sourcepub fn dns_name(self, input: impl Into<String>) -> Self
pub fn dns_name(self, input: impl Into<String>) -> Self
(Optional) For your first request to ListHostedZonesByName
, 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 Amazon Web Services account, in ASCII order. For subsequent requests, include both dnsname
and hostedzoneid
parameters. For dnsname
, specify the value of NextDNSName
from the previous response.
sourcepub fn set_dns_name(self, input: Option<String>) -> Self
pub fn set_dns_name(self, input: Option<String>) -> Self
(Optional) For your first request to ListHostedZonesByName
, 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 Amazon Web Services account, in ASCII order. For subsequent requests, include both dnsname
and hostedzoneid
parameters. For dnsname
, specify the value of NextDNSName
from the previous response.
sourcepub fn get_dns_name(&self) -> &Option<String>
pub fn get_dns_name(&self) -> &Option<String>
(Optional) For your first request to ListHostedZonesByName
, 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 Amazon Web Services account, in ASCII order. For subsequent requests, include both dnsname
and hostedzoneid
parameters. For dnsname
, specify the value of NextDNSName
from the previous response.
sourcepub fn hosted_zone_id(self, input: impl Into<String>) -> Self
pub fn hosted_zone_id(self, input: impl Into<String>) -> Self
(Optional) For your first request to ListHostedZonesByName
, do not include the hostedzoneid
parameter.
If you have more hosted zones than the value of maxitems
, ListHostedZonesByName
returns only the first maxitems
hosted zones. To get the next group of maxitems
hosted zones, submit another request to ListHostedZonesByName
and include both dnsname
and hostedzoneid
parameters. For the value of hostedzoneid
, specify the value of the NextHostedZoneId
element from the previous response.
sourcepub fn set_hosted_zone_id(self, input: Option<String>) -> Self
pub fn set_hosted_zone_id(self, input: Option<String>) -> Self
(Optional) For your first request to ListHostedZonesByName
, do not include the hostedzoneid
parameter.
If you have more hosted zones than the value of maxitems
, ListHostedZonesByName
returns only the first maxitems
hosted zones. To get the next group of maxitems
hosted zones, submit another request to ListHostedZonesByName
and include both dnsname
and hostedzoneid
parameters. For the value of hostedzoneid
, specify the value of the NextHostedZoneId
element from the previous response.
sourcepub fn get_hosted_zone_id(&self) -> &Option<String>
pub fn get_hosted_zone_id(&self) -> &Option<String>
(Optional) For your first request to ListHostedZonesByName
, do not include the hostedzoneid
parameter.
If you have more hosted zones than the value of maxitems
, ListHostedZonesByName
returns only the first maxitems
hosted zones. To get the next group of maxitems
hosted zones, submit another request to ListHostedZonesByName
and include both dnsname
and hostedzoneid
parameters. For the value of hostedzoneid
, specify the value of the NextHostedZoneId
element from the previous response.
sourcepub fn max_items(self, input: i32) -> Self
pub fn max_items(self, input: i32) -> Self
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.
sourcepub fn set_max_items(self, input: Option<i32>) -> Self
pub fn set_max_items(self, input: Option<i32>) -> Self
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.
sourcepub fn get_max_items(&self) -> &Option<i32>
pub fn get_max_items(&self) -> &Option<i32>
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.
Trait Implementations§
source§impl Clone for ListHostedZonesByNameFluentBuilder
impl Clone for ListHostedZonesByNameFluentBuilder
source§fn clone(&self) -> ListHostedZonesByNameFluentBuilder
fn clone(&self) -> ListHostedZonesByNameFluentBuilder
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreAuto Trait Implementations§
impl Freeze for ListHostedZonesByNameFluentBuilder
impl !RefUnwindSafe for ListHostedZonesByNameFluentBuilder
impl Send for ListHostedZonesByNameFluentBuilder
impl Sync for ListHostedZonesByNameFluentBuilder
impl Unpin for ListHostedZonesByNameFluentBuilder
impl !UnwindSafe for ListHostedZonesByNameFluentBuilder
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more