Struct aws_sdk_route53domains::client::Client

pub struct Client<C = DynConnector, M = DefaultMiddleware, R = Standard> { /* private fields */ }

Client for Amazon Route 53 Domains

Client for invoking operations on Amazon Route 53 Domains. Each operation on Amazon Route 53 Domains is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Examples

Constructing a client and invoking an operation

    // create a shared configuration. This can be used & shared between multiple service clients.
    let shared_config = aws_config::load_from_env().await;
    let client = aws_sdk_route53domains::Client::new(&shared_config);
    // invoke an operation
    /* let rsp = client
        .<operation_name>().
        .<param>("some value")
        .send().await; */

Constructing a client with custom configuration

use aws_config::RetryConfig;
    let shared_config = aws_config::load_from_env().await;
    let config = aws_sdk_route53domains::config::Builder::from(&shared_config)
        .retry_config(RetryConfig::disabled())
        .build();
    let client = aws_sdk_route53domains::Client::from_conf(config);

Implementations

impl<C, M, R> Client<C, M, R>

pub fn with_config(client: Client<C, M, R>, conf: Config) -> Self

Creates a client with the given service configuration.

pub fn conf(&self) -> &Config

Returns the client’s configuration.

impl<C, M, R> Client<C, M, R> where
    C: SmithyConnector,
    M: SmithyMiddleware<C>,
    R: NewRequestPolicy, 

pub fn accept_domain_transfer_from_another_aws_account(
    &self
) -> AcceptDomainTransferFromAnotherAwsAccount<C, M, R>

Constructs a fluent builder for the AcceptDomainTransferFromAnotherAwsAccount operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that was specified when another Amazon Web Services account submitted a TransferDomainToAnotherAwsAccount request.

  • password(impl Into<String>) / set_password(Option<String>):

    The password that was returned by the TransferDomainToAnotherAwsAccount request.

• On success, responds with AcceptDomainTransferFromAnotherAwsAccountOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

• On failure, responds with SdkError<AcceptDomainTransferFromAnotherAwsAccountError>

pub fn cancel_domain_transfer_to_another_aws_account(
    &self
) -> CancelDomainTransferToAnotherAwsAccount<C, M, R>

Constructs a fluent builder for the CancelDomainTransferToAnotherAwsAccount operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain for which you want to cancel the transfer to another Amazon Web Services account.

• On success, responds with CancelDomainTransferToAnotherAwsAccountOutput with field(s):
  • operation_id(Option<String>):

    The identifier that TransferDomainToAnotherAwsAccount returned to track the progress of the request. Because the transfer request was canceled, the value is no longer valid, and you can’t use GetOperationDetail to query the operation status.

• On failure, responds with SdkError<CancelDomainTransferToAnotherAwsAccountError>

pub fn check_domain_availability(&self) -> CheckDomainAvailability<C, M, R>

Constructs a fluent builder for the CheckDomainAvailability operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to get availability for. The top-level domain (TLD), such as .com, must be a TLD that Route 53 supports. For a list of supported TLDs, see Domains that You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

    The domain name can contain only the following characters:

    • Letters a through z. Domain names are not case sensitive.

    • Numbers 0 through 9.

    • Hyphen (-). You can’t specify a hyphen at the beginning or end of a label.

    • Period (.) to separate the labels in the name, such as the . in example.com.

    Internationalized domain names are not supported for some top-level domains. To determine whether the TLD that you want to use supports internationalized domain names, see Domains that You Can Register with Amazon Route 53. For more information, see Formatting Internationalized Domain Names.

  • idn_lang_code(impl Into<String>) / set_idn_lang_code(Option<String>):

    Reserved for future use.

• On success, responds with CheckDomainAvailabilityOutput with field(s):
  • availability(Option<DomainAvailability>):

    Whether the domain name is available for registering.

    You can register only domains designated as AVAILABLE.

    Valid values:

    AVAILABLE

    The domain name is available.

    AVAILABLE_RESERVED

    The domain name is reserved under specific conditions.

    AVAILABLE_PREORDER

    The domain name is available and can be preordered.

    DONT_KNOW

    The TLD registry didn’t reply with a definitive answer about whether the domain name is available. Route 53 can return this response for a variety of reasons, for example, the registry is performing maintenance. Try again later.

    PENDING

    The TLD registry didn’t return a response in the expected amount of time. When the response is delayed, it usually takes just a few extra seconds. You can resubmit the request immediately.

    RESERVED

    The domain name has been reserved for another person or organization.

    UNAVAILABLE

    The domain name is not available.

    UNAVAILABLE_PREMIUM

    The domain name is not available.

    UNAVAILABLE_RESTRICTED

    The domain name is forbidden.

• On failure, responds with SdkError<CheckDomainAvailabilityError>

pub fn check_domain_transferability(
    &self
) -> CheckDomainTransferability<C, M, R>

Constructs a fluent builder for the CheckDomainTransferability operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to transfer to Route 53. The top-level domain (TLD), such as .com, must be a TLD that Route 53 supports. For a list of supported TLDs, see Domains that You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

    The domain name can contain only the following characters:

    • Letters a through z. Domain names are not case sensitive.

    • Numbers 0 through 9.

    • Hyphen (-). You can’t specify a hyphen at the beginning or end of a label.

    • Period (.) to separate the labels in the name, such as the . in example.com.

  • auth_code(impl Into<String>) / set_auth_code(Option<String>):

    If the registrar for the top-level domain (TLD) requires an authorization code to transfer the domain, the code that you got from the current registrar for the domain.

• On success, responds with CheckDomainTransferabilityOutput with field(s):
  • transferability(Option<DomainTransferability>):

    A complex type that contains information about whether the specified domain can be transferred to Route 53.

• On failure, responds with SdkError<CheckDomainTransferabilityError>

pub fn delete_domain(&self) -> DeleteDomain<C, M, R>

Constructs a fluent builder for the DeleteDomain operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    Name of the domain to be deleted.

• On success, responds with DeleteDomainOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

• On failure, responds with SdkError<DeleteDomainError>

pub fn delete_tags_for_domain(&self) -> DeleteTagsForDomain<C, M, R>

Constructs a fluent builder for the DeleteTagsForDomain operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The domain for which you want to delete one or more tags.

  • tags_to_delete(Vec<String>) / set_tags_to_delete(Option<Vec<String>>):

    A list of tag keys to delete.

• On success, responds with DeleteTagsForDomainOutput
• On failure, responds with SdkError<DeleteTagsForDomainError>

pub fn disable_domain_auto_renew(&self) -> DisableDomainAutoRenew<C, M, R>

Constructs a fluent builder for the DisableDomainAutoRenew operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to disable automatic renewal for.

• On success, responds with DisableDomainAutoRenewOutput
• On failure, responds with SdkError<DisableDomainAutoRenewError>

pub fn disable_domain_transfer_lock(&self) -> DisableDomainTransferLock<C, M, R>

Constructs a fluent builder for the DisableDomainTransferLock operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to remove the transfer lock for.

• On success, responds with DisableDomainTransferLockOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

• On failure, responds with SdkError<DisableDomainTransferLockError>

pub fn enable_domain_auto_renew(&self) -> EnableDomainAutoRenew<C, M, R>

Constructs a fluent builder for the EnableDomainAutoRenew operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to enable automatic renewal for.

• On success, responds with EnableDomainAutoRenewOutput
• On failure, responds with SdkError<EnableDomainAutoRenewError>

pub fn enable_domain_transfer_lock(&self) -> EnableDomainTransferLock<C, M, R>

Constructs a fluent builder for the EnableDomainTransferLock operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to set the transfer lock for.

• On success, responds with EnableDomainTransferLockOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.

• On failure, responds with SdkError<EnableDomainTransferLockError>

pub fn get_contact_reachability_status(
    &self
) -> GetContactReachabilityStatus<C, M, R>

Constructs a fluent builder for the GetContactReachabilityStatus operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain for which you want to know whether the registrant contact has confirmed that the email address is valid.

• On success, responds with GetContactReachabilityStatusOutput with field(s):
  • domain_name(Option<String>):

    The domain name for which you requested the reachability status.

  • status(Option<ReachabilityStatus>):

    Whether the registrant contact has responded. Values include the following:

    PENDING

    We sent the confirmation email and haven’t received a response yet.

    DONE

    We sent the email and got confirmation from the registrant contact.

    EXPIRED

    The time limit expired before the registrant contact responded.

• On failure, responds with SdkError<GetContactReachabilityStatusError>

pub fn get_domain_detail(&self) -> GetDomainDetail<C, M, R>

Constructs a fluent builder for the GetDomainDetail operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to get detailed information about.

• On success, responds with GetDomainDetailOutput with field(s):
  • domain_name(Option<String>):

    The name of a domain.

  • nameservers(Option<Vec<Nameserver>>):

    The name of the domain.

  • auto_renew(Option<bool>):

    Specifies whether the domain registration is set to renew automatically.

  • admin_contact(Option<ContactDetail>):

    Provides details about the domain administrative contact.

  • registrant_contact(Option<ContactDetail>):

    Provides details about the domain registrant.

  • tech_contact(Option<ContactDetail>):

    Provides details about the domain technical contact.

  • admin_privacy(Option<bool>):

    Specifies whether contact information is concealed from WHOIS queries. If the value is true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If the value is false, WHOIS queries return the information that you entered for the admin contact.

  • registrant_privacy(Option<bool>):

    Specifies whether contact information is concealed from WHOIS queries. If the value is true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If the value is false, WHOIS queries return the information that you entered for the registrant contact (domain owner).

  • tech_privacy(Option<bool>):

    Specifies whether contact information is concealed from WHOIS queries. If the value is true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If the value is false, WHOIS queries return the information that you entered for the technical contact.

  • registrar_name(Option<String>):

    Name of the registrar of the domain as identified in the registry. Domains with a .com, .net, or .org TLD are registered by Amazon Registrar. All other domains are registered by our registrar associate, Gandi. The value for domains that are registered by Gandi is “GANDI SAS”.

  • who_is_server(Option<String>):

    The fully qualified name of the WHOIS server that can answer the WHOIS query for the domain.

  • registrar_url(Option<String>):

    Web address of the registrar.

  • abuse_contact_email(Option<String>):

    Email address to contact to report incorrect contact information for a domain, to report that the domain is being used to send spam, to report that someone is cybersquatting on a domain name, or report some other type of abuse.

  • abuse_contact_phone(Option<String>):

    Phone number for reporting abuse.

  • registry_domain_id(Option<String>):

    Reserved for future use.

  • creation_date(Option<DateTime>):

    The date when the domain was created as found in the response to a WHOIS query. The date and time is in Unix time format and Coordinated Universal time (UTC).

  • updated_date(Option<DateTime>):

    The last updated date of the domain as found in the response to a WHOIS query. The date and time is in Unix time format and Coordinated Universal time (UTC).

  • expiration_date(Option<DateTime>):

    The date when the registration for the domain is set to expire. The date and time is in Unix time format and Coordinated Universal time (UTC).

  • reseller(Option<String>):

    Reseller of the domain. Domains registered or transferred using Route 53 domains will have “Amazon” as the reseller.

  • dns_sec(Option<String>):

    Deprecated.

  • status_list(Option<Vec<String>>):

    An array of domain name status codes, also known as Extensible Provisioning Protocol (EPP) status codes.

    ICANN, the organization that maintains a central database of domain names, has developed a set of domain name status codes that tell you the status of a variety of operations on a domain name, for example, registering a domain name, transferring a domain name to another registrar, renewing the registration for a domain name, and so on. All registrars use this same set of status codes.

    For a current list of domain name status codes and an explanation of what each code means, go to the ICANN website and search for epp status codes. (Search on the ICANN website; web searches sometimes return an old version of the document.)

• On failure, responds with SdkError<GetDomainDetailError>

pub fn get_domain_suggestions(&self) -> GetDomainSuggestions<C, M, R>

Constructs a fluent builder for the GetDomainSuggestions operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    A domain name that you want to use as the basis for a list of possible domain names. The top-level domain (TLD), such as .com, must be a TLD that Route 53 supports. For a list of supported TLDs, see Domains that You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

    The domain name can contain only the following characters:

    • Letters a through z. Domain names are not case sensitive.

    • Numbers 0 through 9.

    • Hyphen (-). You can’t specify a hyphen at the beginning or end of a label.

    • Period (.) to separate the labels in the name, such as the . in example.com.

    Internationalized domain names are not supported for some top-level domains. To determine whether the TLD that you want to use supports internationalized domain names, see Domains that You Can Register with Amazon Route 53.

  • suggestion_count(i32) / set_suggestion_count(i32):

    The number of suggested domain names that you want Route 53 to return. Specify a value between 1 and 50.

  • only_available(bool) / set_only_available(Option<bool>):

    If OnlyAvailable is true, Route 53 returns only domain names that are available. If OnlyAvailable is false, Route 53 returns domain names without checking whether they’re available to be registered. To determine whether the domain is available, you can call checkDomainAvailability for each suggestion.

• On success, responds with GetDomainSuggestionsOutput with field(s):
  • suggestions_list(Option<Vec<DomainSuggestion>>):

    A list of possible domain names. If you specified true for OnlyAvailable in the request, the list contains only domains that are available for registration.

• On failure, responds with SdkError<GetDomainSuggestionsError>

pub fn get_operation_detail(&self) -> GetOperationDetail<C, M, R>

Constructs a fluent builder for the GetOperationDetail operation.

• The fluent builder is configurable:
  • operation_id(impl Into<String>) / set_operation_id(Option<String>):

    The identifier for the operation for which you want to get the status. Route 53 returned the identifier in the response to the original request.

• On success, responds with GetOperationDetailOutput with field(s):
  • operation_id(Option<String>):

    The identifier for the operation.

  • status(Option<OperationStatus>):

    The current status of the requested operation in the system.

  • message(Option<String>):

    Detailed information on the status including possible errors.

  • domain_name(Option<String>):

    The name of a domain.

  • r#type(Option<OperationType>):

    The type of operation that was requested.

  • submitted_date(Option<DateTime>):

    The date when the request was submitted.

• On failure, responds with SdkError<GetOperationDetailError>

pub fn list_domains(&self) -> ListDomains<C, M, R>

Constructs a fluent builder for the ListDomains operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • filter_conditions(Vec<FilterCondition>) / set_filter_conditions(Option<Vec<FilterCondition>>):

    A complex type that contains information about the filters applied during the ListDomains request. The filter conditions can include domain name and domain expiration.

  • sort_condition(SortCondition) / set_sort_condition(Option<SortCondition>):

    A complex type that contains information about the requested ordering of domains in the returned list.

  • marker(impl Into<String>) / set_marker(Option<String>):

    For an initial request for a list of domains, omit this element. If the number of domains that are associated with the current Amazon Web Services account is greater than the value that you specified for MaxItems, you can use Marker to return additional domains. Get the value of NextPageMarker from the previous response, and submit another request that includes the value of NextPageMarker in the Marker element.

    Constraints: The marker must match the value specified in the previous request.

  • max_items(i32) / set_max_items(Option<i32>):

    Number of domains to be returned.

    Default: 20

• On success, responds with ListDomainsOutput with field(s):
  • domains(Option<Vec<DomainSummary>>):

    A list of domains.

  • next_page_marker(Option<String>):

    If there are more domains than you specified for MaxItems in the request, submit another request and include the value of NextPageMarker in the value of Marker.

• On failure, responds with SdkError<ListDomainsError>

pub fn list_operations(&self) -> ListOperations<C, M, R>

Constructs a fluent builder for the ListOperations operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • submitted_since(DateTime) / set_submitted_since(Option<DateTime>):

    An optional parameter that lets you get information about all the operations that you submitted after a specified date and time. Specify the date and time in Unix time format and Coordinated Universal time (UTC).

  • marker(impl Into<String>) / set_marker(Option<String>):

    For an initial request for a list of operations, omit this element. If the number of operations that are not yet complete is greater than the value that you specified for MaxItems, you can use Marker to return additional operations. Get the value of NextPageMarker from the previous response, and submit another request that includes the value of NextPageMarker in the Marker element.

  • max_items(i32) / set_max_items(Option<i32>):

    Number of domains to be returned.

    Default: 20

• On success, responds with ListOperationsOutput with field(s):
  • operations(Option<Vec<OperationSummary>>):

    Lists summaries of the operations.

  • next_page_marker(Option<String>):

    If there are more operations than you specified for MaxItems in the request, submit another request and include the value of NextPageMarker in the value of Marker.

• On failure, responds with SdkError<ListOperationsError>

pub fn list_prices(&self) -> ListPrices<C, M, R>

Constructs a fluent builder for the ListPrices operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • tld(impl Into<String>) / set_tld(Option<String>):

    The TLD for which you want to receive the pricing information. For example. .net.

    If a Tld value is not provided, a list of prices for all TLDs supported by Route 53 is returned.

  • marker(impl Into<String>) / set_marker(Option<String>):

    For an initial request for a list of prices, omit this element. If the number of prices that are not yet complete is greater than the value that you specified for MaxItems, you can use Marker to return additional prices. Get the value of NextPageMarker from the previous response, and submit another request that includes the value of NextPageMarker in the Marker element.

    Used only for all TLDs. If you specify a TLD, don’t specify a Marker.

  • max_items(i32) / set_max_items(Option<i32>):

    Number of Prices to be returned.

    Used only for all TLDs. If you specify a TLD, don’t specify a MaxItems.

• On success, responds with ListPricesOutput with field(s):
  • prices(Option<Vec<DomainPrice>>):

    A complex type that includes all the pricing information. If you specify a TLD, this array contains only the pricing for that TLD.

  • next_page_marker(Option<String>):

    If there are more prices than you specified for MaxItems in the request, submit another request and include the value of NextPageMarker in the value of Marker.

    Used only for all TLDs. If you specify a TLD, don’t specify a NextPageMarker.

• On failure, responds with SdkError<ListPricesError>

pub fn list_tags_for_domain(&self) -> ListTagsForDomain<C, M, R>

Constructs a fluent builder for the ListTagsForDomain operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The domain for which you want to get a list of tags.

• On success, responds with ListTagsForDomainOutput with field(s):
  • tag_list(Option<Vec<Tag>>):

    A list of the tags that are associated with the specified domain.

• On failure, responds with SdkError<ListTagsForDomainError>

pub fn register_domain(&self) -> RegisterDomain<C, M, R>

Constructs a fluent builder for the RegisterDomain operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The domain name that you want to register. The top-level domain (TLD), such as .com, must be a TLD that Route 53 supports. For a list of supported TLDs, see Domains that You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

    The domain name can contain only the following characters:

    • Letters a through z. Domain names are not case sensitive.

    • Numbers 0 through 9.

    • Hyphen (-). You can’t specify a hyphen at the beginning or end of a label.

    • Period (.) to separate the labels in the name, such as the . in example.com.

    Internationalized domain names are not supported for some top-level domains. To determine whether the TLD that you want to use supports internationalized domain names, see Domains that You Can Register with Amazon Route 53. For more information, see Formatting Internationalized Domain Names.

  • idn_lang_code(impl Into<String>) / set_idn_lang_code(Option<String>):

    Reserved for future use.

  • duration_in_years(i32) / set_duration_in_years(Option<i32>):

    The number of years that you want to register the domain for. Domains are registered for a minimum of one year. The maximum period depends on the top-level domain. For the range of valid values for your domain, see Domains that You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

    Default: 1

  • auto_renew(bool) / set_auto_renew(Option<bool>):

    Indicates whether the domain will be automatically renewed (true) or not (false). Autorenewal only takes effect after the account is charged.

    Default: true

  • admin_contact(ContactDetail) / set_admin_contact(Option<ContactDetail>):

    Provides detailed contact information. For information about the values that you specify for each element, see ContactDetail.

  • registrant_contact(ContactDetail) / set_registrant_contact(Option<ContactDetail>):

    Provides detailed contact information. For information about the values that you specify for each element, see ContactDetail.

  • tech_contact(ContactDetail) / set_tech_contact(Option<ContactDetail>):

    Provides detailed contact information. For information about the values that you specify for each element, see ContactDetail.

  • privacy_protect_admin_contact(bool) / set_privacy_protect_admin_contact(Option<bool>):

    Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the admin contact.

    You must specify the same privacy setting for the administrative, registrant, and technical contacts.

    Default: true

  • privacy_protect_registrant_contact(bool) / set_privacy_protect_registrant_contact(Option<bool>):

    Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the registrant contact (the domain owner).

    You must specify the same privacy setting for the administrative, registrant, and technical contacts.

    Default: true

  • privacy_protect_tech_contact(bool) / set_privacy_protect_tech_contact(Option<bool>):

    Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the technical contact.

    You must specify the same privacy setting for the administrative, registrant, and technical contacts.

    Default: true

• On success, responds with RegisterDomainOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

• On failure, responds with SdkError<RegisterDomainError>

pub fn reject_domain_transfer_from_another_aws_account(
    &self
) -> RejectDomainTransferFromAnotherAwsAccount<C, M, R>

Constructs a fluent builder for the RejectDomainTransferFromAnotherAwsAccount operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that was specified when another Amazon Web Services account submitted a TransferDomainToAnotherAwsAccount request.

• On success, responds with RejectDomainTransferFromAnotherAwsAccountOutput with field(s):
  • operation_id(Option<String>):

    The identifier that TransferDomainToAnotherAwsAccount returned to track the progress of the request. Because the transfer request was rejected, the value is no longer valid, and you can’t use GetOperationDetail to query the operation status.

• On failure, responds with SdkError<RejectDomainTransferFromAnotherAwsAccountError>

pub fn renew_domain(&self) -> RenewDomain<C, M, R>

Constructs a fluent builder for the RenewDomain operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to renew.

  • duration_in_years(i32) / set_duration_in_years(Option<i32>):

    The number of years that you want to renew the domain for. The maximum number of years depends on the top-level domain. For the range of valid values for your domain, see Domains that You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

    Default: 1

  • current_expiry_year(i32) / set_current_expiry_year(i32):

    The year when the registration for the domain is set to expire. This value must match the current expiration date for the domain.

• On success, responds with RenewDomainOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

• On failure, responds with SdkError<RenewDomainError>

pub fn resend_contact_reachability_email(
    &self
) -> ResendContactReachabilityEmail<C, M, R>

Constructs a fluent builder for the ResendContactReachabilityEmail operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain for which you want Route 53 to resend a confirmation email to the registrant contact.

• On success, responds with ResendContactReachabilityEmailOutput with field(s):
  • domain_name(Option<String>):

    The domain name for which you requested a confirmation email.

  • email_address(Option<String>):

    The email address for the registrant contact at the time that we sent the verification email.

  • is_already_verified(Option<bool>):

    True if the email address for the registrant contact has already been verified, and false otherwise. If the email address has already been verified, we don’t send another confirmation email.

• On failure, responds with SdkError<ResendContactReachabilityEmailError>

pub fn retrieve_domain_auth_code(&self) -> RetrieveDomainAuthCode<C, M, R>

Constructs a fluent builder for the RetrieveDomainAuthCode operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to get an authorization code for.

• On success, responds with RetrieveDomainAuthCodeOutput with field(s):
  • auth_code(Option<String>):

    The authorization code for the domain.

• On failure, responds with SdkError<RetrieveDomainAuthCodeError>

pub fn transfer_domain(&self) -> TransferDomain<C, M, R>

Constructs a fluent builder for the TransferDomain operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to transfer to Route 53. The top-level domain (TLD), such as .com, must be a TLD that Route 53 supports. For a list of supported TLDs, see Domains that You Can Register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

    The domain name can contain only the following characters:

    • Letters a through z. Domain names are not case sensitive.

    • Numbers 0 through 9.

    • Hyphen (-). You can’t specify a hyphen at the beginning or end of a label.

    • Period (.) to separate the labels in the name, such as the . in example.com.

  • idn_lang_code(impl Into<String>) / set_idn_lang_code(Option<String>):

    Reserved for future use.

  • duration_in_years(i32) / set_duration_in_years(Option<i32>):

    The number of years that you want to register the domain for. Domains are registered for a minimum of one year. The maximum period depends on the top-level domain.

    Default: 1

  • nameservers(Vec<Nameserver>) / set_nameservers(Option<Vec<Nameserver>>):

    Contains details for the host and glue IP addresses.

  • auth_code(impl Into<String>) / set_auth_code(Option<String>):

    The authorization code for the domain. You get this value from the current registrar.

  • auto_renew(bool) / set_auto_renew(Option<bool>):

    Indicates whether the domain will be automatically renewed (true) or not (false). Autorenewal only takes effect after the account is charged.

    Default: true

  • admin_contact(ContactDetail) / set_admin_contact(Option<ContactDetail>):

    Provides detailed contact information.

  • registrant_contact(ContactDetail) / set_registrant_contact(Option<ContactDetail>):

    Provides detailed contact information.

  • tech_contact(ContactDetail) / set_tech_contact(Option<ContactDetail>):

    Provides detailed contact information.

  • privacy_protect_admin_contact(bool) / set_privacy_protect_admin_contact(Option<bool>):

    Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the admin contact.

    You must specify the same privacy setting for the administrative, registrant, and technical contacts.

    Default: true

  • privacy_protect_registrant_contact(bool) / set_privacy_protect_registrant_contact(Option<bool>):

    Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the registrant contact (domain owner).

    You must specify the same privacy setting for the administrative, registrant, and technical contacts.

    Default: true

  • privacy_protect_tech_contact(bool) / set_privacy_protect_tech_contact(Option<bool>):

    Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the technical contact.

    You must specify the same privacy setting for the administrative, registrant, and technical contacts.

    Default: true

• On success, responds with TransferDomainOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

• On failure, responds with SdkError<TransferDomainError>

pub fn transfer_domain_to_another_aws_account(
    &self
) -> TransferDomainToAnotherAwsAccount<C, M, R>

Constructs a fluent builder for the TransferDomainToAnotherAwsAccount operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to transfer from the current Amazon Web Services account to another account.

  • account_id(impl Into<String>) / set_account_id(Option<String>):

    The account ID of the Amazon Web Services account that you want to transfer the domain to, for example, 111122223333.

• On success, responds with TransferDomainToAnotherAwsAccountOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

  • password(Option<String>):

    To finish transferring a domain to another Amazon Web Services account, the account that the domain is being transferred to must submit an AcceptDomainTransferFromAnotherAwsAccount request. The request must include the value of the Password element that was returned in the TransferDomainToAnotherAwsAccount response.

• On failure, responds with SdkError<TransferDomainToAnotherAwsAccountError>

pub fn update_domain_contact(&self) -> UpdateDomainContact<C, M, R>

Constructs a fluent builder for the UpdateDomainContact operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to update contact information for.

  • admin_contact(ContactDetail) / set_admin_contact(Option<ContactDetail>):

    Provides detailed contact information.

  • registrant_contact(ContactDetail) / set_registrant_contact(Option<ContactDetail>):

    Provides detailed contact information.

  • tech_contact(ContactDetail) / set_tech_contact(Option<ContactDetail>):

    Provides detailed contact information.

• On success, responds with UpdateDomainContactOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

• On failure, responds with SdkError<UpdateDomainContactError>

pub fn update_domain_contact_privacy(
    &self
) -> UpdateDomainContactPrivacy<C, M, R>

Constructs a fluent builder for the UpdateDomainContactPrivacy operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to update the privacy setting for.

  • admin_privacy(bool) / set_admin_privacy(Option<bool>):

    Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the admin contact.

    You must specify the same privacy setting for the administrative, registrant, and technical contacts.

  • registrant_privacy(bool) / set_registrant_privacy(Option<bool>):

    Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the registrant contact (domain owner).

    You must specify the same privacy setting for the administrative, registrant, and technical contacts.

  • tech_privacy(bool) / set_tech_privacy(Option<bool>):

    Whether you want to conceal contact information from WHOIS queries. If you specify true, WHOIS (“who is”) queries return contact information either for Amazon Registrar (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you specify false, WHOIS queries return the information that you entered for the technical contact.

    You must specify the same privacy setting for the administrative, registrant, and technical contacts.

• On success, responds with UpdateDomainContactPrivacyOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To use this ID to query the operation status, use GetOperationDetail.

• On failure, responds with SdkError<UpdateDomainContactPrivacyError>

pub fn update_domain_nameservers(&self) -> UpdateDomainNameservers<C, M, R>

Constructs a fluent builder for the UpdateDomainNameservers operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The name of the domain that you want to change name servers for.

  • fi_auth_key(impl Into<String>) / set_fi_auth_key(Option<String>):

    The authorization key for .fi domains

  • nameservers(Vec<Nameserver>) / set_nameservers(Option<Vec<Nameserver>>):

    A list of new name servers for the domain.

• On success, responds with UpdateDomainNameserversOutput with field(s):
  • operation_id(Option<String>):

    Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

• On failure, responds with SdkError<UpdateDomainNameserversError>

pub fn update_tags_for_domain(&self) -> UpdateTagsForDomain<C, M, R>

Constructs a fluent builder for the UpdateTagsForDomain operation.

• The fluent builder is configurable:
  • domain_name(impl Into<String>) / set_domain_name(Option<String>):

    The domain for which you want to add or update tags.

  • tags_to_update(Vec<Tag>) / set_tags_to_update(Option<Vec<Tag>>):

    A list of the tag keys and values that you want to add or update. If you specify a key that already exists, the corresponding value will be replaced.

• On success, responds with UpdateTagsForDomainOutput
• On failure, responds with SdkError<UpdateTagsForDomainError>

pub fn view_billing(&self) -> ViewBilling<C, M, R>

Constructs a fluent builder for the ViewBilling operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • start(DateTime) / set_start(Option<DateTime>):

    The beginning date and time for the time period for which you want a list of billing records. Specify the date and time in Unix time format and Coordinated Universal time (UTC).

  • end(DateTime) / set_end(Option<DateTime>):

    The end date and time for the time period for which you want a list of billing records. Specify the date and time in Unix time format and Coordinated Universal time (UTC).

  • marker(impl Into<String>) / set_marker(Option<String>):

    For an initial request for a list of billing records, omit this element. If the number of billing records that are associated with the current Amazon Web Services account during the specified period is greater than the value that you specified for MaxItems, you can use Marker to return additional billing records. Get the value of NextPageMarker from the previous response, and submit another request that includes the value of NextPageMarker in the Marker element.

    Constraints: The marker must match the value of NextPageMarker that was returned in the previous response.

  • max_items(i32) / set_max_items(Option<i32>):

    The number of billing records to be returned.

    Default: 20

• On success, responds with ViewBillingOutput with field(s):
  • next_page_marker(Option<String>):

    If there are more billing records than you specified for MaxItems in the request, submit another request and include the value of NextPageMarker in the value of Marker.

  • billing_records(Option<Vec<BillingRecord>>):

    A summary of billing records.

• On failure, responds with SdkError<ViewBillingError>

impl<C> Client<C, DefaultMiddleware, Standard>

pub fn from_conf_conn(conf: Config, conn: C) -> Self

Creates a client with the given service config and connector override.

impl Client<DynConnector, DefaultMiddleware, Standard>

pub fn new(config: &Config) -> Self

Creates a new client from a shared config.

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

Trait Implementations

impl<C, M, R> Clone for Client<C, M, R>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<C: Debug, M: Debug, R: Debug> Debug for Client<C, M, R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<C, M, R> From<Client<C, M, R>> for Client<C, M, R>

fn from(client: Client<C, M, R>) -> Self

Performs the conversion.