azure-native.network.RoutingIntent
Explore with Pulumi AI
The routing intent child resource of a Virtual hub. Azure REST API version: 2023-02-01. Prior API version in Azure Native 1.x: 2022-01-01.
Other available API versions: 2023-04-01, 2023-05-01, 2023-06-01, 2023-09-01, 2023-11-01, 2024-01-01.
Example Usage
RouteTablePut
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var routingIntent = new AzureNative.Network.RoutingIntent("routingIntent", new()
{
ResourceGroupName = "rg1",
RoutingIntentName = "Intent1",
RoutingPolicies = new[]
{
new AzureNative.Network.Inputs.RoutingPolicyArgs
{
Destinations = new[]
{
"Internet",
},
Name = "InternetTraffic",
NextHop = "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1",
},
new AzureNative.Network.Inputs.RoutingPolicyArgs
{
Destinations = new[]
{
"PrivateTraffic",
},
Name = "PrivateTrafficPolicy",
NextHop = "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1",
},
},
VirtualHubName = "virtualHub1",
});
});
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.NewRoutingIntent(ctx, "routingIntent", &network.RoutingIntentArgs{
ResourceGroupName: pulumi.String("rg1"),
RoutingIntentName: pulumi.String("Intent1"),
RoutingPolicies: network.RoutingPolicyArray{
&network.RoutingPolicyArgs{
Destinations: pulumi.StringArray{
pulumi.String("Internet"),
},
Name: pulumi.String("InternetTraffic"),
NextHop: pulumi.String("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1"),
},
&network.RoutingPolicyArgs{
Destinations: pulumi.StringArray{
pulumi.String("PrivateTraffic"),
},
Name: pulumi.String("PrivateTrafficPolicy"),
NextHop: pulumi.String("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1"),
},
},
VirtualHubName: pulumi.String("virtualHub1"),
})
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.RoutingIntent;
import com.pulumi.azurenative.network.RoutingIntentArgs;
import com.pulumi.azurenative.network.inputs.RoutingPolicyArgs;
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 routingIntent = new RoutingIntent("routingIntent", RoutingIntentArgs.builder()
.resourceGroupName("rg1")
.routingIntentName("Intent1")
.routingPolicies(
RoutingPolicyArgs.builder()
.destinations("Internet")
.name("InternetTraffic")
.nextHop("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1")
.build(),
RoutingPolicyArgs.builder()
.destinations("PrivateTraffic")
.name("PrivateTrafficPolicy")
.nextHop("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1")
.build())
.virtualHubName("virtualHub1")
.build());
}
}
import pulumi
import pulumi_azure_native as azure_native
routing_intent = azure_native.network.RoutingIntent("routingIntent",
resource_group_name="rg1",
routing_intent_name="Intent1",
routing_policies=[
azure_native.network.RoutingPolicyArgs(
destinations=["Internet"],
name="InternetTraffic",
next_hop="/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1",
),
azure_native.network.RoutingPolicyArgs(
destinations=["PrivateTraffic"],
name="PrivateTrafficPolicy",
next_hop="/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1",
),
],
virtual_hub_name="virtualHub1")
import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";
const routingIntent = new azure_native.network.RoutingIntent("routingIntent", {
resourceGroupName: "rg1",
routingIntentName: "Intent1",
routingPolicies: [
{
destinations: ["Internet"],
name: "InternetTraffic",
nextHop: "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1",
},
{
destinations: ["PrivateTraffic"],
name: "PrivateTrafficPolicy",
nextHop: "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1",
},
],
virtualHubName: "virtualHub1",
});
resources:
routingIntent:
type: azure-native:network:RoutingIntent
properties:
resourceGroupName: rg1
routingIntentName: Intent1
routingPolicies:
- destinations:
- Internet
name: InternetTraffic
nextHop: /subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1
- destinations:
- PrivateTraffic
name: PrivateTrafficPolicy
nextHop: /subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/azureFirewalls/azfw1
virtualHubName: virtualHub1
Create RoutingIntent Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new RoutingIntent(name: string, args: RoutingIntentArgs, opts?: CustomResourceOptions);
@overload
def RoutingIntent(resource_name: str,
args: RoutingIntentArgs,
opts: Optional[ResourceOptions] = None)
@overload
def RoutingIntent(resource_name: str,
opts: Optional[ResourceOptions] = None,
resource_group_name: Optional[str] = None,
virtual_hub_name: Optional[str] = None,
id: Optional[str] = None,
name: Optional[str] = None,
routing_intent_name: Optional[str] = None,
routing_policies: Optional[Sequence[RoutingPolicyArgs]] = None)
func NewRoutingIntent(ctx *Context, name string, args RoutingIntentArgs, opts ...ResourceOption) (*RoutingIntent, error)
public RoutingIntent(string name, RoutingIntentArgs args, CustomResourceOptions? opts = null)
public RoutingIntent(String name, RoutingIntentArgs args)
public RoutingIntent(String name, RoutingIntentArgs args, CustomResourceOptions options)
type: azure-native:network:RoutingIntent
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 RoutingIntentArgs
- 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 RoutingIntentArgs
- 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 RoutingIntentArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args RoutingIntentArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args RoutingIntentArgs
- 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 routingIntentResource = new AzureNative.Network.RoutingIntent("routingIntentResource", new()
{
ResourceGroupName = "string",
VirtualHubName = "string",
Id = "string",
Name = "string",
RoutingIntentName = "string",
RoutingPolicies = new[]
{
new AzureNative.Network.Inputs.RoutingPolicyArgs
{
Destinations = new[]
{
"string",
},
Name = "string",
NextHop = "string",
},
},
});
example, err := network.NewRoutingIntent(ctx, "routingIntentResource", &network.RoutingIntentArgs{
ResourceGroupName: pulumi.String("string"),
VirtualHubName: pulumi.String("string"),
Id: pulumi.String("string"),
Name: pulumi.String("string"),
RoutingIntentName: pulumi.String("string"),
RoutingPolicies: network.RoutingPolicyArray{
&network.RoutingPolicyArgs{
Destinations: pulumi.StringArray{
pulumi.String("string"),
},
Name: pulumi.String("string"),
NextHop: pulumi.String("string"),
},
},
})
var routingIntentResource = new RoutingIntent("routingIntentResource", RoutingIntentArgs.builder()
.resourceGroupName("string")
.virtualHubName("string")
.id("string")
.name("string")
.routingIntentName("string")
.routingPolicies(RoutingPolicyArgs.builder()
.destinations("string")
.name("string")
.nextHop("string")
.build())
.build());
routing_intent_resource = azure_native.network.RoutingIntent("routingIntentResource",
resource_group_name="string",
virtual_hub_name="string",
id="string",
name="string",
routing_intent_name="string",
routing_policies=[azure_native.network.RoutingPolicyArgs(
destinations=["string"],
name="string",
next_hop="string",
)])
const routingIntentResource = new azure_native.network.RoutingIntent("routingIntentResource", {
resourceGroupName: "string",
virtualHubName: "string",
id: "string",
name: "string",
routingIntentName: "string",
routingPolicies: [{
destinations: ["string"],
name: "string",
nextHop: "string",
}],
});
type: azure-native:network:RoutingIntent
properties:
id: string
name: string
resourceGroupName: string
routingIntentName: string
routingPolicies:
- destinations:
- string
name: string
nextHop: string
virtualHubName: string
RoutingIntent Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The RoutingIntent resource accepts the following input properties:
- Resource
Group stringName - The resource group name of the RoutingIntent.
- Virtual
Hub stringName - The name of the VirtualHub.
- Id string
- Resource ID.
- Name string
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- Routing
Intent stringName - The name of the per VirtualHub singleton Routing Intent resource.
- Routing
Policies List<Pulumi.Azure Native. Network. Inputs. Routing Policy> - List of routing policies.
- Resource
Group stringName - The resource group name of the RoutingIntent.
- Virtual
Hub stringName - The name of the VirtualHub.
- Id string
- Resource ID.
- Name string
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- Routing
Intent stringName - The name of the per VirtualHub singleton Routing Intent resource.
- Routing
Policies []RoutingPolicy Args - List of routing policies.
- resource
Group StringName - The resource group name of the RoutingIntent.
- virtual
Hub StringName - The name of the VirtualHub.
- id String
- Resource ID.
- name String
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- routing
Intent StringName - The name of the per VirtualHub singleton Routing Intent resource.
- routing
Policies List<RoutingPolicy> - List of routing policies.
- resource
Group stringName - The resource group name of the RoutingIntent.
- virtual
Hub stringName - The name of the VirtualHub.
- id string
- Resource ID.
- name string
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- routing
Intent stringName - The name of the per VirtualHub singleton Routing Intent resource.
- routing
Policies RoutingPolicy[] - List of routing policies.
- resource_
group_ strname - The resource group name of the RoutingIntent.
- virtual_
hub_ strname - The name of the VirtualHub.
- id str
- Resource ID.
- name str
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- routing_
intent_ strname - The name of the per VirtualHub singleton Routing Intent resource.
- routing_
policies Sequence[RoutingPolicy Args] - List of routing policies.
- resource
Group StringName - The resource group name of the RoutingIntent.
- virtual
Hub StringName - The name of the VirtualHub.
- id String
- Resource ID.
- name String
- The name of the resource that is unique within a resource group. This name can be used to access the resource.
- routing
Intent StringName - The name of the per VirtualHub singleton Routing Intent resource.
- routing
Policies List<Property Map> - List of routing policies.
Outputs
All input properties are implicitly available as output properties. Additionally, the RoutingIntent resource produces the following output properties:
- Etag string
- A unique read-only string that changes whenever the resource is updated.
- Id string
- The provider-assigned unique ID for this managed resource.
- Provisioning
State string - The provisioning state of the RoutingIntent resource.
- Type string
- Resource type.
- Etag string
- A unique read-only string that changes whenever the resource is updated.
- Id string
- The provider-assigned unique ID for this managed resource.
- Provisioning
State string - The provisioning state of the RoutingIntent resource.
- Type string
- Resource type.
- etag String
- A unique read-only string that changes whenever the resource is updated.
- id String
- The provider-assigned unique ID for this managed resource.
- provisioning
State String - The provisioning state of the RoutingIntent resource.
- type String
- Resource type.
- etag string
- A unique read-only string that changes whenever the resource is updated.
- id string
- The provider-assigned unique ID for this managed resource.
- provisioning
State string - The provisioning state of the RoutingIntent resource.
- type string
- Resource type.
- etag str
- A unique read-only string that changes whenever the resource is updated.
- id str
- The provider-assigned unique ID for this managed resource.
- provisioning_
state str - The provisioning state of the RoutingIntent resource.
- type str
- Resource type.
- etag String
- A unique read-only string that changes whenever the resource is updated.
- id String
- The provider-assigned unique ID for this managed resource.
- provisioning
State String - The provisioning state of the RoutingIntent resource.
- type String
- Resource type.
Supporting Types
RoutingPolicy, RoutingPolicyArgs
- Destinations List<string>
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- Name string
- The unique name for the routing policy.
- Next
Hop string - The next hop resource id on which this routing policy is applicable to.
- Destinations []string
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- Name string
- The unique name for the routing policy.
- Next
Hop string - The next hop resource id on which this routing policy is applicable to.
- destinations List<String>
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- name String
- The unique name for the routing policy.
- next
Hop String - The next hop resource id on which this routing policy is applicable to.
- destinations string[]
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- name string
- The unique name for the routing policy.
- next
Hop string - The next hop resource id on which this routing policy is applicable to.
- destinations Sequence[str]
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- name str
- The unique name for the routing policy.
- next_
hop str - The next hop resource id on which this routing policy is applicable to.
- destinations List<String>
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- name String
- The unique name for the routing policy.
- next
Hop String - The next hop resource id on which this routing policy is applicable to.
RoutingPolicyResponse, RoutingPolicyResponseArgs
- Destinations List<string>
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- Name string
- The unique name for the routing policy.
- Next
Hop string - The next hop resource id on which this routing policy is applicable to.
- Destinations []string
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- Name string
- The unique name for the routing policy.
- Next
Hop string - The next hop resource id on which this routing policy is applicable to.
- destinations List<String>
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- name String
- The unique name for the routing policy.
- next
Hop String - The next hop resource id on which this routing policy is applicable to.
- destinations string[]
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- name string
- The unique name for the routing policy.
- next
Hop string - The next hop resource id on which this routing policy is applicable to.
- destinations Sequence[str]
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- name str
- The unique name for the routing policy.
- next_
hop str - The next hop resource id on which this routing policy is applicable to.
- destinations List<String>
- List of all destinations which this routing policy is applicable to (for example: Internet, PrivateTraffic).
- name String
- The unique name for the routing policy.
- next
Hop String - The next hop resource id on which this routing policy is applicable to.
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:network:RoutingIntent Intent1 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/routingIntent/{routingIntentName}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0