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 topologyMaps 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.Network/topologyMaps resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.Network/topologyMaps@2026-10-01-preview' = {
location: 'string'
name: 'string'
properties: {
catchAllSiteName: 'string'
sites: [
{
name: 'string'
properties: {
probingGatewayIds: [
'string'
]
virtualNetworkIds: [
'string'
]
}
}
]
}
tags: {
{customized property}: 'string'
}
}
Property Values
Microsoft.Network/topologyMaps
| Name | Description | Value |
|---|---|---|
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string Constraints: Pattern = ^[a-zA-Z0-9-]{3,24}$ (required) |
| properties | The properties of the Topology Map. | TopologyMapProperties |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
SiteProperties
| Name | Description | Value |
|---|---|---|
| probingGatewayIds | The ARM resource ID of the probing gateway that can be used to monitor health as surrogate to the networks in the Site. | string[] |
| virtualNetworkIds | The list of Network IDs that forms the Site. | string[] |
TopologyMapInlineSite
| Name | Description | Value |
|---|---|---|
| name | The name of the Site. | string (required) |
| properties | The properties of the Site. | SiteProperties |
TopologyMapProperties
| Name | Description | Value |
|---|---|---|
| catchAllSiteName | The Name of the CatchAll site. There is only one CatchAll site in a TopologyMap | string |
| sites | The list of Sites in the Topology Map. | TopologyMapInlineSite[] |
TrackedResourceTags
| Name | Description | Value |
|---|
ARM template resource definition
The topologyMaps 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.Network/topologyMaps resource, add the following JSON to your template.
{
"type": "Microsoft.Network/topologyMaps",
"apiVersion": "2026-10-01-preview",
"name": "string",
"location": "string",
"properties": {
"catchAllSiteName": "string",
"sites": [
{
"name": "string",
"properties": {
"probingGatewayIds": [ "string" ],
"virtualNetworkIds": [ "string" ]
}
}
]
},
"tags": {
"{customized property}": "string"
}
}
Property Values
Microsoft.Network/topologyMaps
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2026-10-01-preview' |
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string Constraints: Pattern = ^[a-zA-Z0-9-]{3,24}$ (required) |
| properties | The properties of the Topology Map. | TopologyMapProperties |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
| type | The resource type | 'Microsoft.Network/topologyMaps' |
SiteProperties
| Name | Description | Value |
|---|---|---|
| probingGatewayIds | The ARM resource ID of the probing gateway that can be used to monitor health as surrogate to the networks in the Site. | string[] |
| virtualNetworkIds | The list of Network IDs that forms the Site. | string[] |
TopologyMapInlineSite
| Name | Description | Value |
|---|---|---|
| name | The name of the Site. | string (required) |
| properties | The properties of the Site. | SiteProperties |
TopologyMapProperties
| Name | Description | Value |
|---|---|---|
| catchAllSiteName | The Name of the CatchAll site. There is only one CatchAll site in a TopologyMap | string |
| sites | The list of Sites in the Topology Map. | TopologyMapInlineSite[] |
TrackedResourceTags
| Name | Description | Value |
|---|
Terraform (AzAPI provider) resource definition
The topologyMaps 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.Network/topologyMaps resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/topologyMaps@2026-10-01-preview"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
catchAllSiteName = "string"
sites = [
{
name = "string"
properties = {
probingGatewayIds = [
"string"
]
virtualNetworkIds = [
"string"
]
}
}
]
}
}
}
Property Values
Microsoft.Network/topologyMaps
| Name | Description | Value |
|---|---|---|
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string Constraints: Pattern = ^[a-zA-Z0-9-]{3,24}$ (required) |
| properties | The properties of the Topology Map. | TopologyMapProperties |
| tags | Resource tags | Dictionary of tag names and values. |
| type | The resource type | "Microsoft.Network/topologyMaps@2026-10-01-preview" |
SiteProperties
| Name | Description | Value |
|---|---|---|
| probingGatewayIds | The ARM resource ID of the probing gateway that can be used to monitor health as surrogate to the networks in the Site. | string[] |
| virtualNetworkIds | The list of Network IDs that forms the Site. | string[] |
TopologyMapInlineSite
| Name | Description | Value |
|---|---|---|
| name | The name of the Site. | string (required) |
| properties | The properties of the Site. | SiteProperties |
TopologyMapProperties
| Name | Description | Value |
|---|---|---|
| catchAllSiteName | The Name of the CatchAll site. There is only one CatchAll site in a TopologyMap | string |
| sites | The list of Sites in the Topology Map. | TopologyMapInlineSite[] |
TrackedResourceTags
| Name | Description | Value |
|---|