# 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 NetworkResourceProviderClient Virtual…
  version: 1.0.0
extends: openapi/microsoft-azure-virtualnetworkgateways-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualnetworkgateways/{virtualNetworkGatewayName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a virtual network gateway
      effect: read
      questions:
      - How do I check the configuration of one virtual network gateway?
      - What details does Azure return about a specific VPN gateway?
      instructions:
      - text: Get virtual network gateway {gateway_name} in resource group {resource_group} (subscription {subscription_id}).
        slots:
          gateway_name: path.virtualNetworkGatewayName
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
      - text: Show the settings of gateway {gateway_name}.
        slots:
          gateway_name: path.virtualNetworkGatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualnetworkgateways/{virtualNetworkGatewayName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a virtual network gateway
      effect: write
      questions:
      - How do I provision a new virtual network gateway in a resource group?
      - Which region do I have to specify when creating a VPN gateway?
      instructions:
      - text: Create virtual network gateway {gateway_name} in resource group {resource_group} in {location} (subscription {subscription_id}).
        slots:
          gateway_name: path.virtualNetworkGatewayName
          resource_group: path.resourceGroupName
          location: requestBody.location
          subscription_id: path.subscriptionId
      - text: Update gateway {gateway_name} with properties {properties} and tags {tags}.
        slots:
          gateway_name: path.virtualNetworkGatewayName
          properties: requestBody.properties
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworkGateways/{virtualNetworkGatewayName}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a virtual network gateway
      effect: destructive
      questions:
      - How do I tear down a virtual network gateway I no longer need?
      - Can I delete a VPN gateway from a resource group?
      instructions:
      - text: Delete virtual network gateway {gateway_name} in resource group {resource_group} (subscription {subscription_id}).
        slots:
          gateway_name: path.virtualNetworkGatewayName
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
      - text: Remove gateway {gateway_name}.
        slots:
          gateway_name: path.virtualNetworkGatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworkGateways'].get
  update:
    x-apievangelist-phrasing:
      intent: List virtual network gateways in a resource group
      effect: read
      questions:
      - Which virtual network gateways exist in my resource group?
      - Can I get an inventory of all VPN gateways I have deployed?
      instructions:
      - text: List the virtual network gateways in resource group {resource_group} (subscription {subscription_id}).
        slots:
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
      - text: Show every gateway deployed in {resource_group}.
        slots:
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualnetworkgateways/{virtualNetworkGatewayName}/reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset the primary of a virtual network gateway
      effect: write
      questions:
      - How do I reset a virtual network gateway that is misbehaving?
      - Does a gateway reset affect the primary instance?
      instructions:
      - text: Reset the primary of virtual network gateway {gateway_name} in resource group {resource_group}, location {location} (subscription {subscription_id}).
        slots:
          gateway_name: path.virtualNetworkGatewayName
          resource_group: path.resourceGroupName
          location: requestBody.location
          subscription_id: path.subscriptionId
      - text: Restart the primary instance of gateway {gateway_name}.
        slots:
          gateway_name: path.virtualNetworkGatewayName
      method: generated
      generated: '2026-09-26'