alicloud.dns.AlidnsDomain
Explore with Pulumi AI
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
import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const _default = new alicloud.dns.DomainGroup("default", {domainGroupName: "tf-example"});
const defaultAlidnsDomain = new alicloud.dns.AlidnsDomain("default", {
domainName: "starmove.com",
groupId: _default.id,
tags: {
Created: "TF",
For: "example",
},
});
import pulumi
import pulumi_alicloud as alicloud
default = alicloud.dns.DomainGroup("default", domain_group_name="tf-example")
default_alidns_domain = alicloud.dns.AlidnsDomain("default",
domain_name="starmove.com",
group_id=default.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 {
_, err := dns.NewDomainGroup(ctx, "default", &dns.DomainGroupArgs{
DomainGroupName: pulumi.String("tf-example"),
})
if err != nil {
return err
}
_, err = dns.NewAlidnsDomain(ctx, "default", &dns.AlidnsDomainArgs{
DomainName: pulumi.String("starmove.com"),
GroupId: _default.ID(),
Tags: pulumi.StringMap{
"Created": pulumi.String("TF"),
"For": pulumi.String("example"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var @default = new AliCloud.Dns.DomainGroup("default", new()
{
DomainGroupName = "tf-example",
});
var defaultAlidnsDomain = new AliCloud.Dns.AlidnsDomain("default", new()
{
DomainName = "starmove.com",
GroupId = @default.Id,
Tags =
{
{ "Created", "TF" },
{ "For", "example" },
},
});
});
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 default_ = new DomainGroup("default", DomainGroupArgs.builder()
.domainGroupName("tf-example")
.build());
var defaultAlidnsDomain = new AlidnsDomain("defaultAlidnsDomain", AlidnsDomainArgs.builder()
.domainName("starmove.com")
.groupId(default_.id())
.tags(Map.ofEntries(
Map.entry("Created", "TF"),
Map.entry("For", "example")
))
.build());
}
}
resources:
default:
type: alicloud:dns:DomainGroup
properties:
domainGroupName: tf-example
defaultAlidnsDomain:
type: alicloud:dns:AlidnsDomain
name: default
properties:
domainName: starmove.com
groupId: ${default.id}
tags:
Created: TF
For: example
Create AlidnsDomain Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new AlidnsDomain(name: string, args: AlidnsDomainArgs, opts?: CustomResourceOptions);
@overload
def AlidnsDomain(resource_name: str,
args: AlidnsDomainArgs,
opts: Optional[ResourceOptions] = None)
@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, str]] = 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.
Parameters
- 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.
Constructor example
The following reference example uses placeholder values for all input properties.
var alidnsDomainResource = new AliCloud.Dns.AlidnsDomain("alidnsDomainResource", new()
{
DomainName = "string",
GroupId = "string",
Lang = "string",
Remark = "string",
ResourceGroupId = "string",
Tags =
{
{ "string", "string" },
},
});
example, err := dns.NewAlidnsDomain(ctx, "alidnsDomainResource", &dns.AlidnsDomainArgs{
DomainName: pulumi.String("string"),
GroupId: pulumi.String("string"),
Lang: pulumi.String("string"),
Remark: pulumi.String("string"),
ResourceGroupId: pulumi.String("string"),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
})
var alidnsDomainResource = new AlidnsDomain("alidnsDomainResource", AlidnsDomainArgs.builder()
.domainName("string")
.groupId("string")
.lang("string")
.remark("string")
.resourceGroupId("string")
.tags(Map.of("string", "string"))
.build());
alidns_domain_resource = alicloud.dns.AlidnsDomain("alidnsDomainResource",
domain_name="string",
group_id="string",
lang="string",
remark="string",
resource_group_id="string",
tags={
"string": "string",
})
const alidnsDomainResource = new alicloud.dns.AlidnsDomain("alidnsDomainResource", {
domainName: "string",
groupId: "string",
lang: "string",
remark: "string",
resourceGroupId: "string",
tags: {
string: "string",
},
});
type: alicloud:dns:AlidnsDomain
properties:
domainName: string
groupId: string
lang: string
remark: string
resourceGroupId: string
tags:
string: string
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
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The AlidnsDomain resource accepts the following input properties:
- Domain
Name 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. - Group
Id 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.
- Resource
Group stringId - The Id of resource group which the dns domain belongs.
- Dictionary<string, string>
- 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 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. - Group
Id 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.
- Resource
Group stringId - The Id of resource group which the dns domain belongs.
- map[string]string
- 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 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. - group
Id 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.
- resource
Group StringId - The Id of resource group which the dns domain belongs.
- Map<String,String>
- 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 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. - group
Id 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.
- resource
Group stringId - The Id of resource group which the dns domain belongs.
- {[key: string]: string}
- 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_ strid - The Id of resource group which the dns domain belongs.
- Mapping[str, str]
- 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 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. - group
Id 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.
- resource
Group StringId - The Id of resource group which the dns domain belongs.
- Map<String>
- 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:
- Dns
Servers List<string> - A list of the dns server name.
- Domain
Id string - The domain ID.
- Group
Name string - Domain name group name.
- Id string
- The provider-assigned unique ID for this managed resource.
- Puny
Code string - Only return punycode codes for Chinese domain names.
- Dns
Servers []string - A list of the dns server name.
- Domain
Id string - The domain ID.
- Group
Name string - Domain name group name.
- Id string
- The provider-assigned unique ID for this managed resource.
- Puny
Code string - Only return punycode codes for Chinese domain names.
- dns
Servers List<String> - A list of the dns server name.
- domain
Id String - The domain ID.
- group
Name String - Domain name group name.
- id String
- The provider-assigned unique ID for this managed resource.
- puny
Code String - Only return punycode codes for Chinese domain names.
- dns
Servers string[] - A list of the dns server name.
- domain
Id string - The domain ID.
- group
Name string - Domain name group name.
- id string
- The provider-assigned unique ID for this managed resource.
- puny
Code 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.
- dns
Servers List<String> - A list of the dns server name.
- domain
Id String - The domain ID.
- group
Name String - Domain name group name.
- id String
- The provider-assigned unique ID for this managed resource.
- puny
Code 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, str]] = 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.
- Dns
Servers List<string> - A list of the dns server name.
- Domain
Id string - The domain ID.
- Domain
Name 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. - Group
Id string - Id of the group in which the domain will add. If not supplied, then use default group.
- Group
Name string - Domain name group name.
- Lang string
- User language.
- Puny
Code string - Only return punycode codes for Chinese domain names.
- Remark string
- Remarks information for your domain name.
- Resource
Group stringId - The Id of resource group which the dns domain belongs.
- Dictionary<string, string>
- 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 []string - A list of the dns server name.
- Domain
Id string - The domain ID.
- Domain
Name 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. - Group
Id string - Id of the group in which the domain will add. If not supplied, then use default group.
- Group
Name string - Domain name group name.
- Lang string
- User language.
- Puny
Code string - Only return punycode codes for Chinese domain names.
- Remark string
- Remarks information for your domain name.
- Resource
Group stringId - The Id of resource group which the dns domain belongs.
- map[string]string
- 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 List<String> - A list of the dns server name.
- domain
Id String - The domain ID.
- domain
Name 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. - group
Id String - Id of the group in which the domain will add. If not supplied, then use default group.
- group
Name String - Domain name group name.
- lang String
- User language.
- puny
Code String - Only return punycode codes for Chinese domain names.
- remark String
- Remarks information for your domain name.
- resource
Group StringId - The Id of resource group which the dns domain belongs.
- Map<String,String>
- 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 string[] - A list of the dns server name.
- domain
Id string - The domain ID.
- domain
Name 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. - group
Id string - Id of the group in which the domain will add. If not supplied, then use default group.
- group
Name string - Domain name group name.
- lang string
- User language.
- puny
Code string - Only return punycode codes for Chinese domain names.
- remark string
- Remarks information for your domain name.
- resource
Group stringId - The Id of resource group which the dns domain belongs.
- {[key: string]: string}
- 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_ strid - The Id of resource group which the dns domain belongs.
- Mapping[str, str]
- 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 List<String> - A list of the dns server name.
- domain
Id String - The domain ID.
- domain
Name 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. - group
Id String - Id of the group in which the domain will add. If not supplied, then use default group.
- group
Name String - Domain name group name.
- lang String
- User language.
- puny
Code String - Only return punycode codes for Chinese domain names.
- remark String
- Remarks information for your domain name.
- resource
Group StringId - The Id of resource group which the dns domain belongs.
- Map<String>
- 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
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Alibaba Cloud pulumi/pulumi-alicloud
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
alicloud
Terraform Provider.