API Evangelist conversational phrasing for Client Web Apps API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Client Web Apps API
  version: 1.0.0
extends: openapi/microsoft-azure-functions-web-apps-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: 416
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/sites'].get
  update:
    x-apievangelist-phrasing:
      intent: List every app in my subscription
      effect: read
      questions:
      - Which App Service and Function apps exist across my whole Azure subscription?
      - Can I get one inventory of all web, mobile and API apps in the subscription regardless of resource group?
      instructions:
      - text: List all the App Service apps in my subscription.
      - text: Show me every function app and web app I own across all resource groups.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites'].get
  update:
    x-apievangelist-phrasing:
      intent: List the apps in a resource group
      effect: read
      questions:
      - What web and function apps live in a particular resource group?
      - Can the resource group app listing include deployment slots and not just production?
      instructions:
      - text: 'List the apps in this resource group, including slots: {include_slots}.'
        slots:
          include_slots: query.includeSlots
      - text: Show only the production apps in the current resource group.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the details of an app
      effect: read
      questions:
      - What are the current properties and state of one of my Azure web apps?
      - Where do I see the hostnames, plan and status of a single function app?
      instructions:
      - text: Get the details of app {app}.
        slots:
          app: path.name
      - text: Show me the state, default hostname and plan for web app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an app
      effect: write
      questions:
      - How do I create a new function app or web app in an existing resource group?
      - Can I give a new App Service app a managed identity when I create it?
      instructions:
      - text: Create web app {app} with properties {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Create function app {app} of kind {kind} with a system-assigned identity {identity}.
        slots:
          app: path.name
          kind: requestBody.kind
          identity: requestBody.identity
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an app
      effect: destructive
      questions:
      - What happens to the App Service plan when I delete the last app in it?
      - Can I delete a web app and also wipe its metrics?
      instructions:
      - text: Delete app {app}.
        slots:
          app: path.name
      - text: Delete web app {app}, delete its metrics {delete_metrics} and keep the empty plan {delete_empty_plan}.
        slots:
          app: path.name
          delete_metrics: query.deleteMetrics
          delete_empty_plan: query.deleteEmptyServerFarm
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing app's properties
      effect: write
      questions:
      - Can I change only a few properties of an existing web app without resending the whole definition?
      - Is there a partial update for an app's settings like its managed identity?
      instructions:
      - text: Patch app {app} with properties {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Update just the managed identity on existing app {app} to {identity}.
        slots:
          app: path.name
          identity: requestBody.identity
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/analyzeCustomHostname'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a custom hostname can be added
      effect: read
      questions:
      - Will my custom domain work with my production web app before I bind it?
      - What DNS records does App Service expect for a custom hostname on my app?
      instructions:
      - text: Analyze custom hostname {host_name} for app {app}.
        slots:
          host_name: query.hostName
          app: path.name
      - text: Check whether {host_name} is correctly configured to point at production app {app}.
        slots:
          host_name: query.hostName
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/applySlotConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply a slot's config to production before swap
      effect: write
      questions:
      - Can I stage a slot's configuration onto production before doing a swap?
      - How can I keep the virtual network setting when applying swap configuration to the production app?
      instructions:
      - text: Apply the configuration from slot {target_slot} onto production of app {app}, preserving VNet {preserve_vnet}.
        slots:
          target_slot: requestBody.targetSlot
          app: path.name
          preserve_vnet: requestBody.preserveVnet
      - text: 'Prepare production app {app} for a swap with {target_slot} without keeping the VNet: {preserve_vnet}.'
        slots:
          app: path.name
          target_slot: requestBody.targetSlot
          preserve_vnet: requestBody.preserveVnet
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backup'].post
  update:
    x-apievangelist-phrasing:
      intent: Back up an app now
      effect: write
      questions:
      - How do I take an on-demand backup of my production web app?
      - Can I trigger a one-off App Service backup to a storage account right now?
      instructions:
      - text: Back up app {app} now.
        slots:
          app: path.name
      - text: Create a backup of production app {app} using backup request {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's backups
      effect: read
      questions:
      - What backups exist for my production web app?
      - Which backups of a function app are available, with their status and dates?
      instructions:
      - text: List the backups of app {app}.
        slots:
          app: path.name
      - text: Show every existing backup for production web app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups/{backupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one backup of an app
      effect: read
      questions:
      - Did a specific backup of my production app succeed?
      - Where can I see the size and status of one backup by its ID?
      instructions:
      - text: Get backup {backup_id} of app {app}.
        slots:
          backup_id: path.backupId
          app: path.name
      - text: Check the status of backup {backup_id} on production app {app}.
        slots:
          backup_id: path.backupId
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups/{backupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a backup of an app
      effect: destructive
      questions:
      - Can I remove an old backup of my production web app by its ID?
      - What's the way to clean up a single app backup I no longer need?
      instructions:
      - text: Delete backup {backup_id} of app {app}.
        slots:
          backup_id: path.backupId
          app: path.name
      - text: Remove production backup {backup_id} from web app {app}.
        slots:
          backup_id: path.backupId
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups/{backupId}/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a backup's status with its storage SAS URL
      effect: read
      questions:
      - Can I see the Azure Storage SAS URL behind a production app backup?
      - Is there a way to check an in-progress backup together with its secrets?
      instructions:
      - text: Get backup {backup_id} of app {app} including its storage SAS URL.
        slots:
          backup_id: path.backupId
          app: path.name
      - text: Show status and secrets of in-progress backup {backup_id} on production app {app} using request {properties}.
        slots:
          backup_id: path.backupId
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/backups/{backupId}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a backup to an app
      effect: write
      questions:
      - How do I restore my production web app from one of its backups?
      - Can I restore an app backup into a different app or deployment slot?
      instructions:
      - text: Restore backup {backup_id} onto app {app}.
        slots:
          backup_id: path.backupId
          app: path.name
      - text: Restore production backup {backup_id} of {app} with restore request {properties}.
        slots:
          backup_id: path.backupId
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/basicPublishingCredentialsPolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: Check basic auth policies for FTP and SCM
      effect: read
      questions:
      - Is basic authentication allowed for both FTP and SCM on my production app?
      - Which publishing credential policies are set on a web app?
      instructions:
      - text: Show the FTP and SCM basic auth policies for app {app}.
        slots:
          app: path.name
      - text: List basic publishing credential policies on production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/basicPublishingCredentialsPolicies/ftp'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether FTP is allowed on an app
      effect: read
      questions:
      - Is FTP deployment currently allowed on my production web app?
      - Can I find out if FTP basic auth is turned off for an app?
      instructions:
      - text: Check whether FTP is allowed on app {app}.
        slots:
          app: path.name
      - text: Tell me if production app {app} accepts FTP publishing.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/basicPublishingCredentialsPolicies/ftp'].put
  update:
    x-apievangelist-phrasing:
      intent: Allow or block FTP on an app
      effect: write
      questions:
      - How do I disable FTP access on my production web app?
      - Can I re-enable FTP basic auth publishing for an app?
      instructions:
      - text: Turn off FTP on app {app} with policy {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Set the FTP allowed policy on production app {app} to {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/basicPublishingCredentialsPolicies/scm'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether SCM basic auth is allowed
      effect: read
      questions:
      - Is SCM basic authentication allowed on my production Kudu site?
      - Can I check if user publishing credentials work against an app's SCM endpoint?
      instructions:
      - text: Check whether SCM basic auth is allowed on app {app}.
        slots:
          app: path.name
      - text: Tell me if production app {app} accepts basic auth on its SCM site.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/basicPublishingCredentialsPolicies/scm'].put
  update:
    x-apievangelist-phrasing:
      intent: Allow or block SCM basic auth
      effect: write
      questions:
      - How can I stop people deploying to the SCM site with basic credentials on production?
      - Can I turn user publishing credentials for the SCM endpoint back on?
      instructions:
      - text: Disable SCM basic auth on app {app} with policy {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Set the SCM allowed policy on production app {app} to {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's configuration resources
      effect: read
      questions:
      - What configuration resources are attached to my production web app?
      - Can I get all of an app's config entries in a single list?
      instructions:
      - text: List the configurations of app {app}.
        slots:
          app: path.name
      - text: Show every config resource for production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/appsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an app's application settings
      effect: write
      questions:
      - How do I set environment variables on my production function app?
      - Does writing app settings replace the whole set rather than merge?
      instructions:
      - text: Replace the app settings of app {app} with {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Set the production application settings on {app} to {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/appsettings/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Read an app's application settings
      effect: read
      questions:
      - What environment variables are configured on my production web app?
      - Can I read the current app settings of a function app?
      instructions:
      - text: Get the application settings of app {app}.
        slots:
          app: path.name
      - text: Show me the production app settings for {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/authsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an app's classic auth settings
      effect: write
      questions:
      - How do I turn on App Service Authentication for my production app using the classic format?
      - Can I change the identity provider settings on the original auth settings?
      instructions:
      - text: Update the classic authentication settings of app {app} to {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Enable Easy Auth (V1 format) on production app {app} with {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/authsettings/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Read an app's classic auth settings
      effect: read
      questions:
      - What authentication and authorization settings does my production app have in the classic format?
      - Can I see the V1 Easy Auth configuration of a web app?
      instructions:
      - text: Get the classic authentication settings of app {app}.
        slots:
          app: path.name
      - text: Show the V1 Easy Auth configuration for production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/authsettingsV2'].get
  update:
    x-apievangelist-phrasing:
      intent: Read V2 auth settings without secrets
      effect: read
      questions:
      - Can I view my production app's V2 auth settings with the secrets left out?
      - Is there a safe way to read Easy Auth V2 config that omits client secrets?
      instructions:
      - text: Get the V2 auth settings of app {app} without secrets.
        slots:
          app: path.name
      - text: Show production app {app}'s V2 authentication config with secrets redacted.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/authsettingsV2'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an app's V2 auth settings
      effect: write
      questions:
      - How do I configure authentication on my production app using the V2 format?
      - Can I change the login providers in Easy Auth V2 for a web app?
      instructions:
      - text: Update the V2 authentication settings of app {app} to {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Apply Easy Auth V2 config {properties} to production app {app}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/authsettingsV2/list'].get
  update:
    x-apievangelist-phrasing:
      intent: Read V2 auth settings with secrets
      effect: read
      questions:
      - Can I list my production app's full V2 auth settings including secrets?
      - Where do I get the complete Easy Auth V2 configuration with client secrets?
      instructions:
      - text: List the full V2 auth settings of app {app}, secrets included.
        slots:
          app: path.name
      - text: Get production app {app}'s Easy Auth V2 configuration including secrets.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/azurestorageaccounts'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an app's mounted storage accounts
      effect: write
      questions:
      - How do I mount an Azure Files share into my production web app?
      - Can I change the Azure storage account mounts configured on an app?
      instructions:
      - text: Set the Azure storage account mounts of app {app} to {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Replace production app {app}'s storage mounts with {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/azurestorageaccounts/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Read an app's mounted storage accounts
      effect: read
      questions:
      - Which Azure storage accounts are mounted on my production web app?
      - What file share mounts does a function app have configured?
      instructions:
      - text: List the Azure storage account mounts of app {app}.
        slots:
          app: path.name
      - text: Show production app {app}'s storage account configuration.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/backup'].put
  update:
    x-apievangelist-phrasing:
      intent: Set an app's scheduled backup configuration
      effect: write
      questions:
      - How do I schedule automatic backups for my production web app?
      - Can I change the backup schedule and retention for an app?
      instructions:
      - text: Update the backup configuration of app {app} to {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Schedule production backups for {app} with {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/backup'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an app's backup configuration
      effect: destructive
      questions:
      - Can I turn off scheduled backups on my production app entirely?
      - What removes the backup schedule configured on a web app?
      instructions:
      - text: Delete the backup configuration of app {app}.
        slots:
          app: path.name
      - text: Stop scheduled backups on production app {app} by removing its backup config.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/backup/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Read an app's backup configuration
      effect: read
      questions:
      - What backup schedule and storage target is set on my production web app?
      - Is a scheduled backup configured for a particular app?
      instructions:
      - text: Get the backup configuration of app {app}.
        slots:
          app: path.name
      - text: Show production app {app}'s backup schedule and retention.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/configreferences/appsettings'].get
  update:
    x-apievangelist-phrasing:
      intent: List Key Vault references in app settings
      effect: read
      questions:
      - Which of my production app settings are Key Vault references, and do they resolve?
      - Can I check the status of every Key Vault reference in a function app's settings?
      instructions:
      - text: List the Key Vault reference app settings of app {app}.
        slots:
          app: path.name
      - text: Show resolution status for all Key Vault-backed settings on production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/configreferences/appsettings/{appSettingKey}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check one app setting's Key Vault reference
      effect: read
      questions:
      - Is a specific Key Vault-backed app setting on my production app resolving correctly?
      - Why is one app setting's Key Vault reference failing?
      instructions:
      - text: Get the Key Vault reference status of setting {setting_key} on app {app}.
        slots:
          setting_key: path.appSettingKey
          app: path.name
      - text: Check whether production app {app} can resolve Key Vault setting {setting_key}.
        slots:
          app: path.name
          setting_key: path.appSettingKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/configreferences/connectionstrings'].get
  update:
    x-apievangelist-phrasing:
      intent: List Key Vault references in connection strings
      effect: read
      questions:
      - Which connection strings on my production app point at Key Vault, and are they resolving?
      - Can I see the Key Vault reference status for all of an app's connection strings?
      instructions:
      - text: List the Key Vault connection string references of app {app}.
        slots:
          app: path.name
      - text: Show resolution status of Key Vault-backed connection strings on production app {app}.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/configreferences/connectionstrings/{connectionStringKey}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check one connection string's Key Vault reference
      effect: read
      questions:
      - Is one Key Vault-backed connection string on my production app resolving?
      - What's the reference status of a single connection string pulled from Key Vault?
      instructions:
      - text: Get the Key Vault reference status of connection string {connection_string_key} on app {app}.
        slots:
          connection_string_key: path.connectionStringKey
          app: path.name
      - text: Check whether production app {app} resolves Key Vault connection string {connection_string_key}.
        slots:
          app: path.name
          connection_string_key: path.connectionStringKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/connectionstrings'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an app's connection strings
      effect: write
      questions:
      - How do I set the database connection strings for my production web app?
      - Does saving connection strings overwrite all the existing ones on an app?
      instructions:
      - text: Replace the connection strings of app {app} with {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Set production connection strings on {app} to {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/connectionstrings/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Read an app's connection strings
      effect: read
      questions:
      - What connection strings are configured on my production web app?
      - Can I read the database connection strings of a function app?
      instructions:
      - text: Get the connection strings of app {app}.
        slots:
          app: path.name
      - text: Show me production app {app}'s connection strings.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Read an app's logging configuration
      effect: read
      questions:
      - Is application and web server logging turned on for my production app?
      - What diagnostic log levels and retention does a web app use?
      instructions:
      - text: Get the logging configuration of app {app}.
        slots:
          app: path.name
      - text: Show production app {app}'s diagnostic logs settings.
        slots:
          app: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/logs'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an app's logging configuration
      effect: write
      questions:
      - How do I turn on application logging for my production web app?
      - Can I change the web server log retention on an app?
      instructions:
      - text: Update the logging configuration of app {app} to {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Enable diagnostic logs on production app {app} with {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/metadata'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an app's metadata
      effect: write
      questions:
      - Can I overwrite the metadata key-value pairs stored on my production app?
      - What sets custom metadata on a web app?
      instructions:
      - text: Replace the metadata of app {app} with {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      - text: Set production metadata entries on {app} to {properties}.
        slots:
          app: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'


# --- truncated at 32 KB (343 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure-functions/refs/heads/main/overlays/microsoft-azure-functions-web-apps-api-phrasing-overlay.yaml