This page documents the language specification for the alicloud package. If you're looking for help working with the inputs, outputs, or functions of alicloud resources in a Pulumi program, please see the resource documentation for examples and API reference.

dns¶

This provider is a derived work of the Terraform Provider distributed under MPL 2.0. If you encounter a bug or missing feature, first check the pulumi/pulumi-alicloud repo; however, if that doesn’t turn up anything, please consult the source terraform-providers/terraform-provider-alicloud repo.

class pulumi_alicloud.dns.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, __name__=None, __opts__=None)¶

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

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")

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
domain_name (pulumi.Input[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 (pulumi.Input[str]) – User language.
line (pulumi.Input[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 dns.getResolutionLines in data source to get the value.
priority (pulumi.Input[float]) – The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.
remark (pulumi.Input[str]) – The remark of the domain record.
rr (pulumi.Input[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 (pulumi.Input[str]) – The status of the domain record. Valid values: ENABLE,DISABLE.
ttl (pulumi.Input[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 (pulumi.Input[str]) – The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
user_client_ip (pulumi.Input[str]) – The IP address of the client.
value (pulumi.Input[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.

domain_name: pulumi.Output[str] = None¶: 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: pulumi.Output[str] = None¶: User language.

line: pulumi.Output[str] = None¶: 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 dns.getResolutionLines in data source to get the value.

priority: pulumi.Output[float] = None¶: The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.

remark: pulumi.Output[str] = None¶: The remark of the domain record.

rr: pulumi.Output[str] = None¶: 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: pulumi.Output[str] = None¶: The status of the domain record. Valid values: ENABLE,DISABLE.

ttl: pulumi.Output[float] = None¶: 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: pulumi.Output[str] = None¶: The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.

user_client_ip: pulumi.Output[str] = None¶: The IP address of the client.

value: pulumi.Output[str] = None¶: 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.

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)¶

Get an existing AlidnsRecord resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
domain_name (pulumi.Input[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 (pulumi.Input[str]) – User language.
line (pulumi.Input[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 dns.getResolutionLines in data source to get the value.
priority (pulumi.Input[float]) – The priority of domain record. Valid values: [1-10]. When the type is MX, this parameter is required.
remark (pulumi.Input[str]) – The remark of the domain record.
rr (pulumi.Input[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 (pulumi.Input[str]) – The status of the domain record. Valid values: ENABLE,DISABLE.
ttl (pulumi.Input[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 (pulumi.Input[str]) – The type of domain record. Valid values: A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
user_client_ip (pulumi.Input[str]) – The IP address of the client.
value (pulumi.Input[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.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_alicloud.dns.AwaitableGetAlidnsDomainGroupsResult(groups=None, id=None, ids=None, name_regex=None, names=None, output_file=None)¶

class pulumi_alicloud.dns.AwaitableGetAlidnsRecordsResult(direction=None, domain_name=None, group_id=None, id=None, ids=None, key_word=None, lang=None, line=None, order_by=None, output_file=None, records=None, rr_key_word=None, rr_regex=None, search_mode=None, status=None, type=None, type_key_word=None, value_key_word=None, value_regex=None)¶

class pulumi_alicloud.dns.AwaitableGetDomainGroupsResult(groups=None, id=None, ids=None, name_regex=None, names=None, output_file=None)¶

class pulumi_alicloud.dns.AwaitableGetDomainRecordsResult(domain_name=None, host_record_regex=None, id=None, ids=None, is_locked=None, line=None, output_file=None, records=None, status=None, type=None, urls=None, value_regex=None)¶

class pulumi_alicloud.dns.AwaitableGetDomainTxtGuidResult(domain_name=None, id=None, lang=None, output_file=None, rr=None, type=None, value=None)¶

class pulumi_alicloud.dns.AwaitableGetDomainsResult(ali_domain=None, domain_name_regex=None, domains=None, group_id=None, group_name_regex=None, id=None, ids=None, instance_id=None, key_word=None, lang=None, names=None, output_file=None, resource_group_id=None, search_mode=None, starmark=None, tags=None, version_code=None)¶

class pulumi_alicloud.dns.AwaitableGetGroupsResult(groups=None, id=None, ids=None, name_regex=None, names=None, output_file=None)¶

class pulumi_alicloud.dns.AwaitableGetInstancesResult(id=None, ids=None, instances=None, output_file=None)¶

class pulumi_alicloud.dns.AwaitableGetRecordsResult(domain_name=None, host_record_regex=None, id=None, ids=None, is_locked=None, line=None, output_file=None, records=None, status=None, type=None, urls=None, value_regex=None)¶

class pulumi_alicloud.dns.AwaitableGetResolutionLinesResult(domain_name=None, id=None, lang=None, line_codes=None, line_display_names=None, line_names=None, lines=None, output_file=None, user_client_ip=None)¶

class pulumi_alicloud.dns.DdosBgpInstance(resource_name, opts=None, bandwidth=None, base_bandwidth=None, ip_count=None, ip_type=None, name=None, period=None, type=None, __props__=None, __name__=None, __opts__=None)¶

Anti-DDoS Advanced instance resource. “Ddosbgp” is the short term of this product.

NOTE: The endpoint of bssopenapi used only support “business.aliyuncs.com” at present.
NOTE: Available in 1.57.0+ .

import pulumi
import pulumi_alicloud as alicloud

instance = alicloud.ddos.DdosBgpInstance("instance",
    bandwidth="201",
    base_bandwidth="20",
    ip_count="100",
    ip_type="IPv4")

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
bandwidth (pulumi.Input[float]) – Elastic defend bandwidth of the instance. This value must be larger than the base defend bandwidth. Valid values: 51,91,101,201,301. The unit is Gbps.
base_bandwidth (pulumi.Input[float]) – Base defend bandwidth of the instance. Valid values: 20. The unit is Gbps. Default to 20.
ip_count (pulumi.Input[float]) – IP count of the instance. Valid values: 100.
ip_type (pulumi.Input[str]) – IP version of the instance. Valid values: IPv4,IPv6.
name (pulumi.Input[str]) – Name of the instance. This name can have a string of 1 to 63 characters.
period (pulumi.Input[float]) – The duration that you will buy Ddosbgp instance (in month). Valid values: [1~9], 12, 24, 36. Default to 12. At present, the provider does not support modify “period”.
type (pulumi.Input[str]) – Type of the instance. Valid values: Enterprise,Professional. Default to Enterprise

bandwidth: pulumi.Output[float] = None¶: Elastic defend bandwidth of the instance. This value must be larger than the base defend bandwidth. Valid values: 51,91,101,201,301. The unit is Gbps.

base_bandwidth: pulumi.Output[float] = None¶: Base defend bandwidth of the instance. Valid values: 20. The unit is Gbps. Default to 20.

ip_count: pulumi.Output[float] = None¶: IP count of the instance. Valid values: 100.

ip_type: pulumi.Output[str] = None¶: IP version of the instance. Valid values: IPv4,IPv6.

name: pulumi.Output[str] = None¶: Name of the instance. This name can have a string of 1 to 63 characters.

period: pulumi.Output[float] = None¶: The duration that you will buy Ddosbgp instance (in month). Valid values: [1~9], 12, 24, 36. Default to 12. At present, the provider does not support modify “period”.

type: pulumi.Output[str] = None¶: Type of the instance. Valid values: Enterprise,Professional. Default to Enterprise

static get(resource_name, id, opts=None, bandwidth=None, base_bandwidth=None, ip_count=None, ip_type=None, name=None, period=None, type=None)¶

Get an existing DdosBgpInstance resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
bandwidth (pulumi.Input[float]) – Elastic defend bandwidth of the instance. This value must be larger than the base defend bandwidth. Valid values: 51,91,101,201,301. The unit is Gbps.
base_bandwidth (pulumi.Input[float]) – Base defend bandwidth of the instance. Valid values: 20. The unit is Gbps. Default to 20.
ip_count (pulumi.Input[float]) – IP count of the instance. Valid values: 100.
ip_type (pulumi.Input[str]) – IP version of the instance. Valid values: IPv4,IPv6.
name (pulumi.Input[str]) – Name of the instance. This name can have a string of 1 to 63 characters.
period (pulumi.Input[float]) – The duration that you will buy Ddosbgp instance (in month). Valid values: [1~9], 12, 24, 36. Default to 12. At present, the provider does not support modify “period”.
type (pulumi.Input[str]) – Type of the instance. Valid values: Enterprise,Professional. Default to Enterprise

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_alicloud.dns.DdosCooInstance(resource_name, opts=None, bandwidth=None, base_bandwidth=None, domain_count=None, name=None, period=None, port_count=None, service_bandwidth=None, __props__=None, __name__=None, __opts__=None)¶

BGP-Line Anti-DDoS instance resource. “Ddoscoo” is the short term of this product. See What is Anti-DDoS Pro.

NOTE: The product region only support cn-hangzhou.
NOTE: The endpoint of bssopenapi used only support “business.aliyuncs.com” at present.
NOTE: Available in 1.37.0+ .

import pulumi
import pulumi_alicloud as alicloud

new_instance = alicloud.ddos.DdosCooInstance("newInstance",
    bandwidth="30",
    base_bandwidth="30",
    domain_count="50",
    period="1",
    port_count="50",
    service_bandwidth="100")

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
bandwidth (pulumi.Input[str]) – Elastic defend bandwidth of the instance. This value must be larger than the base defend bandwidth. Valid values: 30, 60, 100, 300, 400, 500, 600. The unit is Gbps. Only support upgrade.
base_bandwidth (pulumi.Input[str]) – Base defend bandwidth of the instance. Valid values: 30, 60, 100, 300, 400, 500, 600. The unit is Gbps. Only support upgrade.
domain_count (pulumi.Input[str]) – Domain retransmission rule count of the instance. At least 50. Increase 5 per step, such as 55, 60, 65. Only support upgrade.
name (pulumi.Input[str]) – Name of the instance. This name can have a string of 1 to 63 characters.
period (pulumi.Input[float]) – The duration that you will buy Ddoscoo instance (in month). Valid values: [1~9], 12, 24, 36. Default to 1. At present, the provider does not support modify “period”.
port_count (pulumi.Input[str]) – Port retransmission rule count of the instance. At least 50. Increase 5 per step, such as 55, 60, 65. Only support upgrade.
service_bandwidth (pulumi.Input[str]) – Business bandwidth of the instance. At leaset 100. Increased 100 per step, such as 100, 200, 300. The unit is Mbps. Only support upgrade.

bandwidth: pulumi.Output[str] = None¶: Elastic defend bandwidth of the instance. This value must be larger than the base defend bandwidth. Valid values: 30, 60, 100, 300, 400, 500, 600. The unit is Gbps. Only support upgrade.

base_bandwidth: pulumi.Output[str] = None¶: Base defend bandwidth of the instance. Valid values: 30, 60, 100, 300, 400, 500, 600. The unit is Gbps. Only support upgrade.

domain_count: pulumi.Output[str] = None¶: Domain retransmission rule count of the instance. At least 50. Increase 5 per step, such as 55, 60, 65. Only support upgrade.

name: pulumi.Output[str] = None¶: Name of the instance. This name can have a string of 1 to 63 characters.

period: pulumi.Output[float] = None¶: The duration that you will buy Ddoscoo instance (in month). Valid values: [1~9], 12, 24, 36. Default to 1. At present, the provider does not support modify “period”.

port_count: pulumi.Output[str] = None¶: Port retransmission rule count of the instance. At least 50. Increase 5 per step, such as 55, 60, 65. Only support upgrade.

service_bandwidth: pulumi.Output[str] = None¶: Business bandwidth of the instance. At leaset 100. Increased 100 per step, such as 100, 200, 300. The unit is Mbps. Only support upgrade.

static get(resource_name, id, opts=None, bandwidth=None, base_bandwidth=None, domain_count=None, name=None, period=None, port_count=None, service_bandwidth=None)¶

Get an existing DdosCooInstance resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
bandwidth (pulumi.Input[str]) – Elastic defend bandwidth of the instance. This value must be larger than the base defend bandwidth. Valid values: 30, 60, 100, 300, 400, 500, 600. The unit is Gbps. Only support upgrade.
base_bandwidth (pulumi.Input[str]) – Base defend bandwidth of the instance. Valid values: 30, 60, 100, 300, 400, 500, 600. The unit is Gbps. Only support upgrade.
domain_count (pulumi.Input[str]) – Domain retransmission rule count of the instance. At least 50. Increase 5 per step, such as 55, 60, 65. Only support upgrade.
name (pulumi.Input[str]) – Name of the instance. This name can have a string of 1 to 63 characters.
period (pulumi.Input[float]) – The duration that you will buy Ddoscoo instance (in month). Valid values: [1~9], 12, 24, 36. Default to 1. At present, the provider does not support modify “period”.
port_count (pulumi.Input[str]) – Port retransmission rule count of the instance. At least 50. Increase 5 per step, such as 55, 60, 65. Only support upgrade.
service_bandwidth (pulumi.Input[str]) – Business bandwidth of the instance. At leaset 100. Increased 100 per step, such as 100, 200, 300. The unit is Mbps. Only support upgrade.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_alicloud.dns.DnsDomain(resource_name, opts=None, domain_name=None, group_id=None, lang=None, remark=None, resource_group_id=None, tags=None, __props__=None, __name__=None, __opts__=None)¶

Create a DnsDomain resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] domain_name: 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. :param pulumi.Input[str] group_id: Id of the group in which the domain will add. If not supplied, then use default group. :param pulumi.Input[str] lang: User language. :param pulumi.Input[str] remark: Remarks information for your domain name. :param pulumi.Input[str] resource_group_id: The Id of resource group which the dns domain belongs. :param pulumi.Input[dict] tags: A mapping of tags to assign to the resource.

- Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
- Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

domain_id: pulumi.Output[str] = None¶: The domain ID.

domain_name: pulumi.Output[str] = None¶: 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: pulumi.Output[str] = None¶: Id of the group in which the domain will add. If not supplied, then use default group.

lang: pulumi.Output[str] = None¶: User language.

remark: pulumi.Output[str] = None¶: Remarks information for your domain name.

resource_group_id: pulumi.Output[str] = None¶: The Id of resource group which the dns domain belongs.

tags: pulumi.Output[dict] = None¶

A mapping of tags to assign to the resource.

Key: It can be up to 64 characters in length. It cannot begin with “aliyun”, “acs:”, “http://”, or “https://”. It cannot be a null string.
Value: It can be up to 128 characters in length. It cannot begin with “aliyun”, “acs:”, “http://”, or “https://”. It can be a null string.

static get(resource_name, id, opts=None, dns_servers=None, domain_id=None, domain_name=None, group_id=None, lang=None, remark=None, resource_group_id=None, tags=None)¶

Get an existing DnsDomain resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
domain_id (pulumi.Input[str]) – The domain ID.
domain_name (pulumi.Input[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 (pulumi.Input[str]) – Id of the group in which the domain will add. If not supplied, then use default group.
lang (pulumi.Input[str]) – User language.
remark (pulumi.Input[str]) – Remarks information for your domain name.
resource_group_id (pulumi.Input[str]) – The Id of resource group which the dns domain belongs.
tags (pulumi.Input[dict]) – A mapping of tags to assign to the resource.

- Key: It can be up to 64 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It cannot be a null string.
- Value: It can be up to 128 characters in length. It cannot begin with "aliyun", "acs:", "http://", or "https://". It can be a null string.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_alicloud.dns.Domain(resource_name, opts=None, group_id=None, name=None, resource_group_id=None, __props__=None, __name__=None, __opts__=None)¶

Create a Domain resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] group_id: Id of the group in which the domain will add. If not supplied, then use default group. :param pulumi.Input[str] name: 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. :param pulumi.Input[str] resource_group_id: The Id of resource group which the dns belongs.

dns_servers: pulumi.Output[list] = None¶: A list of the dns server name.

domain_id: pulumi.Output[str] = None¶: The domain ID.

group_id: pulumi.Output[str] = None¶: Id of the group in which the domain will add. If not supplied, then use default group.

name: pulumi.Output[str] = None¶: 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.

resource_group_id: pulumi.Output[str] = None¶: The Id of resource group which the dns belongs.

static get(resource_name, id, opts=None, dns_servers=None, domain_id=None, group_id=None, name=None, resource_group_id=None)¶

Get an existing Domain resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
dns_servers (pulumi.Input[list]) – A list of the dns server name.
domain_id (pulumi.Input[str]) – The domain ID.
group_id (pulumi.Input[str]) – Id of the group in which the domain will add. If not supplied, then use default group.
name (pulumi.Input[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.
resource_group_id (pulumi.Input[str]) – The Id of resource group which the dns belongs.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_alicloud.dns.DomainAttachment(resource_name, opts=None, domain_names=None, instance_id=None, __props__=None, __name__=None, __opts__=None)¶

Provides bind the domain name to the DNS instance resource.

NOTE: Available in v1.80.0+.

import pulumi
import pulumi_alicloud as alicloud

dns = alicloud.dns.DomainAttachment("dns",
    domain_names=[
        "test111.abc",
        "test222.abc",
    ],
    instance_id="dns-cn-mp91lyq9xxxx")

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
domain_names (pulumi.Input[list]) – The domain names bound to the DNS instance.
instance_id (pulumi.Input[str]) – The id of the DNS instance.

domain_names: pulumi.Output[list] = None¶: The domain names bound to the DNS instance.

instance_id: pulumi.Output[str] = None¶: The id of the DNS instance.

static get(resource_name, id, opts=None, domain_names=None, instance_id=None)¶

Get an existing DomainAttachment resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
domain_names (pulumi.Input[list]) – The domain names bound to the DNS instance.
instance_id (pulumi.Input[str]) – The id of the DNS instance.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_alicloud.dns.DomainGroup(resource_name, opts=None, group_name=None, lang=None, __props__=None, __name__=None, __opts__=None)¶

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

NOTE: Available in v1.84.0+.

import pulumi
import pulumi_alicloud as alicloud

# Add a new Alinds Domain Group.
example = alicloud.dns.DomainGroup("example", group_name="tf-testDG")

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
group_name (pulumi.Input[str]) – Name of the domain group.
lang (pulumi.Input[str]) – User language.

group_name: pulumi.Output[str] = None¶: Name of the domain group.

lang: pulumi.Output[str] = None¶: User language.

static get(resource_name, id, opts=None, group_name=None, lang=None)¶

Get an existing DomainGroup resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
group_name (pulumi.Input[str]) – Name of the domain group.
lang (pulumi.Input[str]) – User language.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_alicloud.dns.GetAlidnsDomainGroupsResult(groups=None, id=None, ids=None, name_regex=None, names=None, output_file=None)¶

A collection of values returned by getAlidnsDomainGroups.

groups = None¶: A list of instances. Each element contains the following attributes:

id = None¶: The provider-assigned unique ID for this managed resource.

ids = None¶: A list of instance IDs.

names = None¶: A list of domain group names.

class pulumi_alicloud.dns.GetAlidnsRecordsResult(direction=None, domain_name=None, group_id=None, id=None, ids=None, key_word=None, lang=None, line=None, order_by=None, output_file=None, records=None, rr_key_word=None, rr_regex=None, search_mode=None, status=None, type=None, type_key_word=None, value_key_word=None, value_regex=None)¶

A collection of values returned by getAlidnsRecords.

domain_name = None¶: Name of the domain record belongs to.

id = None¶: The provider-assigned unique ID for this managed resource.

ids = None¶: A list of record IDs.

line = None¶: ISP line of the record.

records = None¶: A list of records. Each element contains the following attributes:

status = None¶: Status of the record.

type = None¶: Type of the record.

class pulumi_alicloud.dns.GetDomainGroupsResult(groups=None, id=None, ids=None, name_regex=None, names=None, output_file=None)¶

A collection of values returned by getDomainGroups.

id = None¶: The provider-assigned unique ID for this managed resource.

class pulumi_alicloud.dns.GetDomainRecordsResult(domain_name=None, host_record_regex=None, id=None, ids=None, is_locked=None, line=None, output_file=None, records=None, status=None, type=None, urls=None, value_regex=None)¶

A collection of values returned by getDomainRecords.

id = None¶: The provider-assigned unique ID for this managed resource.

class pulumi_alicloud.dns.GetDomainTxtGuidResult(domain_name=None, id=None, lang=None, output_file=None, rr=None, type=None, value=None)¶

A collection of values returned by getDomainTxtGuid.

id = None¶: The provider-assigned unique ID for this managed resource.

rr = None¶: Host record.

value = None¶: Record the value.

class pulumi_alicloud.dns.GetDomainsResult(ali_domain=None, domain_name_regex=None, domains=None, group_id=None, group_name_regex=None, id=None, ids=None, instance_id=None, key_word=None, lang=None, names=None, output_file=None, resource_group_id=None, search_mode=None, starmark=None, tags=None, version_code=None)¶

A collection of values returned by getDomains.

ali_domain = None¶: Indicates whether the domain is an Alibaba Cloud domain.

domains = None¶: A list of domains. Each element contains the following attributes:

group_id = None¶: Id of group that contains the domain.

id = None¶: The provider-assigned unique ID for this managed resource.

ids = None¶: A list of domain IDs.

instance_id = None¶: Cloud analysis product ID of the domain.

names = None¶: A list of domain names.

resource_group_id = None¶: The Id of resource group which the dns belongs.

version_code = None¶: Cloud resolution version ID.

class pulumi_alicloud.dns.GetGroupsResult(groups=None, id=None, ids=None, name_regex=None, names=None, output_file=None)¶

A collection of values returned by getGroups.

groups = None¶: A list of groups. Each element contains the following attributes:

id = None¶: The provider-assigned unique ID for this managed resource.

ids = None¶: A list of group IDs.

names = None¶: A list of group names.

class pulumi_alicloud.dns.GetInstancesResult(id=None, ids=None, instances=None, output_file=None)¶

A collection of values returned by getInstances.

id = None¶: The provider-assigned unique ID for this managed resource.

ids = None¶: A list of instance IDs.

instances = None¶: A list of instances. Each element contains the following attributes:

class pulumi_alicloud.dns.GetRecordsResult(domain_name=None, host_record_regex=None, id=None, ids=None, is_locked=None, line=None, output_file=None, records=None, status=None, type=None, urls=None, value_regex=None)¶

A collection of values returned by getRecords.

domain_name = None¶: Name of the domain the record belongs to.

id = None¶: The provider-assigned unique ID for this managed resource.

ids = None¶: A list of record IDs.

line = None¶: ISP line of the record.

records = None¶: A list of records. Each element contains the following attributes:

status = None¶: Status of the record.

type = None¶: Type of the record.

urls = None¶: A list of entire URLs. Each item format as <host_record>.<domain_name>.

class pulumi_alicloud.dns.GetResolutionLinesResult(domain_name=None, id=None, lang=None, line_codes=None, line_display_names=None, line_names=None, lines=None, output_file=None, user_client_ip=None)¶

A collection of values returned by getResolutionLines.

id = None¶: The provider-assigned unique ID for this managed resource.

line_codes = None¶: Line code.

line_display_names = None¶: A list of line display names.

lines = None¶: A list of cloud resolution line. Each element contains the following attributes:

class pulumi_alicloud.dns.Group(resource_name, opts=None, name=None, __props__=None, __name__=None, __opts__=None)¶

Create a Group resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] name: Name of the domain group.

name: pulumi.Output[str] = None¶: Name of the domain group.

static get(resource_name, id, opts=None, name=None)¶

Get an existing Group resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
name (pulumi.Input[str]) – Name of the domain group.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_alicloud.dns.Instance(resource_name, opts=None, dns_security=None, domain_numbers=None, period=None, renew_period=None, renewal_status=None, version_code=None, __props__=None, __name__=None, __opts__=None)¶

Create an DNS Instance resource.

NOTE: Available in v1.80.0+.

import pulumi
import pulumi_alicloud as alicloud

this = alicloud.dns.Instance("this",
    dns_security="no",
    domain_numbers="2",
    period=1,
    renew_period=1,
    renewal_status="ManualRenewal",
    version_code="version_personal")

Parameters

resource_name (str) – The name of the resource.
opts (pulumi.ResourceOptions) – Options for the resource.
dns_security (pulumi.Input[str]) – DNS security level. Valid values: no, basic, advanced.
domain_numbers (pulumi.Input[str]) – Number of domain names bound.
period (pulumi.Input[float]) – Creating a pre-paid instance, it must be set, the unit is month, please enter an integer multiple of 12 for annually paid products.
renew_period (pulumi.Input[float]) – Automatic renewal period, the unit is month. When setting RenewalStatus to AutoRenewal, it must be set.
renewal_status (pulumi.Input[str]) – Automatic renewal status. Valid values: AutoRenewal, ManualRenewal, default to ManualRenewal.
version_code (pulumi.Input[str]) – Paid package version. Valid values: version_personal, version_enterprise_basic, version_enterprise_advanced.

dns_security: pulumi.Output[str] = None¶: DNS security level. Valid values: no, basic, advanced.

domain_numbers: pulumi.Output[str] = None¶: Number of domain names bound.

period: pulumi.Output[float] = None¶: Creating a pre-paid instance, it must be set, the unit is month, please enter an integer multiple of 12 for annually paid products.

renew_period: pulumi.Output[float] = None¶: Automatic renewal period, the unit is month. When setting RenewalStatus to AutoRenewal, it must be set.

renewal_status: pulumi.Output[str] = None¶: Automatic renewal status. Valid values: AutoRenewal, ManualRenewal, default to ManualRenewal.

version_code: pulumi.Output[str] = None¶: Paid package version. Valid values: version_personal, version_enterprise_basic, version_enterprise_advanced.

version_name: pulumi.Output[str] = None¶: Paid package version name.

static get(resource_name, id, opts=None, dns_security=None, domain_numbers=None, period=None, renew_period=None, renewal_status=None, version_code=None, version_name=None)¶

Get an existing Instance resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
dns_security (pulumi.Input[str]) – DNS security level. Valid values: no, basic, advanced.
domain_numbers (pulumi.Input[str]) – Number of domain names bound.
period (pulumi.Input[float]) – Creating a pre-paid instance, it must be set, the unit is month, please enter an integer multiple of 12 for annually paid products.
renew_period (pulumi.Input[float]) – Automatic renewal period, the unit is month. When setting RenewalStatus to AutoRenewal, it must be set.
renewal_status (pulumi.Input[str]) – Automatic renewal status. Valid values: AutoRenewal, ManualRenewal, default to ManualRenewal.
version_code (pulumi.Input[str]) – Paid package version. Valid values: version_personal, version_enterprise_basic, version_enterprise_advanced.
version_name (pulumi.Input[str]) – Paid package version name.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

class pulumi_alicloud.dns.Record(resource_name, opts=None, host_record=None, name=None, priority=None, routing=None, ttl=None, type=None, value=None, __props__=None, __name__=None, __opts__=None)¶

Create a Record resource with the given unique name, props, and options. :param str resource_name: The name of the resource. :param pulumi.ResourceOptions opts: Options for the resource. :param pulumi.Input[str] host_record: 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 “-“. :param pulumi.Input[str] name: 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. :param pulumi.Input[float] priority: The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required. :param pulumi.Input[str] routing: 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 dns.getResolutionLines in data source to get the value. :param pulumi.Input[float] ttl: 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. :param pulumi.Input[str] type: The type of domain record. Valid values are A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL. :param pulumi.Input[str] value: 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: pulumi.Output[str] = None¶: 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 “-“.

name: pulumi.Output[str] = None¶: 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: pulumi.Output[float] = None¶: The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required.

routing: pulumi.Output[str] = None¶: 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 dns.getResolutionLines in data source to get the value.

status: pulumi.Output[str] = None¶: The record status. Enable or Disable.

ttl: pulumi.Output[float] = None¶: 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: pulumi.Output[str] = None¶: The type of domain record. Valid values are A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.

value: pulumi.Output[str] = None¶: 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.

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)¶

Get an existing Record resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters

resource_name (str) – The unique name of the resulting resource.
id (str) – The unique provider ID of the resource to lookup.
opts (pulumi.ResourceOptions) – Options for the resource.
host_record (pulumi.Input[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 “-“.
name (pulumi.Input[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 (pulumi.Input[float]) – The priority of domain record. Valid values are [1-10]. When the type is MX, this parameter is required.
routing (pulumi.Input[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 dns.getResolutionLines in data source to get the value.
status (pulumi.Input[str]) – The record status. Enable or Disable.
ttl (pulumi.Input[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 (pulumi.Input[str]) – The type of domain record. Valid values are A,NS,MX,TXT,CNAME,SRV,AAAA,CAA, REDIRECT_URL and FORWORD_URL.
value (pulumi.Input[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.

translate_output_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

translate_input_property(prop)¶

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters: prop (str) – A property name.
Returns: A potentially transformed property name.
Return type: str

pulumi_alicloud.dns.get_alidns_domain_groups(ids=None, name_regex=None, output_file=None, opts=None)¶

This data source provides a list of Alidns Domain Groups in an Alibaba Cloud account according to the specified filters.

NOTE: Available in 1.85.0+.

import pulumi
import pulumi_alicloud as alicloud

example = alicloud.dns.get_alidns_domain_groups(ids=["c5ef2bc43064445787adf182af2****"])
pulumi.export("firstDomainGroupId", example.groups[0]["id"])

Parameters

ids (list) – A list of instance IDs.
name_regex (str) – A regex string to filter results by the domain group name.

pulumi_alicloud.dns.get_alidns_records(direction=None, domain_name=None, group_id=None, ids=None, key_word=None, lang=None, line=None, order_by=None, output_file=None, rr_key_word=None, rr_regex=None, search_mode=None, status=None, type=None, type_key_word=None, value_key_word=None, value_regex=None, opts=None)¶

This data source provides a list of Alidns Domain Records in an Alibaba Cloud account according to the specified filters.

NOTE: Available in 1.86.0+.

Parameters

direction (str) – Sorting direction. Valid values: DESC,ASC. Default to AESC.
domain_name (str) – The domain name associated to the records.
group_id (float) – Domain name group ID.
ids (list) – A list of record IDs.
key_word (str) – Keywords.
lang (str) – User language.
line (str) –
ISP line. Valid values: default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc
order_by (str) – Sort by. Sort from newest to oldest according to the time added by resolution.
rr_key_word (str) – The keywords recorded by the host are searched according to the %RRKeyWord% mode, and are not case sensitive.
rr_regex (str) – Host record regex.
search_mode (str) – Search mode, Valid values: LIKE, EXACT, ADVANCED, LIKE (fuzzy), EXACT (accurate) search supports KeyWord field, ADVANCED (advanced) mode supports other fields.
status (str) – Record status. Valid values: ENABLE and DISABLE.
type (str) – Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .
type_key_word (str) – Analyze type keywords, search by full match, not case sensitive.
value_key_word (str) – The keywords of the recorded value are searched according to the %ValueKeyWord% mode, and are not case sensitive.
value_regex (str) – Host record value regex.

pulumi_alicloud.dns.get_domain_groups(ids=None, name_regex=None, output_file=None, opts=None)¶: Use this data source to access information about an existing resource.

pulumi_alicloud.dns.get_domain_records(domain_name=None, host_record_regex=None, ids=None, is_locked=None, line=None, output_file=None, status=None, type=None, value_regex=None, opts=None)¶: Use this data source to access information about an existing resource.

pulumi_alicloud.dns.get_domain_txt_guid(domain_name=None, lang=None, output_file=None, type=None, opts=None)¶

Provides the generation of txt records to realize the retrieval and verification of domain names.

NOTE: Available in v1.80.0+.

import pulumi
import pulumi_alicloud as alicloud

this = alicloud.dns.get_domain_txt_guid(domain_name="test111.abc",
    type="ADD_SUB_DOMAIN")
pulumi.export("rr", this.rr)
pulumi.export("value", this.value)

Parameters

domain_name (str) – Verified domain name.
lang (str) – User language.
type (str) – Txt verification function. Value:ADD_SUB_DOMAIN, RETRIEVAL.

pulumi_alicloud.dns.get_domains(ali_domain=None, domain_name_regex=None, group_id=None, group_name_regex=None, ids=None, instance_id=None, key_word=None, lang=None, output_file=None, resource_group_id=None, search_mode=None, starmark=None, tags=None, version_code=None, opts=None)¶

This data source provides a list of DNS Domains in an Alibaba Cloud account according to the specified filters.

import pulumi
import pulumi_alicloud as alicloud

domains_ds = alicloud.dns.get_domains(domain_name_regex="^hegu",
    output_file="domains.txt")
pulumi.export("firstDomainId", domains_ds.domains[0]["domain_id"])

Parameters

ali_domain (bool) – Specifies whether the domain is from Alibaba Cloud or not.
domain_name_regex (str) – A regex string to filter results by the domain name.
group_id (str) – Domain group ID, if not filled, the default is all groups.
group_name_regex (str) – A regex string to filter results by the group name.
ids (list) –
- A list of domain IDs.
instance_id (str) – Cloud analysis product ID.
key_word (str) – The keywords are searched according to the %KeyWord% mode, which is not case sensitive.
lang (str) – User language.
resource_group_id (str) – The Id of resource group which the dns belongs.
search_mode (str) – Search mode, LIKE fuzzy search, EXACT exact search.
starmark (bool) – Whether to query the domain name star.
tags (dict) – A mapping of tags to assign to the resource.
version_code (str) – Cloud analysis version code.

pulumi_alicloud.dns.get_groups(ids=None, name_regex=None, output_file=None, opts=None)¶

This data source provides a list of DNS Domain Groups in an Alibaba Cloud account according to the specified filters.

import pulumi
import pulumi_alicloud as alicloud

groups_ds = alicloud.dns.get_groups(name_regex="^y[A-Za-z]+",
    output_file="groups.txt")
pulumi.export("firstGroupName", groups_ds.groups[0]["group_name"])

Parameters

ids (list) – A list of group IDs.
name_regex (str) – A regex string to filter results by group name.

pulumi_alicloud.dns.get_instances(ids=None, output_file=None, opts=None)¶

This data source provides a list of DNS instances in an Alibaba Cloud account according to the specified filters.

NOTE: Available in 1.84.0+.

import pulumi
import pulumi_alicloud as alicloud

example = alicloud.dns.get_instances(ids=["dns-cn-oew1npk****"])
pulumi.export("firstInstanceId", example.instances[0]["id"])

Parameters: ids (list) – A list of instance IDs.

pulumi_alicloud.dns.get_records(domain_name=None, host_record_regex=None, ids=None, is_locked=None, line=None, output_file=None, status=None, type=None, value_regex=None, opts=None)¶

This data source provides a list of DNS Domain Records in an Alibaba Cloud account according to the specified filters.

import pulumi
import pulumi_alicloud as alicloud

records_ds = alicloud.dns.get_records(domain_name="xiaozhu.top",
    host_record_regex="^@",
    is_locked=False,
    output_file="records.txt",
    type="A")
pulumi.export("firstRecordId", records_ds.records[0]["record_id"])

Parameters

domain_name (str) – The domain name associated to the records.
host_record_regex (str) – Host record regex.
ids (list) – A list of record IDs.
is_locked (bool) – Whether the record is locked or not.
line (str) –
ISP line. Valid items are default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc
status (str) – Record status. Valid items are ENABLE and DISABLE.
type (str) – Record type. Valid items are A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .
value_regex (str) – Host record value regex.

pulumi_alicloud.dns.get_resolution_lines(domain_name=None, lang=None, line_codes=None, line_display_names=None, line_names=None, output_file=None, user_client_ip=None, opts=None)¶

This data source provides a list of DNS Resolution Lines in an Alibaba Cloud account according to the specified filters.

NOTE: Available in 1.60.0.

import pulumi
import pulumi_alicloud as alicloud

resolution_lines_ds = alicloud.dns.get_resolution_lines(line_codes=["cn_unicom_shanxi"],
    output_file="support_lines.txt")
pulumi.export("firstLineCode", resolution_lines_ds.lines[0]["lineCode"])

Parameters

domain_name (str) – Domain Name.
lang (str) – language.
line_codes (list) – A list of lines codes.
line_display_names (list) – A list of line display names.
user_client_ip (str) – The ip of user client.

The Pulumi Platform

Get Started

Migrate to Pulumi

Solutions for All Teams and Engineers

Any Code

Any Cloud

dns¶

On This Page