NetworkInterface

class NetworkInterface : KotlinCustomResource

The network interface resource definition. Uses Azure REST API version 2022-12-15-preview. Other available API versions: 2023-07-01-preview, 2023-09-01-preview, 2024-01-01, 2024-02-01-preview, 2024-05-01-preview, 2024-07-15-preview, 2024-08-01-preview, 2024-10-01-preview, 2025-02-01-preview, 2025-04-01-preview.

Example Usage

PutNetworkInterface

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var networkInterface = new AzureNative.AzureStackHCI.NetworkInterface("networkInterface", new()
{
ExtendedLocation = new AzureNative.AzureStackHCI.Inputs.ExtendedLocationArgs
{
Name = "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
Type = AzureNative.AzureStackHCI.ExtendedLocationTypes.CustomLocation,
},
IpConfigurations = new[]
{
new AzureNative.AzureStackHCI.Inputs.IPConfigurationArgs
{
Name = "ipconfig-sample",
Properties = new AzureNative.AzureStackHCI.Inputs.IPConfigurationPropertiesArgs
{
Subnet = new AzureNative.AzureStackHCI.Inputs.IPConfigurationSubnetArgs
{
Id = "test-vnet",
},
},
},
},
Location = "West US2",
NetworkInterfaceName = "test-nic",
ResourceGroupName = "test-rg",
});
});
package main
import (
azurestackhci "github.com/pulumi/pulumi-azure-native-sdk/azurestackhci/v2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := azurestackhci.NewNetworkInterface(ctx, "networkInterface", &azurestackhci.NetworkInterfaceArgs{
ExtendedLocation: &azurestackhci.ExtendedLocationArgs{
Name: pulumi.String("/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location"),
Type: pulumi.String(azurestackhci.ExtendedLocationTypesCustomLocation),
},
IpConfigurations: azurestackhci.IPConfigurationArray{
&azurestackhci.IPConfigurationArgs{
Name: pulumi.String("ipconfig-sample"),
Properties: &azurestackhci.IPConfigurationPropertiesArgs{
Subnet: &azurestackhci.IPConfigurationSubnetArgs{
Id: pulumi.String("test-vnet"),
},
},
},
},
Location: pulumi.String("West US2"),
NetworkInterfaceName: pulumi.String("test-nic"),
ResourceGroupName: pulumi.String("test-rg"),
})
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.azurestackhci.NetworkInterface;
import com.pulumi.azurenative.azurestackhci.NetworkInterfaceArgs;
import com.pulumi.azurenative.azurestackhci.inputs.ExtendedLocationArgs;
import com.pulumi.azurenative.azurestackhci.inputs.IPConfigurationArgs;
import com.pulumi.azurenative.azurestackhci.inputs.IPConfigurationPropertiesArgs;
import com.pulumi.azurenative.azurestackhci.inputs.IPConfigurationSubnetArgs;
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 networkInterface = new NetworkInterface("networkInterface", NetworkInterfaceArgs.builder()
.extendedLocation(ExtendedLocationArgs.builder()
.name("/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location")
.type("CustomLocation")
.build())
.ipConfigurations(IPConfigurationArgs.builder()
.name("ipconfig-sample")
.properties(IPConfigurationPropertiesArgs.builder()
.subnet(IPConfigurationSubnetArgs.builder()
.id("test-vnet")
.build())
.build())
.build())
.location("West US2")
.networkInterfaceName("test-nic")
.resourceGroupName("test-rg")
.build());
}
}

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:azurestackhci:NetworkInterface test-nic /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/networkInterfaces/{networkInterfaceName}

Properties

Link copied to clipboard

DNS Settings for the interface

Link copied to clipboard

The extendedLocation of the resource.

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

IPConfigurations - A list of IPConfigurations of the network interface.

Link copied to clipboard
val location: Output<String>

The geo-location where the resource lives

Link copied to clipboard
val macAddress: Output<String>?

MacAddress - The MAC address of the network interface.

Link copied to clipboard
val name: Output<String>

The name of the resource

Link copied to clipboard

Provisioning state of the network interface.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard

The observed state of network interfaces

Link copied to clipboard

Azure Resource Manager metadata containing createdBy and modifiedBy information.

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

Resource tags.

Link copied to clipboard
val type: Output<String>

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

Link copied to clipboard
val urn: Output<String>