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 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",
})
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",
},
});
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:
- Resource
Group stringName - The name of the resource group. The name is case insensitive.
- Virtual
Network Pulumi.Azure Native. Network. Inputs. Sub Resource - The reference to the virtual network. This cannot be changed after creation.
- Dns
Resolver stringName - The name of the DNS resolver.
- Location string
- The geo-location where the resource lives
- Dictionary<string, string>
- Resource tags.
- Resource
Group stringName - 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 stringName - The name of the DNS resolver.
- Location string
- The geo-location where the resource lives
- map[string]string
- Resource tags.
- resource
Group StringName - The name of the resource group. The name is case insensitive.
- virtual
Network SubResource - The reference to the virtual network. This cannot be changed after creation.
- dns
Resolver StringName - The name of the DNS resolver.
- location String
- The geo-location where the resource lives
- Map<String,String>
- Resource tags.
- resource
Group stringName - The name of the resource group. The name is case insensitive.
- virtual
Network SubResource - The reference to the virtual network. This cannot be changed after creation.
- dns
Resolver 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.
- resource
Group StringName - The name of the resource group. The name is case insensitive.
- virtual
Network Property Map - The reference to the virtual network. This cannot be changed after creation.
- dns
Resolver 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:
- Dns
Resolver 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
- Provisioning
State 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.
- Resource
Guid string - The resourceGuid property of the DNS resolver resource.
- System
Data 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"
- Dns
Resolver 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
- Provisioning
State 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.
- Resource
Guid string - The resourceGuid property of the DNS resolver resource.
- System
Data 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 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
- provisioning
State 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.
- resource
Guid String - The resourceGuid property of the DNS resolver resource.
- system
Data 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 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
- provisioning
State 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.
- resource
Guid string - The resourceGuid property of the DNS resolver resource.
- system
Data 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"
- dns
Resolver 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
- provisioning
State 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.
- resource
Guid String - The resourceGuid property of the DNS resolver resource.
- system
Data 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
- Created
At string - The timestamp of resource creation (UTC).
- Created
By string - The identity that created the resource.
- Created
By stringType - The type of identity that created the resource.
- Last
Modified stringAt - The type of identity that last modified the resource.
- Last
Modified stringBy - The identity that last modified the resource.
- Last
Modified stringBy Type - The type of identity that last modified the resource.
- Created
At string - The timestamp of resource creation (UTC).
- Created
By string - The identity that created the resource.
- Created
By stringType - The type of identity that created the resource.
- Last
Modified stringAt - The type of identity that last modified the resource.
- Last
Modified stringBy - The identity that last modified the resource.
- Last
Modified stringBy Type - The type of identity that last modified the resource.
- created
At String - The timestamp of resource creation (UTC).
- created
By String - The identity that created the resource.
- created
By StringType - The type of identity that created the resource.
- last
Modified StringAt - The type of identity that last modified the resource.
- last
Modified StringBy - The identity that last modified the resource.
- last
Modified StringBy Type - The type of identity that last modified the resource.
- created
At string - The timestamp of resource creation (UTC).
- created
By string - The identity that created the resource.
- created
By stringType - The type of identity that created the resource.
- last
Modified stringAt - The type of identity that last modified the resource.
- last
Modified stringBy - The identity that last modified the resource.
- last
Modified 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.
- created
At String - The timestamp of resource creation (UTC).
- created
By String - The identity that created the resource.
- created
By StringType - The type of identity that created the resource.
- last
Modified StringAt - The type of identity that last modified the resource.
- last
Modified StringBy - The identity that last modified the resource.
- last
Modified 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