1. Packages
  2. Alibaba Cloud
  3. API Docs
  4. dns
  5. AlidnsDomain
Alibaba Cloud v3.43.1 published on Monday, Sep 11, 2023 by Pulumi

alicloud.dns.AlidnsDomain

Explore with Pulumi AI

alicloud logo
Alibaba Cloud v3.43.1 published on Monday, Sep 11, 2023 by Pulumi

    Provides a Alidns domain resource.

    NOTE: The domain name which you want to add must be already registered and had not added by another account. Every domain name can only exist in a unique group.

    NOTE: Available since v1.95.0.

    Example Usage

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AliCloud = Pulumi.AliCloud;
    
    return await Deployment.RunAsync(() => 
    {
        var defaultDomainGroup = new AliCloud.Dns.DomainGroup("defaultDomainGroup", new()
        {
            DomainGroupName = "tf-example",
        });
    
        var defaultAlidnsDomain = new AliCloud.Dns.AlidnsDomain("defaultAlidnsDomain", new()
        {
            DomainName = "starmove.com",
            GroupId = defaultDomainGroup.Id,
            Tags = 
            {
                { "Created", "TF" },
                { "For", "example" },
            },
        });
    
    });
    
    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 {
    		defaultDomainGroup, err := dns.NewDomainGroup(ctx, "defaultDomainGroup", &dns.DomainGroupArgs{
    			DomainGroupName: pulumi.String("tf-example"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = dns.NewAlidnsDomain(ctx, "defaultAlidnsDomain", &dns.AlidnsDomainArgs{
    			DomainName: pulumi.String("starmove.com"),
    			GroupId:    defaultDomainGroup.ID(),
    			Tags: pulumi.AnyMap{
    				"Created": pulumi.Any("TF"),
    				"For":     pulumi.Any("example"),
    			},
    		})
    		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.DomainGroup;
    import com.pulumi.alicloud.dns.DomainGroupArgs;
    import com.pulumi.alicloud.dns.AlidnsDomain;
    import com.pulumi.alicloud.dns.AlidnsDomainArgs;
    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 defaultDomainGroup = new DomainGroup("defaultDomainGroup", DomainGroupArgs.builder()        
                .domainGroupName("tf-example")
                .build());
    
            var defaultAlidnsDomain = new AlidnsDomain("defaultAlidnsDomain", AlidnsDomainArgs.builder()        
                .domainName("starmove.com")
                .groupId(defaultDomainGroup.id())
                .tags(Map.ofEntries(
                    Map.entry("Created", "TF"),
                    Map.entry("For", "example")
                ))
                .build());
    
        }
    }
    
    import pulumi
    import pulumi_alicloud as alicloud
    
    default_domain_group = alicloud.dns.DomainGroup("defaultDomainGroup", domain_group_name="tf-example")
    default_alidns_domain = alicloud.dns.AlidnsDomain("defaultAlidnsDomain",
        domain_name="starmove.com",
        group_id=default_domain_group.id,
        tags={
            "Created": "TF",
            "For": "example",
        })
    
    import * as pulumi from "@pulumi/pulumi";
    import * as alicloud from "@pulumi/alicloud";
    
    const defaultDomainGroup = new alicloud.dns.DomainGroup("defaultDomainGroup", {domainGroupName: "tf-example"});
    const defaultAlidnsDomain = new alicloud.dns.AlidnsDomain("defaultAlidnsDomain", {
        domainName: "starmove.com",
        groupId: defaultDomainGroup.id,
        tags: {
            Created: "TF",
            For: "example",
        },
    });
    
    resources:
      defaultDomainGroup:
        type: alicloud:dns:DomainGroup
        properties:
          domainGroupName: tf-example
      defaultAlidnsDomain:
        type: alicloud:dns:AlidnsDomain
        properties:
          domainName: starmove.com
          groupId: ${defaultDomainGroup.id}
          tags:
            Created: TF
            For: example
    

    Create AlidnsDomain Resource

    new AlidnsDomain(name: string, args: AlidnsDomainArgs, opts?: CustomResourceOptions);
    @overload
    def AlidnsDomain(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 AlidnsDomain(resource_name: str,
                     args: AlidnsDomainArgs,
                     opts: Optional[ResourceOptions] = None)
    func NewAlidnsDomain(ctx *Context, name string, args AlidnsDomainArgs, opts ...ResourceOption) (*AlidnsDomain, error)
    public AlidnsDomain(string name, AlidnsDomainArgs args, CustomResourceOptions? opts = null)
    public AlidnsDomain(String name, AlidnsDomainArgs args)
    public AlidnsDomain(String name, AlidnsDomainArgs args, CustomResourceOptions options)
    
    type: alicloud:dns:AlidnsDomain
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    name string
    The unique name of the resource.
    args AlidnsDomainArgs
    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 AlidnsDomainArgs
    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 AlidnsDomainArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args AlidnsDomainArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args AlidnsDomainArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    AlidnsDomain 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 AlidnsDomain 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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). 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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). 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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). 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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). 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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). 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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). 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 AlidnsDomain resource produces the following output properties:

    DnsServers List<string>

    A list of the dns server name.

    DomainId string

    The domain ID.

    GroupName string

    Domain name group name.

    Id string

    The provider-assigned unique ID for this managed resource.

    PunyCode string

    Only return punycode codes for Chinese domain names.

    DnsServers []string

    A list of the dns server name.

    DomainId string

    The domain ID.

    GroupName string

    Domain name group name.

    Id string

    The provider-assigned unique ID for this managed resource.

    PunyCode string

    Only return punycode codes for Chinese domain names.

    dnsServers List<String>

    A list of the dns server name.

    domainId String

    The domain ID.

    groupName String

    Domain name group name.

    id String

    The provider-assigned unique ID for this managed resource.

    punyCode String

    Only return punycode codes for Chinese domain names.

    dnsServers string[]

    A list of the dns server name.

    domainId string

    The domain ID.

    groupName string

    Domain name group name.

    id string

    The provider-assigned unique ID for this managed resource.

    punyCode string

    Only return punycode codes for Chinese domain names.

    dns_servers Sequence[str]

    A list of the dns server name.

    domain_id str

    The domain ID.

    group_name str

    Domain name group name.

    id str

    The provider-assigned unique ID for this managed resource.

    puny_code str

    Only return punycode codes for Chinese domain names.

    dnsServers List<String>

    A list of the dns server name.

    domainId String

    The domain ID.

    groupName String

    Domain name group name.

    id String

    The provider-assigned unique ID for this managed resource.

    punyCode String

    Only return punycode codes for Chinese domain names.

    Look up Existing AlidnsDomain Resource

    Get an existing AlidnsDomain 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?: AlidnsDomainState, opts?: CustomResourceOptions): AlidnsDomain
    @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) -> AlidnsDomain
    func GetAlidnsDomain(ctx *Context, name string, id IDInput, state *AlidnsDomainState, opts ...ResourceOption) (*AlidnsDomain, error)
    public static AlidnsDomain Get(string name, Input<string> id, AlidnsDomainState? state, CustomResourceOptions? opts = null)
    public static AlidnsDomain get(String name, Output<String> id, AlidnsDomainState 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>

    A list of the dns server name.

    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

    Domain name group name.

    Lang string

    User language.

    PunyCode string

    Only return punycode codes for Chinese domain names.

    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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
    DnsServers []string

    A list of the dns server name.

    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

    Domain name group name.

    Lang string

    User language.

    PunyCode string

    Only return punycode codes for Chinese domain names.

    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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
    dnsServers List<String>

    A list of the dns server name.

    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

    Domain name group name.

    lang String

    User language.

    punyCode String

    Only return punycode codes for Chinese domain names.

    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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
    dnsServers string[]

    A list of the dns server name.

    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

    Domain name group name.

    lang string

    User language.

    punyCode string

    Only return punycode codes for Chinese domain names.

    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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
    dns_servers Sequence[str]

    A list of the dns server name.

    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

    Domain name group name.

    lang str

    User language.

    puny_code str

    Only return punycode codes for Chinese domain names.

    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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.
    dnsServers List<String>

    A list of the dns server name.

    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

    Domain name group name.

    lang String

    User language.

    punyCode String

    Only return punycode codes for Chinese domain names.

    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 [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
    • Value: It can be [1, 20] characters in length. It can contain A-Z, a-z, numbers, underscores (_), and hyphens (-). It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

    Import

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

     $ pulumi import alicloud:dns/alidnsDomain:AlidnsDomain example aliyun.com
    

    Package Details

    Repository
    Alibaba Cloud pulumi/pulumi-alicloud
    License
    Apache-2.0
    Notes

    This Pulumi package is based on the alicloud Terraform Provider.

    alicloud logo
    Alibaba Cloud v3.43.1 published on Monday, Sep 11, 2023 by Pulumi