AlidnsRecord

Provides a Alidns Record resource. For information about Alidns Domain Record and how to use it, see What is Resource Alidns Record.

NOTE: Available in v1.85.0+.
NOTE: When the site is an international site, the type neither supports REDIRECT_URL nor REDIRECT_URL

Example Usage

using Pulumi;
using AliCloud = Pulumi.AliCloud;

class MyStack : Stack
{
    public MyStack()
    {
        // Create a new Domain Record
        var record = new AliCloud.Dns.AlidnsRecord("record", new AliCloud.Dns.AlidnsRecordArgs
        {
            DomainName = "domainname",
            Remark = "Test new alidns record.",
            Rr = "@",
            Status = "ENABLE",
            Type = "A",
            Value = "192.168.99.99",
        });
    }

}

Coming soon!

import pulumi
import pulumi_alicloud as alicloud

# Create a new Domain Record
record = alicloud.dns.AlidnsRecord("record",
    domain_name="domainname",
    remark="Test new alidns record.",
    rr="@",
    status="ENABLE",
    type="A",
    value="192.168.99.99")

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";

// Create a new Domain Record
const record = new alicloud.dns.AlidnsRecord("record", {
    domainName: "domainname",
    remark: "Test new alidns record.",
    rr: "@",
    status: "ENABLE",
    type: "A",
    value: "192.168.99.99",
});

Create a AlidnsRecord Resource

new AlidnsRecord(name: string, args: AlidnsRecordArgs, opts?: CustomResourceOptions);

def AlidnsRecord(resource_name, opts=None, domain_name=None, lang=None, line=None, priority=None, remark=None, rr=None, status=None, ttl=None, type=None, user_client_ip=None, value=None, __props__=None);

func NewAlidnsRecord(ctx *Context, name string, args AlidnsRecordArgs, opts ...ResourceOption) (*AlidnsRecord, error)

public AlidnsRecord(string name, AlidnsRecordArgs args, CustomResourceOptions? opts = null)

name string: The unique name of the resource.
args AlidnsRecordArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
opts ResourceOptions: A bag of options that control this resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args AlidnsRecordArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args AlidnsRecordArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

AlidnsRecord Resource Properties

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

Inputs

The AlidnsRecord 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, 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.
Rr string: Host record for the domain record. This host_record can have at most 253 characters, and each part split with . can have at most 63 characters, and must contain only alphanumeric characters or hyphens, such as -, ., *, @, and must not begin or end with -.
Type string: The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
Value string: The value of domain record, When the type is MX,NS,CNAME,SRV, the server will treat the value as a fully qualified domain name, so it’s no need to add a . at the end.
Lang string: User language.
Line string: The resolution line of domain record. Valid values: default, telecom, unicom, mobile, oversea, edu, drpeng, btvn. When the type is FORWORD_URL, this parameter must be default. Default value is default. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc or using alicloud.dns.getResolutionLines in data source to get the value.
Priority int: The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.
Remark string: The remark of the domain record.
Status string: The status of the domain record. Valid values: ENABLE,DISABLE.
Ttl int: The effective time of domain record. Its scope depends on the edition of the cloud resolution. Free is [600, 86400], Basic is [120, 86400], Standard is [60, 86400], Ultimate is [10, 86400], Exclusive is [1, 86400]. Default value is 600.
UserClientIp string: The IP address of the client.

DomainName string: Name of the domain. This name without suffix can have a string of 1 to 63 characters, 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.
Rr string: Host record for the domain record. This host_record can have at most 253 characters, and each part split with . can have at most 63 characters, and must contain only alphanumeric characters or hyphens, such as -, ., *, @, and must not begin or end with -.
Type string: The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
Value string: The value of domain record, When the type is MX,NS,CNAME,SRV, the server will treat the value as a fully qualified domain name, so it’s no need to add a . at the end.
Lang string: User language.
Line string: The resolution line of domain record. Valid values: default, telecom, unicom, mobile, oversea, edu, drpeng, btvn. When the type is FORWORD_URL, this parameter must be default. Default value is default. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc or using alicloud.dns.getResolutionLines in data source to get the value.
Priority int: The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.
Remark string: The remark of the domain record.
Status string: The status of the domain record. Valid values: ENABLE,DISABLE.
Ttl int: The effective time of domain record. Its scope depends on the edition of the cloud resolution. Free is [600, 86400], Basic is [120, 86400], Standard is [60, 86400], Ultimate is [10, 86400], Exclusive is [1, 86400]. Default value is 600.
UserClientIp string: The IP address of the client.

domainName string: Name of the domain. This name without suffix can have a string of 1 to 63 characters, 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.
rr string: Host record for the domain record. This host_record can have at most 253 characters, and each part split with . can have at most 63 characters, and must contain only alphanumeric characters or hyphens, such as -, ., *, @, and must not begin or end with -.
type string: The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
value string: The value of domain record, When the type is MX,NS,CNAME,SRV, the server will treat the value as a fully qualified domain name, so it’s no need to add a . at the end.
lang string: User language.
line string: The resolution line of domain record. Valid values: default, telecom, unicom, mobile, oversea, edu, drpeng, btvn. When the type is FORWORD_URL, this parameter must be default. Default value is default. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc or using alicloud.dns.getResolutionLines in data source to get the value.
priority number: The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.
remark string: The remark of the domain record.
status string: The status of the domain record. Valid values: ENABLE,DISABLE.
ttl number: The effective time of domain record. Its scope depends on the edition of the cloud resolution. Free is [600, 86400], Basic is [120, 86400], Standard is [60, 86400], Ultimate is [10, 86400], Exclusive is [1, 86400]. Default value is 600.
userClientIp string: The IP address of the client.

domain_name str: Name of the domain. This name without suffix can have a string of 1 to 63 characters, 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.
rr str: Host record for the domain record. This host_record can have at most 253 characters, and each part split with . can have at most 63 characters, and must contain only alphanumeric characters or hyphens, such as -, ., *, @, and must not begin or end with -.
type str: The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
value str: The value of domain record, When the type is MX,NS,CNAME,SRV, the server will treat the value as a fully qualified domain name, so it’s no need to add a . at the end.
lang str: User language.
line str: The resolution line of domain record. Valid values: default, telecom, unicom, mobile, oversea, edu, drpeng, btvn. When the type is FORWORD_URL, this parameter must be default. Default value is default. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc or using alicloud.dns.getResolutionLines in data source to get the value.
priority float: The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.
remark str: The remark of the domain record.
status str: The status of the domain record. Valid values: ENABLE,DISABLE.
ttl float: The effective time of domain record. Its scope depends on the edition of the cloud resolution. Free is [600, 86400], Basic is [120, 86400], Standard is [60, 86400], Ultimate is [10, 86400], Exclusive is [1, 86400]. Default value is 600.
user_client_ip str: The IP address of the client.

Outputs

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

Id string: The provider-assigned unique ID for this managed resource.

Id string: The provider-assigned unique ID for this managed resource.

id string: The provider-assigned unique ID for this managed resource.

id str: The provider-assigned unique ID for this managed resource.

Look up an Existing AlidnsRecord Resource

Get an existing AlidnsRecord 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?: AlidnsRecordState, opts?: CustomResourceOptions): AlidnsRecord

static get(resource_name, id, opts=None, domain_name=None, lang=None, line=None, priority=None, remark=None, rr=None, status=None, ttl=None, type=None, user_client_ip=None, value=None, __props__=None);

func GetAlidnsRecord(ctx *Context, name string, id IDInput, state *AlidnsRecordState, opts ...ResourceOption) (*AlidnsRecord, error)

public static AlidnsRecord Get(string name, Input<string> id, AlidnsRecordState? state, CustomResourceOptions? opts = null)

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.

The following state arguments are supported:

DomainName string: Name of the domain. This name without suffix can have a string of 1 to 63 characters, 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.
Lang string: User language.
Line string: The resolution line of domain record. Valid values: default, telecom, unicom, mobile, oversea, edu, drpeng, btvn. When the type is FORWORD_URL, this parameter must be default. Default value is default. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc or using alicloud.dns.getResolutionLines in data source to get the value.
Priority int: The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.
Remark string: The remark of the domain record.
Rr string: Host record for the domain record. This host_record can have at most 253 characters, and each part split with . can have at most 63 characters, and must contain only alphanumeric characters or hyphens, such as -, ., *, @, and must not begin or end with -.
Status string: The status of the domain record. Valid values: ENABLE,DISABLE.
Ttl int: The effective time of domain record. Its scope depends on the edition of the cloud resolution. Free is [600, 86400], Basic is [120, 86400], Standard is [60, 86400], Ultimate is [10, 86400], Exclusive is [1, 86400]. Default value is 600.
Type string: The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
UserClientIp string: The IP address of the client.
Value string: The value of domain record, When the type is MX,NS,CNAME,SRV, the server will treat the value as a fully qualified domain name, so it’s no need to add a . at the end.

DomainName string: Name of the domain. This name without suffix can have a string of 1 to 63 characters, 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.
Lang string: User language.
Line string: The resolution line of domain record. Valid values: default, telecom, unicom, mobile, oversea, edu, drpeng, btvn. When the type is FORWORD_URL, this parameter must be default. Default value is default. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc or using alicloud.dns.getResolutionLines in data source to get the value.
Priority int: The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.
Remark string: The remark of the domain record.
Rr string: Host record for the domain record. This host_record can have at most 253 characters, and each part split with . can have at most 63 characters, and must contain only alphanumeric characters or hyphens, such as -, ., *, @, and must not begin or end with -.
Status string: The status of the domain record. Valid values: ENABLE,DISABLE.
Ttl int: The effective time of domain record. Its scope depends on the edition of the cloud resolution. Free is [600, 86400], Basic is [120, 86400], Standard is [60, 86400], Ultimate is [10, 86400], Exclusive is [1, 86400]. Default value is 600.
Type string: The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
UserClientIp string: The IP address of the client.
Value string: The value of domain record, When the type is MX,NS,CNAME,SRV, the server will treat the value as a fully qualified domain name, so it’s no need to add a . at the end.

domainName string: Name of the domain. This name without suffix can have a string of 1 to 63 characters, 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.
lang string: User language.
line string: The resolution line of domain record. Valid values: default, telecom, unicom, mobile, oversea, edu, drpeng, btvn. When the type is FORWORD_URL, this parameter must be default. Default value is default. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc or using alicloud.dns.getResolutionLines in data source to get the value.
priority number: The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.
remark string: The remark of the domain record.
rr string: Host record for the domain record. This host_record can have at most 253 characters, and each part split with . can have at most 63 characters, and must contain only alphanumeric characters or hyphens, such as -, ., *, @, and must not begin or end with -.
status string: The status of the domain record. Valid values: ENABLE,DISABLE.
ttl number: The effective time of domain record. Its scope depends on the edition of the cloud resolution. Free is [600, 86400], Basic is [120, 86400], Standard is [60, 86400], Ultimate is [10, 86400], Exclusive is [1, 86400]. Default value is 600.
type string: The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
userClientIp string: The IP address of the client.
value string: The value of domain record, When the type is MX,NS,CNAME,SRV, the server will treat the value as a fully qualified domain name, so it’s no need to add a . at the end.

domain_name str: Name of the domain. This name without suffix can have a string of 1 to 63 characters, 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.
lang str: User language.
line str: The resolution line of domain record. Valid values: default, telecom, unicom, mobile, oversea, edu, drpeng, btvn. When the type is FORWORD_URL, this parameter must be default. Default value is default. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc or using alicloud.dns.getResolutionLines in data source to get the value.
priority float: The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.
remark str: The remark of the domain record.
rr str: Host record for the domain record. This host_record can have at most 253 characters, and each part split with . can have at most 63 characters, and must contain only alphanumeric characters or hyphens, such as -, ., *, @, and must not begin or end with -.
status str: The status of the domain record. Valid values: ENABLE,DISABLE.
ttl float: The effective time of domain record. Its scope depends on the edition of the cloud resolution. Free is [600, 86400], Basic is [120, 86400], Standard is [60, 86400], Ultimate is [10, 86400], Exclusive is [1, 86400]. Default value is 600.
type str: The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
user_client_ip str: The IP address of the client.
value str: The value of domain record, When the type is MX,NS,CNAME,SRV, the server will treat the value as a fully qualified domain name, so it’s no need to add a . at the end.

Package Details

Repository: https://github.com/pulumi/pulumi-alicloud
License: Apache-2.0
Notes: This Pulumi package is based on the alicloud Terraform Provider.

The Pulumi Platform

Get Started

Migrate to Pulumi

Solutions for All Teams and Engineers

Any Code

Any Cloud