Microsoft.Network expressRouteCircuits 2025-03-01

Определение ресурсов Bicep

Тип ресурса expressRouteCircuits можно развернуть с помощью операций, предназначенных для следующих операций:

• группы ресурсов . См. команды развертывания группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/expressRouteCircuits, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.Network/expressRouteCircuits@2025-03-01' = {
  location: 'string'
  name: 'string'
  properties: {
    allowClassicOperations: bool
    authorizationKey: 'string'
    authorizations: [
      {
        id: 'string'
        name: 'string'
        properties: {
          authorizationKey: 'string'
          authorizationUseStatus: 'string'
        }
      }
    ]
    bandwidthInGbps: int
    circuitProvisioningState: 'string'
    enableDirectPortRateLimit: bool
    expressRoutePort: {
      id: 'string'
    }
    gatewayManagerEtag: 'string'
    globalReachEnabled: bool
    peerings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          azureASN: int
          connections: [
            {
              id: 'string'
              name: 'string'
              properties: {
                addressPrefix: 'string'
                authorizationKey: 'string'
                expressRouteCircuitPeering: {
                  id: 'string'
                }
                ipv6CircuitConnectionConfig: {
                  addressPrefix: 'string'
                }
                peerExpressRouteCircuitPeering: {
                  id: 'string'
                }
              }
            }
          ]
          expressRouteConnection: {}
          gatewayManagerEtag: 'string'
          ipv6PeeringConfig: {
            microsoftPeeringConfig: {
              advertisedCommunities: [
                'string'
              ]
              advertisedPublicPrefixes: [
                'string'
              ]
              advertisedPublicPrefixInfo: [
                {
                  prefix: 'string'
                  signature: 'string'
                  validationId: 'string'
                }
              ]
              customerASN: int
              legacyMode: int
              routingRegistryName: 'string'
            }
            primaryPeerAddressPrefix: 'string'
            routeFilter: {
              id: 'string'
            }
            secondaryPeerAddressPrefix: 'string'
            state: 'string'
          }
          microsoftPeeringConfig: {
            advertisedCommunities: [
              'string'
            ]
            advertisedPublicPrefixes: [
              'string'
            ]
            advertisedPublicPrefixInfo: [
              {
                prefix: 'string'
                signature: 'string'
                validationId: 'string'
              }
            ]
            customerASN: int
            legacyMode: int
            routingRegistryName: 'string'
          }
          peerASN: int
          peeringType: 'string'
          primaryAzurePort: 'string'
          primaryPeerAddressPrefix: 'string'
          routeFilter: {
            id: 'string'
          }
          secondaryAzurePort: 'string'
          secondaryPeerAddressPrefix: 'string'
          sharedKey: 'string'
          state: 'string'
          stats: {
            primarybytesIn: int
            primarybytesOut: int
            secondarybytesIn: int
            secondarybytesOut: int
          }
          vlanId: int
        }
      }
    ]
    serviceKey: 'string'
    serviceProviderNotes: 'string'
    serviceProviderProperties: {
      bandwidthInMbps: int
      peeringLocation: 'string'
      serviceProviderName: 'string'
    }
    serviceProviderProvisioningState: 'string'
  }
  sku: {
    family: 'string'
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Значения свойств

Microsoft.Network/expressRouteCircuits

AdvertisedPublicPrefixProperties

AuthorizationPropertiesFormat (Формат AuthorizationProperties)

ExpressRouteCircuitAuthorization (Авторизация ExpressRouteCircuit)

ExpressRouteCircuitConnection (Подключение ExpressRouteCircuit)

ExpressRouteCircuitConnectionPropertiesFormat

ExpressRouteCircuitПиринг

ExpressRouteCircuitPeeringConfig (ExpressRouteCircuitPeeringConfig)

ExpressRouteCircuitPeeringPropertiesFormat

ExpressRouteCircuitPropertiesFormat

Свойства поставщика услуг ExpressRouteCircuit

ExpressRouteCircuitSku

ExpressRouteCircuitStats (ЭкспрессМаршрутКонтурСтатистика)

ExpressRouteConnectionId (Идентификатор соединения)

Конфигурация ipv6CircuitConnectionConfig

Ipv6ExpressRouteCircuitPeeringConfig

Теги ресурса

Подресурс

Примеры использования

Примеры Bicep

Простой пример развертывания канала ExpressRoute.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource expressrouteport 'Microsoft.Network/ExpressRoutePorts@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    bandwidthInGbps: 10
    encapsulation: 'Dot1Q'
    peeringLocation: 'CDC-Canberra'
  }
}

resource expressRouteCircuit 'Microsoft.Network/expressRouteCircuits@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    authorizationKey: ''
    bandwidthInGbps: 5
    expressRoutePort: {
      id: expressrouteport.id
    }
  }
  sku: {
    family: 'MeteredData'
    name: 'Premium_MeteredData'
    tier: 'Premium'
  }
}

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Определение ресурса шаблона ARM

Тип ресурса expressRouteCircuits можно развернуть с помощью операций, предназначенных для следующих операций:

• группы ресурсов . См. команды развертывания группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/expressRouteCircuits, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Network/expressRouteCircuits",
  "apiVersion": "2025-03-01",
  "name": "string",
  "location": "string",
  "properties": {
    "allowClassicOperations": "bool",
    "authorizationKey": "string",
    "authorizations": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "authorizationKey": "string",
          "authorizationUseStatus": "string"
        }
      }
    ],
    "bandwidthInGbps": "int",
    "circuitProvisioningState": "string",
    "enableDirectPortRateLimit": "bool",
    "expressRoutePort": {
      "id": "string"
    },
    "gatewayManagerEtag": "string",
    "globalReachEnabled": "bool",
    "peerings": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "azureASN": "int",
          "connections": [
            {
              "id": "string",
              "name": "string",
              "properties": {
                "addressPrefix": "string",
                "authorizationKey": "string",
                "expressRouteCircuitPeering": {
                  "id": "string"
                },
                "ipv6CircuitConnectionConfig": {
                  "addressPrefix": "string"
                },
                "peerExpressRouteCircuitPeering": {
                  "id": "string"
                }
              }
            }
          ],
          "expressRouteConnection": {
          },
          "gatewayManagerEtag": "string",
          "ipv6PeeringConfig": {
            "microsoftPeeringConfig": {
              "advertisedCommunities": [ "string" ],
              "advertisedPublicPrefixes": [ "string" ],
              "advertisedPublicPrefixInfo": [
                {
                  "prefix": "string",
                  "signature": "string",
                  "validationId": "string"
                }
              ],
              "customerASN": "int",
              "legacyMode": "int",
              "routingRegistryName": "string"
            },
            "primaryPeerAddressPrefix": "string",
            "routeFilter": {
              "id": "string"
            },
            "secondaryPeerAddressPrefix": "string",
            "state": "string"
          },
          "microsoftPeeringConfig": {
            "advertisedCommunities": [ "string" ],
            "advertisedPublicPrefixes": [ "string" ],
            "advertisedPublicPrefixInfo": [
              {
                "prefix": "string",
                "signature": "string",
                "validationId": "string"
              }
            ],
            "customerASN": "int",
            "legacyMode": "int",
            "routingRegistryName": "string"
          },
          "peerASN": "int",
          "peeringType": "string",
          "primaryAzurePort": "string",
          "primaryPeerAddressPrefix": "string",
          "routeFilter": {
            "id": "string"
          },
          "secondaryAzurePort": "string",
          "secondaryPeerAddressPrefix": "string",
          "sharedKey": "string",
          "state": "string",
          "stats": {
            "primarybytesIn": "int",
            "primarybytesOut": "int",
            "secondarybytesIn": "int",
            "secondarybytesOut": "int"
          },
          "vlanId": "int"
        }
      }
    ],
    "serviceKey": "string",
    "serviceProviderNotes": "string",
    "serviceProviderProperties": {
      "bandwidthInMbps": "int",
      "peeringLocation": "string",
      "serviceProviderName": "string"
    },
    "serviceProviderProvisioningState": "string"
  },
  "sku": {
    "family": "string",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Значения свойств

Microsoft.Network/expressRouteCircuits

AdvertisedPublicPrefixProperties

AuthorizationPropertiesFormat (Формат AuthorizationProperties)

ExpressRouteCircuitAuthorization (Авторизация ExpressRouteCircuit)

ExpressRouteCircuitConnection (Подключение ExpressRouteCircuit)

ExpressRouteCircuitConnectionPropertiesFormat

ExpressRouteCircuitПиринг

ExpressRouteCircuitPeeringConfig (ExpressRouteCircuitPeeringConfig)

ExpressRouteCircuitPeeringPropertiesFormat

ExpressRouteCircuitPropertiesFormat

Свойства поставщика услуг ExpressRouteCircuit

ExpressRouteCircuitSku

ExpressRouteCircuitStats (ЭкспрессМаршрутКонтурСтатистика)

ExpressRouteConnectionId (Идентификатор соединения)

Конфигурация ipv6CircuitConnectionConfig

Ipv6ExpressRouteCircuitPeeringConfig

Теги ресурса

Подресурс

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Template	Description
создание канала ExpressRoute	Этот шаблон создает канал ExpressRoute для указанного поставщика услуг и номера SKU
создание канала ExpressRoute с помощью пиринга BGP	Этот шаблон создает канал ExpressRoute и пиринг BGP AzurePrublicPeering для указанного поставщика услуг и SKU
канал ExpressRoute с частным пирингом и виртуальной сетью Azure	Этот шаблон настраивает пиринг Microsoft ExpressRoute, развертывает виртуальную сеть Azure с помощью шлюза Expressroute и связывает виртуальную сеть с каналом ExpressRoute.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса expressRouteCircuits можно развернуть с помощью операций, предназначенных для следующих операций:

• Группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/expressRouteCircuits, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/expressRouteCircuits@2025-03-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      allowClassicOperations = bool
      authorizationKey = "string"
      authorizations = [
        {
          id = "string"
          name = "string"
          properties = {
            authorizationKey = "string"
            authorizationUseStatus = "string"
          }
        }
      ]
      bandwidthInGbps = int
      circuitProvisioningState = "string"
      enableDirectPortRateLimit = bool
      expressRoutePort = {
        id = "string"
      }
      gatewayManagerEtag = "string"
      globalReachEnabled = bool
      peerings = [
        {
          id = "string"
          name = "string"
          properties = {
            azureASN = int
            connections = [
              {
                id = "string"
                name = "string"
                properties = {
                  addressPrefix = "string"
                  authorizationKey = "string"
                  expressRouteCircuitPeering = {
                    id = "string"
                  }
                  ipv6CircuitConnectionConfig = {
                    addressPrefix = "string"
                  }
                  peerExpressRouteCircuitPeering = {
                    id = "string"
                  }
                }
              }
            ]
            expressRouteConnection = {
            }
            gatewayManagerEtag = "string"
            ipv6PeeringConfig = {
              microsoftPeeringConfig = {
                advertisedCommunities = [
                  "string"
                ]
                advertisedPublicPrefixes = [
                  "string"
                ]
                advertisedPublicPrefixInfo = [
                  {
                    prefix = "string"
                    signature = "string"
                    validationId = "string"
                  }
                ]
                customerASN = int
                legacyMode = int
                routingRegistryName = "string"
              }
              primaryPeerAddressPrefix = "string"
              routeFilter = {
                id = "string"
              }
              secondaryPeerAddressPrefix = "string"
              state = "string"
            }
            microsoftPeeringConfig = {
              advertisedCommunities = [
                "string"
              ]
              advertisedPublicPrefixes = [
                "string"
              ]
              advertisedPublicPrefixInfo = [
                {
                  prefix = "string"
                  signature = "string"
                  validationId = "string"
                }
              ]
              customerASN = int
              legacyMode = int
              routingRegistryName = "string"
            }
            peerASN = int
            peeringType = "string"
            primaryAzurePort = "string"
            primaryPeerAddressPrefix = "string"
            routeFilter = {
              id = "string"
            }
            secondaryAzurePort = "string"
            secondaryPeerAddressPrefix = "string"
            sharedKey = "string"
            state = "string"
            stats = {
              primarybytesIn = int
              primarybytesOut = int
              secondarybytesIn = int
              secondarybytesOut = int
            }
            vlanId = int
          }
        }
      ]
      serviceKey = "string"
      serviceProviderNotes = "string"
      serviceProviderProperties = {
        bandwidthInMbps = int
        peeringLocation = "string"
        serviceProviderName = "string"
      }
      serviceProviderProvisioningState = "string"
    }
    sku = {
      family = "string"
      name = "string"
      tier = "string"
    }
  }
}

Значения свойств

Microsoft.Network/expressRouteCircuits

AdvertisedPublicPrefixProperties

AuthorizationPropertiesFormat (Формат AuthorizationProperties)

ExpressRouteCircuitAuthorization (Авторизация ExpressRouteCircuit)

ExpressRouteCircuitConnection (Подключение ExpressRouteCircuit)

ExpressRouteCircuitConnectionPropertiesFormat

ExpressRouteCircuitПиринг

ExpressRouteCircuitPeeringConfig (ExpressRouteCircuitPeeringConfig)

ExpressRouteCircuitPeeringPropertiesFormat

ExpressRouteCircuitPropertiesFormat

Свойства поставщика услуг ExpressRouteCircuit

ExpressRouteCircuitSku

ExpressRouteCircuitStats (ЭкспрессМаршрутКонтурСтатистика)

ExpressRouteConnectionId (Идентификатор соединения)

Конфигурация ipv6CircuitConnectionConfig

Ipv6ExpressRouteCircuitPeeringConfig

Теги ресурса

Подресурс

Примеры использования

Примеры Terraform

Простой пример развертывания канала ExpressRoute.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "ExpressRoutePort" {
  type      = "Microsoft.Network/ExpressRoutePorts@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      bandwidthInGbps = 10
      encapsulation   = "Dot1Q"
      peeringLocation = "CDC-Canberra"
    }
  }
  schema_validation_enabled = false
  ignore_casing             = true
  response_export_values    = ["*"]
}

resource "azapi_resource" "expressRouteCircuit" {
  type      = "Microsoft.Network/expressRouteCircuits@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      authorizationKey = ""
      bandwidthInGbps  = 5
      expressRoutePort = {
        id = azapi_resource.ExpressRoutePort.id
      }
    }
    sku = {
      family = "MeteredData"
      name   = "Premium_MeteredData"
      tier   = "Premium"
    }
  }
  schema_validation_enabled = false
  ignore_casing             = true
  response_export_values    = ["*"]
}

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.