Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Bicep resource definition
The interconnectBlocks resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Compute/interconnectBlocks resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.Compute/interconnectBlocks@2026-03-01' = {
location: 'string'
name: 'string'
placement: {
excludeZones: [
'string'
]
includeZones: [
'string'
]
zonePlacementPolicy: 'string'
}
properties: {
interconnectGroup: {
id: 'string'
}
}
sku: {
capacity: int
name: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
zones: [
'string'
]
}
Property Values
Microsoft.Compute/interconnectBlocks
| Name | Description | Value |
|---|---|---|
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string (required) |
| placement | Placement section specifies the user-defined constraints for Interconnect Block hardware placement. This property cannot be changed once Interconnect Block is provisioned. | Placement |
| properties | Properties of the Interconnect Block. | InterconnectBlockProperties |
| sku | SKU of the resource for which capacity needs to be pre-allocated. Both sku.name and sku.capacity are required at create. After create, only sku.capacity can be updated. |
Sku (required) |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
| zones | The availability zones. | string[] |
ApiEntityReference
| Name | Description | Value |
|---|---|---|
| id | The ARM resource id in the form of /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... | string |
InterconnectBlockProperties
| Name | Description | Value |
|---|---|---|
| interconnectGroup | The Microsoft.Network/interconnectGroups resource that this Interconnect Block is associated with. Required at create and immutable thereafter. | ApiEntityReference (required) |
Placement
| Name | Description | Value |
|---|---|---|
| excludeZones | This property supplements the 'zonePlacementPolicy' property. If 'zonePlacementPolicy' is set to 'Any'/'Auto', availability zone selected by the system must not be present in the list of availability zones passed with 'excludeZones'. If 'excludeZones' is not provided, all availability zones in region will be considered for selection. | string[] |
| includeZones | This property supplements the 'zonePlacementPolicy' property. If 'zonePlacementPolicy' is set to 'Any'/'Auto', availability zone selected by the system must be present in the list of availability zones passed with 'includeZones'. If 'includeZones' is not provided, all availability zones in region will be considered for selection. | string[] |
| zonePlacementPolicy | Specifies the policy for resource's placement in availability zone. Possible values are: Any (used for Virtual Machines), Auto (used for Virtual Machine Scale Sets) - An availability zone will be automatically picked by system as part of resource creation. | 'Any' 'Auto' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Specifies the number of virtual machines in the scale set. | int |
| name | The sku name. | string |
| tier | Specifies the tier of virtual machines in a scale set. Possible Values: Standard Basic |
string |
TrackedResourceTags
| Name | Description | Value |
|---|
ARM template resource definition
The interconnectBlocks resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands For a list of changed properties in each API version, see change log.
Usage Examples
Resource format
To create a Microsoft.Compute/interconnectBlocks resource, add the following JSON to your template.
{
"type": "Microsoft.Compute/interconnectBlocks",
"apiVersion": "2026-03-01",
"name": "string",
"location": "string",
"placement": {
"excludeZones": [ "string" ],
"includeZones": [ "string" ],
"zonePlacementPolicy": "string"
},
"properties": {
"interconnectGroup": {
"id": "string"
}
},
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
},
"zones": [ "string" ]
}
Property Values
Microsoft.Compute/interconnectBlocks
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2026-03-01' |
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string (required) |
| placement | Placement section specifies the user-defined constraints for Interconnect Block hardware placement. This property cannot be changed once Interconnect Block is provisioned. | Placement |
| properties | Properties of the Interconnect Block. | InterconnectBlockProperties |
| sku | SKU of the resource for which capacity needs to be pre-allocated. Both sku.name and sku.capacity are required at create. After create, only sku.capacity can be updated. |
Sku (required) |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
| type | The resource type | 'Microsoft.Compute/interconnectBlocks' |
| zones | The availability zones. | string[] |
ApiEntityReference
| Name | Description | Value |
|---|---|---|
| id | The ARM resource id in the form of /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... | string |
InterconnectBlockProperties
| Name | Description | Value |
|---|---|---|
| interconnectGroup | The Microsoft.Network/interconnectGroups resource that this Interconnect Block is associated with. Required at create and immutable thereafter. | ApiEntityReference (required) |
Placement
| Name | Description | Value |
|---|---|---|
| excludeZones | This property supplements the 'zonePlacementPolicy' property. If 'zonePlacementPolicy' is set to 'Any'/'Auto', availability zone selected by the system must not be present in the list of availability zones passed with 'excludeZones'. If 'excludeZones' is not provided, all availability zones in region will be considered for selection. | string[] |
| includeZones | This property supplements the 'zonePlacementPolicy' property. If 'zonePlacementPolicy' is set to 'Any'/'Auto', availability zone selected by the system must be present in the list of availability zones passed with 'includeZones'. If 'includeZones' is not provided, all availability zones in region will be considered for selection. | string[] |
| zonePlacementPolicy | Specifies the policy for resource's placement in availability zone. Possible values are: Any (used for Virtual Machines), Auto (used for Virtual Machine Scale Sets) - An availability zone will be automatically picked by system as part of resource creation. | 'Any' 'Auto' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Specifies the number of virtual machines in the scale set. | int |
| name | The sku name. | string |
| tier | Specifies the tier of virtual machines in a scale set. Possible Values: Standard Basic |
string |
TrackedResourceTags
| Name | Description | Value |
|---|
Terraform (AzAPI provider) resource definition
The interconnectBlocks resource type can be deployed with operations that target:
- Resource groups For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Compute/interconnectBlocks resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/interconnectBlocks@2026-03-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
placement = {
excludeZones = [
"string"
]
includeZones = [
"string"
]
zonePlacementPolicy = "string"
}
properties = {
interconnectGroup = {
id = "string"
}
}
sku = {
capacity = int
name = "string"
tier = "string"
}
zones = [
"string"
]
}
}
Property Values
Microsoft.Compute/interconnectBlocks
| Name | Description | Value |
|---|---|---|
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string (required) |
| placement | Placement section specifies the user-defined constraints for Interconnect Block hardware placement. This property cannot be changed once Interconnect Block is provisioned. | Placement |
| properties | Properties of the Interconnect Block. | InterconnectBlockProperties |
| sku | SKU of the resource for which capacity needs to be pre-allocated. Both sku.name and sku.capacity are required at create. After create, only sku.capacity can be updated. |
Sku (required) |
| tags | Resource tags | Dictionary of tag names and values. |
| type | The resource type | "Microsoft.Compute/interconnectBlocks@2026-03-01" |
| zones | The availability zones. | string[] |
ApiEntityReference
| Name | Description | Value |
|---|---|---|
| id | The ARM resource id in the form of /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... | string |
InterconnectBlockProperties
| Name | Description | Value |
|---|---|---|
| interconnectGroup | The Microsoft.Network/interconnectGroups resource that this Interconnect Block is associated with. Required at create and immutable thereafter. | ApiEntityReference (required) |
Placement
| Name | Description | Value |
|---|---|---|
| excludeZones | This property supplements the 'zonePlacementPolicy' property. If 'zonePlacementPolicy' is set to 'Any'/'Auto', availability zone selected by the system must not be present in the list of availability zones passed with 'excludeZones'. If 'excludeZones' is not provided, all availability zones in region will be considered for selection. | string[] |
| includeZones | This property supplements the 'zonePlacementPolicy' property. If 'zonePlacementPolicy' is set to 'Any'/'Auto', availability zone selected by the system must be present in the list of availability zones passed with 'includeZones'. If 'includeZones' is not provided, all availability zones in region will be considered for selection. | string[] |
| zonePlacementPolicy | Specifies the policy for resource's placement in availability zone. Possible values are: Any (used for Virtual Machines), Auto (used for Virtual Machine Scale Sets) - An availability zone will be automatically picked by system as part of resource creation. | 'Any' 'Auto' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Specifies the number of virtual machines in the scale set. | int |
| name | The sku name. | string |
| tier | Specifies the tier of virtual machines in a scale set. Possible Values: Standard Basic |
string |
TrackedResourceTags
| Name | Description | Value |
|---|