Alibaba Cloud

v3.28.0 published on Tuesday, Aug 16, 2022 by Pulumi

DnsDomain

Import

DNS domain can be imported using the id or domain name, e.g.

 $ pulumi import alicloud:dns/dnsDomain:DnsDomain example aliyun.com

Example Usage

using Pulumi;
using AliCloud = Pulumi.AliCloud;

class MyStack : Stack
{
    public MyStack()
    {
        // Add a new Domain.
        var dns = new AliCloud.Dns.DnsDomain("dns", new AliCloud.Dns.DnsDomainArgs
        {
            DomainName = "starmove.com",
            GroupId = "85ab8713-4a30-4de4-9d20-155ff830****",
            Tags = 
            {
                { "Created", "Terraform" },
                { "Environment", "test" },
            },
        });
    }

}
package main

import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/dns"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := dns.NewDnsDomain(ctx, "dns", &dns.DnsDomainArgs{
			DomainName: pulumi.String("starmove.com"),
			GroupId:    pulumi.String("85ab8713-4a30-4de4-9d20-155ff830****"),
			Tags: pulumi.AnyMap{
				"Created":     pulumi.Any("Terraform"),
				"Environment": pulumi.Any("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.alicloud.dns.DnsDomain;
import com.pulumi.alicloud.dns.DnsDomainArgs;
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 dns = new DnsDomain("dns", DnsDomainArgs.builder()        
            .domainName("starmove.com")
            .groupId("85ab8713-4a30-4de4-9d20-155ff830****")
            .tags(Map.ofEntries(
                Map.entry("Created", "Terraform"),
                Map.entry("Environment", "test")
            ))
            .build());

    }
}
import pulumi
import pulumi_alicloud as alicloud

# Add a new Domain.
dns = alicloud.dns.DnsDomain("dns",
    domain_name="starmove.com",
    group_id="85ab8713-4a30-4de4-9d20-155ff830****",
    tags={
        "Created": "Terraform",
        "Environment": "test",
    })
import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";

// Add a new Domain.
const dns = new alicloud.dns.DnsDomain("dns", {
    domainName: "starmove.com",
    groupId: "85ab8713-4a30-4de4-9d20-155ff830****",
    tags: {
        Created: "Terraform",
        Environment: "test",
    },
});
resources:
  # Add a new Domain.
  dns:
    type: alicloud:dns:DnsDomain
    properties:
      domainName: starmove.com
      groupId: 85ab8713-4a30-4de4-9d20-155ff830****
      tags:
        Created: Terraform
        Environment: test

Create a DnsDomain Resource

new DnsDomain(name: string, args: DnsDomainArgs, opts?: CustomResourceOptions);
@overload
def DnsDomain(resource_name: str,
              opts: Optional[ResourceOptions] = None,
              domain_name: Optional[str] = None,
              group_id: Optional[str] = None,
              lang: Optional[str] = None,
              remark: Optional[str] = None,
              resource_group_id: Optional[str] = None,
              tags: Optional[Mapping[str, Any]] = None)
@overload
def DnsDomain(resource_name: str,
              args: DnsDomainArgs,
              opts: Optional[ResourceOptions] = None)
func NewDnsDomain(ctx *Context, name string, args DnsDomainArgs, opts ...ResourceOption) (*DnsDomain, error)
public DnsDomain(string name, DnsDomainArgs args, CustomResourceOptions? opts = null)
public DnsDomain(String name, DnsDomainArgs args)
public DnsDomain(String name, DnsDomainArgs args, CustomResourceOptions options)
type: alicloud:dns:DnsDomain
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string
The unique name of the resource.
args DnsDomainArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
args DnsDomainArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args DnsDomainArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args DnsDomainArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args DnsDomainArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

DnsDomain Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The DnsDomain resource accepts the following input properties:

DomainName string

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

GroupId string

Id of the group in which the domain will add. If not supplied, then use default group.

Lang string

User language.

Remark string

Remarks information for your domain name.

ResourceGroupId string

The Id of resource group which the dns domain belongs.

Tags Dictionary<string, object>

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
DomainName string

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

GroupId string

Id of the group in which the domain will add. If not supplied, then use default group.

Lang string

User language.

Remark string

Remarks information for your domain name.

ResourceGroupId string

The Id of resource group which the dns domain belongs.

Tags map[string]interface{}

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
domainName String

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

groupId String

Id of the group in which the domain will add. If not supplied, then use default group.

lang String

User language.

remark String

Remarks information for your domain name.

resourceGroupId String

The Id of resource group which the dns domain belongs.

tags Map<String,Object>

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
domainName string

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

groupId string

Id of the group in which the domain will add. If not supplied, then use default group.

lang string

User language.

remark string

Remarks information for your domain name.

resourceGroupId string

The Id of resource group which the dns domain belongs.

tags {[key: string]: any}

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
domain_name str

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

group_id str

Id of the group in which the domain will add. If not supplied, then use default group.

lang str

User language.

remark str

Remarks information for your domain name.

resource_group_id str

The Id of resource group which the dns domain belongs.

tags Mapping[str, Any]

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
domainName String

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

groupId String

Id of the group in which the domain will add. If not supplied, then use default group.

lang String

User language.

remark String

Remarks information for your domain name.

resourceGroupId String

The Id of resource group which the dns domain belongs.

tags Map<Any>

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

Outputs

All input properties are implicitly available as output properties. Additionally, the DnsDomain resource produces the following output properties:

DnsServers List<string>
DomainId string

The domain ID.

GroupName string
Id string

The provider-assigned unique ID for this managed resource.

PunyCode string
DnsServers []string
DomainId string

The domain ID.

GroupName string
Id string

The provider-assigned unique ID for this managed resource.

PunyCode string
dnsServers List<String>
domainId String

The domain ID.

groupName String
id String

The provider-assigned unique ID for this managed resource.

punyCode String
dnsServers string[]
domainId string

The domain ID.

groupName string
id string

The provider-assigned unique ID for this managed resource.

punyCode string
dns_servers Sequence[str]
domain_id str

The domain ID.

group_name str
id str

The provider-assigned unique ID for this managed resource.

puny_code str
dnsServers List<String>
domainId String

The domain ID.

groupName String
id String

The provider-assigned unique ID for this managed resource.

punyCode String

Look up an Existing DnsDomain Resource

Get an existing DnsDomain resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: DnsDomainState, opts?: CustomResourceOptions): DnsDomain
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        dns_servers: Optional[Sequence[str]] = None,
        domain_id: Optional[str] = None,
        domain_name: Optional[str] = None,
        group_id: Optional[str] = None,
        group_name: Optional[str] = None,
        lang: Optional[str] = None,
        puny_code: Optional[str] = None,
        remark: Optional[str] = None,
        resource_group_id: Optional[str] = None,
        tags: Optional[Mapping[str, Any]] = None) -> DnsDomain
func GetDnsDomain(ctx *Context, name string, id IDInput, state *DnsDomainState, opts ...ResourceOption) (*DnsDomain, error)
public static DnsDomain Get(string name, Input<string> id, DnsDomainState? state, CustomResourceOptions? opts = null)
public static DnsDomain get(String name, Output<String> id, DnsDomainState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
DnsServers List<string>
DomainId string

The domain ID.

DomainName string

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

GroupId string

Id of the group in which the domain will add. If not supplied, then use default group.

GroupName string
Lang string

User language.

PunyCode string
Remark string

Remarks information for your domain name.

ResourceGroupId string

The Id of resource group which the dns domain belongs.

Tags Dictionary<string, object>

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
DnsServers []string
DomainId string

The domain ID.

DomainName string

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

GroupId string

Id of the group in which the domain will add. If not supplied, then use default group.

GroupName string
Lang string

User language.

PunyCode string
Remark string

Remarks information for your domain name.

ResourceGroupId string

The Id of resource group which the dns domain belongs.

Tags map[string]interface{}

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
dnsServers List<String>
domainId String

The domain ID.

domainName String

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

groupId String

Id of the group in which the domain will add. If not supplied, then use default group.

groupName String
lang String

User language.

punyCode String
remark String

Remarks information for your domain name.

resourceGroupId String

The Id of resource group which the dns domain belongs.

tags Map<String,Object>

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
dnsServers string[]
domainId string

The domain ID.

domainName string

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

groupId string

Id of the group in which the domain will add. If not supplied, then use default group.

groupName string
lang string

User language.

punyCode string
remark string

Remarks information for your domain name.

resourceGroupId string

The Id of resource group which the dns domain belongs.

tags {[key: string]: any}

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
dns_servers Sequence[str]
domain_id str

The domain ID.

domain_name str

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

group_id str

Id of the group in which the domain will add. If not supplied, then use default group.

group_name str
lang str

User language.

puny_code str
remark str

Remarks information for your domain name.

resource_group_id str

The Id of resource group which the dns domain belongs.

tags Mapping[str, Any]

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
dnsServers List<String>
domainId String

The domain ID.

domainName String

Name of the domain. This name without suffix can have a string of 1 to 63 characters(domain name subject, excluding suffix), must contain only alphanumeric characters or "-", and must not begin or end with "-", and "-" must not in the 3th and 4th character positions at the same time. Suffix .sh and .tel are not supported.

groupId String

Id of the group in which the domain will add. If not supplied, then use default group.

groupName String
lang String

User language.

punyCode String
remark String

Remarks information for your domain name.

resourceGroupId String

The Id of resource group which the dns domain belongs.

tags Map<Any>

A mapping of tags to assign to the resource.

  • Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
  • Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

Package Details

Repository
https://github.com/pulumi/pulumi-alicloud
License
Apache-2.0
Notes

This Pulumi package is based on the alicloud Terraform Provider.