1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`RegisterDomain`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`domain_name(impl Into<String>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::domain_name) / [`set_domain_name(Option<String>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_domain_name):<br>required: **true**<br><p>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 <a href="https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html">Domains that You Can Register with Amazon Route 53</a> in the <i>Amazon Route 53 Developer Guide</i>.</p> <p>The domain name can contain only the following characters:</p> <ul>  <li>   <p>Letters a through z. Domain names are not case sensitive.</p></li>  <li>   <p>Numbers 0 through 9.</p></li>  <li>   <p>Hyphen (-). You can't specify a hyphen at the beginning or end of a label.</p></li>  <li>   <p>Period (.) to separate the labels in the name, such as the <code>.</code> in <code>example.com</code>.</p></li> </ul> <p>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 <a href="https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html">Domains that You Can Register with Amazon Route 53</a>. For more information, see <a href="https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DomainNameFormat.html#domain-name-format-idns">Formatting Internationalized Domain Names</a>.</p><br>
    ///   - [`idn_lang_code(impl Into<String>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::idn_lang_code) / [`set_idn_lang_code(Option<String>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_idn_lang_code):<br>required: **false**<br><p>Reserved for future use.</p><br>
    ///   - [`duration_in_years(i32)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::duration_in_years) / [`set_duration_in_years(Option<i32>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_duration_in_years):<br>required: **true**<br><p>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 <a href="https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html">Domains that You Can Register with Amazon Route 53</a> in the <i>Amazon Route 53 Developer Guide</i>.</p> <p>Default: 1</p><br>
    ///   - [`auto_renew(bool)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::auto_renew) / [`set_auto_renew(Option<bool>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_auto_renew):<br>required: **false**<br><p>Indicates whether the domain will be automatically renewed (<code>true</code>) or not (<code>false</code>). Auto renewal only takes effect after the account is charged.</p> <p>Default: <code>true</code></p><br>
    ///   - [`admin_contact(ContactDetail)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::admin_contact) / [`set_admin_contact(Option<ContactDetail>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_admin_contact):<br>required: **true**<br><p>Provides detailed contact information. For information about the values that you specify for each element, see <a href="https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ContactDetail.html">ContactDetail</a>.</p><br>
    ///   - [`registrant_contact(ContactDetail)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::registrant_contact) / [`set_registrant_contact(Option<ContactDetail>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_registrant_contact):<br>required: **true**<br><p>Provides detailed contact information. For information about the values that you specify for each element, see <a href="https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ContactDetail.html">ContactDetail</a>.</p><br>
    ///   - [`tech_contact(ContactDetail)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::tech_contact) / [`set_tech_contact(Option<ContactDetail>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_tech_contact):<br>required: **true**<br><p>Provides detailed contact information. For information about the values that you specify for each element, see <a href="https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ContactDetail.html">ContactDetail</a>.</p><br>
    ///   - [`privacy_protect_admin_contact(bool)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::privacy_protect_admin_contact) / [`set_privacy_protect_admin_contact(Option<bool>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_privacy_protect_admin_contact):<br>required: **false**<br><p>Whether you want to conceal contact information from WHOIS queries. If you specify <code>true</code>, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify <code>false</code>, WHOIS queries return the information that you entered for the admin contact.</p><note>  <p>You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.</p> </note> <p>Default: <code>true</code></p><br>
    ///   - [`privacy_protect_registrant_contact(bool)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::privacy_protect_registrant_contact) / [`set_privacy_protect_registrant_contact(Option<bool>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_privacy_protect_registrant_contact):<br>required: **false**<br><p>Whether you want to conceal contact information from WHOIS queries. If you specify <code>true</code>, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify <code>false</code>, WHOIS queries return the information that you entered for the registrant contact (the domain owner).</p><note>  <p>You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.</p> </note> <p>Default: <code>true</code></p><br>
    ///   - [`privacy_protect_tech_contact(bool)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::privacy_protect_tech_contact) / [`set_privacy_protect_tech_contact(Option<bool>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_privacy_protect_tech_contact):<br>required: **false**<br><p>Whether you want to conceal contact information from WHOIS queries. If you specify <code>true</code>, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify <code>false</code>, WHOIS queries return the information that you entered for the technical contact.</p><note>  <p>You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.</p> </note> <p>Default: <code>true</code></p><br>
    ///   - [`billing_contact(ContactDetail)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::billing_contact) / [`set_billing_contact(Option<ContactDetail>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_billing_contact):<br>required: **false**<br><p>Provides detailed contact information. For information about the values that you specify for each element, see <a href="https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ContactDetail.html">ContactDetail</a>.</p><br>
    ///   - [`privacy_protect_billing_contact(bool)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::privacy_protect_billing_contact) / [`set_privacy_protect_billing_contact(Option<bool>)`](crate::operation::register_domain::builders::RegisterDomainFluentBuilder::set_privacy_protect_billing_contact):<br>required: **false**<br><p>Whether you want to conceal contact information from WHOIS queries. If you specify <code>true</code>, WHOIS ("who is") queries return contact information either for Amazon Registrar or for our registrar associate, Gandi. If you specify <code>false</code>, WHOIS queries return the information that you entered for the billing contact.</p><note>  <p>You must specify the same privacy setting for the administrative, billing, registrant, and technical contacts.</p> </note><br>
    /// - On success, responds with [`RegisterDomainOutput`](crate::operation::register_domain::RegisterDomainOutput) with field(s):
    ///   - [`operation_id(Option<String>)`](crate::operation::register_domain::RegisterDomainOutput::operation_id): <p>Identifier for tracking the progress of the request. To query the operation status, use <a href="https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html">GetOperationDetail</a>.</p>
    /// - On failure, responds with [`SdkError<RegisterDomainError>`](crate::operation::register_domain::RegisterDomainError)
    pub fn register_domain(&self) -> crate::operation::register_domain::builders::RegisterDomainFluentBuilder {
        crate::operation::register_domain::builders::RegisterDomainFluentBuilder::new(self.handle.clone())
    }
}