azure-native.networkcloud.L2Network
Explore with Pulumi AI
Uses Azure REST API version 2025-02-01. In version 2.x of the Azure Native provider, it used API version 2023-10-01-preview.
Other available API versions: 2023-10-01-preview, 2024-06-01-preview, 2024-07-01, 2024-10-01-preview. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native networkcloud [ApiVersion]
. See the version guide for details.
Create L2Network Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new L2Network(name: string, args: L2NetworkArgs, opts?: CustomResourceOptions);
@overload
def L2Network(resource_name: str,
args: L2NetworkArgs,
opts: Optional[ResourceOptions] = None)
@overload
def L2Network(resource_name: str,
opts: Optional[ResourceOptions] = None,
extended_location: Optional[ExtendedLocationArgs] = None,
l2_isolation_domain_id: Optional[str] = None,
resource_group_name: Optional[str] = None,
hybrid_aks_plugin_type: Optional[Union[str, HybridAksPluginType]] = None,
interface_name: Optional[str] = None,
l2_network_name: Optional[str] = None,
location: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None)
func NewL2Network(ctx *Context, name string, args L2NetworkArgs, opts ...ResourceOption) (*L2Network, error)
public L2Network(string name, L2NetworkArgs args, CustomResourceOptions? opts = null)
public L2Network(String name, L2NetworkArgs args)
public L2Network(String name, L2NetworkArgs args, CustomResourceOptions options)
type: azure-native:networkcloud:L2Network
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name
This property is required. string - The unique name of the resource.
- args
This property is required. L2NetworkArgs - The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name
This property is required. str - The unique name of the resource.
- args
This property is required. L2NetworkArgs - The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name
This property is required. string - The unique name of the resource.
- args
This property is required. L2NetworkArgs - The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name
This property is required. string - The unique name of the resource.
- args
This property is required. L2NetworkArgs - The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name
This property is required. String - The unique name of the resource.
- args
This property is required. L2NetworkArgs - 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 l2networkResource = new AzureNative.NetworkCloud.L2Network("l2networkResource", new()
{
ExtendedLocation = new AzureNative.NetworkCloud.Inputs.ExtendedLocationArgs
{
Name = "string",
Type = "string",
},
L2IsolationDomainId = "string",
ResourceGroupName = "string",
HybridAksPluginType = "string",
InterfaceName = "string",
L2NetworkName = "string",
Location = "string",
Tags =
{
{ "string", "string" },
},
});
example, err := networkcloud.NewL2Network(ctx, "l2networkResource", &networkcloud.L2NetworkArgs{
ExtendedLocation: &networkcloud.ExtendedLocationArgs{
Name: pulumi.String("string"),
Type: pulumi.String("string"),
},
L2IsolationDomainId: pulumi.String("string"),
ResourceGroupName: pulumi.String("string"),
HybridAksPluginType: pulumi.String("string"),
InterfaceName: pulumi.String("string"),
L2NetworkName: pulumi.String("string"),
Location: pulumi.String("string"),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
})
var l2networkResource = new L2Network("l2networkResource", L2NetworkArgs.builder()
.extendedLocation(ExtendedLocationArgs.builder()
.name("string")
.type("string")
.build())
.l2IsolationDomainId("string")
.resourceGroupName("string")
.hybridAksPluginType("string")
.interfaceName("string")
.l2NetworkName("string")
.location("string")
.tags(Map.of("string", "string"))
.build());
l2network_resource = azure_native.networkcloud.L2Network("l2networkResource",
extended_location={
"name": "string",
"type": "string",
},
l2_isolation_domain_id="string",
resource_group_name="string",
hybrid_aks_plugin_type="string",
interface_name="string",
l2_network_name="string",
location="string",
tags={
"string": "string",
})
const l2networkResource = new azure_native.networkcloud.L2Network("l2networkResource", {
extendedLocation: {
name: "string",
type: "string",
},
l2IsolationDomainId: "string",
resourceGroupName: "string",
hybridAksPluginType: "string",
interfaceName: "string",
l2NetworkName: "string",
location: "string",
tags: {
string: "string",
},
});
type: azure-native:networkcloud:L2Network
properties:
extendedLocation:
name: string
type: string
hybridAksPluginType: string
interfaceName: string
l2IsolationDomainId: string
l2NetworkName: string
location: string
resourceGroupName: string
tags:
string: string
L2Network Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The L2Network resource accepts the following input properties:
- Extended
Location This property is required. Pulumi.Azure Native. Network Cloud. Inputs. Extended Location - The extended location of the cluster associated with the resource.
- L2Isolation
Domain Id This property is required. Changes to this property will trigger replacement.
- The resource ID of the Network Fabric l2IsolationDomain.
- Resource
Group Name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- Hybrid
Aks Plugin Type Changes to this property will trigger replacement.
Azure Native. Network Cloud. Hybrid Aks Plugin Type - Field Deprecated. The field was previously optional, now it will have no defined behavior and will be ignored. The network plugin type for Hybrid AKS.
- Interface
Name Changes to this property will trigger replacement.
- The default interface name for this L2 network in the virtual machine. This name can be overridden by the name supplied in the network attachment configuration of that virtual machine.
- L2Network
Name Changes to this property will trigger replacement.
- The name of the L2 network.
- Location
Changes to this property will trigger replacement.
- The geo-location where the resource lives
- Dictionary<string, string>
- Resource tags.
- Extended
Location This property is required. ExtendedLocation Args - The extended location of the cluster associated with the resource.
- L2Isolation
Domain Id This property is required. Changes to this property will trigger replacement.
- The resource ID of the Network Fabric l2IsolationDomain.
- Resource
Group Name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- Hybrid
Aks Plugin Type Changes to this property will trigger replacement.
Aks Plugin Type - Field Deprecated. The field was previously optional, now it will have no defined behavior and will be ignored. The network plugin type for Hybrid AKS.
- Interface
Name Changes to this property will trigger replacement.
- The default interface name for this L2 network in the virtual machine. This name can be overridden by the name supplied in the network attachment configuration of that virtual machine.
- L2Network
Name Changes to this property will trigger replacement.
- The name of the L2 network.
- Location
Changes to this property will trigger replacement.
- The geo-location where the resource lives
- map[string]string
- Resource tags.
- extended
Location This property is required. ExtendedLocation - The extended location of the cluster associated with the resource.
- l2Isolation
Domain Id This property is required. Changes to this property will trigger replacement.
- The resource ID of the Network Fabric l2IsolationDomain.
- resource
Group Name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- hybrid
Aks Plugin Type Changes to this property will trigger replacement.
Aks Plugin Type - Field Deprecated. The field was previously optional, now it will have no defined behavior and will be ignored. The network plugin type for Hybrid AKS.
- interface
Name Changes to this property will trigger replacement.
- The default interface name for this L2 network in the virtual machine. This name can be overridden by the name supplied in the network attachment configuration of that virtual machine.
- l2Network
Name Changes to this property will trigger replacement.
- The name of the L2 network.
- location
Changes to this property will trigger replacement.
- The geo-location where the resource lives
- Map<String,String>
- Resource tags.
- extended
Location This property is required. ExtendedLocation - The extended location of the cluster associated with the resource.
- l2Isolation
Domain Id This property is required. Changes to this property will trigger replacement.
- The resource ID of the Network Fabric l2IsolationDomain.
- resource
Group Name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- hybrid
Aks Plugin Type Changes to this property will trigger replacement.
Aks Plugin Type - Field Deprecated. The field was previously optional, now it will have no defined behavior and will be ignored. The network plugin type for Hybrid AKS.
- interface
Name Changes to this property will trigger replacement.
- The default interface name for this L2 network in the virtual machine. This name can be overridden by the name supplied in the network attachment configuration of that virtual machine.
- l2Network
Name Changes to this property will trigger replacement.
- The name of the L2 network.
- location
Changes to this property will trigger replacement.
- The geo-location where the resource lives
- {[key: string]: string}
- Resource tags.
- extended_
location This property is required. ExtendedLocation Args - The extended location of the cluster associated with the resource.
- l2_
isolation_ domain_ id This property is required. Changes to this property will trigger replacement.
- The resource ID of the Network Fabric l2IsolationDomain.
- resource_
group_ name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- hybrid_
aks_ plugin_ type Changes to this property will trigger replacement.
Aks Plugin Type - Field Deprecated. The field was previously optional, now it will have no defined behavior and will be ignored. The network plugin type for Hybrid AKS.
- interface_
name Changes to this property will trigger replacement.
- The default interface name for this L2 network in the virtual machine. This name can be overridden by the name supplied in the network attachment configuration of that virtual machine.
- l2_
network_ name Changes to this property will trigger replacement.
- The name of the L2 network.
- location
Changes to this property will trigger replacement.
- The geo-location where the resource lives
- Mapping[str, str]
- Resource tags.
- extended
Location This property is required. Property Map - The extended location of the cluster associated with the resource.
- l2Isolation
Domain Id This property is required. Changes to this property will trigger replacement.
- The resource ID of the Network Fabric l2IsolationDomain.
- resource
Group Name This property is required. Changes to this property will trigger replacement.
- The name of the resource group. The name is case insensitive.
- hybrid
Aks Plugin Type Changes to this property will trigger replacement.
- Field Deprecated. The field was previously optional, now it will have no defined behavior and will be ignored. The network plugin type for Hybrid AKS.
- interface
Name Changes to this property will trigger replacement.
- The default interface name for this L2 network in the virtual machine. This name can be overridden by the name supplied in the network attachment configuration of that virtual machine.
- l2Network
Name Changes to this property will trigger replacement.
- The name of the L2 network.
- location
Changes to this property will trigger replacement.
- The geo-location where the resource lives
- Map<String>
- Resource tags.
Outputs
All input properties are implicitly available as output properties. Additionally, the L2Network resource produces the following output properties:
- Associated
Resource List<string>Ids - The list of resource IDs for the other Microsoft.NetworkCloud resources that have attached this network.
- Azure
Api stringVersion - The Azure API version of the resource.
- Cluster
Id string - The resource ID of the Network Cloud cluster this L2 network is associated with.
- Detailed
Status string - The more detailed status of the L2 network.
- Detailed
Status stringMessage - The descriptive message about the current detailed status.
- Etag string
- Resource ETag.
- Hybrid
Aks List<string>Clusters Associated Ids - Field Deprecated. These fields will be empty/omitted. The list of Hybrid AKS cluster resource ID(s) that are associated with this L2 network.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The name of the resource
- Provisioning
State string - The provisioning state of the L2 network.
- System
Data Pulumi.Azure Native. Network Cloud. Outputs. System Data Response - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- Type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- Virtual
Machines List<string>Associated Ids - Field Deprecated. These fields will be empty/omitted. The list of virtual machine resource ID(s), excluding any Hybrid AKS virtual machines, that are currently using this L2 network.
- Associated
Resource []stringIds - The list of resource IDs for the other Microsoft.NetworkCloud resources that have attached this network.
- Azure
Api stringVersion - The Azure API version of the resource.
- Cluster
Id string - The resource ID of the Network Cloud cluster this L2 network is associated with.
- Detailed
Status string - The more detailed status of the L2 network.
- Detailed
Status stringMessage - The descriptive message about the current detailed status.
- Etag string
- Resource ETag.
- Hybrid
Aks []stringClusters Associated Ids - Field Deprecated. These fields will be empty/omitted. The list of Hybrid AKS cluster resource ID(s) that are associated with this L2 network.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The name of the resource
- Provisioning
State string - The provisioning state of the L2 network.
- System
Data SystemData Response - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- Type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- Virtual
Machines []stringAssociated Ids - Field Deprecated. These fields will be empty/omitted. The list of virtual machine resource ID(s), excluding any Hybrid AKS virtual machines, that are currently using this L2 network.
- associated
Resource List<String>Ids - The list of resource IDs for the other Microsoft.NetworkCloud resources that have attached this network.
- azure
Api StringVersion - The Azure API version of the resource.
- cluster
Id String - The resource ID of the Network Cloud cluster this L2 network is associated with.
- detailed
Status String - The more detailed status of the L2 network.
- detailed
Status StringMessage - The descriptive message about the current detailed status.
- etag String
- Resource ETag.
- hybrid
Aks List<String>Clusters Associated Ids - Field Deprecated. These fields will be empty/omitted. The list of Hybrid AKS cluster resource ID(s) that are associated with this L2 network.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The name of the resource
- provisioning
State String - The provisioning state of the L2 network.
- system
Data SystemData Response - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type String
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- virtual
Machines List<String>Associated Ids - Field Deprecated. These fields will be empty/omitted. The list of virtual machine resource ID(s), excluding any Hybrid AKS virtual machines, that are currently using this L2 network.
- associated
Resource string[]Ids - The list of resource IDs for the other Microsoft.NetworkCloud resources that have attached this network.
- azure
Api stringVersion - The Azure API version of the resource.
- cluster
Id string - The resource ID of the Network Cloud cluster this L2 network is associated with.
- detailed
Status string - The more detailed status of the L2 network.
- detailed
Status stringMessage - The descriptive message about the current detailed status.
- etag string
- Resource ETag.
- hybrid
Aks string[]Clusters Associated Ids - Field Deprecated. These fields will be empty/omitted. The list of Hybrid AKS cluster resource ID(s) that are associated with this L2 network.
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- The name of the resource
- provisioning
State string - The provisioning state of the L2 network.
- system
Data SystemData Response - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- virtual
Machines string[]Associated Ids - Field Deprecated. These fields will be empty/omitted. The list of virtual machine resource ID(s), excluding any Hybrid AKS virtual machines, that are currently using this L2 network.
- associated_
resource_ Sequence[str]ids - The list of resource IDs for the other Microsoft.NetworkCloud resources that have attached this network.
- azure_
api_ strversion - The Azure API version of the resource.
- cluster_
id str - The resource ID of the Network Cloud cluster this L2 network is associated with.
- detailed_
status str - The more detailed status of the L2 network.
- detailed_
status_ strmessage - The descriptive message about the current detailed status.
- etag str
- Resource ETag.
- hybrid_
aks_ Sequence[str]clusters_ associated_ ids - Field Deprecated. These fields will be empty/omitted. The list of Hybrid AKS cluster resource ID(s) that are associated with this L2 network.
- id str
- The provider-assigned unique ID for this managed resource.
- name str
- The name of the resource
- provisioning_
state str - The provisioning state of the L2 network.
- system_
data SystemData Response - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type str
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- virtual_
machines_ Sequence[str]associated_ ids - Field Deprecated. These fields will be empty/omitted. The list of virtual machine resource ID(s), excluding any Hybrid AKS virtual machines, that are currently using this L2 network.
- associated
Resource List<String>Ids - The list of resource IDs for the other Microsoft.NetworkCloud resources that have attached this network.
- azure
Api StringVersion - The Azure API version of the resource.
- cluster
Id String - The resource ID of the Network Cloud cluster this L2 network is associated with.
- detailed
Status String - The more detailed status of the L2 network.
- detailed
Status StringMessage - The descriptive message about the current detailed status.
- etag String
- Resource ETag.
- hybrid
Aks List<String>Clusters Associated Ids - Field Deprecated. These fields will be empty/omitted. The list of Hybrid AKS cluster resource ID(s) that are associated with this L2 network.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The name of the resource
- provisioning
State String - The provisioning state of the L2 network.
- system
Data Property Map - Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type String
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- virtual
Machines List<String>Associated Ids - Field Deprecated. These fields will be empty/omitted. The list of virtual machine resource ID(s), excluding any Hybrid AKS virtual machines, that are currently using this L2 network.
Supporting Types
ExtendedLocation, ExtendedLocationArgs
ExtendedLocationResponse, ExtendedLocationResponseArgs
HybridAksPluginType, HybridAksPluginTypeArgs
- DPDK
- DPDK
- SRIOV
- SRIOV
- OSDevice
- OSDevice
- Hybrid
Aks Plugin Type DPDK - DPDK
- Hybrid
Aks Plugin Type SRIOV - SRIOV
- Hybrid
Aks Plugin Type OSDevice - OSDevice
- DPDK
- DPDK
- SRIOV
- SRIOV
- OSDevice
- OSDevice
- DPDK
- DPDK
- SRIOV
- SRIOV
- OSDevice
- OSDevice
- DPDK
- DPDK
- SRIOV
- SRIOV
- OS_DEVICE
- OSDevice
- "DPDK"
- DPDK
- "SRIOV"
- SRIOV
- "OSDevice"
- OSDevice
SystemDataResponse, SystemDataResponseArgs
- Created
At string - The timestamp of resource creation (UTC).
- Created
By string - The identity that created the resource.
- Created
By stringType - The type of identity that created the resource.
- Last
Modified stringAt - The timestamp of resource last modification (UTC)
- Last
Modified stringBy - The identity that last modified the resource.
- Last
Modified stringBy Type - The type of identity that last modified the resource.
- Created
At string - The timestamp of resource creation (UTC).
- Created
By string - The identity that created the resource.
- Created
By stringType - The type of identity that created the resource.
- Last
Modified stringAt - The timestamp of resource last modification (UTC)
- Last
Modified stringBy - The identity that last modified the resource.
- Last
Modified stringBy Type - The type of identity that last modified the resource.
- created
At String - The timestamp of resource creation (UTC).
- created
By String - The identity that created the resource.
- created
By StringType - The type of identity that created the resource.
- last
Modified StringAt - The timestamp of resource last modification (UTC)
- last
Modified StringBy - The identity that last modified the resource.
- last
Modified StringBy Type - The type of identity that last modified the resource.
- created
At string - The timestamp of resource creation (UTC).
- created
By string - The identity that created the resource.
- created
By stringType - The type of identity that created the resource.
- last
Modified stringAt - The timestamp of resource last modification (UTC)
- last
Modified stringBy - The identity that last modified the resource.
- last
Modified stringBy Type - The type of identity that last modified the resource.
- created_
at str - The timestamp of resource creation (UTC).
- created_
by str - The identity that created the resource.
- created_
by_ strtype - The type of identity that created the resource.
- last_
modified_ strat - The timestamp of resource last modification (UTC)
- last_
modified_ strby - The identity that last modified the resource.
- last_
modified_ strby_ type - The type of identity that last modified the resource.
- created
At String - The timestamp of resource creation (UTC).
- created
By String - The identity that created the resource.
- created
By StringType - The type of identity that created the resource.
- last
Modified StringAt - The timestamp of resource last modification (UTC)
- last
Modified StringBy - The identity that last modified the resource.
- last
Modified StringBy Type - The type of identity that last modified the resource.
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:networkcloud:L2Network l2NetworkName /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/l2Networks/{l2NetworkName}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0