Class ManagedZone

A zone is a subtree of the DNS namespace under one administrative responsibility. A ManagedZone is a resource that represents a DNS zone hosted by the Cloud DNS service.

To get more information about ManagedZone, see:

• API documentation
• How-to Guides
• Managing Zones

Example Usage - Dns Managed Zone Basic

using Pulumi;
using Gcp = Pulumi.Gcp;

class MyStack : Stack
{
public MyStack()
{
    var example_zone = new Gcp.Dns.ManagedZone("example-zone", new Gcp.Dns.ManagedZoneArgs
    {
        Description = "Example DNS zone",
        DnsName = "my-domain.com.",
        Labels = 
        {
            { "foo", "bar" },
        },
    });
}

}

Inheritance

System.Object

Resource

CustomResource

ManagedZone

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.Gcp.Dns

Assembly: Pulumi.Gcp.dll

Syntax

public class ManagedZone : CustomResource

Constructors

ManagedZone(String, ManagedZoneArgs, CustomResourceOptions)

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

Declaration

public ManagedZone(string name, ManagedZoneArgs args, CustomResourceOptions options = null)

Parameters

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

Properties

Description

A textual description field. Defaults to 'Managed by Pulumi'.

Declaration

public Output<string> Description { get; }

Property Value

Type	Description
Output<System.String>

DnsName

The DNS name of this managed zone, for instance "example.com.".

Declaration

public Output<string> DnsName { get; }

Property Value

Type	Description
Output<System.String>

DnssecConfig

DNSSEC configuration Structure is documented below.

Declaration

public Output<ManagedZoneDnssecConfig> DnssecConfig { get; }

Property Value

Type	Description
Output<ManagedZoneDnssecConfig>

ForwardingConfig

The presence for this field indicates that outbound forwarding is enabled for this zone. The value of this field contains the set of destinations to forward to. Structure is documented below.

Declaration

public Output<ManagedZoneForwardingConfig> ForwardingConfig { get; }

Property Value

Type	Description
Output<ManagedZoneForwardingConfig>

Labels

A set of key/value label pairs to assign to this ManagedZone.

Declaration

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

Property Value

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

Name

User assigned name for this resource. Must be unique within the project.

Declaration

public Output<string> Name { get; }

Property Value

Type	Description
Output<System.String>

NameServers

Delegate your managed_zone to these virtual name servers; defined by the server

Declaration

public Output<ImmutableArray<string>> NameServers { get; }

Property Value

Type	Description
Output<System.Collections.Immutable.ImmutableArray<System.String>>

PeeringConfig

The presence of this field indicates that DNS Peering is enabled for this zone. The value of this field contains the network to peer with. Structure is documented below.

Declaration

public Output<ManagedZonePeeringConfig> PeeringConfig { get; }

Property Value

Type	Description
Output<ManagedZonePeeringConfig>

PrivateVisibilityConfig

For privately visible zones, the set of Virtual Private Cloud resources that the zone is visible from. Structure is documented below.

Declaration

public Output<ManagedZonePrivateVisibilityConfig> PrivateVisibilityConfig { get; }

Property Value

Type	Description
Output<ManagedZonePrivateVisibilityConfig>

Project

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Declaration

public Output<string> Project { get; }

Property Value

Type	Description
Output<System.String>

ReverseLookup

Specifies if this is a managed reverse lookup zone. If true, Cloud DNS will resolve reverse lookup queries using automatically configured records for VPC resources. This only applies to networks listed under private_visibility_config.

Declaration

public Output<bool?> ReverseLookup { get; }

Property Value

Type	Description
Output<System.Nullable<System.Boolean>>

ServiceDirectoryConfig

The presence of this field indicates that this zone is backed by Service Directory. The value of this field contains information related to the namespace associated with the zone. Structure is documented below.

Declaration

public Output<ManagedZoneServiceDirectoryConfig> ServiceDirectoryConfig { get; }

Property Value

Type	Description
Output<ManagedZoneServiceDirectoryConfig>

Visibility

The zone's visibility: public zones are exposed to the Internet, while private zones are visible only to Virtual Private Cloud resources.

Declaration

public Output<string> Visibility { get; }

Property Value

Type	Description
Output<System.String>

Methods

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

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

Declaration

public static ManagedZone Get(string name, Input<string> id, ManagedZoneState 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.
ManagedZoneState	state	Any extra arguments used during the lookup.
CustomResourceOptions	options	A bag of options that control this resource's behavior

Returns

Type	Description
ManagedZone