azure-native.network.DnsResolver
Explore with Pulumi AI
Describes a DNS resolver. Azure REST API version: 2022-07-01. Prior API version in Azure Native 1.x: 2020-04-01-preview.
Other available API versions: 2023-07-01-preview.
Example Usage
Upsert DNS resolver
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() => 
{
    var dnsResolver = new AzureNative.Network.DnsResolver("dnsResolver", new()
    {
        DnsResolverName = "sampleDnsResolver",
        Location = "westus2",
        ResourceGroupName = "sampleResourceGroup",
        Tags = 
        {
            { "key1", "value1" },
        },
        VirtualNetwork = new AzureNative.Network.Inputs.SubResourceArgs
        {
            Id = "/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork",
        },
    });
});
package main
import (
	network "github.com/pulumi/pulumi-azure-native-sdk/network/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := network.NewDnsResolver(ctx, "dnsResolver", &network.DnsResolverArgs{
			DnsResolverName:   pulumi.String("sampleDnsResolver"),
			Location:          pulumi.String("westus2"),
			ResourceGroupName: pulumi.String("sampleResourceGroup"),
			Tags: pulumi.StringMap{
				"key1": pulumi.String("value1"),
			},
			VirtualNetwork: &network.SubResourceArgs{
				Id: pulumi.String("/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork"),
			},
		})
		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.azurenative.network.DnsResolver;
import com.pulumi.azurenative.network.DnsResolverArgs;
import com.pulumi.azurenative.network.inputs.SubResourceArgs;
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 dnsResolver = new DnsResolver("dnsResolver", DnsResolverArgs.builder()
            .dnsResolverName("sampleDnsResolver")
            .location("westus2")
            .resourceGroupName("sampleResourceGroup")
            .tags(Map.of("key1", "value1"))
            .virtualNetwork(SubResourceArgs.builder()
                .id("/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork")
                .build())
            .build());
    }
}
import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";
const dnsResolver = new azure_native.network.DnsResolver("dnsResolver", {
    dnsResolverName: "sampleDnsResolver",
    location: "westus2",
    resourceGroupName: "sampleResourceGroup",
    tags: {
        key1: "value1",
    },
    virtualNetwork: {
        id: "/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork",
    },
});
import pulumi
import pulumi_azure_native as azure_native
dns_resolver = azure_native.network.DnsResolver("dnsResolver",
    dns_resolver_name="sampleDnsResolver",
    location="westus2",
    resource_group_name="sampleResourceGroup",
    tags={
        "key1": "value1",
    },
    virtual_network={
        "id": "/subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork",
    })
resources:
  dnsResolver:
    type: azure-native:network:DnsResolver
    properties:
      dnsResolverName: sampleDnsResolver
      location: westus2
      resourceGroupName: sampleResourceGroup
      tags:
        key1: value1
      virtualNetwork:
        id: /subscriptions/cbb1387e-4b03-44f2-ad41-58d4677b9873/resourceGroups/virtualNetworkResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork
Create DnsResolver Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new DnsResolver(name: string, args: DnsResolverArgs, opts?: CustomResourceOptions);@overload
def DnsResolver(resource_name: str,
                args: DnsResolverArgs,
                opts: Optional[ResourceOptions] = None)
@overload
def DnsResolver(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                resource_group_name: Optional[str] = None,
                virtual_network: Optional[SubResourceArgs] = None,
                dns_resolver_name: Optional[str] = None,
                location: Optional[str] = None,
                tags: Optional[Mapping[str, str]] = None)func NewDnsResolver(ctx *Context, name string, args DnsResolverArgs, opts ...ResourceOption) (*DnsResolver, error)public DnsResolver(string name, DnsResolverArgs args, CustomResourceOptions? opts = null)
public DnsResolver(String name, DnsResolverArgs args)
public DnsResolver(String name, DnsResolverArgs args, CustomResourceOptions options)
type: azure-native:network:DnsResolver
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args DnsResolverArgs
- 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 DnsResolverArgs
- 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 DnsResolverArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DnsResolverArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DnsResolverArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var dnsResolverResource = new AzureNative.Network.DnsResolver("dnsResolverResource", new()
{
    ResourceGroupName = "string",
    VirtualNetwork = new AzureNative.Network.Inputs.SubResourceArgs
    {
        Id = "string",
    },
    DnsResolverName = "string",
    Location = "string",
    Tags = 
    {
        { "string", "string" },
    },
});
example, err := network.NewDnsResolver(ctx, "dnsResolverResource", &network.DnsResolverArgs{
	ResourceGroupName: pulumi.String("string"),
	VirtualNetwork: &network.SubResourceArgs{
		Id: pulumi.String("string"),
	},
	DnsResolverName: pulumi.String("string"),
	Location:        pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
})
var dnsResolverResource = new DnsResolver("dnsResolverResource", DnsResolverArgs.builder()
    .resourceGroupName("string")
    .virtualNetwork(SubResourceArgs.builder()
        .id("string")
        .build())
    .dnsResolverName("string")
    .location("string")
    .tags(Map.of("string", "string"))
    .build());
dns_resolver_resource = azure_native.network.DnsResolver("dnsResolverResource",
    resource_group_name="string",
    virtual_network={
        "id": "string",
    },
    dns_resolver_name="string",
    location="string",
    tags={
        "string": "string",
    })
const dnsResolverResource = new azure_native.network.DnsResolver("dnsResolverResource", {
    resourceGroupName: "string",
    virtualNetwork: {
        id: "string",
    },
    dnsResolverName: "string",
    location: "string",
    tags: {
        string: "string",
    },
});
type: azure-native:network:DnsResolver
properties:
    dnsResolverName: string
    location: string
    resourceGroupName: string
    tags:
        string: string
    virtualNetwork:
        id: string
DnsResolver Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The DnsResolver resource accepts the following input properties:
- ResourceGroup stringName 
- The name of the resource group. The name is case insensitive.
- VirtualNetwork Pulumi.Azure Native. Network. Inputs. Sub Resource 
- The reference to the virtual network. This cannot be changed after creation.
- DnsResolver stringName 
- The name of the DNS resolver.
- Location string
- The geo-location where the resource lives
- Dictionary<string, string>
- Resource tags.
- ResourceGroup stringName 
- The name of the resource group. The name is case insensitive.
- VirtualNetwork SubResource Args 
- The reference to the virtual network. This cannot be changed after creation.
- DnsResolver stringName 
- The name of the DNS resolver.
- Location string
- The geo-location where the resource lives
- map[string]string
- Resource tags.
- resourceGroup StringName 
- The name of the resource group. The name is case insensitive.
- virtualNetwork SubResource 
- The reference to the virtual network. This cannot be changed after creation.
- dnsResolver StringName 
- The name of the DNS resolver.
- location String
- The geo-location where the resource lives
- Map<String,String>
- Resource tags.
- resourceGroup stringName 
- The name of the resource group. The name is case insensitive.
- virtualNetwork SubResource 
- The reference to the virtual network. This cannot be changed after creation.
- dnsResolver stringName 
- The name of the DNS resolver.
- location string
- The geo-location where the resource lives
- {[key: string]: string}
- Resource tags.
- resource_group_ strname 
- The name of the resource group. The name is case insensitive.
- virtual_network SubResource Args 
- The reference to the virtual network. This cannot be changed after creation.
- dns_resolver_ strname 
- The name of the DNS resolver.
- location str
- The geo-location where the resource lives
- Mapping[str, str]
- Resource tags.
- resourceGroup StringName 
- The name of the resource group. The name is case insensitive.
- virtualNetwork Property Map
- The reference to the virtual network. This cannot be changed after creation.
- dnsResolver StringName 
- The name of the DNS resolver.
- location String
- The geo-location where the resource lives
- Map<String>
- Resource tags.
Outputs
All input properties are implicitly available as output properties. Additionally, the DnsResolver resource produces the following output properties:
- DnsResolver stringState 
- The current status of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- Etag string
- ETag of the DNS resolver.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The name of the resource
- ProvisioningState string
- The current provisioning state of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- ResourceGuid string
- The resourceGuid property of the DNS resolver resource.
- SystemData Pulumi.Azure Native. Network. Outputs. System Data Response 
- Metadata pertaining to creation and last modification of the resource.
- Type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- DnsResolver stringState 
- The current status of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- Etag string
- ETag of the DNS resolver.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The name of the resource
- ProvisioningState string
- The current provisioning state of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- ResourceGuid string
- The resourceGuid property of the DNS resolver resource.
- SystemData SystemData Response 
- Metadata pertaining to creation and last modification of the resource.
- Type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- dnsResolver StringState 
- The current status of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- etag String
- ETag of the DNS resolver.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The name of the resource
- provisioningState String
- The current provisioning state of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- resourceGuid String
- The resourceGuid property of the DNS resolver resource.
- systemData SystemData Response 
- Metadata pertaining to creation and last modification of the resource.
- type String
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- dnsResolver stringState 
- The current status of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- etag string
- ETag of the DNS resolver.
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- The name of the resource
- provisioningState string
- The current provisioning state of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- resourceGuid string
- The resourceGuid property of the DNS resolver resource.
- systemData SystemData Response 
- Metadata pertaining to creation and last modification of the resource.
- type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- dns_resolver_ strstate 
- The current status of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- etag str
- ETag of the DNS resolver.
- id str
- The provider-assigned unique ID for this managed resource.
- name str
- The name of the resource
- provisioning_state str
- The current provisioning state of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- resource_guid str
- The resourceGuid property of the DNS resolver resource.
- system_data SystemData Response 
- Metadata pertaining to creation and last modification of the resource.
- type str
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- dnsResolver StringState 
- The current status of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- etag String
- ETag of the DNS resolver.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The name of the resource
- provisioningState String
- The current provisioning state of the DNS resolver. This is a read-only property and any attempt to set this value will be ignored.
- resourceGuid String
- The resourceGuid property of the DNS resolver resource.
- systemData Property Map
- Metadata pertaining to creation and last modification of the resource.
- type String
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
Supporting Types
SubResource, SubResourceArgs    
- Id string
- Sub-resource ID. Both absolute resource ID and a relative resource ID are accepted. An absolute ID starts with /subscriptions/ and contains the entire ID of the parent resource and the ID of the sub-resource in the end. A relative ID replaces the ID of the parent resource with a token '$self', followed by the sub-resource ID itself. Example of a relative ID: $self/frontEndConfigurations/my-frontend.
- Id string
- Sub-resource ID. Both absolute resource ID and a relative resource ID are accepted. An absolute ID starts with /subscriptions/ and contains the entire ID of the parent resource and the ID of the sub-resource in the end. A relative ID replaces the ID of the parent resource with a token '$self', followed by the sub-resource ID itself. Example of a relative ID: $self/frontEndConfigurations/my-frontend.
- id String
- Sub-resource ID. Both absolute resource ID and a relative resource ID are accepted. An absolute ID starts with /subscriptions/ and contains the entire ID of the parent resource and the ID of the sub-resource in the end. A relative ID replaces the ID of the parent resource with a token '$self', followed by the sub-resource ID itself. Example of a relative ID: $self/frontEndConfigurations/my-frontend.
- id string
- Sub-resource ID. Both absolute resource ID and a relative resource ID are accepted. An absolute ID starts with /subscriptions/ and contains the entire ID of the parent resource and the ID of the sub-resource in the end. A relative ID replaces the ID of the parent resource with a token '$self', followed by the sub-resource ID itself. Example of a relative ID: $self/frontEndConfigurations/my-frontend.
- id str
- Sub-resource ID. Both absolute resource ID and a relative resource ID are accepted. An absolute ID starts with /subscriptions/ and contains the entire ID of the parent resource and the ID of the sub-resource in the end. A relative ID replaces the ID of the parent resource with a token '$self', followed by the sub-resource ID itself. Example of a relative ID: $self/frontEndConfigurations/my-frontend.
- id String
- Sub-resource ID. Both absolute resource ID and a relative resource ID are accepted. An absolute ID starts with /subscriptions/ and contains the entire ID of the parent resource and the ID of the sub-resource in the end. A relative ID replaces the ID of the parent resource with a token '$self', followed by the sub-resource ID itself. Example of a relative ID: $self/frontEndConfigurations/my-frontend.
SubResourceResponse, SubResourceResponseArgs      
- Id string
- Resource ID.
- Id string
- Resource ID.
- id String
- Resource ID.
- id string
- Resource ID.
- id str
- Resource ID.
- id String
- Resource ID.
SystemDataResponse, SystemDataResponseArgs      
- CreatedAt string
- The timestamp of resource creation (UTC).
- CreatedBy string
- The identity that created the resource.
- CreatedBy stringType 
- The type of identity that created the resource.
- LastModified stringAt 
- The type of identity that last modified the resource.
- LastModified stringBy 
- The identity that last modified the resource.
- LastModified stringBy Type 
- The type of identity that last modified the resource.
- CreatedAt string
- The timestamp of resource creation (UTC).
- CreatedBy string
- The identity that created the resource.
- CreatedBy stringType 
- The type of identity that created the resource.
- LastModified stringAt 
- The type of identity that last modified the resource.
- LastModified stringBy 
- The identity that last modified the resource.
- LastModified stringBy Type 
- The type of identity that last modified the resource.
- createdAt String
- The timestamp of resource creation (UTC).
- createdBy String
- The identity that created the resource.
- createdBy StringType 
- The type of identity that created the resource.
- lastModified StringAt 
- The type of identity that last modified the resource.
- lastModified StringBy 
- The identity that last modified the resource.
- lastModified StringBy Type 
- The type of identity that last modified the resource.
- createdAt string
- The timestamp of resource creation (UTC).
- createdBy string
- The identity that created the resource.
- createdBy stringType 
- The type of identity that created the resource.
- lastModified stringAt 
- The type of identity that last modified the resource.
- lastModified stringBy 
- The identity that last modified the resource.
- lastModified stringBy Type 
- The type of identity that last modified the resource.
- created_at str
- The timestamp of resource creation (UTC).
- created_by str
- The identity that created the resource.
- created_by_ strtype 
- The type of identity that created the resource.
- last_modified_ strat 
- The type of identity that last modified the resource.
- last_modified_ strby 
- The identity that last modified the resource.
- last_modified_ strby_ type 
- The type of identity that last modified the resource.
- createdAt String
- The timestamp of resource creation (UTC).
- createdBy String
- The identity that created the resource.
- createdBy StringType 
- The type of identity that created the resource.
- lastModified StringAt 
- The type of identity that last modified the resource.
- lastModified StringBy 
- The identity that last modified the resource.
- lastModified StringBy Type 
- The type of identity that last modified the resource.
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:network:DnsResolver sampleDnsResolver /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsResolvers/{dnsResolverName} 
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0