Record

Create a Record Resource

new Record(name: string, args: RecordArgs, opts?: CustomResourceOptions);
def Record(resource_name, opts=None, host_record=None, name=None, priority=None, routing=None, ttl=None, type=None, value=None, __props__=None);
func NewRecord(ctx *Context, name string, args RecordArgs, opts ...ResourceOption) (*Record, error)
public Record(string name, RecordArgs args, CustomResourceOptions? opts = null)
name string
The unique name of the resource.
args RecordArgs
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 RecordArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args RecordArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.

Record Resource Properties

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

Inputs

The Record resource accepts the following input properties:

HostRecord 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 are 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.

Name 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.

Priority int

The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required.

Routing string

The resolution line of domain record. Valid values are default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. 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.

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.

HostRecord 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 are 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.

Name 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.

Priority int

The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required.

Routing string

The resolution line of domain record. Valid values are default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. 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.

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.

hostRecord 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 are 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.

name 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.

priority number

The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required.

routing string

The resolution line of domain record. Valid values are default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. 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.

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.

host_record 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 are 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.

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.

priority float

The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required.

routing str

The resolution line of domain record. Valid values are default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. 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.

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.

Outputs

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

Id string
The provider-assigned unique ID for this managed resource.
Locked bool
Status string

The record status. Enable or Disable.

Id string
The provider-assigned unique ID for this managed resource.
Locked bool
Status string

The record status. Enable or Disable.

id string
The provider-assigned unique ID for this managed resource.
locked boolean
status string

The record status. Enable or Disable.

id str
The provider-assigned unique ID for this managed resource.
locked bool
status str

The record status. Enable or Disable.

Look up an Existing Record Resource

Get an existing Record 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?: RecordState, opts?: CustomResourceOptions): Record
static get(resource_name, id, opts=None, host_record=None, locked=None, name=None, priority=None, routing=None, status=None, ttl=None, type=None, value=None, __props__=None);
func GetRecord(ctx *Context, name string, id IDInput, state *RecordState, opts ...ResourceOption) (*Record, error)
public static Record Get(string name, Input<string> id, RecordState? 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:

HostRecord 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 “-”.

Locked bool
Name 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.

Priority int

The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required.

Routing string

The resolution line of domain record. Valid values are default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. 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.

Status string

The record status. Enable or 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 are 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.

HostRecord 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 “-”.

Locked bool
Name 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.

Priority int

The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required.

Routing string

The resolution line of domain record. Valid values are default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. 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.

Status string

The record status. Enable or 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 are 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.

hostRecord 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 “-”.

locked boolean
name 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.

priority number

The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required.

routing string

The resolution line of domain record. Valid values are default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. 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.

status string

The record status. Enable or 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 are 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.

host_record 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 “-”.

locked bool
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.

priority float

The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required.

routing str

The resolution line of domain record. Valid values are default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. 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.

status str

The record status. Enable or 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 are 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.

Package Details

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