Forwarding Rule
Describes a forwarding rule within 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 forwarding rule in a DNS forwarding ruleset
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var forwardingRule = new AzureNative.DnsResolver.ForwardingRule("forwardingRule", new()
{
DnsForwardingRulesetName = "sampleDnsForwardingRuleset",
DomainName = "contoso.com.",
ForwardingRuleName = "sampleForwardingRule",
ForwardingRuleState = AzureNative.DnsResolver.ForwardingRuleState.Enabled,
Metadata =
{
{ "additionalProp1", "value1" },
},
ResourceGroupName = "sampleResourceGroup",
TargetDnsServers = new[]
{
new AzureNative.DnsResolver.Inputs.TargetDnsServerArgs
{
IpAddress = "10.0.0.1",
Port = 53,
},
new AzureNative.DnsResolver.Inputs.TargetDnsServerArgs
{
IpAddress = "10.0.0.2",
Port = 53,
},
},
});
});
package main
import (
dnsresolver "github.com/pulumi/pulumi-azure-native-sdk/dnsresolver/v2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := dnsresolver.NewForwardingRule(ctx, "forwardingRule", &dnsresolver.ForwardingRuleArgs{
DnsForwardingRulesetName: pulumi.String("sampleDnsForwardingRuleset"),
DomainName: pulumi.String("contoso.com."),
ForwardingRuleName: pulumi.String("sampleForwardingRule"),
ForwardingRuleState: pulumi.String(dnsresolver.ForwardingRuleStateEnabled),
Metadata: pulumi.StringMap{
"additionalProp1": pulumi.String("value1"),
},
ResourceGroupName: pulumi.String("sampleResourceGroup"),
TargetDnsServers: dnsresolver.TargetDnsServerArray{
&dnsresolver.TargetDnsServerArgs{
IpAddress: pulumi.String("10.0.0.1"),
Port: pulumi.Int(53),
},
&dnsresolver.TargetDnsServerArgs{
IpAddress: pulumi.String("10.0.0.2"),
Port: pulumi.Int(53),
},
},
})
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.ForwardingRule;
import com.pulumi.azurenative.dnsresolver.ForwardingRuleArgs;
import com.pulumi.azurenative.dnsresolver.inputs.TargetDnsServerArgs;
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 forwardingRule = new ForwardingRule("forwardingRule", ForwardingRuleArgs.builder()
.dnsForwardingRulesetName("sampleDnsForwardingRuleset")
.domainName("contoso.com.")
.forwardingRuleName("sampleForwardingRule")
.forwardingRuleState("Enabled")
.metadata(Map.of("additionalProp1", "value1"))
.resourceGroupName("sampleResourceGroup")
.targetDnsServers(
TargetDnsServerArgs.builder()
.ipAddress("10.0.0.1")
.port(53)
.build(),
TargetDnsServerArgs.builder()
.ipAddress("10.0.0.2")
.port(53)
.build())
.build());
}
}
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:dnsresolver:ForwardingRule sampleForwardingRule /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsForwardingRulesets/{dnsForwardingRulesetName}/forwardingRules/{forwardingRuleName}
Properties
The Azure API version of the resource.
The domain name for the forwarding rule.
The state of forwarding rule.
The current provisioning state of the forwarding rule. This is a read-only property and any attempt to set this value will be ignored.
Azure Resource Manager metadata containing createdBy and modifiedBy information.
DNS servers to forward the DNS query to.