Package com.pulumi.aws.route53domains

Class RegisteredDomain

  • public class RegisteredDomain
extends com.pulumi.resources.CustomResource
    Provides a resource to manage a domain that has been [registered](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) and associated with the current AWS account. To register, renew and deregister a domain use the `aws.route53domains.Domain` resource instead. **This is an advanced resource** and has special caveats to be aware of when using it. Please read this document in its entirety before using this resource. The `aws.route53domains.RegisteredDomain` resource behaves differently from normal resources in that if a domain has been registered, the provider does not _register_ this domain, but instead "adopts" it into management. A destroy does not delete the domain but does remove the resource from state. ## Example Usage 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.route53domains.RegisteredDomain;
 import com.pulumi.aws.route53domains.RegisteredDomainArgs;
 import com.pulumi.aws.route53domains.inputs.RegisteredDomainNameServerArgs;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Map;
 import java.io.File;
 import java.nio.file.Files;
 import java.nio.file.Paths;
 
 public class App {
     public static void main(String[] args) {
         Pulumi.run(App::stack);
     }
 
     public static void stack(Context ctx) {
         var example = new RegisteredDomain("example", RegisteredDomainArgs.builder()
             .nameServers(            
                 RegisteredDomainNameServerArgs.builder()
                     .name("ns-195.awsdns-24.com")
                     .build(),
                 RegisteredDomainNameServerArgs.builder()
                     .name("ns-874.awsdns-45.net")
                     .build())
             .domainName("example.com")
             .tags(Map.of("Environment", "test"))
             .build());
 
     }
 }
    ## Import Using `pulumi import`, import domains using the domain name. For example: ```sh $ pulumi import aws:route53domains/registeredDomain:RegisteredDomain example example.com ```

    • Nested Class Summary

      • Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

        com.pulumi.resources.CustomResource.CustomResourceInternal

      • Nested classes/interfaces inherited from class com.pulumi.resources.Resource

        com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal

    • Field Summary

      • Fields inherited from class com.pulumi.resources.Resource

        childResources, remote

    • Constructor Detail

      • RegisteredDomain

        public RegisteredDomain​(java.lang.String name)
        Parameters:
        name - The _unique_ name of the resulting resource.

      • RegisteredDomain

        public RegisteredDomain​(java.lang.String name,
                        RegisteredDomainArgs args)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.

      • RegisteredDomain

        public RegisteredDomain​(java.lang.String name,
                        RegisteredDomainArgs args,
                        @Nullable
                        com.pulumi.resources.CustomResourceOptions options)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.
        options - A bag of options that control this resource's behavior.

    • Method Detail

      • abuseContactEmail

        public com.pulumi.core.Output<java.lang.String> abuseContactEmail()
        Returns:
        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.

      • abuseContactPhone

        public com.pulumi.core.Output<java.lang.String> abuseContactPhone()
        Returns:
        Phone number for reporting abuse.

      • adminContact

        public com.pulumi.core.Output<RegisteredDomainAdminContact> adminContact()
        Returns:
        Details about the domain administrative contact. See Contact Blocks for more details.

      • adminPrivacy

        public com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> adminPrivacy()
        Returns:
        Whether domain administrative contact information is concealed from WHOIS queries. Default: `true`.

      • autoRenew

        public com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> autoRenew()
        Returns:
        Whether the domain registration is set to renew automatically. Default: `true`.

      • billingContact

        public com.pulumi.core.Output<RegisteredDomainBillingContact> billingContact()
        Returns:
        Details about the domain billing contact. See Contact Blocks for more details.

      • billingPrivacy

        public com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> billingPrivacy()
        Returns:
        Whether domain billing contact information is concealed from WHOIS queries. Default: `true`.

      • creationDate

        public com.pulumi.core.Output<java.lang.String> creationDate()
        Returns:
        The date when the domain was created as found in the response to a WHOIS query.

      • domainName

        public com.pulumi.core.Output<java.lang.String> domainName()
        Returns:
        The name of the registered domain.

      • expirationDate

        public com.pulumi.core.Output<java.lang.String> expirationDate()
        Returns:
        The date when the registration for the domain is set to expire.

      • nameServers

        public com.pulumi.core.Output<java.util.List<RegisteredDomainNameServer>> nameServers()
        Returns:
        The list of nameservers for the domain. See `nameServer` Blocks for more details.

      • registrantContact

        public com.pulumi.core.Output<RegisteredDomainRegistrantContact> registrantContact()
        Returns:
        Details about the domain registrant. See Contact Blocks for more details.

      • registrantPrivacy

        public com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> registrantPrivacy()
        Returns:
        Whether domain registrant contact information is concealed from WHOIS queries. Default: `true`.

      • registrarName

        public com.pulumi.core.Output<java.lang.String> registrarName()
        Returns:
        Name of the registrar of the domain as identified in the registry.

      • registrarUrl

        public com.pulumi.core.Output<java.lang.String> registrarUrl()
        Returns:
        Web address of the registrar.

      • reseller

        public com.pulumi.core.Output<java.lang.String> reseller()
        Returns:
        Reseller of the domain.

      • statusLists

        public com.pulumi.core.Output<java.util.List<java.lang.String>> statusLists()
        Returns:
        List of [domain name status codes](https://www.icann.org/resources/pages/epp-status-codes-2014-06-16-en).

      • tags

        public com.pulumi.core.Output<java.util.Optional<java.util.Map<java.lang.String,​java.lang.String>>> tags()
        Returns:
        A map of tags to assign to the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.

      • tagsAll

        public com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>> tagsAll()
        Returns:
        A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.

      • techContact

        public com.pulumi.core.Output<RegisteredDomainTechContact> techContact()
        Returns:
        Details about the domain technical contact. See Contact Blocks for more details.

      • techPrivacy

        public com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> techPrivacy()
        Returns:
        Whether domain technical contact information is concealed from WHOIS queries. Default: `true`.

      • transferLock

        public com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> transferLock()
        Returns:
        Whether the domain is locked for transfer. Default: `true`. > **NOTE:** You must specify the same privacy setting for `adminPrivacy`, `registrantPrivacy` and `techPrivacy`.

      • updatedDate

        public com.pulumi.core.Output<java.lang.String> updatedDate()
        Returns:
        The last updated date of the domain as found in the response to a WHOIS query.

      • whoisServer

        public com.pulumi.core.Output<java.lang.String> whoisServer()
        Returns:
        The fully qualified name of the WHOIS server that can answer the WHOIS query for the domain.

      • get

        public static RegisteredDomain get​(java.lang.String name,
                                   com.pulumi.core.Output<java.lang.String> id,
                                   @Nullable
                                   RegisteredDomainState state,
                                   @Nullable
                                   com.pulumi.resources.CustomResourceOptions options)
        Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
        Parameters:
        name - The _unique_ name of the resulting resource.
        id - The _unique_ provider ID of the resource to lookup.
        state -
        options - Optional settings to control the behavior of the CustomResource.