# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WebApps API Client Subscriptions API
  version: 1.0.0
extends: openapi/microsoft-azure-functions-subscriptions-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: 15
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/aseRegions'].get
  update:
    x-apievangelist-phrasing:
      intent: List regions available for App Service Environments
      effect: read
      questions:
      - Which regions can I deploy an App Service Environment into?
      - What SKUs does each ASE region support?
      instructions:
      - text: List the regions available for App Service Environments with their supported SKUs.
      - text: Show me where I can create an ASE.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/billingMeters'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Service billing meters for a location
      effect: read
      questions:
      - What billing meters apply to App Service in a given region?
      - Can I filter billing meters by Windows or Linux?
      instructions:
      - text: List App Service billing meters for location {billingLocation}.
        slots:
          billingLocation: query.billingLocation
      - text: Show billing meters in {billingLocation} for OS type {osType}.
        slots:
          billingLocation: query.billingLocation
          osType: query.osType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/checknameavailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if an App Service resource name is free
      effect: read
      questions:
      - Is the name I want for my web app already taken?
      - Can I check whether a fully qualified domain name is available before creating a resource?
      instructions:
      - text: Check whether the name {name} is available for resource type {type}.
        slots:
          name: requestBody.name
          type: requestBody.type
      - text: Check if {name} is free to use as a site name.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/customhostnameSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom hostnames in a subscription
      effect: read
      questions:
      - Which custom hostnames are bound to sites in my subscription?
      - Can I look up which site uses a particular custom domain?
      instructions:
      - text: List all custom hostnames under my subscription.
      - text: Find the custom hostname entry for {hostname}.
        slots:
          hostname: query.hostname
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/deploymentLocations'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployment locations including ministamps
      effect: read
      questions:
      - What geo regions and ministamps can my subscription deploy to?
      - Where are App Service deployment locations available for me?
      instructions:
      - text: List available deployment locations and ministamps for my subscription.
      - text: Show the geo regions plus ministamps I can deploy into.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/geoRegions'].get
  update:
    x-apievangelist-phrasing:
      intent: List geographical regions for App Service
      effect: read
      questions:
      - Which Azure regions support Linux workers for App Service?
      - Can I filter available regions by pricing tier?
      - What regions offer Linux dynamic workers for consumption-plan functions?
      instructions:
      - text: List geographical regions available for SKU {sku}.
        slots:
          sku: query.sku
      - text: Show regions where Linux workers are enabled ({linuxWorkersEnabled}).
        slots:
          linuxWorkersEnabled: query.linuxWorkersEnabled
      - text: List regions with Linux dynamic workers set to {linuxDynamicWorkersEnabled}.
        slots:
          linuxDynamicWorkersEnabled: query.linuxDynamicWorkersEnabled
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/listSitesAssignedToHostName'].post
  update:
    x-apievangelist-phrasing:
      intent: List apps assigned to a hostname
      effect: read
      questions:
      - Which apps are assigned to a particular hostname?
      - Can I find out what site a domain name is pointing at in my subscription?
      instructions:
      - text: List the apps assigned to hostname {name}.
        slots:
          name: requestBody.name
      - text: Find which site identifiers use host {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/locations/{location}/checknameavailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check name availability for DNL sites in a region
      effect: read
      questions:
      - Is a site name available with a domain name label in a specific region?
      - Can I check name availability for an auto-generated domain name label scope?
      instructions:
      - text: Check if {name} of type {type} is available as a DNL site in {location}.
        slots:
          name: requestBody.name
          type: requestBody.type
          location: path.location
      - text: Check DNL name {name} for type {type} with label scope {autoGeneratedDomainNameLabelScope}.
        slots:
          name: requestBody.name
          type: requestBody.type
          autoGeneratedDomainNameLabelScope: requestBody.autoGeneratedDomainNameLabelScope
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/locations/{location}/usages'].get
  update:
    x-apievangelist-phrasing:
      intent: List core usage by SKU in a location
      effect: read
      questions:
      - How many cores is my subscription using per SKU in a region?
      - Am I close to my core quota in a given location?
      instructions:
      - text: List my subscription's core usages for all SKUs in {location}.
        slots:
          location: path.location
      - text: Show core quota usage for my subscription in region {location}.
        slots:
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/premieraddonoffers'].get
  update:
    x-apievangelist-phrasing:
      intent: List premier add-on offers
      effect: read
      questions:
      - What premier add-on offers are available for App Service?
      - Which premium add-ons can I attach to my apps?
      instructions:
      - text: List all premier add-on offers.
      - text: Show the premium add-on catalog for App Service.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List all App Service SKUs
      effect: read
      questions:
      - What SKUs does App Service offer across my subscription?
      - Which pricing tiers exist for App Service in general?
      instructions:
      - text: List all App Service SKUs available to my subscription.
      - text: Show every App Service pricing tier.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/verifyHostingEnvironmentVnet'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a VNet is compatible with an ASE
      effect: read
      questions:
      - Will my virtual network's security group rules work with an App Service Environment?
      - How do I check a VNet's compatibility before creating an ASE in it?
      instructions:
      - text: Verify VNet {properties} is compatible with an App Service Environment.
        slots:
          properties: requestBody.properties
      - text: Check the network security group rules of my VNet for ASE compatibility.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/moveResources'].post
  update:
    x-apievangelist-phrasing:
      intent: Move resources to another resource group
      effect: write
      questions:
      - How do I move my web apps to a different resource group?
      - Can I move several App Service resources at once?
      instructions:
      - text: Move resources {resources} to resource group {targetResourceGroup}.
        slots:
          resources: requestBody.resources
          targetResourceGroup: requestBody.targetResourceGroup
      - text: Relocate these App Service resources into {targetResourceGroup}.
        slots:
          targetResourceGroup: requestBody.targetResourceGroup
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate whether a resource can be created
      effect: read
      questions:
      - Can I dry-run the creation of an App Service resource to catch errors first?
      - Will a new resource with these properties pass validation in this location?
      instructions:
      - text: Validate creating {type} resource {name} in {location} with {properties}.
        slots:
          type: requestBody.type
          name: requestBody.name
          location: requestBody.location
          properties: requestBody.properties
      - text: Check that resource {name} of type {type} can be created.
        slots:
          name: requestBody.name
          type: requestBody.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/validateMoveResources'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate whether resources can be moved
      effect: read
      questions:
      - Will moving my resources to another resource group succeed?
      - Can I pre-check a resource group move before doing it?
      instructions:
      - text: Validate moving {resources} to resource group {targetResourceGroup}.
        slots:
          resources: requestBody.resources
          targetResourceGroup: requestBody.targetResourceGroup
      - text: Pre-check whether these resources can be moved to {targetResourceGroup} without moving them.
        slots:
          targetResourceGroup: requestBody.targetResourceGroup
      method: generated
      generated: '2026-10-01'