# 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 Nginx.NginxPlus Nginx Configuration API
  version: 1.0.0
extends: openapi/microsoft-azure-nginxconfiguration-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Nginx.NginxPlus/nginxDeployments/{deploymentName}/configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List NGINX configurations of a deployment
      effect: read
      questions:
      - Which NGINX configurations does my NGINXaaS deployment have?
      - How do I list the config files applied to an NGINX deployment?
      instructions:
      - text: List NGINX configurations for deployment {deployment}.
        slots:
          deployment: path.deploymentName
      - text: Show all configurations on NGINX deployment {deployment}.
        slots:
          deployment: path.deploymentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Nginx.NginxPlus/nginxDeployments/{deploymentName}/configurations/{configurationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an NGINX configuration
      effect: read
      questions:
      - What is in a specific NGINX configuration on my deployment?
      - Can I read one NGINX configuration by name?
      instructions:
      - text: Get NGINX configuration {config} for deployment {deployment}.
        slots:
          config: path.configurationName
          deployment: path.deploymentName
      - text: Show configuration {config} on NGINX deployment {deployment}.
        slots:
          config: path.configurationName
          deployment: path.deploymentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Nginx.NginxPlus/nginxDeployments/{deploymentName}/configurations/{configurationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an NGINX configuration
      effect: write
      questions:
      - How do I upload a new NGINX configuration to my deployment?
      - Can I replace the NGINX config files on an existing deployment?
      instructions:
      - text: Apply NGINX configuration {config} to deployment {deployment} with {properties}.
        slots:
          config: path.configurationName
          deployment: path.deploymentName
          properties: requestBody.properties
      - text: Create configuration {config} on NGINX deployment {deployment}.
        slots:
          config: path.configurationName
          deployment: path.deploymentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Nginx.NginxPlus/nginxDeployments/{deploymentName}/configurations/{configurationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Reset an NGINX configuration to default
      effect: destructive
      questions:
      - Can I reset my NGINX deployment's configuration back to the default?
      - What happens when I delete an NGINX configuration?
      instructions:
      - text: Reset NGINX configuration {config} on deployment {deployment} to default.
        slots:
          config: path.configurationName
          deployment: path.deploymentName
      - text: Delete configuration {config} from NGINX deployment {deployment}.
        slots:
          config: path.configurationName
          deployment: path.deploymentName
      method: generated
      generated: '2026-09-26'