Dns Forwarding Ruleset
Describes a DNS forwarding ruleset. Uses Azure REST API version 2023-07-01-preview. Other available API versions: 2020-04-01-preview, 2022-07-01. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native dnsresolver [ApiVersion]
. See the ../../../version-guide/#accessing-any-api-version-via-local-packages for details.
Example Usage
Upsert DNS forwarding ruleset
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var dnsForwardingRuleset = new AzureNative.DnsResolver.DnsForwardingRuleset("dnsForwardingRuleset", new()
{
DnsForwardingRulesetName = "samplednsForwardingRuleset",
DnsResolverOutboundEndpoints = new[]
{
new AzureNative.DnsResolver.Inputs.SubResourceArgs
{
Id = "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint0",
},
new AzureNative.DnsResolver.Inputs.SubResourceArgs
{
Id = "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint1",
},
},
Location = "westus2",
ResourceGroupName = "sampleResourceGroup",
Tags =
{
{ "key1", "value1" },
},
});
});
package main
import (
dnsresolver "github.com/pulumi/pulumi-azure-native-sdk/dnsresolver/v3"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := dnsresolver.NewDnsForwardingRuleset(ctx, "dnsForwardingRuleset", &dnsresolver.DnsForwardingRulesetArgs{
DnsForwardingRulesetName: pulumi.String("samplednsForwardingRuleset"),
DnsResolverOutboundEndpoints: dnsresolver.SubResourceArray{
&dnsresolver.SubResourceArgs{
Id: pulumi.String("/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint0"),
},
&dnsresolver.SubResourceArgs{
Id: pulumi.String("/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint1"),
},
},
Location: pulumi.String("westus2"),
ResourceGroupName: pulumi.String("sampleResourceGroup"),
Tags: pulumi.StringMap{
"key1": pulumi.String("value1"),
},
})
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.dnsresolver.DnsForwardingRuleset;
import com.pulumi.azurenative.dnsresolver.DnsForwardingRulesetArgs;
import com.pulumi.azurenative.dnsresolver.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 dnsForwardingRuleset = new DnsForwardingRuleset("dnsForwardingRuleset", DnsForwardingRulesetArgs.builder()
.dnsForwardingRulesetName("samplednsForwardingRuleset")
.dnsResolverOutboundEndpoints(
SubResourceArgs.builder()
.id("/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint0")
.build(),
SubResourceArgs.builder()
.id("/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint1")
.build())
.location("westus2")
.resourceGroupName("sampleResourceGroup")
.tags(Map.of("key1", "value1"))
.build());
}
}
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:dnsresolver:DnsForwardingRuleset sampleDnsForwardingRuleset /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}
Properties
The Azure API version of the resource.
The reference to the DNS resolver outbound endpoints that are used to route DNS queries matching the forwarding rules in the ruleset to the target DNS servers.
The current provisioning state of the DNS forwarding ruleset. This is a read-only property and any attempt to set this value will be ignored.
The resourceGuid for the DNS forwarding ruleset.
Azure Resource Manager metadata containing createdBy and modifiedBy information.