published on Wednesday, Aug 5, 2026 by Pulumi
published on Wednesday, Aug 5, 2026 by Pulumi
An interconnect group resource.
Uses Azure REST API version 2025-07-01.
Example Usage
Create interconnect group
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var interconnectGroup = new AzureNative.Network.InterconnectGroup("interconnectGroup", new()
{
InterconnectGroupName = "test-ig",
Location = "eastus",
ResourceGroupName = "rg1",
Scope = AzureNative.Network.InterconnectGroupScope.InfiniBand,
SubgroupProfile = new AzureNative.Network.Inputs.SubgroupProfileArgs
{
Scope = AzureNative.Network.SubgroupProfileScope.VerticalConnect,
Size = 18,
VmSize = "Standard_ND128isr_NDR_GB200_v6",
},
});
});
package main
import (
network "github.com/pulumi/pulumi-azure-native-sdk/network/v3"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := network.NewInterconnectGroup(ctx, "interconnectGroup", &network.InterconnectGroupArgs{
InterconnectGroupName: pulumi.String("test-ig"),
Location: pulumi.String("eastus"),
ResourceGroupName: pulumi.String("rg1"),
Scope: pulumi.String(network.InterconnectGroupScopeInfiniBand),
SubgroupProfile: &network.SubgroupProfileArgs{
Scope: pulumi.String(network.SubgroupProfileScopeVerticalConnect),
Size: pulumi.Int(18),
VmSize: pulumi.String("Standard_ND128isr_NDR_GB200_v6"),
},
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
azure-native = {
source = "pulumi/azure-native"
}
}
}
resource "azure-native_network_interconnectgroup" "interconnectGroup" {
interconnect_group_name = "test-ig"
location = "eastus"
resource_group_name = "rg1"
scope = "InfiniBand"
subgroup_profile = {
scope = "VerticalConnect"
size = 18
vm_size = "Standard_ND128isr_NDR_GB200_v6"
}
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.network.InterconnectGroup;
import com.pulumi.azurenative.network.InterconnectGroupArgs;
import com.pulumi.azurenative.network.inputs.SubgroupProfileArgs;
import java.util.ArrayList;
import java.util.Arrays;
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 interconnectGroup = new InterconnectGroup("interconnectGroup", InterconnectGroupArgs.builder()
.interconnectGroupName("test-ig")
.location("eastus")
.resourceGroupName("rg1")
.scope("InfiniBand")
.subgroupProfile(SubgroupProfileArgs.builder()
.scope("VerticalConnect")
.size(18)
.vmSize("Standard_ND128isr_NDR_GB200_v6")
.build())
.build());
}
}
import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";
const interconnectGroup = new azure_native.network.InterconnectGroup("interconnectGroup", {
interconnectGroupName: "test-ig",
location: "eastus",
resourceGroupName: "rg1",
scope: azure_native.network.InterconnectGroupScope.InfiniBand,
subgroupProfile: {
scope: azure_native.network.SubgroupProfileScope.VerticalConnect,
size: 18,
vmSize: "Standard_ND128isr_NDR_GB200_v6",
},
});
import pulumi
import pulumi_azure_native as azure_native
interconnect_group = azure_native.network.InterconnectGroup("interconnectGroup",
interconnect_group_name="test-ig",
location="eastus",
resource_group_name="rg1",
scope=azure_native.network.InterconnectGroupScope.INFINI_BAND,
subgroup_profile={
"scope": azure_native.network.SubgroupProfileScope.VERTICAL_CONNECT,
"size": 18,
"vm_size": "Standard_ND128isr_NDR_GB200_v6",
})
resources:
interconnectGroup:
type: azure-native:network:InterconnectGroup
properties:
interconnectGroupName: test-ig
location: eastus
resourceGroupName: rg1
scope: InfiniBand
subgroupProfile:
scope: VerticalConnect
size: 18
vmSize: Standard_ND128isr_NDR_GB200_v6
Create InterconnectGroup Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new InterconnectGroup(name: string, args: InterconnectGroupArgs, opts?: CustomResourceOptions);@overload
def InterconnectGroup(resource_name: str,
args: InterconnectGroupArgs,
opts: Optional[ResourceOptions] = None)
@overload
def InterconnectGroup(resource_name: str,
opts: Optional[ResourceOptions] = None,
resource_group_name: Optional[str] = None,
subgroup_profile: Optional[SubgroupProfileArgs] = None,
id: Optional[str] = None,
interconnect_group_name: Optional[str] = None,
location: Optional[str] = None,
scope: Optional[Union[str, InterconnectGroupScope]] = None,
tags: Optional[Mapping[str, str]] = None)func NewInterconnectGroup(ctx *Context, name string, args InterconnectGroupArgs, opts ...ResourceOption) (*InterconnectGroup, error)public InterconnectGroup(string name, InterconnectGroupArgs args, CustomResourceOptions? opts = null)
public InterconnectGroup(String name, InterconnectGroupArgs args)
public InterconnectGroup(String name, InterconnectGroupArgs args, CustomResourceOptions options)
type: azure-native:network:InterconnectGroup
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "azure-native_network_interconnect_group" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args InterconnectGroupArgs
- 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 InterconnectGroupArgs
- 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 InterconnectGroupArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InterconnectGroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args InterconnectGroupArgs
- 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 interconnectGroupResource = new AzureNative.Network.InterconnectGroup("interconnectGroupResource", new()
{
ResourceGroupName = "string",
SubgroupProfile = new AzureNative.Network.Inputs.SubgroupProfileArgs
{
VmSize = "string",
Scope = "string",
Size = 0,
},
Id = "string",
InterconnectGroupName = "string",
Location = "string",
Scope = "string",
Tags =
{
{ "string", "string" },
},
});
example, err := network.NewInterconnectGroup(ctx, "interconnectGroupResource", &network.InterconnectGroupArgs{
ResourceGroupName: pulumi.String("string"),
SubgroupProfile: &network.SubgroupProfileArgs{
VmSize: pulumi.String("string"),
Scope: pulumi.String("string"),
Size: pulumi.Int(0),
},
Id: pulumi.String("string"),
InterconnectGroupName: pulumi.String("string"),
Location: pulumi.String("string"),
Scope: pulumi.String("string"),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
})
resource "azure-native_network_interconnect_group" "interconnectGroupResource" {
lifecycle {
create_before_destroy = true
}
resource_group_name = "string"
subgroup_profile = {
vm_size = "string"
scope = "string"
size = 0
}
id = "string"
interconnect_group_name = "string"
location = "string"
scope = "string"
tags = {
"string" = "string"
}
}
var interconnectGroupResource = new InterconnectGroup("interconnectGroupResource", InterconnectGroupArgs.builder()
.resourceGroupName("string")
.subgroupProfile(SubgroupProfileArgs.builder()
.vmSize("string")
.scope("string")
.size(0)
.build())
.id("string")
.interconnectGroupName("string")
.location("string")
.scope("string")
.tags(Map.of("string", "string"))
.build());
interconnect_group_resource = azure_native.network.InterconnectGroup("interconnectGroupResource",
resource_group_name="string",
subgroup_profile={
"vm_size": "string",
"scope": "string",
"size": 0,
},
id="string",
interconnect_group_name="string",
location="string",
scope="string",
tags={
"string": "string",
})
const interconnectGroupResource = new azure_native.network.InterconnectGroup("interconnectGroupResource", {
resourceGroupName: "string",
subgroupProfile: {
vmSize: "string",
scope: "string",
size: 0,
},
id: "string",
interconnectGroupName: "string",
location: "string",
scope: "string",
tags: {
string: "string",
},
});
type: azure-native:network:InterconnectGroup
properties:
id: string
interconnectGroupName: string
location: string
resourceGroupName: string
scope: string
subgroupProfile:
scope: string
size: 0
vmSize: string
tags:
string: string
InterconnectGroup 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 InterconnectGroup resource accepts the following input properties:
- Resource
Group stringName - The name of the resource group. The name is case insensitive.
- Subgroup
Profile Pulumi.Azure Native. Network. Inputs. Subgroup Profile - The subgroup profile of the interconnect group resource.
- Id string
- Resource ID.
- Interconnect
Group stringName - The name of the interconnect group.
- Location string
- Resource location.
- Scope
string | Pulumi.
Azure Native. Network. Interconnect Group Scope - Scope of interconnect group resource.
- Dictionary<string, string>
- Resource tags.
- Resource
Group stringName - The name of the resource group. The name is case insensitive.
- Subgroup
Profile SubgroupProfile Args - The subgroup profile of the interconnect group resource.
- Id string
- Resource ID.
- Interconnect
Group stringName - The name of the interconnect group.
- Location string
- Resource location.
- Scope
string | Interconnect
Group Scope - Scope of interconnect group resource.
- map[string]string
- Resource tags.
- resource_
group_ stringname - The name of the resource group. The name is case insensitive.
- subgroup_
profile object - The subgroup profile of the interconnect group resource.
- id string
- Resource ID.
- interconnect_
group_ stringname - The name of the interconnect group.
- location string
- Resource location.
- scope
string | "None" | "Infini
Band" - Scope of interconnect group resource.
- map(string)
- Resource tags.
- resource
Group StringName - The name of the resource group. The name is case insensitive.
- subgroup
Profile SubgroupProfile - The subgroup profile of the interconnect group resource.
- id String
- Resource ID.
- interconnect
Group StringName - The name of the interconnect group.
- location String
- Resource location.
- scope
String | Interconnect
Group Scope - Scope of interconnect group resource.
- Map<String,String>
- Resource tags.
- resource
Group stringName - The name of the resource group. The name is case insensitive.
- subgroup
Profile SubgroupProfile - The subgroup profile of the interconnect group resource.
- id string
- Resource ID.
- interconnect
Group stringName - The name of the interconnect group.
- location string
- Resource location.
- scope
string | Interconnect
Group Scope - Scope of interconnect group resource.
- {[key: string]: string}
- Resource tags.
- resource_
group_ strname - The name of the resource group. The name is case insensitive.
- subgroup_
profile SubgroupProfile Args - The subgroup profile of the interconnect group resource.
- id str
- Resource ID.
- interconnect_
group_ strname - The name of the interconnect group.
- location str
- Resource location.
- scope
str | Interconnect
Group Scope - Scope of interconnect group resource.
- Mapping[str, str]
- Resource tags.
- resource
Group StringName - The name of the resource group. The name is case insensitive.
- subgroup
Profile Property Map - The subgroup profile of the interconnect group resource.
- id String
- Resource ID.
- interconnect
Group StringName - The name of the interconnect group.
- location String
- Resource location.
- scope
String | "None" | "Infini
Band" - Scope of interconnect group resource.
- Map<String>
- Resource tags.
Outputs
All input properties are implicitly available as output properties. Additionally, the InterconnectGroup resource produces the following output properties:
- Azure
Api stringVersion - The Azure API version of the resource.
- 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.
- Name string
- Resource name.
- Provisioning
State string - The provisioning state of the interconnect group resource.
- Resource
Guid string - The resource GUID property of the interconnect group resource.
- Subgroups
List<Pulumi.
Azure Native. Network. Outputs. Subgroup Response> - A list of subgroups of the interconnect group.
- Type string
- Resource type.
- Azure
Api stringVersion - The Azure API version of the resource.
- 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.
- Name string
- Resource name.
- Provisioning
State string - The provisioning state of the interconnect group resource.
- Resource
Guid string - The resource GUID property of the interconnect group resource.
- Subgroups
[]Subgroup
Response - A list of subgroups of the interconnect group.
- Type string
- Resource type.
- azure_
api_ stringversion - The Azure API version of the resource.
- 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.
- name string
- Resource name.
- provisioning_
state string - The provisioning state of the interconnect group resource.
- resource_
guid string - The resource GUID property of the interconnect group resource.
- subgroups list(object)
- A list of subgroups of the interconnect group.
- type string
- Resource type.
- azure
Api StringVersion - The Azure API version of the resource.
- 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.
- name String
- Resource name.
- provisioning
State String - The provisioning state of the interconnect group resource.
- resource
Guid String - The resource GUID property of the interconnect group resource.
- subgroups
List<Subgroup
Response> - A list of subgroups of the interconnect group.
- type String
- Resource type.
- azure
Api stringVersion - The Azure API version of the resource.
- 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.
- name string
- Resource name.
- provisioning
State string - The provisioning state of the interconnect group resource.
- resource
Guid string - The resource GUID property of the interconnect group resource.
- subgroups
Subgroup
Response[] - A list of subgroups of the interconnect group.
- type string
- Resource type.
- azure_
api_ strversion - The Azure API version of the resource.
- 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.
- name str
- Resource name.
- provisioning_
state str - The provisioning state of the interconnect group resource.
- resource_
guid str - The resource GUID property of the interconnect group resource.
- subgroups
Sequence[Subgroup
Response] - A list of subgroups of the interconnect group.
- type str
- Resource type.
- azure
Api StringVersion - The Azure API version of the resource.
- 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.
- name String
- Resource name.
- provisioning
State String - The provisioning state of the interconnect group resource.
- resource
Guid String - The resource GUID property of the interconnect group resource.
- subgroups List<Property Map>
- A list of subgroups of the interconnect group.
- type String
- Resource type.
Supporting Types
InterconnectGroupScope, InterconnectGroupScopeArgs
- None
NoneNo interconnect group scope.- Infini
Band InfiniBandInfiniBand interconnect group scope.
- Interconnect
Group Scope None NoneNo interconnect group scope.- Interconnect
Group Scope Infini Band InfiniBandInfiniBand interconnect group scope.
- "None"
NoneNo interconnect group scope.- "Infini
Band" InfiniBandInfiniBand interconnect group scope.
- None
NoneNo interconnect group scope.- Infini
Band InfiniBandInfiniBand interconnect group scope.
- None
NoneNo interconnect group scope.- Infini
Band InfiniBandInfiniBand interconnect group scope.
- NONE
NoneNo interconnect group scope.- INFINI_BAND
InfiniBandInfiniBand interconnect group scope.
- "None"
NoneNo interconnect group scope.- "Infini
Band" InfiniBandInfiniBand interconnect group scope.
SubResourceResponse, SubResourceResponseArgs
Reference to another subresource.- Id string
- Resource ID.
- Id string
- Resource ID.
- id string
- Resource ID.
- id String
- Resource ID.
- id string
- Resource ID.
- id str
- Resource ID.
- id String
- Resource ID.
SubgroupProfile, SubgroupProfileArgs
Subgroup profile of the interconnect group resource.- Vm
Size string - VM size of the subgroup profile.
- Scope
string | Pulumi.
Azure Native. Network. Subgroup Profile Scope - Scope of the subgroup profile.
- Size int
- Size of the subgroup profile.
- Vm
Size string - VM size of the subgroup profile.
- Scope
string | Subgroup
Profile Scope - Scope of the subgroup profile.
- Size int
- Size of the subgroup profile.
- vm_
size string - VM size of the subgroup profile.
- scope
string | "None" | "Vertical
Connect" - Scope of the subgroup profile.
- size number
- Size of the subgroup profile.
- vm
Size String - VM size of the subgroup profile.
- scope
String | Subgroup
Profile Scope - Scope of the subgroup profile.
- size Integer
- Size of the subgroup profile.
- vm
Size string - VM size of the subgroup profile.
- scope
string | Subgroup
Profile Scope - Scope of the subgroup profile.
- size number
- Size of the subgroup profile.
- vm_
size str - VM size of the subgroup profile.
- scope
str | Subgroup
Profile Scope - Scope of the subgroup profile.
- size int
- Size of the subgroup profile.
- vm
Size String - VM size of the subgroup profile.
- scope
String | "None" | "Vertical
Connect" - Scope of the subgroup profile.
- size Number
- Size of the subgroup profile.
SubgroupProfileResponse, SubgroupProfileResponseArgs
Subgroup profile of the interconnect group resource.SubgroupProfileScope, SubgroupProfileScopeArgs
- None
NoneNo subgroup profile scope.- Vertical
Connect VerticalConnectVerticalConnect subgroup profile scope.
- Subgroup
Profile Scope None NoneNo subgroup profile scope.- Subgroup
Profile Scope Vertical Connect VerticalConnectVerticalConnect subgroup profile scope.
- "None"
NoneNo subgroup profile scope.- "Vertical
Connect" VerticalConnectVerticalConnect subgroup profile scope.
- None
NoneNo subgroup profile scope.- Vertical
Connect VerticalConnectVerticalConnect subgroup profile scope.
- None
NoneNo subgroup profile scope.- Vertical
Connect VerticalConnectVerticalConnect subgroup profile scope.
- NONE
NoneNo subgroup profile scope.- VERTICAL_CONNECT
VerticalConnectVerticalConnect subgroup profile scope.
- "None"
NoneNo subgroup profile scope.- "Vertical
Connect" VerticalConnectVerticalConnect subgroup profile scope.
SubgroupResponse, SubgroupResponseArgs
A subgroup in an interconnect group.- Interconnect
Block Pulumi.Azure Native. Network. Inputs. Sub Resource Response - The reference to an interconnect block resource.
- Internal
Subgroup stringId - The unique identifier of the subgroup.
- Provisioning
State string - The provisioning state of the subgroup.
- Type string
- Resource type.
- Virtual
Machines List<Pulumi.Azure Native. Network. Inputs. Sub Resource Response> - A list of virtual machine references.
- Id string
- Resource ID.
- Name string
- Name of the resource.
- Interconnect
Block SubResource Response - The reference to an interconnect block resource.
- Internal
Subgroup stringId - The unique identifier of the subgroup.
- Provisioning
State string - The provisioning state of the subgroup.
- Type string
- Resource type.
- Virtual
Machines []SubResource Response - A list of virtual machine references.
- Id string
- Resource ID.
- Name string
- Name of the resource.
- interconnect_
block object - The reference to an interconnect block resource.
- internal_
subgroup_ stringid - The unique identifier of the subgroup.
- provisioning_
state string - The provisioning state of the subgroup.
- type string
- Resource type.
- virtual_
machines list(object) - A list of virtual machine references.
- id string
- Resource ID.
- name string
- Name of the resource.
- interconnect
Block SubResource Response - The reference to an interconnect block resource.
- internal
Subgroup StringId - The unique identifier of the subgroup.
- provisioning
State String - The provisioning state of the subgroup.
- type String
- Resource type.
- virtual
Machines List<SubResource Response> - A list of virtual machine references.
- id String
- Resource ID.
- name String
- Name of the resource.
- interconnect
Block SubResource Response - The reference to an interconnect block resource.
- internal
Subgroup stringId - The unique identifier of the subgroup.
- provisioning
State string - The provisioning state of the subgroup.
- type string
- Resource type.
- virtual
Machines SubResource Response[] - A list of virtual machine references.
- id string
- Resource ID.
- name string
- Name of the resource.
- interconnect_
block SubResource Response - The reference to an interconnect block resource.
- internal_
subgroup_ strid - The unique identifier of the subgroup.
- provisioning_
state str - The provisioning state of the subgroup.
- type str
- Resource type.
- virtual_
machines Sequence[SubResource Response] - A list of virtual machine references.
- id str
- Resource ID.
- name str
- Name of the resource.
- interconnect
Block Property Map - The reference to an interconnect block resource.
- internal
Subgroup StringId - The unique identifier of the subgroup.
- provisioning
State String - The provisioning state of the subgroup.
- type String
- Resource type.
- virtual
Machines List<Property Map> - A list of virtual machine references.
- id String
- Resource ID.
- name String
- Name of the resource.
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:network:InterconnectGroup test-ig /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/interconnectGroups/{interconnectGroupName}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0
published on Wednesday, Aug 5, 2026 by Pulumi