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:
- Host
Record 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_URLandFORWORD_URL.- Value string
The value of domain record, When the
typeisMX,NS,CNAME,SRV, the server will treat thevalueas 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
.shand.telare not supported.- Priority int
The priority of domain record. Valid values are
[1-10]. When thetypeisMX, 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 thetypeisFORWORD_URL, this parameter must bedefault. Default value isdefault. 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 is600.
- Host
Record 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_URLandFORWORD_URL.- Value string
The value of domain record, When the
typeisMX,NS,CNAME,SRV, the server will treat thevalueas 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
.shand.telare not supported.- Priority int
The priority of domain record. Valid values are
[1-10]. When thetypeisMX, 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 thetypeisFORWORD_URL, this parameter must bedefault. Default value isdefault. 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 is600.
- host
Record 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_URLandFORWORD_URL.- value string
The value of domain record, When the
typeisMX,NS,CNAME,SRV, the server will treat thevalueas 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
.shand.telare not supported.- priority number
The priority of domain record. Valid values are
[1-10]. When thetypeisMX, 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 thetypeisFORWORD_URL, this parameter must bedefault. Default value isdefault. 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 is600.
- 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_URLandFORWORD_URL.- value str
The value of domain record, When the
typeisMX,NS,CNAME,SRV, the server will treat thevalueas 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
.shand.telare not supported.- priority float
The priority of domain record. Valid values are
[1-10]. When thetypeisMX, 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 thetypeisFORWORD_URL, this parameter must bedefault. Default value isdefault. 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 is600.
Outputs
All input properties are implicitly available as output properties. Additionally, the Record resource produces the following output properties:
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): Recordstatic 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:
- Host
Record 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
.shand.telare not supported.- Priority int
The priority of domain record. Valid values are
[1-10]. When thetypeisMX, 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 thetypeisFORWORD_URL, this parameter must bedefault. Default value isdefault. 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.
EnableorDisable.- 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 is600.- Type string
The type of domain record. Valid values are
A,NS,MX,TXT,CNAME,SRV,AAAA,CAA,REDIRECT_URLandFORWORD_URL.- Value string
The value of domain record, When the
typeisMX,NS,CNAME,SRV, the server will treat thevalueas a fully qualified domain name, so it’s no need to add a.at the end.
- Host
Record 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
.shand.telare not supported.- Priority int
The priority of domain record. Valid values are
[1-10]. When thetypeisMX, 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 thetypeisFORWORD_URL, this parameter must bedefault. Default value isdefault. 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.
EnableorDisable.- 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 is600.- Type string
The type of domain record. Valid values are
A,NS,MX,TXT,CNAME,SRV,AAAA,CAA,REDIRECT_URLandFORWORD_URL.- Value string
The value of domain record, When the
typeisMX,NS,CNAME,SRV, the server will treat thevalueas a fully qualified domain name, so it’s no need to add a.at the end.
- host
Record 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
.shand.telare not supported.- priority number
The priority of domain record. Valid values are
[1-10]. When thetypeisMX, 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 thetypeisFORWORD_URL, this parameter must bedefault. Default value isdefault. 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.
EnableorDisable.- 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 is600.- type string
The type of domain record. Valid values are
A,NS,MX,TXT,CNAME,SRV,AAAA,CAA,REDIRECT_URLandFORWORD_URL.- value string
The value of domain record, When the
typeisMX,NS,CNAME,SRV, the server will treat thevalueas 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
.shand.telare not supported.- priority float
The priority of domain record. Valid values are
[1-10]. When thetypeisMX, 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 thetypeisFORWORD_URL, this parameter must bedefault. Default value isdefault. 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.
EnableorDisable.- 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 is600.- type str
The type of domain record. Valid values are
A,NS,MX,TXT,CNAME,SRV,AAAA,CAA,REDIRECT_URLandFORWORD_URL.- value str
The value of domain record, When the
typeisMX,NS,CNAME,SRV, the server will treat thevalueas 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
alicloudTerraform Provider.