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

Express Route Connections - Create Or Update

参考

Service:: ExpressRoute

API Version:: 2019-12-01

在 ExpressRoute 网关和 ExpressRoute 线路之间创建连接。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteGateways/{expressRouteGatewayName}/expressRouteConnections/{connectionName}?api-version=2019-12-01

URI 参数

名称	在	必需	类型	说明
connectionName	path	True	string	连接子资源的名称。
expressRouteGatewayName	path	True	string	ExpressRoute 网关的名称。
resourceGroupName	path	True	string	资源组的名称。
subscriptionId	path	True	string	可以唯一标识 Microsoft Azure 订阅的订阅凭据。此订阅 ID 是每个服务调用的 URI 的一部分。
api-version	query	True	string	客户端 API 版本。

请求正文

名称	必需	类型	说明
name	True	string	资源的名称。
properties.expressRouteCircuitPeering	True	ExpressRouteCircuitPeeringId	ExpressRoute 线路对等互连。
id		string	资源 ID。
properties.authorizationKey		string	用于建立连接的授权密钥。
properties.enableInternetSecurity		boolean	启用 Internet 安全性。
properties.routingWeight		integer	与连接关联的路由权重。

响应

名称	类型	说明
200 OK	ExpressRouteConnection	更新成功。该操作返回 ExpressRouteConnection。
201 Created	ExpressRouteConnection	创建成功。该操作返回 ExpressRouteConnection。
Other Status Codes	CloudError	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

ExpressRouteConnectionCreate

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/resourceGroupName/providers/Microsoft.Network/expressRouteGateways/gateway-2/expressRouteConnections/connectionName?api-version=2019-12-01

{
  "id": "/subscriptions/subid/resourceGroups/resourceGroupName/providers/Microsoft.Network/expressRouteGateways/gateway-2/expressRouteConnections/connectionName",
  "name": "connectionName",
  "properties": {
    "routingWeight": 2,
    "authorizationKey": "authorizationKey",
    "expressRouteCircuitPeering": {
      "id": "/subscriptions/subid/resourceGroups/resourceGroupName/providers/Microsoft.Network/expressRouteCircuits/circuitName/peerings/AzurePrivatePeering"
    }
  }
}

Sample Response

Status code:: 200

{
  "name": "connectionName",
  "id": "/subscriptions/subid/resourceGroups/resourceGroupName/providers/Microsoft.Network/expressRouteGateways/gateway-2/expressRouteConnections/connectionName",
  "properties": {
    "provisioningState": "Provisioned",
    "expressRouteCircuitPeering": {
      "id": "/subscriptions/subid/resourceGroups/resourceGroupName/providers/Microsoft.Network/expressRouteCircuits/circuitName/peerings/AzurePrivatePeering"
    },
    "authorizationKey": "authorizationKey",
    "routingWeight": 2
  }
}

Status code:: 201

{
  "name": "connectionName",
  "id": "/subscriptions/subid/resourceGroups/resourceGroupName/providers/Microsoft.Network/expressRouteGateways/gateway-2/expressRouteConnections/connectionName",
  "properties": {
    "provisioningState": "Provisioned",
    "expressRouteCircuitPeering": {
      "id": "/subscriptions/subid/resourceGroups/resourceGroupName/providers/Microsoft.Network/expressRouteCircuits/circuitName/peerings/AzurePrivatePeering"
    },
    "authorizationKey": "authorizationKey",
    "routingWeight": 2
  }
}

定义

名称	说明
CloudError	来自服务的错误响应。
CloudErrorBody	来自服务的错误响应。
ExpressRouteCircuitPeeringId	ExpressRoute 线路对等互连标识符。
ExpressRouteConnection	ExpressRouteConnection 资源。
ProvisioningState	当前预配状态。

CloudError

来自服务的错误响应。

名称	类型	说明
error	CloudErrorBody	云错误正文。

CloudErrorBody

来自服务的错误响应。

名称	类型	说明
code	string	错误的标识符。代码是固定的，旨在以编程方式使用。
details	CloudErrorBody[]	有关错误的其他详细信息的列表。
message	string	描述错误的消息，该消息适用于在用户界面中显示。
target	string	特定错误的目标。例如，属性的名称出错。

ExpressRouteCircuitPeeringId

ExpressRoute 线路对等互连标识符。

名称	类型	说明
id	string	ExpressRoute 线路对等互连的 ID。

ExpressRouteConnection

ExpressRouteConnection 资源。

名称	类型	说明
id	string	资源 ID。
name	string	资源的名称。
properties.authorizationKey	string	用于建立连接的授权密钥。
properties.enableInternetSecurity	boolean	启用 Internet 安全性。
properties.expressRouteCircuitPeering	ExpressRouteCircuitPeeringId	ExpressRoute 线路对等互连。
properties.provisioningState	ProvisioningState	快速路由连接资源的预配状态。
properties.routingWeight	integer	与连接关联的路由权重。

ProvisioningState

当前预配状态。

名称	类型	说明
Deleting	string
Failed	string
Succeeded	string
Updating	string