你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Vpn Gateways - Reset
重置指定资源组中 VPN 网关的主网关。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/reset?api-version=2024-05-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnGateways/{gatewayName}/reset?ipConfigurationId={ipConfigurationId}&api-version=2024-05-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
gateway
|
path | True |
string |
网关的名称。 |
resource
|
path | True |
string |
VpnGateway 的资源组名称。 |
subscription
|
path | True |
string |
唯一标识 Azure 订阅Microsoft的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
ip
|
query |
string |
用于指定网关实例的 VpnGateway ipConfigurationId。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
请求成功。 该操作重置 VpnGateway 的主节点。 |
|
202 Accepted |
接受且操作将以异步方式完成。 |
|
Other Status Codes |
描述操作失败的原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
ResetVpnGateway
示例请求
示例响应
location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/operationResults/{operationId}?api-version={api-version}
{
"name": "vpngw",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/vpngw",
"etag": "w/\\00000000-0000-0000-0000-000000000000\\",
"location": "West US",
"type": "Microsoft.Network/vpnGateways",
"properties": {
"provisioningState": "Succeeded",
"virtualHub": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1"
},
"connections": [
{
"name": "vpnConnection1",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnGateways/vpngw/vpnConnections/vpnConnection1",
"etag": "w/\\00000000-0000-0000-0000-000000000000\\",
"properties": {
"provisioningState": "Succeeded",
"remoteVpnSite": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1"
},
"connectionStatus": "Connected",
"ingressBytesTransferred": 0,
"egressBytesTransferred": 0,
"routingWeight": 0,
"connectionBandwidth": 100,
"sharedKey": "key",
"enableBgp": false,
"useLocalAzureIpAddress": false,
"ipsecPolicies": [],
"routingConfiguration": {
"associatedRouteTable": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1"
},
"propagatedRouteTables": {
"labels": [
"label1",
"label2"
],
"ids": [
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1"
},
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable2"
},
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable3"
}
]
},
"vnetRoutes": {
"staticRoutes": []
}
}
}
}
],
"bgpSettings": {
"asn": 65514,
"bgpPeeringAddress": "10.0.1.30",
"peerWeight": 0,
"bgpPeeringAddresses": [
{
"ipconfigurationId": "Instance0",
"defaultBgpIpAddresses": [
"10.30.0.4"
],
"customBgpIpAddresses": [
"169.254.21.5"
],
"tunnelIpAddresses": [
"104.208.48.178"
]
},
{
"ipconfigurationId": "Instance1",
"defaultBgpIpAddresses": [
"10.30.0.5"
],
"customBgpIpAddresses": [
"169.254.21.10"
],
"tunnelIpAddresses": [
"104.208.48.179"
]
}
]
},
"natRules": [],
"isRoutingPreferenceInternet": false,
"enableBgpRouteTranslationForNat": false
}
}
定义
名称 | 说明 |
---|---|
Bgp |
BGP 设置详细信息。 |
Cloud |
服务的错误响应。 |
Cloud |
服务的错误响应。 |
Dh |
IKE 阶段 1 中使用的 DH 组用于初始 SA。 |
Gateway |
虚拟网络网关连接的 GatewayCustomBgpIpAddressIpConfiguration。 |
Ike |
IKE 加密算法(IKE 阶段 2)。 |
Ike |
IKE 完整性算法(IKE 阶段 2)。 |
IPConfiguration |
IPConfigurationBgpPeeringAddress 的属性。 |
Ipsec |
IPSec 加密算法(IKE 阶段 1)。 |
Ipsec |
IPSec 完整性算法(IKE 阶段 1)。 |
Ipsec |
虚拟网络网关连接的 IPSec 策略配置。 |
Pfs |
IKE 阶段 2 中用于新子 SA 的 Pfs 组。 |
Propagated |
要向其播发路由的 RouteTable 列表。 |
Provisioning |
当前预配状态。 |
Routing |
路由配置,指示此连接的关联路由表和传播的路由表。 |
Static |
所有静态路由的列表。 |
Static |
此 HubVnetConnectionConfiguration 上静态路由的配置,用于此 HubVnetConnection 上的静态路由。 |
Sub |
对另一个子资源的引用。 |
Traffic |
虚拟网络网关连接的流量选择器策略。 |
Virtual |
用于此连接的连接协议。 |
Vnet |
确定辐射 vnet 中的 NVA 是否为辐射 vnet 中的流量绕过参数。 |
Vnet |
控制从 VirtualHub 到虚拟网络连接的路由的路由列表。 |
Vpn |
VpnConnection 资源。 |
Vpn |
VPN 连接的当前状态。 |
Vpn |
VpnGateway 资源。 |
Vpn |
VPN 网关资源的 IP 配置。 |
Vpn |
VpnGatewayNatRule 资源。 |
Vpn |
Vpn 链接连接模式。 |
Vpn |
Vpn NatRule 映射。 |
Vpn |
VPN NAT 的源 NAT 方向。 |
Vpn |
VPN NAT 的 NAT 规则的类型。 |
Vpn |
VpnSiteLinkConnection 资源。 |
BgpSettings
BGP 设置详细信息。
名称 | 类型 | 说明 |
---|---|---|
asn |
integer |
BGP 扬声器的 ASN。 |
bgpPeeringAddress |
string |
此 BGP 扬声器的 BGP 对等互连地址和 BGP 标识符。 |
bgpPeeringAddresses |
具有虚拟网络网关 IP 配置 ID 的 BGP 对等互连地址。 |
|
peerWeight |
integer |
添加到从此 BGP 扬声器中学习的路由的权重。 |
CloudError
服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
云错误正文。 |
CloudErrorBody
服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误的标识符。 代码是固定的,旨在以编程方式使用。 |
details |
有关错误的其他详细信息的列表。 |
|
message |
string |
描述错误的消息,旨在适合在用户界面中显示。 |
target |
string |
特定错误的目标。 例如,错误属性的名称。 |
DhGroup
IKE 阶段 1 中使用的 DH 组用于初始 SA。
值 | 说明 |
---|---|
DHGroup1 | |
DHGroup14 | |
DHGroup2 | |
DHGroup2048 | |
DHGroup24 | |
ECP256 | |
ECP384 | |
None |
GatewayCustomBgpIpAddressIpConfiguration
虚拟网络网关连接的 GatewayCustomBgpIpAddressIpConfiguration。
名称 | 类型 | 说明 |
---|---|---|
customBgpIpAddress |
string |
属于 IpconfigurationId 的自定义 BgpPeeringAddress。 |
ipConfigurationId |
string |
属于网关的 ipconfiguration 的 IpconfigurationId。 |
IkeEncryption
IKE 加密算法(IKE 阶段 2)。
值 | 说明 |
---|---|
AES128 | |
AES192 | |
AES256 | |
DES | |
DES3 | |
GCMAES128 | |
GCMAES256 |
IkeIntegrity
IKE 完整性算法(IKE 阶段 2)。
值 | 说明 |
---|---|
GCMAES128 | |
GCMAES256 | |
MD5 | |
SHA1 | |
SHA256 | |
SHA384 |
IPConfigurationBgpPeeringAddress
IPConfigurationBgpPeeringAddress 的属性。
名称 | 类型 | 说明 |
---|---|---|
customBgpIpAddresses |
string[] |
属于 IP 配置的自定义 BGP 对等互连地址的列表。 |
defaultBgpIpAddresses |
string[] |
属于 IP 配置的默认 BGP 对等互连地址的列表。 |
ipconfigurationId |
string |
属于网关的 IP 配置的 ID。 |
tunnelIpAddresses |
string[] |
属于 IP 配置的隧道公共 IP 地址的列表。 |
IpsecEncryption
IPSec 加密算法(IKE 阶段 1)。
值 | 说明 |
---|---|
AES128 | |
AES192 | |
AES256 | |
DES | |
DES3 | |
GCMAES128 | |
GCMAES192 | |
GCMAES256 | |
None |
IpsecIntegrity
IPSec 完整性算法(IKE 阶段 1)。
值 | 说明 |
---|---|
GCMAES128 | |
GCMAES192 | |
GCMAES256 | |
MD5 | |
SHA1 | |
SHA256 |
IpsecPolicy
虚拟网络网关连接的 IPSec 策略配置。
名称 | 类型 | 说明 |
---|---|---|
dhGroup |
IKE 阶段 1 中用于初始 SA 的 DH 组。 |
|
ikeEncryption |
IKE 加密算法(IKE 阶段 2)。 |
|
ikeIntegrity |
IKE 完整性算法(IKE 阶段 2)。 |
|
ipsecEncryption |
IPSec 加密算法(IKE 阶段 1)。 |
|
ipsecIntegrity |
IPSec 完整性算法(IKE 阶段 1)。 |
|
pfsGroup |
IKE 阶段 2 中使用的 Pfs 组用于新的子 SA。 |
|
saDataSizeKilobytes |
integer |
IPSec 安全关联(也称为快速模式或阶段 2 SA)有效负载大小(以 KB 为单位),用于站点到站点 VPN 隧道。 |
saLifeTimeSeconds |
integer |
站点到站点 VPN 隧道的 IPSec 安全关联(也称为快速模式或阶段 2 SA)生存期(以秒为单位)。 |
PfsGroup
IKE 阶段 2 中用于新子 SA 的 Pfs 组。
值 | 说明 |
---|---|
ECP256 | |
ECP384 | |
None | |
PFS1 | |
PFS14 | |
PFS2 | |
PFS2048 | |
PFS24 | |
PFSMM |
PropagatedRouteTable
要向其播发路由的 RouteTable 列表。
名称 | 类型 | 说明 |
---|---|---|
ids |
所有 RouteTable 的资源 ID 列表。 |
|
labels |
string[] |
标签列表。 |
ProvisioningState
当前预配状态。
值 | 说明 |
---|---|
Deleting | |
Failed | |
Succeeded | |
Updating |
RoutingConfiguration
路由配置,指示此连接的关联路由表和传播的路由表。
名称 | 类型 | 说明 |
---|---|---|
associatedRouteTable |
与此 RoutingConfiguration 关联的资源 ID RouteTable。 |
|
inboundRouteMap |
与此 RoutingConfiguration 关联的 RouteMap 的资源 ID,用于入站学习的路由。 |
|
outboundRouteMap |
与此 RoutingConfiguration 关联的RouteMap 的资源 ID,用于出站播发路由。 |
|
propagatedRouteTables |
要向其播发路由的 RouteTable 列表。 |
|
vnetRoutes |
控制从 VirtualHub 到虚拟网络连接的路由的路由列表。 |
StaticRoute
所有静态路由的列表。
名称 | 类型 | 说明 |
---|---|---|
addressPrefixes |
string[] |
所有地址前缀的列表。 |
name |
string |
在 VnetRoute 中唯一的 StaticRoute 的名称。 |
nextHopIpAddress |
string |
下一跃点的 IP 地址。 |
StaticRoutesConfig
此 HubVnetConnectionConfiguration 上静态路由的配置,用于此 HubVnetConnection 上的静态路由。
名称 | 类型 | 说明 |
---|---|---|
propagateStaticRoutes |
boolean |
指示此连接上的静态路由是否自动传播到此连接传播到的路由表的布尔值。 |
vnetLocalRouteOverrideCriteria |
参数,用于确定辐射 vnet 中的 NVA 是否为辐射中具有目标的流量绕过。 |
SubResource
对另一个子资源的引用。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源 ID。 |
TrafficSelectorPolicy
虚拟网络网关连接的流量选择器策略。
名称 | 类型 | 说明 |
---|---|---|
localAddressRanges |
string[] |
CIDR 格式的本地地址空间的集合。 |
remoteAddressRanges |
string[] |
采用 CIDR 格式的远程地址空间集合。 |
VirtualNetworkGatewayConnectionProtocol
用于此连接的连接协议。
值 | 说明 |
---|---|
IKEv1 | |
IKEv2 |
VnetLocalRouteOverrideCriteria
确定辐射 vnet 中的 NVA 是否为辐射 vnet 中的流量绕过参数。
值 | 说明 |
---|---|
Contains | |
Equal |
VnetRoute
控制从 VirtualHub 到虚拟网络连接的路由的路由列表。
名称 | 类型 | 说明 |
---|---|---|
bgpConnections |
对 HubBgpConnection 对象的引用列表。 |
|
staticRoutes |
所有静态路由的列表。 |
|
staticRoutesConfig |
此 HubVnetConnection 上的静态路由的配置。 |
VpnConnection
VpnConnection 资源。
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
一个唯一的只读字符串,每当更新资源时更改。 |
id |
string |
资源 ID。 |
name |
string |
资源组中唯一的资源的名称。 此名称可用于访问资源。 |
properties.connectionBandwidth |
integer |
预期带宽(以 MBPS 为单位)。 |
properties.connectionStatus |
连接状态。 |
|
properties.dpdTimeoutSeconds |
integer |
VPN 连接的 DPD 超时(以秒为单位)。 |
properties.egressBytesTransferred |
integer |
传输的出口字节数。 |
properties.enableBgp |
boolean |
EnableBgp 标志。 |
properties.enableInternetSecurity |
boolean |
启用 Internet 安全性。 |
properties.enableRateLimiting |
boolean |
EnableBgp 标志。 |
properties.ingressBytesTransferred |
integer |
传输的入口字节数。 |
properties.ipsecPolicies |
此连接要考虑的 IPSec 策略。 |
|
properties.provisioningState |
VPN 连接资源的预配状态。 |
|
properties.remoteVpnSite |
连接的 VPN 站点的 ID。 |
|
properties.routingConfiguration |
路由配置,指示此连接上关联的路由表和传播的路由表。 |
|
properties.routingWeight |
integer |
VPN 连接的路由权重。 |
properties.sharedKey |
string |
用于 VPN 连接的 SharedKey。 |
properties.trafficSelectorPolicies |
此连接要考虑的流量选择器策略。 |
|
properties.useLocalAzureIpAddress |
boolean |
使用本地 Azure IP 启动连接。 |
properties.usePolicyBasedTrafficSelectors |
boolean |
启用基于策略的流量选择器。 |
properties.vpnConnectionProtocolType |
用于此连接的连接协议。 |
|
properties.vpnLinkConnections |
指向网关的所有 VPN 站点链接连接的列表。 |
VpnConnectionStatus
VPN 连接的当前状态。
值 | 说明 |
---|---|
Connected | |
Connecting | |
NotConnected | |
Unknown |
VpnGateway
VpnGateway 资源。
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
一个唯一的只读字符串,每当更新资源时更改。 |
id |
string |
资源 ID。 |
location |
string |
资源位置。 |
name |
string |
资源名称。 |
properties.bgpSettings |
本地网络网关的 BGP 扬声器设置。 |
|
properties.connections |
指向网关的所有 VPN 连接的列表。 |
|
properties.enableBgpRouteTranslationForNat |
boolean |
在此 VpnGateway 上为 NAT 启用 BGP 路由转换。 |
properties.ipConfigurations |
网关上配置的所有 IP 的列表。 |
|
properties.isRoutingPreferenceInternet |
boolean |
为 VpnGateway 的公共 IP 接口启用路由首选项属性。 |
properties.natRules |
与网关关联的所有 nat 规则的列表。 |
|
properties.provisioningState |
VPN 网关资源的预配状态。 |
|
properties.virtualHub |
网关所属的 VirtualHub。 |
|
properties.vpnGatewayScaleUnit |
integer |
此 VPN 网关的缩放单元。 |
tags |
object |
资源标记。 |
type |
string |
资源类型。 |
VpnGatewayIpConfiguration
VPN 网关资源的 IP 配置。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
VPN 网关的 IP 配置的标识符。 |
privateIpAddress |
string |
此 IP 配置的专用 IP 地址。 |
publicIpAddress |
string |
此 IP 配置的公共 IP 地址。 |
VpnGatewayNatRule
VpnGatewayNatRule 资源。
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
一个唯一的只读字符串,每当更新资源时更改。 |
id |
string |
资源 ID。 |
name |
string |
资源组中唯一的资源的名称。 此名称可用于访问资源。 |
properties.egressVpnSiteLinkConnections |
出口 VpnSiteLinkConnections 的列表。 |
|
properties.externalMappings |
NAT 的专用 IP 地址外部映射。 |
|
properties.ingressVpnSiteLinkConnections |
入口 VpnSiteLinkConnections 的列表。 |
|
properties.internalMappings |
NAT 的专用 IP 地址内部映射。 |
|
properties.ipConfigurationId |
string |
此 NAT 规则适用的 IP 配置 ID。 |
properties.mode |
VPN NAT 的源 NAT 方向。 |
|
properties.provisioningState |
NAT 规则资源的预配状态。 |
|
properties.type |
VPN NAT 的 NAT 规则的类型。 |
|
type |
string |
资源类型。 |
VpnLinkConnectionMode
Vpn 链接连接模式。
值 | 说明 |
---|---|
Default | |
InitiatorOnly | |
ResponderOnly |
VpnNatRuleMapping
Vpn NatRule 映射。
名称 | 类型 | 说明 |
---|---|---|
addressSpace |
string |
Vpn NatRule 映射的地址空间。 |
portRange |
string |
Vpn NatRule 映射的端口范围。 |
VpnNatRuleMode
VPN NAT 的源 NAT 方向。
值 | 说明 |
---|---|
EgressSnat | |
IngressSnat |
VpnNatRuleType
VPN NAT 的 NAT 规则的类型。
值 | 说明 |
---|---|
Dynamic | |
Static |
VpnSiteLinkConnection
VpnSiteLinkConnection 资源。
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
一个唯一的只读字符串,每当更新资源时更改。 |
id |
string |
资源 ID。 |
name |
string |
资源组中唯一的资源的名称。 此名称可用于访问资源。 |
properties.connectionBandwidth |
integer |
预期带宽(以 MBPS 为单位)。 |
properties.connectionStatus |
连接状态。 |
|
properties.dpdTimeoutSeconds |
integer |
VpnLink 连接的死对等检测超时(以秒为单位)。 |
properties.egressBytesTransferred |
integer |
传输的出口字节数。 |
properties.egressNatRules |
出口 NatRules 列表。 |
|
properties.enableBgp |
boolean |
EnableBgp 标志。 |
properties.enableRateLimiting |
boolean |
EnableBgp 标志。 |
properties.ingressBytesTransferred |
integer |
传输的入口字节数。 |
properties.ingressNatRules |
入口 NatRules 列表。 |
|
properties.ipsecPolicies |
此连接要考虑的 IPSec 策略。 |
|
properties.provisioningState |
VPN 站点链接连接资源的预配状态。 |
|
properties.routingWeight |
integer |
VPN 连接的路由权重。 |
properties.sharedKey |
string |
用于 VPN 连接的 SharedKey。 |
properties.useLocalAzureIpAddress |
boolean |
使用本地 Azure IP 启动连接。 |
properties.usePolicyBasedTrafficSelectors |
boolean |
启用基于策略的流量选择器。 |
properties.vpnConnectionProtocolType |
用于此连接的连接协议。 |
|
properties.vpnGatewayCustomBgpAddresses |
此连接使用的 vpnGatewayCustomBgpAddresses。 |
|
properties.vpnLinkConnectionMode |
Vpn 链接连接模式。 |
|
properties.vpnSiteLink |
连接的 VPN 站点链接的 ID。 |
|
type |
string |
资源类型。 |