Class CNameRecord

Enables you to manage DNS CNAME Records within Azure DNS.

Example Usage

using Pulumi;
using Azure = Pulumi.Azure;

class MyStack : Stack
{
public MyStack()
{
    var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new Azure.Core.ResourceGroupArgs
    {
        Location = "West US",
    });
    var exampleZone = new Azure.Dns.Zone("exampleZone", new Azure.Dns.ZoneArgs
    {
        ResourceGroupName = exampleResourceGroup.Name,
    });
    var exampleCNameRecord = new Azure.Dns.CNameRecord("exampleCNameRecord", new Azure.Dns.CNameRecordArgs
    {
        ZoneName = exampleZone.Name,
        ResourceGroupName = exampleResourceGroup.Name,
        Ttl = 300,
        Record = "contoso.com",
    });
}

}

Example Usage (Alias Record)

using Pulumi;
using Azure = Pulumi.Azure;

class MyStack : Stack
{
public MyStack()
{
    var exampleResourceGroup = new Azure.Core.ResourceGroup("exampleResourceGroup", new Azure.Core.ResourceGroupArgs
    {
        Location = "West US",
    });
    var exampleZone = new Azure.Dns.Zone("exampleZone", new Azure.Dns.ZoneArgs
    {
        ResourceGroupName = exampleResourceGroup.Name,
    });
    var target = new Azure.Dns.CNameRecord("target", new Azure.Dns.CNameRecordArgs
    {
        ZoneName = exampleZone.Name,
        ResourceGroupName = exampleResourceGroup.Name,
        Ttl = 300,
        Record = "contoso.com",
    });
    var exampleCNameRecord = new Azure.Dns.CNameRecord("exampleCNameRecord", new Azure.Dns.CNameRecordArgs
    {
        ZoneName = exampleZone.Name,
        ResourceGroupName = exampleResourceGroup.Name,
        Ttl = 300,
        TargetResourceId = target.Id,
    });
}

}

Inheritance

System.Object

Resource

CustomResource

CNameRecord

Inherited Members

CustomResource.Id

Resource.GetResourceType()

Resource.GetResourceName()

Resource.Urn

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: Pulumi.Azure.Dns

Assembly: Pulumi.Azure.dll

Syntax

public class CNameRecord : CustomResource

Constructors

CNameRecord(String, CNameRecordArgs, CustomResourceOptions)

Create a CNameRecord resource with the given unique name, arguments, and options.

Declaration

public CNameRecord(string name, CNameRecordArgs args, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resource
CNameRecordArgs	args	The arguments used to populate this resource's properties
CustomResourceOptions	options	A bag of options that control this resource's behavior

Properties

Fqdn

The FQDN of the DNS CName Record.

Declaration

public Output<string> Fqdn { get; }

Property Value

Type	Description
Output<System.String>

Name

The name of the DNS CNAME Record.

Declaration

public Output<string> Name { get; }

Property Value

Type	Description
Output<System.String>

Record

The target of the CNAME.

Declaration

public Output<string> Record { get; }

Property Value

Type	Description
Output<System.String>

ResourceGroupName

Specifies the resource group where the DNS Zone (parent resource) exists. Changing this forces a new resource to be created.

Declaration

public Output<string> ResourceGroupName { get; }

Property Value

Type	Description
Output<System.String>

Tags

A mapping of tags to assign to the resource.

Declaration

public Output<ImmutableDictionary<string, string>> Tags { get; }

Property Value

Type	Description
Output<System.Collections.Immutable.ImmutableDictionary<System.String, System.String>>

TargetResourceId

The Azure resource id of the target object. Conflicts with records

Declaration

public Output<string> TargetResourceId { get; }

Property Value

Type	Description
Output<System.String>

Ttl

Declaration

public Output<int> Ttl { get; }

Property Value

Type	Description
Output<System.Int32>

ZoneName

Specifies the DNS Zone where the resource exists. Changing this forces a new resource to be created.

Declaration

public Output<string> ZoneName { get; }

Property Value

Type	Description
Output<System.String>

Methods

Get(String, Input<String>, CNameRecordState, CustomResourceOptions)

Get an existing CNameRecord resource's state with the given name, ID, and optional extra properties used to qualify the lookup.

Declaration

public static CNameRecord Get(string name, Input<string> id, CNameRecordState state = null, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resulting resource.
Input<System.String>	id	The unique provider ID of the resource to lookup.
CNameRecordState	state	Any extra arguments used during the lookup.
CustomResourceOptions	options	A bag of options that control this resource's behavior

Returns

Type	Description
CNameRecord