1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`GetDomainSuggestions`](crate::operation::get_domain_suggestions::builders::GetDomainSuggestionsFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`domain_name(impl Into<String>)`](crate::operation::get_domain_suggestions::builders::GetDomainSuggestionsFluentBuilder::domain_name) / [`set_domain_name(Option<String>)`](crate::operation::get_domain_suggestions::builders::GetDomainSuggestionsFluentBuilder::set_domain_name):<br>required: **true**<br><p>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 <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>.</p><br>
    ///   - [`suggestion_count(i32)`](crate::operation::get_domain_suggestions::builders::GetDomainSuggestionsFluentBuilder::suggestion_count) / [`set_suggestion_count(Option<i32>)`](crate::operation::get_domain_suggestions::builders::GetDomainSuggestionsFluentBuilder::set_suggestion_count):<br>required: **true**<br><p>The number of suggested domain names that you want Route 53 to return. Specify a value between 1 and 50.</p><br>
    ///   - [`only_available(bool)`](crate::operation::get_domain_suggestions::builders::GetDomainSuggestionsFluentBuilder::only_available) / [`set_only_available(Option<bool>)`](crate::operation::get_domain_suggestions::builders::GetDomainSuggestionsFluentBuilder::set_only_available):<br>required: **true**<br><p>If <code>OnlyAvailable</code> is <code>true</code>, Route 53 returns only domain names that are available. If <code>OnlyAvailable</code> is <code>false</code>, Route 53 returns domain names without checking whether they're available to be registered. To determine whether the domain is available, you can call <code>checkDomainAvailability</code> for each suggestion.</p><br>
    /// - On success, responds with [`GetDomainSuggestionsOutput`](crate::operation::get_domain_suggestions::GetDomainSuggestionsOutput) with field(s):
    ///   - [`suggestions_list(Option<Vec::<DomainSuggestion>>)`](crate::operation::get_domain_suggestions::GetDomainSuggestionsOutput::suggestions_list): <p>A list of possible domain names. If you specified <code>true</code> for <code>OnlyAvailable</code> in the request, the list contains only domains that are available for registration.</p>
    /// - On failure, responds with [`SdkError<GetDomainSuggestionsError>`](crate::operation::get_domain_suggestions::GetDomainSuggestionsError)
    pub fn get_domain_suggestions(&self) -> crate::operation::get_domain_suggestions::builders::GetDomainSuggestionsFluentBuilder {
        crate::operation::get_domain_suggestions::builders::GetDomainSuggestionsFluentBuilder::new(self.handle.clone())
    }
}