1. Packages
  2. Azure Native
  3. API Docs
  4. network
  5. RoutingIntent
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.38.0 published on Monday, Apr 22, 2024 by Pulumi

azure-native.network.RoutingIntent

Explore with Pulumi AI

azure-native logo
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.38.0 published on Monday, Apr 22, 2024 by Pulumi

    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.

    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 (
    	"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.

    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:

    ResourceGroupName string
    The resource group name of the RoutingIntent.
    VirtualHubName string
    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.
    RoutingIntentName string
    The name of the per VirtualHub singleton Routing Intent resource.
    RoutingPolicies List<Pulumi.AzureNative.Network.Inputs.RoutingPolicy>
    List of routing policies.
    ResourceGroupName string
    The resource group name of the RoutingIntent.
    VirtualHubName string
    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.
    RoutingIntentName string
    The name of the per VirtualHub singleton Routing Intent resource.
    RoutingPolicies []RoutingPolicyArgs
    List of routing policies.
    resourceGroupName String
    The resource group name of the RoutingIntent.
    virtualHubName String
    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.
    routingIntentName String
    The name of the per VirtualHub singleton Routing Intent resource.
    routingPolicies List<RoutingPolicy>
    List of routing policies.
    resourceGroupName string
    The resource group name of the RoutingIntent.
    virtualHubName string
    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.
    routingIntentName string
    The name of the per VirtualHub singleton Routing Intent resource.
    routingPolicies RoutingPolicy[]
    List of routing policies.
    resource_group_name str
    The resource group name of the RoutingIntent.
    virtual_hub_name str
    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_name str
    The name of the per VirtualHub singleton Routing Intent resource.
    routing_policies Sequence[RoutingPolicyArgs]
    List of routing policies.
    resourceGroupName String
    The resource group name of the RoutingIntent.
    virtualHubName String
    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.
    routingIntentName String
    The name of the per VirtualHub singleton Routing Intent resource.
    routingPolicies 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.
    ProvisioningState 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.
    ProvisioningState 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.
    provisioningState 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.
    provisioningState 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.
    provisioningState 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.
    NextHop 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.
    NextHop 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.
    nextHop 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.
    nextHop 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.
    nextHop 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.
    NextHop 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.
    NextHop 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.
    nextHop 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.
    nextHop 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.
    nextHop 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
    azure-native logo
    This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
    Azure Native v2.38.0 published on Monday, Apr 22, 2024 by Pulumi