aws_registered_domains
Stable
Direct

AWS Registered Domains

Providers

The following providers are needed by this module:

Required Inputs

The following input variables are required:

admin_contact

Description: Admin contact information for the domain

Type:

object({
    contact_type      = optional(string, "DEFAULT") # The type of the contact. Defaults to PERSON if organization_name is not provided. Otherwise, defaults to COMPANY.
    organization_name = optional(string)            # The name of the organization that the admin contact works for
    first_name        = string                      # The first name of the domain admin contact
    last_name         = string                      # The last name of the domain admin contact
    email_address     = string                      # The email address of the domain contact
    phone_number      = string                      # The phone number of the domain contact
    address_line_1    = string                      # The street address (1) of the domain admin contact
    address_line_2    = optional(string)            # The street address (2) of the domain admin contact
    city              = string                      # The city of the domain admin contact
    state             = string                      # The state or province of the domain admin contact
    zip_code          = string                      # The ZIP code of the domain admin contact
    country_code      = string                      # The country code of the domain admin contact
  })

domain_names

Description: Domain names that will be managed by this module

Type: set(string)

registrant_contact

Description: Registrant contact information for the domain

Type:

object({
    contact_type      = optional(string, "DEFAULT") # The type of the contact. Defaults to PERSON if organization_name is not provided. Otherwise, defaults to COMPANY.
    organization_name = optional(string)            # The name of the organization that the registrant contact works for
    first_name        = string                      # The first name of the domain registrant contact
    last_name         = string                      # The last name of the domain registrant contact
    email_address     = string                      # The email address of the domain contact
    phone_number      = string                      # The phone number of the domain contact
    address_line_1    = string                      # The street address (1) of the domain registrant contact
    address_line_2    = optional(string)            # The street address (2) of the domain registrant contact
    city              = string                      # The city of the domain registrant contact
    state             = string                      # The state or province of the domain registrant contact
    zip_code          = string                      # The ZIP code of the domain registrant contact
    country_code      = string                      # The country code of the domain registrant contact
  })

tech_contact

Description: Tech contact information for the domain

Type:

object({
    contact_type      = optional(string, "DEFAULT") # The type of the contact. Defaults to PERSON if organization_name is not provided. Otherwise, defaults to COMPANY.
    organization_name = optional(string)            # The name of the organization that the tech contact works for
    first_name        = string                      # The first name of the domain tech contact
    last_name         = string                      # The last name of the domain tech contact
    email_address     = string                      # The email address of the domain contact
    phone_number      = string                      # The phone number of the domain contact
    address_line_1    = string                      # The street address (1) of the domain tech contact
    address_line_2    = optional(string)            # The street address (2) of the domain tech contact
    city              = string                      # The city of the domain tech contact
    state             = string                      # The state or province of the domain tech contact
    zip_code          = string                      # The ZIP code of the domain tech contact
    country_code      = string                      # The country code of the domain tech contact
  })

Optional Inputs

The following input variables are optional (have default values):

additional_account_ids_with_record_access

Description: Additional AWS account IDs for accounts that can assume with record manager role

Type: list(string)

Default: []

enable_auto_renew

Description: Whether to enable automatic domain renewal

Type: bool

Default: true

enable_privacy_protection

Description: Whether to enable Whois privacy protection

Type: bool

Default: true

enable_transfer_lock

Description: Whether to enable domain transfer lock

Type: bool

Default: true

Outputs

The following outputs are exported:

domains

Description: n/a

record_manager_role_arn

Description: The ARN of the IAM role used to manage DNS records.

zones

Description: Zone information

Usage

Create / Delete

This module does not register domains but rather adopts domains that you have already registered and updates their information. Additionally, destroying this module does un-register the domains; it only removes them from the terraform state.

Contact Information

There are three different domain contacts:

  • Registrant: The owner of the domain
  • Admin: The person responsible for administrative decisions about the domain
  • Tech: The person responsible for executing changes for the domain

It is possible for the same person to serve multiple roles.

These people will be contacted in the case of billing issues, abuse, or required changes. Their information is not publicly available, but will be made available to the registrar (AWS).