1. Pulumi Registry
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Dns
  5. Record
oci logo
Oracle Cloud Infrastructure v0.13.0, Mar 28 23

oci.Dns.Record

Import

Import is not supported for this resource.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testRecord = new Oci.Dns.Record("testRecord", new()
    {
        ZoneNameOrId = oci_dns_zone_name_or.Test_zone_name_or.Id,
        Domain = @var.Record_items_domain,
        Rtype = @var.Record_items_rtype,
        CompartmentId = @var.Compartment_id,
        Rdata = @var.Record_items_rdata,
        Ttl = @var.Record_items_ttl,
    });

});

package main

import (
	"github.com/pulumi/pulumi-oci/sdk/go/oci/Dns"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := Dns.NewRecord(ctx, "testRecord", &Dns.RecordArgs{
			ZoneNameOrId:  pulumi.Any(oci_dns_zone_name_or.Test_zone_name_or.Id),
			Domain:        pulumi.Any(_var.Record_items_domain),
			Rtype:         pulumi.Any(_var.Record_items_rtype),
			CompartmentId: pulumi.Any(_var.Compartment_id),
			Rdata:         pulumi.Any(_var.Record_items_rdata),
			Ttl:           pulumi.Any(_var.Record_items_ttl),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Dns.Record;
import com.pulumi.oci.Dns.RecordArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var testRecord = new Record("testRecord", RecordArgs.builder()        
            .zoneNameOrId(oci_dns_zone_name_or.test_zone_name_or().id())
            .domain(var_.record_items_domain())
            .rtype(var_.record_items_rtype())
            .compartmentId(var_.compartment_id())
            .rdata(var_.record_items_rdata())
            .ttl(var_.record_items_ttl())
            .build());

    }
}

import pulumi
import pulumi_oci as oci

test_record = oci.dns.Record("testRecord",
    zone_name_or_id=oci_dns_zone_name_or["test_zone_name_or"]["id"],
    domain=var["record_items_domain"],
    rtype=var["record_items_rtype"],
    compartment_id=var["compartment_id"],
    rdata=var["record_items_rdata"],
    ttl=var["record_items_ttl"])

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

const testRecord = new oci.dns.Record("testRecord", {
    zoneNameOrId: oci_dns_zone_name_or.test_zone_name_or.id,
    domain: _var.record_items_domain,
    rtype: _var.record_items_rtype,
    compartmentId: _var.compartment_id,
    rdata: _var.record_items_rdata,
    ttl: _var.record_items_ttl,
});

resources:
  testRecord:
    type: oci:Dns:Record
    properties:
      #Required
      zoneNameOrId: ${oci_dns_zone_name_or.test_zone_name_or.id}
      domain: ${var.record_items_domain}
      rtype: ${var.record_items_rtype}
      #Optional
      compartmentId: ${var.compartment_id}
      rdata: ${var.record_items_rdata}
      ttl: ${var.record_items_ttl}

Create Record Resource

new Record(name: string, args: RecordArgs, opts?: CustomResourceOptions);
@overload
def Record(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           compartment_id: Optional[str] = None,
           domain: Optional[str] = None,
           rdata: Optional[str] = None,
           rtype: Optional[str] = None,
           ttl: Optional[int] = None,
           zone_name_or_id: Optional[str] = None)
@overload
def Record(resource_name: str,
           args: RecordArgs,
           opts: Optional[ResourceOptions] = None)
func NewRecord(ctx *Context, name string, args RecordArgs, opts ...ResourceOption) (*Record, error)
public Record(string name, RecordArgs args, CustomResourceOptions? opts = null)
public Record(String name, RecordArgs args)
public Record(String name, RecordArgs args, CustomResourceOptions options)

type: oci:Dns:Record
properties: # The arguments to resource properties.
options: # 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.
resource_name str
The unique name of the resource.
args RecordArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control 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.
name String
The unique name of the resource.
args RecordArgs
The arguments to resource properties.
options 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 Architecture and Concepts docs.

Inputs

The Record resource accepts the following input properties:

Domain string

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

Rtype string

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

ZoneNameOrId string

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

CompartmentId string

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

Rdata string

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

Ttl int

(Updatable) The Time To Live for the record, in seconds.

Domain string

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

Rtype string

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

ZoneNameOrId string

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

CompartmentId string

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

Rdata string

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

Ttl int

(Updatable) The Time To Live for the record, in seconds.

domain String

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

rtype String

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

zoneNameOrId String

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

compartmentId String

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

rdata String

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

ttl Integer

(Updatable) The Time To Live for the record, in seconds.

domain string

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

rtype string

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

zoneNameOrId string

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

compartmentId string

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

rdata string

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

ttl number

(Updatable) The Time To Live for the record, in seconds.

domain str

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

rtype str

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

zone_name_or_id str

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

compartment_id str

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

rdata str

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

ttl int

(Updatable) The Time To Live for the record, in seconds.

domain String

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

rtype String

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

zoneNameOrId String

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

compartmentId String

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

rdata String

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

ttl Number

(Updatable) The Time To Live for the record, in seconds.

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.

IsProtected bool

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

RecordHash string

A unique identifier for the record within its zone.

RrsetVersion string

The latest version of the record's zone in which its RRSet differs from the preceding version.

Id string

The provider-assigned unique ID for this managed resource.

IsProtected bool

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

RecordHash string

A unique identifier for the record within its zone.

RrsetVersion string

The latest version of the record's zone in which its RRSet differs from the preceding version.

id String

The provider-assigned unique ID for this managed resource.

isProtected Boolean

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

recordHash String

A unique identifier for the record within its zone.

rrsetVersion String

The latest version of the record's zone in which its RRSet differs from the preceding version.

id string

The provider-assigned unique ID for this managed resource.

isProtected boolean

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

recordHash string

A unique identifier for the record within its zone.

rrsetVersion string

The latest version of the record's zone in which its RRSet differs from the preceding version.

id str

The provider-assigned unique ID for this managed resource.

is_protected bool

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

record_hash str

A unique identifier for the record within its zone.

rrset_version str

The latest version of the record's zone in which its RRSet differs from the preceding version.

id String

The provider-assigned unique ID for this managed resource.

isProtected Boolean

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

recordHash String

A unique identifier for the record within its zone.

rrsetVersion String

The latest version of the record's zone in which its RRSet differs from the preceding version.

Look up 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
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        compartment_id: Optional[str] = None,
        domain: Optional[str] = None,
        is_protected: Optional[bool] = None,
        rdata: Optional[str] = None,
        record_hash: Optional[str] = None,
        rrset_version: Optional[str] = None,
        rtype: Optional[str] = None,
        ttl: Optional[int] = None,
        zone_name_or_id: Optional[str] = None) -> Record
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)
public static Record get(String name, Output<String> id, RecordState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
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.
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:
CompartmentId string

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

Domain string

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

IsProtected bool

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

Rdata string

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

RecordHash string

A unique identifier for the record within its zone.

RrsetVersion string

The latest version of the record's zone in which its RRSet differs from the preceding version.

Rtype string

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

Ttl int

(Updatable) The Time To Live for the record, in seconds.

ZoneNameOrId string

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

CompartmentId string

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

Domain string

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

IsProtected bool

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

Rdata string

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

RecordHash string

A unique identifier for the record within its zone.

RrsetVersion string

The latest version of the record's zone in which its RRSet differs from the preceding version.

Rtype string

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

Ttl int

(Updatable) The Time To Live for the record, in seconds.

ZoneNameOrId string

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

compartmentId String

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

domain String

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

isProtected Boolean

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

rdata String

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

recordHash String

A unique identifier for the record within its zone.

rrsetVersion String

The latest version of the record's zone in which its RRSet differs from the preceding version.

rtype String

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

ttl Integer

(Updatable) The Time To Live for the record, in seconds.

zoneNameOrId String

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

compartmentId string

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

domain string

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

isProtected boolean

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

rdata string

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

recordHash string

A unique identifier for the record within its zone.

rrsetVersion string

The latest version of the record's zone in which its RRSet differs from the preceding version.

rtype string

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

ttl number

(Updatable) The Time To Live for the record, in seconds.

zoneNameOrId string

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

compartment_id str

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

domain str

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

is_protected bool

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

rdata str

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

record_hash str

A unique identifier for the record within its zone.

rrset_version str

The latest version of the record's zone in which its RRSet differs from the preceding version.

rtype str

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

ttl int

(Updatable) The Time To Live for the record, in seconds.

zone_name_or_id str

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

compartmentId String

(Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.

domain String

The fully qualified domain name where the record can be located. Domain value is case insensitive.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

isProtected Boolean

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

rdata String

(Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

recordHash String

A unique identifier for the record within its zone.

rrsetVersion String

The latest version of the record's zone in which its RRSet differs from the preceding version.

rtype String

The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

ttl Number

(Updatable) The Time To Live for the record, in seconds.

zoneNameOrId String

The name or OCID of the target zone.

Deprecated:

The 'oci_dns_record' resource has been deprecated. Please use 'oci_dns_rrset' instead.

Package Details

Repository
oci pulumi/pulumi-oci
License
Apache-2.0
Notes

This Pulumi package is based on the oci Terraform Provider.