# 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 Recommendations API
  version: 1.0.0
extends: openapi/microsoft-azure-recommendations-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: 15
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Service recommendations for a subscription
      effect: read
      questions:
      - What App Service recommendations apply across my whole subscription?
      - Can I see only the featured recommendations for my subscription?
      instructions:
      - text: List all App Service recommendations for subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show featured App Service recommendations for subscription {sub} matching {filter}.
        slots:
          sub: path.subscriptionId
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset recommendation opt-outs for a subscription
      effect: write
      questions:
      - How do I undo every recommendation I opted out of at the subscription level?
      - Can I bring back all the App Service recommendations I disabled for my subscription?
      instructions:
      - text: Reset all recommendation opt-out settings for subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Re-enable every subscription-wide recommendation rule I turned off in {sub}.
        slots:
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/recommendations/{name}/disable'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable a recommendation rule for a subscription
      effect: write
      questions:
      - Can I stop a specific recommendation rule from applying to my subscription in the future?
      - Which call turns off one App Service recommendation for the whole subscription?
      instructions:
      - text: Disable recommendation rule {rule} for subscription {sub}.
        slots:
          rule: path.name
          sub: path.subscriptionId
      - text: Stop rule {rule} from appearing across my subscription {sub}.
        slots:
          rule: path.name
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendationHistory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get past recommendations for an App Service Environment
      effect: read
      questions:
      - What recommendations did my App Service Environment receive in the past?
      - Can I limit an App Service Environment's recommendation history to expired items only?
      instructions:
      - text: Show the recommendation history for App Service Environment {ase} in {rg} of subscription {sub}.
        slots:
          ase: path.hostingEnvironmentName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: List past recommendations for hosting environment {ase} in {rg} within time range {filter}.
        slots:
          ase: path.hostingEnvironmentName
          rg: path.resourceGroupName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: List current recommendations for an App Service Environment
      effect: read
      questions:
      - Which recommendations currently apply to my App Service Environment?
      - Can I see just the featured recommendations for a hosting environment?
      instructions:
      - text: List active recommendations for App Service Environment {ase} in {rg} of subscription {sub}.
        slots:
          ase: path.hostingEnvironmentName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show current recommendations for hosting environment {ase} in {rg} filtered by {filter}.
        slots:
          ase: path.hostingEnvironmentName
          rg: path.resourceGroupName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/disable'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable all recommendations for an App Service Environment
      effect: write
      questions:
      - Can I turn off every recommendation for an App Service Environment at once?
      - How do I silence all recommendations on a hosting environment?
      instructions:
      - text: Disable all recommendations for App Service Environment {ase} (environment {env}) in {rg} of subscription {sub}.
        slots:
          ase: path.hostingEnvironmentName
          env: query.environmentName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn off every recommendation on hosting environment {ase} named {env} in {rg}.
        slots:
          ase: path.hostingEnvironmentName
          env: query.environmentName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset recommendation opt-outs for an App Service Environment
      effect: write
      questions:
      - How do I restore recommendations I opted out of on an App Service Environment?
      - Can I clear all the disabled recommendation rules for a hosting environment?
      instructions:
      - text: Reset recommendation opt-out settings for App Service Environment {ase} (environment {env}) in {rg} of subscription {sub}.
        slots:
          ase: path.hostingEnvironmentName
          env: query.environmentName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Re-enable disabled recommendations on hosting environment {ase} named {env} in {rg}.
        slots:
          ase: path.hostingEnvironmentName
          env: query.environmentName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a recommendation rule for an App Service Environment
      effect: read
      questions:
      - What does a specific recommendation rule say for my App Service Environment?
      - Can I mark a hosting environment's recommendation as seen when I read it?
      instructions:
      - text: Get recommendation rule {rule} for App Service Environment {ase} in {rg} of subscription {sub}.
        slots:
          rule: path.name
          ase: path.hostingEnvironmentName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show rule {rule} on hosting environment {ase} in {rg} for recommendation {rec}.
        slots:
          rule: path.name
          ase: path.hostingEnvironmentName
          rg: path.resourceGroupName
          rec: query.recommendationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{hostingEnvironmentName}/recommendations/{name}/disable'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable a recommendation rule for an App Service Environment
      effect: write
      questions:
      - Can I permanently disable one recommendation rule on an App Service Environment?
      - Which call turns off a single rule for a hosting environment?
      instructions:
      - text: Disable rule {rule} for App Service Environment {ase} (environment {env}) in {rg} of subscription {sub}.
        slots:
          rule: path.name
          ase: path.hostingEnvironmentName
          env: query.environmentName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Permanently turn off recommendation {rule} on hosting environment {ase} named {env} in {rg}.
        slots:
          rule: path.name
          ase: path.hostingEnvironmentName
          env: query.environmentName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendationHistory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get past recommendations for a web app
      effect: read
      questions:
      - What recommendations has my App Service web app received in the past?
      - Can I see a web app's recommendation history for a specific time range?
      instructions:
      - text: Show the recommendation history for web app {site} in {rg} of subscription {sub}.
        slots:
          site: path.siteName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: List past recommendations for app {site} in {rg} within time range {filter}.
        slots:
          site: path.siteName
          rg: path.resourceGroupName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations'].get
  update:
    x-apievangelist-phrasing:
      intent: List current recommendations for a web app
      effect: read
      questions:
      - Which recommendations currently apply to my web app?
      - Can I get only featured recommendations for one App Service app?
      instructions:
      - text: List active recommendations for web app {site} in {rg} of subscription {sub}.
        slots:
          site: path.siteName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show current recommendations for app {site} in {rg} filtered by {filter}.
        slots:
          site: path.siteName
          rg: path.resourceGroupName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/disable'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable all recommendations for a web app
      effect: write
      questions:
      - Can I turn off every recommendation for a single web app?
      - How do I stop all recommendations from showing on one App Service app?
      instructions:
      - text: Disable all recommendations for web app {site} in {rg} of subscription {sub}.
        slots:
          site: path.siteName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Silence every recommendation on app {site} in {rg}.
        slots:
          site: path.siteName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset recommendation opt-outs for a web app
      effect: write
      questions:
      - How do I restore recommendations I disabled on a web app?
      - Can I clear all recommendation opt-outs for one App Service app?
      instructions:
      - text: Reset recommendation opt-out settings for web app {site} in {rg} of subscription {sub}.
        slots:
          site: path.siteName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Re-enable disabled recommendations on app {site} in {rg}.
        slots:
          site: path.siteName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a recommendation rule for a web app
      effect: read
      questions:
      - What are the details of one recommendation rule for my web app?
      - Can I mark a web app recommendation as seen while reading it?
      instructions:
      - text: Get recommendation rule {rule} for web app {site} in {rg} of subscription {sub}.
        slots:
          rule: path.name
          site: path.siteName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show rule {rule} on app {site} in {rg} for recommendation {rec}.
        slots:
          rule: path.name
          site: path.siteName
          rg: path.resourceGroupName
          rec: query.recommendationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/recommendations/{name}/disable'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable a recommendation rule for a web app
      effect: write
      questions:
      - Can I permanently disable one recommendation rule on a web site?
      - Which call switches off a single rule for one App Service app?
      instructions:
      - text: Disable rule {rule} for web app {site} in {rg} of subscription {sub}.
        slots:
          rule: path.name
          site: path.siteName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Permanently turn off recommendation {rule} on site {site} in {rg}.
        slots:
          rule: path.name
          site: path.siteName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'