# 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 Application…
  version: 1.0.0
extends: openapi/microsoft-azure-application-gateways-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/applicationGateways/{applicationGatewayName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application gateway
      effect: read
      questions:
      - Where can I view the configuration of one application gateway?
      - What listeners and backend pools does my application gateway have?
      instructions:
      - text: Get application gateway {applicationGatewayName} in {resourceGroupName}.
        slots:
          applicationGatewayName: path.applicationGatewayName
          resourceGroupName: path.resourceGroupName
      - text: Show the configuration of gateway {applicationGatewayName} in subscription {subscriptionId}, group {resourceGroupName}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          applicationGatewayName: path.applicationGatewayName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/applicationGateways/{applicationGatewayName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an application gateway
      effect: write
      questions:
      - How do I deploy a new application gateway in a region?
      - Can I update an application gateway's full configuration in one request?
      instructions:
      - text: Create application gateway {applicationGatewayName} in {resourceGroupName} at {location}.
        slots:
          applicationGatewayName: path.applicationGatewayName
          resourceGroupName: path.resourceGroupName
          location: requestBody.location
      - text: Apply configuration {properties} to application gateway {applicationGatewayName} in {resourceGroupName} at {location}.
        slots:
          properties: requestBody.properties
          applicationGatewayName: path.applicationGatewayName
          resourceGroupName: path.resourceGroupName
          location: requestBody.location
      - text: Deploy application gateway {applicationGatewayName} into subscription {subscriptionId}, group {resourceGroupName}, region {location}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          applicationGatewayName: path.applicationGatewayName
          location: requestBody.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/applicationGateways/{applicationGatewayName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application gateway
      effect: destructive
      questions:
      - Is it possible to permanently remove an application gateway?
      - Can I delete an application gateway from a resource group?
      instructions:
      - text: Delete application gateway {applicationGatewayName} in {resourceGroupName}.
        slots:
          applicationGatewayName: path.applicationGatewayName
          resourceGroupName: path.resourceGroupName
      - text: Remove gateway {applicationGatewayName} from subscription {subscriptionId}, group {resourceGroupName}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          applicationGatewayName: path.applicationGatewayName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/applicationGateways'].get
  update:
    x-apievangelist-phrasing:
      intent: List application gateways in a resource group
      effect: read
      questions:
      - Which application gateways are in one resource group?
      - Can I list gateways scoped to a single resource group?
      instructions:
      - text: List application gateways in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      - text: Show the application gateways in subscription {subscriptionId}, group {resourceGroupName}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/applicationGateways'].get
  update:
    x-apievangelist-phrasing:
      intent: List application gateways in a subscription
      effect: read
      questions:
      - What application gateways exist across my entire subscription?
      - Can I see every application gateway without naming a resource group?
      instructions:
      - text: List all application gateways in my subscription.
      - text: Show every application gateway across subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/applicationGateways/{applicationGatewayName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an application gateway
      effect: write
      questions:
      - How do I start an application gateway that I stopped?
      - Can I bring a stopped gateway back online?
      instructions:
      - text: Start application gateway {applicationGatewayName} in {resourceGroupName}.
        slots:
          applicationGatewayName: path.applicationGatewayName
          resourceGroupName: path.resourceGroupName
      - text: Bring stopped gateway {applicationGatewayName} back online in subscription {subscriptionId}, group {resourceGroupName}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          applicationGatewayName: path.applicationGatewayName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/applicationGateways/{applicationGatewayName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an application gateway
      effect: write
      questions:
      - Is there a way to stop an application gateway to pause traffic?
      - Can I shut down a gateway temporarily without deleting it?
      instructions:
      - text: Stop application gateway {applicationGatewayName} in {resourceGroupName}.
        slots:
          applicationGatewayName: path.applicationGatewayName
          resourceGroupName: path.resourceGroupName
      - text: Pause gateway {applicationGatewayName} in subscription {subscriptionId}, group {resourceGroupName}.
        slots:
          subscriptionId: path.subscriptionId
          resourceGroupName: path.resourceGroupName
          applicationGatewayName: path.applicationGatewayName
      method: generated
      generated: '2026-10-01'