1. Packages
  2. Civo
  3. API Docs
  4. DnsDomainRecord
Civo v2.3.8 published on Tuesday, Jul 25, 2023 by Pulumi

civo.DnsDomainRecord

Explore with Pulumi AI

civo logo
Civo v2.3.8 published on Tuesday, Jul 25, 2023 by Pulumi

    Provides a Civo DNS domain record resource.

    Create DnsDomainRecord Resource

    new DnsDomainRecord(name: string, args: DnsDomainRecordArgs, opts?: CustomResourceOptions);
    @overload
    def DnsDomainRecord(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        domain_id: Optional[str] = None,
                        name: Optional[str] = None,
                        priority: Optional[int] = None,
                        ttl: Optional[int] = None,
                        type: Optional[str] = None,
                        value: Optional[str] = None)
    @overload
    def DnsDomainRecord(resource_name: str,
                        args: DnsDomainRecordArgs,
                        opts: Optional[ResourceOptions] = None)
    func NewDnsDomainRecord(ctx *Context, name string, args DnsDomainRecordArgs, opts ...ResourceOption) (*DnsDomainRecord, error)
    public DnsDomainRecord(string name, DnsDomainRecordArgs args, CustomResourceOptions? opts = null)
    public DnsDomainRecord(String name, DnsDomainRecordArgs args)
    public DnsDomainRecord(String name, DnsDomainRecordArgs args, CustomResourceOptions options)
    
    type: civo:DnsDomainRecord
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    name string
    The unique name of the resource.
    args DnsDomainRecordArgs
    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 DnsDomainRecordArgs
    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 DnsDomainRecordArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DnsDomainRecordArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DnsDomainRecordArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    DnsDomainRecord 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 DnsDomainRecord resource accepts the following input properties:

    DomainId string

    ID from domain name

    Ttl int

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    Type string

    The choice of RR type from a, cname, mx or txt

    Value string

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    Name string

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    Priority int

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    DomainId string

    ID from domain name

    Ttl int

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    Type string

    The choice of RR type from a, cname, mx or txt

    Value string

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    Name string

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    Priority int

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    domainId String

    ID from domain name

    ttl Integer

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    type String

    The choice of RR type from a, cname, mx or txt

    value String

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    name String

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    priority Integer

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    domainId string

    ID from domain name

    ttl number

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    type string

    The choice of RR type from a, cname, mx or txt

    value string

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    name string

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    priority number

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    domain_id str

    ID from domain name

    ttl int

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    type str

    The choice of RR type from a, cname, mx or txt

    value str

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    name str

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    priority int

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    domainId String

    ID from domain name

    ttl Number

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    type String

    The choice of RR type from a, cname, mx or txt

    value String

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    name String

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    priority Number

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    Outputs

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

    AccountId string

    The account ID of this resource

    CreatedAt string

    Timestamp when this resource was created

    Id string

    The provider-assigned unique ID for this managed resource.

    UpdatedAt string

    Timestamp when this resource was updated

    AccountId string

    The account ID of this resource

    CreatedAt string

    Timestamp when this resource was created

    Id string

    The provider-assigned unique ID for this managed resource.

    UpdatedAt string

    Timestamp when this resource was updated

    accountId String

    The account ID of this resource

    createdAt String

    Timestamp when this resource was created

    id String

    The provider-assigned unique ID for this managed resource.

    updatedAt String

    Timestamp when this resource was updated

    accountId string

    The account ID of this resource

    createdAt string

    Timestamp when this resource was created

    id string

    The provider-assigned unique ID for this managed resource.

    updatedAt string

    Timestamp when this resource was updated

    account_id str

    The account ID of this resource

    created_at str

    Timestamp when this resource was created

    id str

    The provider-assigned unique ID for this managed resource.

    updated_at str

    Timestamp when this resource was updated

    accountId String

    The account ID of this resource

    createdAt String

    Timestamp when this resource was created

    id String

    The provider-assigned unique ID for this managed resource.

    updatedAt String

    Timestamp when this resource was updated

    Look up Existing DnsDomainRecord Resource

    Get an existing DnsDomainRecord 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?: DnsDomainRecordState, opts?: CustomResourceOptions): DnsDomainRecord
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            account_id: Optional[str] = None,
            created_at: Optional[str] = None,
            domain_id: Optional[str] = None,
            name: Optional[str] = None,
            priority: Optional[int] = None,
            ttl: Optional[int] = None,
            type: Optional[str] = None,
            updated_at: Optional[str] = None,
            value: Optional[str] = None) -> DnsDomainRecord
    func GetDnsDomainRecord(ctx *Context, name string, id IDInput, state *DnsDomainRecordState, opts ...ResourceOption) (*DnsDomainRecord, error)
    public static DnsDomainRecord Get(string name, Input<string> id, DnsDomainRecordState? state, CustomResourceOptions? opts = null)
    public static DnsDomainRecord get(String name, Output<String> id, DnsDomainRecordState 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:
    AccountId string

    The account ID of this resource

    CreatedAt string

    Timestamp when this resource was created

    DomainId string

    ID from domain name

    Name string

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    Priority int

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    Ttl int

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    Type string

    The choice of RR type from a, cname, mx or txt

    UpdatedAt string

    Timestamp when this resource was updated

    Value string

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    AccountId string

    The account ID of this resource

    CreatedAt string

    Timestamp when this resource was created

    DomainId string

    ID from domain name

    Name string

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    Priority int

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    Ttl int

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    Type string

    The choice of RR type from a, cname, mx or txt

    UpdatedAt string

    Timestamp when this resource was updated

    Value string

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    accountId String

    The account ID of this resource

    createdAt String

    Timestamp when this resource was created

    domainId String

    ID from domain name

    name String

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    priority Integer

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    ttl Integer

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    type String

    The choice of RR type from a, cname, mx or txt

    updatedAt String

    Timestamp when this resource was updated

    value String

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    accountId string

    The account ID of this resource

    createdAt string

    Timestamp when this resource was created

    domainId string

    ID from domain name

    name string

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    priority number

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    ttl number

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    type string

    The choice of RR type from a, cname, mx or txt

    updatedAt string

    Timestamp when this resource was updated

    value string

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    account_id str

    The account ID of this resource

    created_at str

    Timestamp when this resource was created

    domain_id str

    ID from domain name

    name str

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    priority int

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    ttl int

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    type str

    The choice of RR type from a, cname, mx or txt

    updated_at str

    Timestamp when this resource was updated

    value str

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    accountId String

    The account ID of this resource

    createdAt String

    Timestamp when this resource was created

    domainId String

    ID from domain name

    name String

    The portion before the domain name (e.g. www) or an @ for the apex/root domain (you cannot use an A record with an amex/root domain)

    priority Number

    Useful for MX records only, the priority mail should be attempted it (defaults to 10)

    ttl Number

    How long caching DNS servers should cache this record for, in seconds (the minimum is 600 and the default if unspecified is 600)

    type String

    The choice of RR type from a, cname, mx or txt

    updatedAt String

    Timestamp when this resource was updated

    value String

    The IP address (A or MX), hostname (CNAME or MX) or text value (TXT) to serve for this record

    Import

    using domain_id:domain_record_id

     $ pulumi import civo:index/dnsDomainRecord:DnsDomainRecord www a3cd6832-9577-4017-afd7-17d239fc0bf0:c9a39d14-ee1b-4870-8fb0-a2d4f465e822
    

    Package Details

    Repository
    Civo pulumi/pulumi-civo
    License
    Apache-2.0
    Notes

    This Pulumi package is based on the civo Terraform Provider.

    civo logo
    Civo v2.3.8 published on Tuesday, Jul 25, 2023 by Pulumi