# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure VirtualWANAsAServiceManagementClient P2S…
  version: 1.0.0
extends: openapi/microsoft-azure-p2svpngateways-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/p2svpnGateways/{gatewayName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a point-to-site VPN gateway
      effect: write
      questions:
      - How do I change the tags on a Virtual WAN point-to-site VPN gateway?
      - Can I retag a P2S VPN gateway without touching its configuration?
      instructions:
      - text: Update the tags on P2S VPN gateway {gw} in resource group {rg}.
        slots:
          gw: path.gatewayName
          rg: path.resourceGroupName
      - text: Retag point-to-site gateway {gw} in {rg}.
        slots:
          gw: path.gatewayName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/p2svpnGateways/{gatewayName}/reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset a point-to-site VPN gateway
      effect: write
      questions:
      - How do I reset the primary instance of a P2S VPN gateway that's misbehaving?
      - Can I restart a Virtual WAN point-to-site gateway?
      instructions:
      - text: Reset the primary of P2S VPN gateway {gw} in resource group {rg}.
        slots:
          gw: path.gatewayName
          rg: path.resourceGroupName
      - text: Restart point-to-site gateway {gw} in {rg}.
        slots:
          gw: path.gatewayName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/p2svpnGateways/{gatewayName}/generatevpnprofile'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a VPN client profile for a P2S gateway
      effect: write
      questions:
      - How do I download a VPN client configuration profile for my point-to-site users?
      - Can I generate a P2S VPN profile for EAP-TLS or certificate authentication?
      instructions:
      - text: Generate a VPN client profile for P2S gateway {gw} in resource group {rg}.
        slots:
          gw: path.gatewayName
          rg: path.resourceGroupName
      - text: Create a VPN profile for gateway {gw} in {rg} using authentication method {auth}.
        slots:
          gw: path.gatewayName
          rg: path.resourceGroupName
          auth: requestBody.authenticationMethod
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/p2svpnGateways/{gatewayName}/getP2sVpnConnectionHealth'].post
  update:
    x-apievangelist-phrasing:
      intent: Get P2S VPN client connection health
      effect: read
      questions:
      - How healthy are the point-to-site client connections on my Virtual WAN gateway?
      - Can I get a quick connection health summary for P2S VPN clients?
      instructions:
      - text: Get P2S client connection health for gateway {gw} in resource group {rg}.
        slots:
          gw: path.gatewayName
          rg: path.resourceGroupName
      - text: Show the connection health summary of point-to-site clients on {gw} in {rg}.
        slots:
          gw: path.gatewayName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/p2svpnGateways/{gatewayName}/getP2sVpnConnectionHealthDetailed'].post
  update:
    x-apievangelist-phrasing:
      intent: Export detailed P2S VPN connection health to blob
      effect: read
      questions:
      - How do I get per-user connection health details for my P2S VPN gateway written to storage?
      - Can I filter the detailed P2S health report to specific VPN user names?
      instructions:
      - text: Write detailed P2S connection health for gateway {gw} in resource group {rg} to SAS URL {sasUrl}.
        slots:
          gw: path.gatewayName
          rg: path.resourceGroupName
          sasUrl: requestBody.outputBlobSasUrl
      - text: Export detailed health for VPN users {users} on gateway {gw} in {rg}.
        slots:
          users: requestBody.vpnUserNamesFilter
          gw: path.gatewayName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/p2svpnGateways/{p2sVpnGatewayName}/disconnectP2sVpnConnections'].post
  update:
    x-apievangelist-phrasing:
      intent: Disconnect point-to-site VPN client connections
      effect: destructive
      questions:
      - How do I kick specific users off my point-to-site VPN gateway?
      - Can I force-disconnect P2S VPN sessions by connection ID?
      instructions:
      - text: Disconnect P2S VPN connections {ids} on gateway {gw} in resource group {rg}.
        slots:
          ids: requestBody.vpnConnectionIds
          gw: path.p2sVpnGatewayName
          rg: path.resourceGroupName
      - text: Drop the point-to-site sessions on gateway {gw} in {rg}.
        slots:
          gw: path.p2sVpnGatewayName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'