pulumi-azure-kotlin/com.pulumi.azure.stack.kotlin/HciLogicalNetwork

HciLogicalNetwork

class HciLogicalNetwork : KotlinCustomResource

Manages an Azure Stack HCI Logical Network.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";
const example = new azure.core.ResourceGroup("example", {
    name: "example-rg",
    location: "West Europe",
});
const exampleHciLogicalNetwork = new azure.stack.HciLogicalNetwork("example", {
    name: "example-hci-ln",
    resourceGroupName: example.name,
    location: example.location,
    customLocationId: "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/cl1",
    virtualSwitchName: "ConvergedSwitch(managementcompute)",
    dnsServers: [
        "10.0.0.7",
        "10.0.0.8",
    ],
    subnet: {
        ipAllocationMethod: "Static",
        addressPrefix: "10.0.0.0/24",
        routes: [{
            name: "example-route",
            addressPrefix: "0.0.0.0/0",
            nextHopIpAddress: "10.0.20.1",
        }],
        vlanId: 123,
    },
    tags: {
        foo: "bar",
    },
});
Content copied to clipboard
import pulumi
import pulumi_azure as azure
example = azure.core.ResourceGroup("example",
    name="example-rg",
    location="West Europe")
example_hci_logical_network = azure.stack.HciLogicalNetwork("example",
    name="example-hci-ln",
    resource_group_name=example.name,
    location=example.location,
    custom_location_id="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/cl1",
    virtual_switch_name="ConvergedSwitch(managementcompute)",
    dns_servers=[
        "10.0.0.7",
        "10.0.0.8",
    ],
    subnet={
        "ip_allocation_method": "Static",
        "address_prefix": "10.0.0.0/24",
        "routes": [{
            "name": "example-route",
            "address_prefix": "0.0.0.0/0",
            "next_hop_ip_address": "10.0.20.1",
        }],
        "vlan_id": 123,
    },
    tags={
        "foo": "bar",
    })
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;
return await Deployment.RunAsync(() =>
{
    var example = new Azure.Core.ResourceGroup("example", new()
    {
        Name = "example-rg",
        Location = "West Europe",
    });
    var exampleHciLogicalNetwork = new Azure.Stack.HciLogicalNetwork("example", new()
    {
        Name = "example-hci-ln",
        ResourceGroupName = example.Name,
        Location = example.Location,
        CustomLocationId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/cl1",
        VirtualSwitchName = "ConvergedSwitch(managementcompute)",
        DnsServers = new[]
        {
            "10.0.0.7",
            "10.0.0.8",
        },
        Subnet = new Azure.Stack.Inputs.HciLogicalNetworkSubnetArgs
        {
            IpAllocationMethod = "Static",
            AddressPrefix = "10.0.0.0/24",
            Routes = new[]
            {
                new Azure.Stack.Inputs.HciLogicalNetworkSubnetRouteArgs
                {
                    Name = "example-route",
                    AddressPrefix = "0.0.0.0/0",
                    NextHopIpAddress = "10.0.20.1",
                },
            },
            VlanId = 123,
        },
        Tags =
        {
            { "foo", "bar" },
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/stack"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
			Name:     pulumi.String("example-rg"),
			Location: pulumi.String("West Europe"),
		})
		if err != nil {
			return err
		}
		_, err = stack.NewHciLogicalNetwork(ctx, "example", &stack.HciLogicalNetworkArgs{
			Name:              pulumi.String("example-hci-ln"),
			ResourceGroupName: example.Name,
			Location:          example.Location,
			CustomLocationId:  pulumi.String("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/cl1"),
			VirtualSwitchName: pulumi.String("ConvergedSwitch(managementcompute)"),
			DnsServers: pulumi.StringArray{
				pulumi.String("10.0.0.7"),
				pulumi.String("10.0.0.8"),
			},
			Subnet: &stack.HciLogicalNetworkSubnetArgs{
				IpAllocationMethod: pulumi.String("Static"),
				AddressPrefix:      pulumi.String("10.0.0.0/24"),
				Routes: stack.HciLogicalNetworkSubnetRouteArray{
					&stack.HciLogicalNetworkSubnetRouteArgs{
						Name:             pulumi.String("example-route"),
						AddressPrefix:    pulumi.String("0.0.0.0/0"),
						NextHopIpAddress: pulumi.String("10.0.20.1"),
					},
				},
				VlanId: pulumi.Int(123),
			},
			Tags: pulumi.StringMap{
				"foo": pulumi.String("bar"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.stack.HciLogicalNetwork;
import com.pulumi.azure.stack.HciLogicalNetworkArgs;
import com.pulumi.azure.stack.inputs.HciLogicalNetworkSubnetArgs;
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 example = new ResourceGroup("example", ResourceGroupArgs.builder()
            .name("example-rg")
            .location("West Europe")
            .build());
        var exampleHciLogicalNetwork = new HciLogicalNetwork("exampleHciLogicalNetwork", HciLogicalNetworkArgs.builder()
            .name("example-hci-ln")
            .resourceGroupName(example.name())
            .location(example.location())
            .customLocationId("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/cl1")
            .virtualSwitchName("ConvergedSwitch(managementcompute)")
            .dnsServers(
                "10.0.0.7",
                "10.0.0.8")
            .subnet(HciLogicalNetworkSubnetArgs.builder()
                .ipAllocationMethod("Static")
                .addressPrefix("10.0.0.0/24")
                .routes(HciLogicalNetworkSubnetRouteArgs.builder()
                    .name("example-route")
                    .addressPrefix("0.0.0.0/0")
                    .nextHopIpAddress("10.0.20.1")
                    .build())
                .vlanId(123)
                .build())
            .tags(Map.of("foo", "bar"))
            .build());
    }
}
Content copied to clipboard
resources:
  example:
    type: azure:core:ResourceGroup
    properties:
      name: example-rg
      location: West Europe
  exampleHciLogicalNetwork:
    type: azure:stack:HciLogicalNetwork
    name: example
    properties:
      name: example-hci-ln
      resourceGroupName: ${example.name}
      location: ${example.location}
      customLocationId: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/cl1
      virtualSwitchName: ConvergedSwitch(managementcompute)
      dnsServers:
        - 10.0.0.7
        - 10.0.0.8
      subnet:
        ipAllocationMethod: Static
        addressPrefix: 10.0.0.0/24
        routes:
          - name: example-route
            addressPrefix: 0.0.0.0/0
            nextHopIpAddress: 10.0.20.1
        vlanId: 123
      tags:
        foo: bar
Content copied to clipboard

Import

Azure Stack HCI Logical Networks can be imported using the resource id, e.g.

$ pulumi import azure:stack/hciLogicalNetwork:HciLogicalNetwork example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.AzureStackHCI/logicalNetworks/ln1
Content copied to clipboard

Properties

Link copied to clipboard
val customLocationId: Output<String>

The ID of Custom Location where the Azure Stack HCI Logical Network should exist. Changing this forces a new resource to be created.

Link copied to clipboard
val dnsServers: Output<List<String>>?

A list of IPv4 addresses of DNS servers available to VMs deployed in the Logical Networks. Changing this forces a new resource to be created.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val location: Output<String>

The Azure Region where the Azure Stack HCI Logical Network should exist. Changing this forces a new resource to be created.

Link copied to clipboard
val name: Output<String>

The name which should be used for this Azure Stack HCI Logical Network. Changing this forces a new resource to be created.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val resourceGroupName: Output<String>

The name of the Resource Group where the Azure Stack HCI Logical Network should exist. Changing this forces a new resource to be created.

Link copied to clipboard
val subnet: Output<HciLogicalNetworkSubnet>

A subnet block as defined below. Changing this forces a new resource to be created.

Link copied to clipboard
val tags: Output<Map<String, String>>?

A mapping of tags which should be assigned to the Azure Stack HCI Logical Network.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val virtualSwitchName: Output<String>

The name of the virtual switch on the cluster used to associate with the Azure Stack HCI Logical Network. Possible switch names can be retrieved by following this Azure guide. Changing this forces a new resource to be created.