你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.Network expressRouteCircuits 2018-04-01

• 最新
• 2024-05-01
• 2024-03-01
• 2024-01-01
• 2023-11-01
• 2023-09-01
• 2023-06-01
• 2023-05-01
• 2023-04-01
• 2023-02-01
• 2022-11-01
• 2022-09-01
• 2022-07-01
• 2022-05-01
• 2022-01-01
• 2021-08-01
• 2021-05-01
• 2021-03-01
• 2021-02-01
• 2020-11-01
• 2020-08-01
• 2020-07-01
• 2020-06-01
• 2020-05-01
• 2020-04-01
• 2020-03-01
• 2019-12-01
• 2019-11-01
• 2019-09-01
• 2019-08-01
• 2019-07-01
• 2019-06-01
• 2019-04-01
• 2019-02-01
• 2018-12-01
• 2018-11-01
• 2018-10-01
• 2018-08-01
• 2018-07-01
• 2018-06-01
• 2018-04-01
• 2018-02-01
• 2018-01-01
• 2017-11-01
• 2017-10-01
• 2017-09-01
• 2017-08-01
• 2017-06-01
• 2017-03-30
• 2017-03-01
• 2016-12-01
• 2016-09-01
• 2016-06-01
• 2016-03-30
• 2015-06-15
• 2015-05-01-preview

Bicep 资源定义

可以使用目标操作部署 expressRouteCircuits 资源类型：

• 资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Network/expressRouteCircuits 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.Network/expressRouteCircuits@2018-04-01' = {
  location: 'string'
  name: 'string'
  properties: {
    allowClassicOperations: bool
    authorizations: [
      {
        id: 'string'
        name: 'string'
        properties: {
          authorizationKey: 'string'
          authorizationUseStatus: 'string'
          provisioningState: 'string'
        }
      }
    ]
    circuitProvisioningState: 'string'
    gatewayManagerEtag: 'string'
    peerings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          azureASN: int
          connections: [
            {
              id: 'string'
              name: 'string'
              properties: {
                addressPrefix: 'string'
                authorizationKey: 'string'
                expressRouteCircuitPeering: {
                  id: 'string'
                }
                peerExpressRouteCircuitPeering: {
                  id: 'string'
                }
              }
            }
          ]
          gatewayManagerEtag: 'string'
          ipv6PeeringConfig: {
            microsoftPeeringConfig: {
              advertisedCommunities: [
                'string'
              ]
              advertisedPublicPrefixes: [
                'string'
              ]
              advertisedPublicPrefixesState: 'string'
              customerASN: int
              legacyMode: int
              routingRegistryName: 'string'
            }
            primaryPeerAddressPrefix: 'string'
            routeFilter: {
              id: 'string'
              location: 'string'
              properties: {
                peerings: [
                  ...
                ]
                rules: [
                  {
                    id: 'string'
                    location: 'string'
                    name: 'string'
                    properties: {
                      access: 'string'
                      communities: [
                        'string'
                      ]
                      routeFilterRuleType: 'string'
                    }
                  }
                ]
              }
              tags: {
                {customized property}: 'string'
              }
            }
            secondaryPeerAddressPrefix: 'string'
            state: 'string'
          }
          lastModifiedBy: 'string'
          microsoftPeeringConfig: {
            advertisedCommunities: [
              'string'
            ]
            advertisedPublicPrefixes: [
              'string'
            ]
            advertisedPublicPrefixesState: 'string'
            customerASN: int
            legacyMode: int
            routingRegistryName: 'string'
          }
          peerASN: int
          peeringType: 'string'
          primaryAzurePort: 'string'
          primaryPeerAddressPrefix: 'string'
          provisioningState: 'string'
          routeFilter: {
            id: 'string'
            location: 'string'
            properties: {
              peerings: [
                ...
              ]
              rules: [
                {
                  id: 'string'
                  location: 'string'
                  name: 'string'
                  properties: {
                    access: 'string'
                    communities: [
                      'string'
                    ]
                    routeFilterRuleType: 'string'
                  }
                }
              ]
            }
            tags: {
              {customized property}: 'string'
            }
          }
          secondaryAzurePort: 'string'
          secondaryPeerAddressPrefix: 'string'
          sharedKey: 'string'
          state: 'string'
          stats: {
            primarybytesIn: int
            primarybytesOut: int
            secondarybytesIn: int
            secondarybytesOut: int
          }
          vlanId: int
        }
      }
    ]
    provisioningState: 'string'
    serviceKey: 'string'
    serviceProviderNotes: 'string'
    serviceProviderProperties: {
      bandwidthInMbps: int
      peeringLocation: 'string'
      serviceProviderName: 'string'
    }
    serviceProviderProvisioningState: 'string'
  }
  sku: {
    family: 'string'
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

属性值

AuthorizationPropertiesFormat

名字	描述	价值
authorizationKey	授权密钥。	字符串
authorizationUseStatus	AuthorizationUseStatus。 可能的值为：“Available”和“InUse”。	“Available” “InUse”
provisioningState	获取公共 IP 资源的预配状态。 可能的值包括：“正在更新”、“删除”和“Failed”。	字符串

ExpressRouteCircuitAuthorization

名字	描述	价值
id	资源 ID。	字符串
名字	获取资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能		AuthorizationPropertiesFormat

ExpressRouteCircuitConnection

名字	描述	价值
id	资源 ID。	字符串
名字	获取资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能		ExpressRouteCircuitConnectionPropertiesFormat

ExpressRouteCircuitConnectionPropertiesFormat

名字	描述	价值
addressPrefix	/29 IP 地址空间来挖掘隧道的客户地址。	字符串
authorizationKey	授权密钥。	字符串
expressRouteCircuitPeering	对线路发起连接的 Express Route 线路专用对等互连资源的引用。	SubResource
peerExpressRouteCircuitPeering	对对等线路的 Express Route 线路专用对等互连资源的引用。	SubResource

ExpressRouteCircuitPeering

名字	描述	价值
id	资源 ID。	字符串
名字	获取资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能		ExpressRouteCircuitPeeringPropertiesFormat

ExpressRouteCircuitPeeringConfig

名字	描述	价值
广告社区	bgp 对等互连的社区。 为 Microsoft 对等互连指定	string[]
advertisedPublicPrefixes	AdvertisedPublicPrefixes 的引用。	string[]
advertisedPublicPrefixesState	对等互连资源的 AdvertisedPublicPrefixState。 可能的值为“NotConfigured”、“Configuring”、“Configured”和“ValidationNeeded”。	“已配置” “配置” “NotConfigured” “ValidationNeeded”
customerASN	对等互连的 CustomerASN。	int
legacyMode	对等互连的旧模式。	int
routingRegistryName	配置的 RoutingRegistryName。	字符串

ExpressRouteCircuitPeeringPropertiesFormat

名字	描述	价值
azureASN	Azure ASN。	int
连接	与此线路的 Azure 专用对等互连关联的线路连接列表。	ExpressRouteCircuitConnection[]
gatewayManagerEtag	GatewayManager Etag。	字符串
ipv6PeeringConfig	IPv6 对等互连配置。	Ipv6ExpressRouteCircuitPeeringConfig
lastModifiedBy	获取提供程序还是客户上次修改对等互连。	字符串
microsoftPeeringConfig	Microsoft对等互连配置。	ExpressRouteCircuitPeeringConfig
peerASN	对等 ASN。	int 约束： 最小值 = 1 最大值 = 4294967295
peeringType	对等互连类型。	“AzurePrivatePeering” “AzurePublicPeering” “MicrosoftPeering”
primaryAzurePort	主端口。	字符串
primaryPeerAddressPrefix	主地址前缀。	字符串
provisioningState	获取公共 IP 资源的预配状态。 可能的值包括：“正在更新”、“删除”和“Failed”。	字符串
routeFilter	RouteFilter 资源的引用。	RouteFilter
secondaryAzurePort	辅助端口。	字符串
secondaryPeerAddressPrefix	辅助地址前缀。	字符串
sharedKey	共享密钥。	字符串
州	对等互连状态。	“Disabled” “Enabled”
统计	获取对等互连统计信息。	ExpressRouteCircuitStats
vlanId	VLAN ID。	int

ExpressRouteCircuitPropertiesFormat

名字	描述	价值
allowClassicOperations	允许经典操作	bool
授权	授权列表。	ExpressRouteCircuitAuthorization[]
circuitProvisioningState	资源的 CircuitProvisioningState 状态。	字符串
gatewayManagerEtag	GatewayManager Etag。	字符串
对等互连	对等互连的列表。	ExpressRouteCircuitPeering[]
provisioningState	获取公共 IP 资源的预配状态。 可能的值包括：“正在更新”、“删除”和“Failed”。	字符串
serviceKey	ServiceKey。	字符串
serviceProviderNotes	ServiceProviderNotes。	字符串
serviceProviderProperties	ServiceProviderProperties。	ExpressRouteCircuitServiceProviderProperties
serviceProviderProvisioningState	资源的 ServiceProviderProvisioningState 状态。 可能的值为“NotProvisioned”、“Provisioning”、“Provisioned”和“Deprovisioning”。	“取消预配” “NotProvisioned” “Provisioned” “预配”

ExpressRouteCircuitServiceProviderProperties

名字	描述	价值
bandwidthInMbps	BandwidthInMbps。	int
peeringLocation	对等互连位置。	字符串
serviceProviderName	serviceProviderName。	字符串

ExpressRouteCircuitSku

名字	描述	价值
家庭	SKU 系列。 可能的值为：“UnlimitedData”和“MeteredData”。	“MeteredData” “UnlimitedData”
名字	SKU 的名称。	字符串
层	SKU 的层。 可能的值为“Standard”和“Premium”。	“Premium” “Standard”

ExpressRouteCircuitStats

名字	描述	价值
primarybytesIn	获取对等互连的 BytesIn。	int
primarybytesOut	获取对等互连的 BytesOut。	int
secondarybytesIn	获取对等互连的 BytesIn。	int
secondarybytesOut	获取对等互连的 BytesOut。	int

Ipv6ExpressRouteCircuitPeeringConfig

名字	描述	价值
microsoftPeeringConfig	Microsoft对等互连配置。	ExpressRouteCircuitPeeringConfig
primaryPeerAddressPrefix	主地址前缀。	字符串
routeFilter	RouteFilter 资源的引用。	RouteFilter
secondaryPeerAddressPrefix	辅助地址前缀。	字符串
州	对等互连的状态。 可能的值为：“Disabled”和“Enabled”	“Disabled” “Enabled”

Microsoft.Network/expressRouteCircuits

名字	描述	价值
位置	资源位置。	字符串
名字	资源名称	string （必需）
性能	ExpressRouteCircuit 的属性。	ExpressRouteCircuitPropertiesFormat
sku	SKU。	ExpressRouteCircuitSku
标签	资源标记	标记名称和值的字典。 请参阅模板 中的 标记

ResourceTags

名字	描述	价值

ResourceTags

名字	描述	价值

RouteFilter

名字	描述	价值
id	资源 ID。	字符串
位置	资源位置。	字符串
性能	路由筛选器资源	RouteFilterPropertiesFormat
标签	资源标记。	ResourceTags

RouteFilterPropertiesFormat

名字	描述	价值
对等互连	对快速路由线路对等互连的引用集合。	ExpressRouteCircuitPeering[]
规则	路由筛选器中包含的 RouteFilterRules 的集合。	RouteFilterRule[]

RouteFilterRule

名字	描述	价值
id	资源 ID。	字符串
位置	资源位置。	字符串
名字	资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能	路由筛选器规则资源	RouteFilterRulePropertiesFormat

RouteFilterRulePropertiesFormat

名字	描述	价值
访问	规则的访问类型。 有效值为：“Allow”、“Deny”	“允许” “拒绝”（必需）
社区	要筛选的 bgp 社区值的集合。例如 ['12076：5010'，'12076：5020']	string[] （必需）
routeFilterRuleType	规则的规则类型。 有效值为：“Community”	“社区”（必需）

SubResource

名字	描述	价值
id	资源 ID。	字符串

快速入门示例

以下快速入门示例部署此资源类型。

Bicep 文件	描述
创建 ExpressRoute 线路	此模板为指定的服务提供商和 SKU 创建 ExpressRoute 线路
使用专用对等互连和 Azure VNet ExpressRoute 线路	此模板配置 ExpressRoute Microsoft对等互连，部署包含 Expressroute 网关的 Azure VNet，并将 VNet 链接到 ExpressRoute 线路

ARM 模板资源定义

可以使用目标操作部署 expressRouteCircuits 资源类型：

• 资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Network/expressRouteCircuits 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.Network/expressRouteCircuits",
  "apiVersion": "2018-04-01",
  "name": "string",
  "location": "string",
  "properties": {
    "allowClassicOperations": "bool",
    "authorizations": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "authorizationKey": "string",
          "authorizationUseStatus": "string",
          "provisioningState": "string"
        }
      }
    ],
    "circuitProvisioningState": "string",
    "gatewayManagerEtag": "string",
    "peerings": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "azureASN": "int",
          "connections": [
            {
              "id": "string",
              "name": "string",
              "properties": {
                "addressPrefix": "string",
                "authorizationKey": "string",
                "expressRouteCircuitPeering": {
                  "id": "string"
                },
                "peerExpressRouteCircuitPeering": {
                  "id": "string"
                }
              }
            }
          ],
          "gatewayManagerEtag": "string",
          "ipv6PeeringConfig": {
            "microsoftPeeringConfig": {
              "advertisedCommunities": [ "string" ],
              "advertisedPublicPrefixes": [ "string" ],
              "advertisedPublicPrefixesState": "string",
              "customerASN": "int",
              "legacyMode": "int",
              "routingRegistryName": "string"
            },
            "primaryPeerAddressPrefix": "string",
            "routeFilter": {
              "id": "string",
              "location": "string",
              "properties": {
                "peerings": [
                  ...
                ],
                "rules": [
                  {
                    "id": "string",
                    "location": "string",
                    "name": "string",
                    "properties": {
                      "access": "string",
                      "communities": [ "string" ],
                      "routeFilterRuleType": "string"
                    }
                  }
                ]
              },
              "tags": {
                "{customized property}": "string"
              }
            },
            "secondaryPeerAddressPrefix": "string",
            "state": "string"
          },
          "lastModifiedBy": "string",
          "microsoftPeeringConfig": {
            "advertisedCommunities": [ "string" ],
            "advertisedPublicPrefixes": [ "string" ],
            "advertisedPublicPrefixesState": "string",
            "customerASN": "int",
            "legacyMode": "int",
            "routingRegistryName": "string"
          },
          "peerASN": "int",
          "peeringType": "string",
          "primaryAzurePort": "string",
          "primaryPeerAddressPrefix": "string",
          "provisioningState": "string",
          "routeFilter": {
            "id": "string",
            "location": "string",
            "properties": {
              "peerings": [
                ...
              ],
              "rules": [
                {
                  "id": "string",
                  "location": "string",
                  "name": "string",
                  "properties": {
                    "access": "string",
                    "communities": [ "string" ],
                    "routeFilterRuleType": "string"
                  }
                }
              ]
            },
            "tags": {
              "{customized property}": "string"
            }
          },
          "secondaryAzurePort": "string",
          "secondaryPeerAddressPrefix": "string",
          "sharedKey": "string",
          "state": "string",
          "stats": {
            "primarybytesIn": "int",
            "primarybytesOut": "int",
            "secondarybytesIn": "int",
            "secondarybytesOut": "int"
          },
          "vlanId": "int"
        }
      }
    ],
    "provisioningState": "string",
    "serviceKey": "string",
    "serviceProviderNotes": "string",
    "serviceProviderProperties": {
      "bandwidthInMbps": "int",
      "peeringLocation": "string",
      "serviceProviderName": "string"
    },
    "serviceProviderProvisioningState": "string"
  },
  "sku": {
    "family": "string",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

属性值

AuthorizationPropertiesFormat

名字	描述	价值
authorizationKey	授权密钥。	字符串
authorizationUseStatus	AuthorizationUseStatus。 可能的值为：“Available”和“InUse”。	“Available” “InUse”
provisioningState	获取公共 IP 资源的预配状态。 可能的值包括：“正在更新”、“删除”和“Failed”。	字符串

ExpressRouteCircuitAuthorization

名字	描述	价值
id	资源 ID。	字符串
名字	获取资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能		AuthorizationPropertiesFormat

ExpressRouteCircuitConnection

名字	描述	价值
id	资源 ID。	字符串
名字	获取资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能		ExpressRouteCircuitConnectionPropertiesFormat

ExpressRouteCircuitConnectionPropertiesFormat

名字	描述	价值
addressPrefix	/29 IP 地址空间来挖掘隧道的客户地址。	字符串
authorizationKey	授权密钥。	字符串
expressRouteCircuitPeering	对线路发起连接的 Express Route 线路专用对等互连资源的引用。	SubResource
peerExpressRouteCircuitPeering	对对等线路的 Express Route 线路专用对等互连资源的引用。	SubResource

ExpressRouteCircuitPeering

名字	描述	价值
id	资源 ID。	字符串
名字	获取资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能		ExpressRouteCircuitPeeringPropertiesFormat

ExpressRouteCircuitPeeringConfig

名字	描述	价值
广告社区	bgp 对等互连的社区。 为 Microsoft 对等互连指定	string[]
advertisedPublicPrefixes	AdvertisedPublicPrefixes 的引用。	string[]
advertisedPublicPrefixesState	对等互连资源的 AdvertisedPublicPrefixState。 可能的值为“NotConfigured”、“Configuring”、“Configured”和“ValidationNeeded”。	“已配置” “配置” “NotConfigured” “ValidationNeeded”
customerASN	对等互连的 CustomerASN。	int
legacyMode	对等互连的旧模式。	int
routingRegistryName	配置的 RoutingRegistryName。	字符串

ExpressRouteCircuitPeeringPropertiesFormat

名字	描述	价值
azureASN	Azure ASN。	int
连接	与此线路的 Azure 专用对等互连关联的线路连接列表。	ExpressRouteCircuitConnection[]
gatewayManagerEtag	GatewayManager Etag。	字符串
ipv6PeeringConfig	IPv6 对等互连配置。	Ipv6ExpressRouteCircuitPeeringConfig
lastModifiedBy	获取提供程序还是客户上次修改对等互连。	字符串
microsoftPeeringConfig	Microsoft对等互连配置。	ExpressRouteCircuitPeeringConfig
peerASN	对等 ASN。	int 约束： 最小值 = 1 最大值 = 4294967295
peeringType	对等互连类型。	“AzurePrivatePeering” “AzurePublicPeering” “MicrosoftPeering”
primaryAzurePort	主端口。	字符串
primaryPeerAddressPrefix	主地址前缀。	字符串
provisioningState	获取公共 IP 资源的预配状态。 可能的值包括：“正在更新”、“删除”和“Failed”。	字符串
routeFilter	RouteFilter 资源的引用。	RouteFilter
secondaryAzurePort	辅助端口。	字符串
secondaryPeerAddressPrefix	辅助地址前缀。	字符串
sharedKey	共享密钥。	字符串
州	对等互连状态。	“Disabled” “Enabled”
统计	获取对等互连统计信息。	ExpressRouteCircuitStats
vlanId	VLAN ID。	int

ExpressRouteCircuitPropertiesFormat

名字	描述	价值
allowClassicOperations	允许经典操作	bool
授权	授权列表。	ExpressRouteCircuitAuthorization[]
circuitProvisioningState	资源的 CircuitProvisioningState 状态。	字符串
gatewayManagerEtag	GatewayManager Etag。	字符串
对等互连	对等互连的列表。	ExpressRouteCircuitPeering[]
provisioningState	获取公共 IP 资源的预配状态。 可能的值包括：“正在更新”、“删除”和“Failed”。	字符串
serviceKey	ServiceKey。	字符串
serviceProviderNotes	ServiceProviderNotes。	字符串
serviceProviderProperties	ServiceProviderProperties。	ExpressRouteCircuitServiceProviderProperties
serviceProviderProvisioningState	资源的 ServiceProviderProvisioningState 状态。 可能的值为“NotProvisioned”、“Provisioning”、“Provisioned”和“Deprovisioning”。	“取消预配” “NotProvisioned” “Provisioned” “预配”

ExpressRouteCircuitServiceProviderProperties

名字	描述	价值
bandwidthInMbps	BandwidthInMbps。	int
peeringLocation	对等互连位置。	字符串
serviceProviderName	serviceProviderName。	字符串

ExpressRouteCircuitSku

名字	描述	价值
家庭	SKU 系列。 可能的值为：“UnlimitedData”和“MeteredData”。	“MeteredData” “UnlimitedData”
名字	SKU 的名称。	字符串
层	SKU 的层。 可能的值为“Standard”和“Premium”。	“Premium” “Standard”

ExpressRouteCircuitStats

名字	描述	价值
primarybytesIn	获取对等互连的 BytesIn。	int
primarybytesOut	获取对等互连的 BytesOut。	int
secondarybytesIn	获取对等互连的 BytesIn。	int
secondarybytesOut	获取对等互连的 BytesOut。	int

Ipv6ExpressRouteCircuitPeeringConfig

名字	描述	价值
microsoftPeeringConfig	Microsoft对等互连配置。	ExpressRouteCircuitPeeringConfig
primaryPeerAddressPrefix	主地址前缀。	字符串
routeFilter	RouteFilter 资源的引用。	RouteFilter
secondaryPeerAddressPrefix	辅助地址前缀。	字符串
州	对等互连的状态。 可能的值为：“Disabled”和“Enabled”	“Disabled” “Enabled”

Microsoft.Network/expressRouteCircuits

名字	描述	价值
apiVersion	API 版本	'2018-04-01'
位置	资源位置。	字符串
名字	资源名称	string （必需）
性能	ExpressRouteCircuit 的属性。	ExpressRouteCircuitPropertiesFormat
sku	SKU。	ExpressRouteCircuitSku
标签	资源标记	标记名称和值的字典。 请参阅模板 中的 标记
类型	资源类型	“Microsoft.Network/expressRouteCircuits”

ResourceTags

名字	描述	价值

ResourceTags

名字	描述	价值

RouteFilter

名字	描述	价值
id	资源 ID。	字符串
位置	资源位置。	字符串
性能	路由筛选器资源	RouteFilterPropertiesFormat
标签	资源标记。	ResourceTags

RouteFilterPropertiesFormat

名字	描述	价值
对等互连	对快速路由线路对等互连的引用集合。	ExpressRouteCircuitPeering[]
规则	路由筛选器中包含的 RouteFilterRules 的集合。	RouteFilterRule[]

RouteFilterRule

名字	描述	价值
id	资源 ID。	字符串
位置	资源位置。	字符串
名字	资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能	路由筛选器规则资源	RouteFilterRulePropertiesFormat

RouteFilterRulePropertiesFormat

名字	描述	价值
访问	规则的访问类型。 有效值为：“Allow”、“Deny”	“允许” “拒绝”（必需）
社区	要筛选的 bgp 社区值的集合。例如 ['12076：5010'，'12076：5020']	string[] （必需）
routeFilterRuleType	规则的规则类型。 有效值为：“Community”	“社区”（必需）

SubResource

名字	描述	价值
id	资源 ID。	字符串

快速入门模板

以下快速入门模板部署此资源类型。

模板	描述
创建 ExpressRoute 线路	此模板为指定的服务提供商和 SKU 创建 ExpressRoute 线路
使用 BGP 对等互连创建 ExpressRoute 线路	此模板为指定的服务提供商和 SKU 创建 ExpressRoute 线路和 AzurePrublicPeering BGP 对等互连
使用专用对等互连和 Azure VNet ExpressRoute 线路	此模板配置 ExpressRoute Microsoft对等互连，部署包含 Expressroute 网关的 Azure VNet，并将 VNet 链接到 ExpressRoute 线路

Terraform （AzAPI 提供程序）资源定义

可以使用目标操作部署 expressRouteCircuits 资源类型：

• 资源组

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Network/expressRouteCircuits 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/expressRouteCircuits@2018-04-01"
  name = "string"
  location = "string"
  sku = {
    family = "string"
    name = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      allowClassicOperations = bool
      authorizations = [
        {
          id = "string"
          name = "string"
          properties = {
            authorizationKey = "string"
            authorizationUseStatus = "string"
            provisioningState = "string"
          }
        }
      ]
      circuitProvisioningState = "string"
      gatewayManagerEtag = "string"
      peerings = [
        {
          id = "string"
          name = "string"
          properties = {
            azureASN = int
            connections = [
              {
                id = "string"
                name = "string"
                properties = {
                  addressPrefix = "string"
                  authorizationKey = "string"
                  expressRouteCircuitPeering = {
                    id = "string"
                  }
                  peerExpressRouteCircuitPeering = {
                    id = "string"
                  }
                }
              }
            ]
            gatewayManagerEtag = "string"
            ipv6PeeringConfig = {
              microsoftPeeringConfig = {
                advertisedCommunities = [
                  "string"
                ]
                advertisedPublicPrefixes = [
                  "string"
                ]
                advertisedPublicPrefixesState = "string"
                customerASN = int
                legacyMode = int
                routingRegistryName = "string"
              }
              primaryPeerAddressPrefix = "string"
              routeFilter = {
                id = "string"
                location = "string"
                properties = {
                  peerings = [
                    ...
                  ]
                  rules = [
                    {
                      id = "string"
                      location = "string"
                      name = "string"
                      properties = {
                        access = "string"
                        communities = [
                          "string"
                        ]
                        routeFilterRuleType = "string"
                      }
                    }
                  ]
                }
                tags = {
                  {customized property} = "string"
                }
              }
              secondaryPeerAddressPrefix = "string"
              state = "string"
            }
            lastModifiedBy = "string"
            microsoftPeeringConfig = {
              advertisedCommunities = [
                "string"
              ]
              advertisedPublicPrefixes = [
                "string"
              ]
              advertisedPublicPrefixesState = "string"
              customerASN = int
              legacyMode = int
              routingRegistryName = "string"
            }
            peerASN = int
            peeringType = "string"
            primaryAzurePort = "string"
            primaryPeerAddressPrefix = "string"
            provisioningState = "string"
            routeFilter = {
              id = "string"
              location = "string"
              properties = {
                peerings = [
                  ...
                ]
                rules = [
                  {
                    id = "string"
                    location = "string"
                    name = "string"
                    properties = {
                      access = "string"
                      communities = [
                        "string"
                      ]
                      routeFilterRuleType = "string"
                    }
                  }
                ]
              }
              tags = {
                {customized property} = "string"
              }
            }
            secondaryAzurePort = "string"
            secondaryPeerAddressPrefix = "string"
            sharedKey = "string"
            state = "string"
            stats = {
              primarybytesIn = int
              primarybytesOut = int
              secondarybytesIn = int
              secondarybytesOut = int
            }
            vlanId = int
          }
        }
      ]
      provisioningState = "string"
      serviceKey = "string"
      serviceProviderNotes = "string"
      serviceProviderProperties = {
        bandwidthInMbps = int
        peeringLocation = "string"
        serviceProviderName = "string"
      }
      serviceProviderProvisioningState = "string"
    }
  })
}

属性值

AuthorizationPropertiesFormat

名字	描述	价值
authorizationKey	授权密钥。	字符串
authorizationUseStatus	AuthorizationUseStatus。 可能的值为：“Available”和“InUse”。	“Available” “InUse”
provisioningState	获取公共 IP 资源的预配状态。 可能的值包括：“正在更新”、“删除”和“Failed”。	字符串

ExpressRouteCircuitAuthorization

名字	描述	价值
id	资源 ID。	字符串
名字	获取资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能		AuthorizationPropertiesFormat

ExpressRouteCircuitConnection

名字	描述	价值
id	资源 ID。	字符串
名字	获取资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能		ExpressRouteCircuitConnectionPropertiesFormat

ExpressRouteCircuitConnectionPropertiesFormat

名字	描述	价值
addressPrefix	/29 IP 地址空间来挖掘隧道的客户地址。	字符串
authorizationKey	授权密钥。	字符串
expressRouteCircuitPeering	对线路发起连接的 Express Route 线路专用对等互连资源的引用。	SubResource
peerExpressRouteCircuitPeering	对对等线路的 Express Route 线路专用对等互连资源的引用。	SubResource

ExpressRouteCircuitPeering

名字	描述	价值
id	资源 ID。	字符串
名字	获取资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能		ExpressRouteCircuitPeeringPropertiesFormat

ExpressRouteCircuitPeeringConfig

名字	描述	价值
广告社区	bgp 对等互连的社区。 为 Microsoft 对等互连指定	string[]
advertisedPublicPrefixes	AdvertisedPublicPrefixes 的引用。	string[]
advertisedPublicPrefixesState	对等互连资源的 AdvertisedPublicPrefixState。 可能的值为“NotConfigured”、“Configuring”、“Configured”和“ValidationNeeded”。	“已配置” “配置” “NotConfigured” “ValidationNeeded”
customerASN	对等互连的 CustomerASN。	int
legacyMode	对等互连的旧模式。	int
routingRegistryName	配置的 RoutingRegistryName。	字符串

ExpressRouteCircuitPeeringPropertiesFormat

名字	描述	价值
azureASN	Azure ASN。	int
连接	与此线路的 Azure 专用对等互连关联的线路连接列表。	ExpressRouteCircuitConnection[]
gatewayManagerEtag	GatewayManager Etag。	字符串
ipv6PeeringConfig	IPv6 对等互连配置。	Ipv6ExpressRouteCircuitPeeringConfig
lastModifiedBy	获取提供程序还是客户上次修改对等互连。	字符串
microsoftPeeringConfig	Microsoft对等互连配置。	ExpressRouteCircuitPeeringConfig
peerASN	对等 ASN。	int 约束： 最小值 = 1 最大值 = 4294967295
peeringType	对等互连类型。	“AzurePrivatePeering” “AzurePublicPeering” “MicrosoftPeering”
primaryAzurePort	主端口。	字符串
primaryPeerAddressPrefix	主地址前缀。	字符串
provisioningState	获取公共 IP 资源的预配状态。 可能的值包括：“正在更新”、“删除”和“Failed”。	字符串
routeFilter	RouteFilter 资源的引用。	RouteFilter
secondaryAzurePort	辅助端口。	字符串
secondaryPeerAddressPrefix	辅助地址前缀。	字符串
sharedKey	共享密钥。	字符串
州	对等互连状态。	“Disabled” “Enabled”
统计	获取对等互连统计信息。	ExpressRouteCircuitStats
vlanId	VLAN ID。	int

ExpressRouteCircuitPropertiesFormat

名字	描述	价值
allowClassicOperations	允许经典操作	bool
授权	授权列表。	ExpressRouteCircuitAuthorization[]
circuitProvisioningState	资源的 CircuitProvisioningState 状态。	字符串
gatewayManagerEtag	GatewayManager Etag。	字符串
对等互连	对等互连的列表。	ExpressRouteCircuitPeering[]
provisioningState	获取公共 IP 资源的预配状态。 可能的值包括：“正在更新”、“删除”和“Failed”。	字符串
serviceKey	ServiceKey。	字符串
serviceProviderNotes	ServiceProviderNotes。	字符串
serviceProviderProperties	ServiceProviderProperties。	ExpressRouteCircuitServiceProviderProperties
serviceProviderProvisioningState	资源的 ServiceProviderProvisioningState 状态。 可能的值为“NotProvisioned”、“Provisioning”、“Provisioned”和“Deprovisioning”。	“取消预配” “NotProvisioned” “Provisioned” “预配”

ExpressRouteCircuitServiceProviderProperties

名字	描述	价值
bandwidthInMbps	BandwidthInMbps。	int
peeringLocation	对等互连位置。	字符串
serviceProviderName	serviceProviderName。	字符串

ExpressRouteCircuitSku

名字	描述	价值
家庭	SKU 系列。 可能的值为：“UnlimitedData”和“MeteredData”。	“MeteredData” “UnlimitedData”
名字	SKU 的名称。	字符串
层	SKU 的层。 可能的值为“Standard”和“Premium”。	“Premium” “Standard”

ExpressRouteCircuitStats

名字	描述	价值
primarybytesIn	获取对等互连的 BytesIn。	int
primarybytesOut	获取对等互连的 BytesOut。	int
secondarybytesIn	获取对等互连的 BytesIn。	int
secondarybytesOut	获取对等互连的 BytesOut。	int

Ipv6ExpressRouteCircuitPeeringConfig

名字	描述	价值
microsoftPeeringConfig	Microsoft对等互连配置。	ExpressRouteCircuitPeeringConfig
primaryPeerAddressPrefix	主地址前缀。	字符串
routeFilter	RouteFilter 资源的引用。	RouteFilter
secondaryPeerAddressPrefix	辅助地址前缀。	字符串
州	对等互连的状态。 可能的值为：“Disabled”和“Enabled”	“Disabled” “Enabled”

Microsoft.Network/expressRouteCircuits

名字	描述	价值
位置	资源位置。	字符串
名字	资源名称	string （必需）
性能	ExpressRouteCircuit 的属性。	ExpressRouteCircuitPropertiesFormat
sku	SKU。	ExpressRouteCircuitSku
标签	资源标记	标记名称和值的字典。
类型	资源类型	“Microsoft.Network/expressRouteCircuits@2018-04-01”

ResourceTags

名字	描述	价值

ResourceTags

名字	描述	价值

RouteFilter

名字	描述	价值
id	资源 ID。	字符串
位置	资源位置。	字符串
性能	路由筛选器资源	RouteFilterPropertiesFormat
标签	资源标记。	ResourceTags

RouteFilterPropertiesFormat

名字	描述	价值
对等互连	对快速路由线路对等互连的引用集合。	ExpressRouteCircuitPeering[]
规则	路由筛选器中包含的 RouteFilterRules 的集合。	RouteFilterRule[]

RouteFilterRule

名字	描述	价值
id	资源 ID。	字符串
位置	资源位置。	字符串
名字	资源组中唯一的资源的名称。 此名称可用于访问资源。	字符串
性能	路由筛选器规则资源	RouteFilterRulePropertiesFormat

RouteFilterRulePropertiesFormat

名字	描述	价值
访问	规则的访问类型。 有效值为：“Allow”、“Deny”	“允许” “拒绝”（必需）
社区	要筛选的 bgp 社区值的集合。例如 ['12076：5010'，'12076：5020']	string[] （必需）
routeFilterRuleType	规则的规则类型。 有效值为：“Community”	“社区”（必需）

SubResource

名字	描述	价值
id	资源 ID。	字符串