pulumi-aws-kotlin/com.pulumi.aws.route53domains.kotlin/RegisteredDomainArgs

RegisteredDomainArgs

data class RegisteredDomainArgs(val adminContact: Output<RegisteredDomainAdminContactArgs>? = null, val adminPrivacy: Output<Boolean>? = null, val autoRenew: Output<Boolean>? = null, val billingContact: Output<RegisteredDomainBillingContactArgs>? = null, val billingPrivacy: Output<Boolean>? = null, val domainName: Output<String>? = null, val nameServers: Output<List<RegisteredDomainNameServerArgs>>? = null, val registrantContact: Output<RegisteredDomainRegistrantContactArgs>? = null, val registrantPrivacy: Output<Boolean>? = null, val tags: Output<Map<String, String>>? = null, val techContact: Output<RegisteredDomainTechContactArgs>? = null, val techPrivacy: Output<Boolean>? = null, val transferLock: Output<Boolean>? = null) : ConvertibleToJava<RegisteredDomainArgs>

Provides a resource to manage a domain that has been registered 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

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.route53domains.RegisteredDomain("example", {
    domainName: "example.com",
    nameServers: [
        {
            name: "ns-195.awsdns-24.com",
        },
        {
            name: "ns-874.awsdns-45.net",
        },
    ],
    tags: {
        Environment: "test",
    },
});

import pulumi
import pulumi_aws as aws
example = aws.route53domains.RegisteredDomain("example",
    domain_name="example.com",
    name_servers=[
        {
            "name": "ns-195.awsdns-24.com",
        },
        {
            "name": "ns-874.awsdns-45.net",
        },
    ],
    tags={
        "Environment": "test",
    })

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var example = new Aws.Route53Domains.RegisteredDomain("example", new()
    {
        DomainName = "example.com",
        NameServers = new[]
        {
            new Aws.Route53Domains.Inputs.RegisteredDomainNameServerArgs
            {
                Name = "ns-195.awsdns-24.com",
            },
            new Aws.Route53Domains.Inputs.RegisteredDomainNameServerArgs
            {
                Name = "ns-874.awsdns-45.net",
            },
        },
        Tags =
        {
            { "Environment", "test" },
        },
    });
});

package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/route53domains"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := route53domains.NewRegisteredDomain(ctx, "example", &route53domains.RegisteredDomainArgs{
			DomainName: pulumi.String("example.com"),
			NameServers: route53domains.RegisteredDomainNameServerArray{
				&route53domains.RegisteredDomainNameServerArgs{
					Name: pulumi.String("ns-195.awsdns-24.com"),
				},
				&route53domains.RegisteredDomainNameServerArgs{
					Name: pulumi.String("ns-874.awsdns-45.net"),
				},
			},
			Tags: pulumi.StringMap{
				"Environment": pulumi.String("test"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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.List;
import java.util.ArrayList;
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()
            .domainName("example.com")
            .nameServers(
                RegisteredDomainNameServerArgs.builder()
                    .name("ns-195.awsdns-24.com")
                    .build(),
                RegisteredDomainNameServerArgs.builder()
                    .name("ns-874.awsdns-45.net")
                    .build())
            .tags(Map.of("Environment", "test"))
            .build());
    }
}

resources:
  example:
    type: aws:route53domains:RegisteredDomain
    properties:
      domainName: example.com
      nameServers:
        - name: ns-195.awsdns-24.com
        - name: ns-874.awsdns-45.net
      tags:
        Environment: test

Import

Using pulumi import, import domains using the domain name. For example:

$ pulumi import aws:route53domains/registeredDomain:RegisteredDomain example example.com

Constructors

RegisteredDomainArgs

constructor(adminContact: Output<RegisteredDomainAdminContactArgs>? = null, adminPrivacy: Output<Boolean>? = null, autoRenew: Output<Boolean>? = null, billingContact: Output<RegisteredDomainBillingContactArgs>? = null, billingPrivacy: Output<Boolean>? = null, domainName: Output<String>? = null, nameServers: Output<List<RegisteredDomainNameServerArgs>>? = null, registrantContact: Output<RegisteredDomainRegistrantContactArgs>? = null, registrantPrivacy: Output<Boolean>? = null, tags: Output<Map<String, String>>? = null, techContact: Output<RegisteredDomainTechContactArgs>? = null, techPrivacy: Output<Boolean>? = null, transferLock: Output<Boolean>? = null)

Properties

adminContact

val adminContact: Output<RegisteredDomainAdminContactArgs>? = null

Details about the domain administrative contact. See Contact Blocks for more details.

adminPrivacy

val adminPrivacy: Output<Boolean>? = null

Whether domain administrative contact information is concealed from WHOIS queries. Default: true.

autoRenew

val autoRenew: Output<Boolean>? = null

Whether the domain registration is set to renew automatically. Default: true.

billingContact

val billingContact: Output<RegisteredDomainBillingContactArgs>? = null

Details about the domain billing contact. See Contact Blocks for more details.

billingPrivacy

val billingPrivacy: Output<Boolean>? = null

Whether domain billing contact information is concealed from WHOIS queries. Default: true.

domainName

val domainName: Output<String>? = null

The name of the registered domain.

nameServers

val nameServers: Output<List<RegisteredDomainNameServerArgs>>? = null

The list of nameservers for the domain. See name_server Blocks for more details.

registrantContact

val registrantContact: Output<RegisteredDomainRegistrantContactArgs>? = null

Details about the domain registrant. See Contact Blocks for more details.

registrantPrivacy

val registrantPrivacy: Output<Boolean>? = null

Whether domain registrant contact information is concealed from WHOIS queries. Default: true.

Functions

toJava

open override fun toJava(): RegisteredDomainArgs