# 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 Provider API
  version: 1.0.0
extends: openapi/microsoft-azure-provider-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: 13
- target: $.paths['/providers/Microsoft.Web/availableStacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List available App Service application stacks
      effect: read
      questions:
      - Which application frameworks and versions can App Service run?
      - Can I limit the list of available stacks to Windows or Linux?
      instructions:
      - text: List the application frameworks available in App Service.
      - text: Show available App Service stacks for OS type {osTypeSelected}.
        slots:
          osTypeSelected: query.osTypeSelected
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/functionAppStacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List available Function app stacks
      effect: read
      questions:
      - What runtimes and versions are available for Azure Functions apps?
      - Can I see only the Linux Function app stacks?
      instructions:
      - text: List the frameworks available for Function apps.
      - text: Show Function app stacks for OS {stackOsType}.
        slots:
          stackOsType: query.stackOsType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/locations/{location}/functionAppStacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List Function app stacks for a region
      effect: read
      questions:
      - Which Function app runtimes are offered in a particular Azure region?
      - Does the set of Function app frameworks differ by location?
      instructions:
      - text: List the Function app stacks available in {location}.
        slots:
          location: path.location
      - text: Show {stackOsType} Function app frameworks offered in region {location}.
        slots:
          location: path.location
          stackOsType: query.stackOsType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/locations/{location}/webAppStacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List Web app stacks for a region
      effect: read
      questions:
      - Which web app frameworks can I use in a specific Azure region?
      - Are some Web app runtime versions unavailable in certain locations?
      instructions:
      - text: List the Web app stacks available in {location}.
        slots:
          location: path.location
      - text: Show {stackOsType} web app frameworks offered in region {location}.
        slots:
          location: path.location
          stackOsType: query.stackOsType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Microsoft.Web provider operations and metrics
      effect: read
      questions:
      - What operations does the Microsoft.Web resource provider expose?
      - Where can I find the resource metric definitions for App Service resources?
      instructions:
      - text: List every available operation for the Microsoft.Web resource provider.
      - text: Show the Microsoft.Web operations and metric definitions for API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/webAppStacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List available Web app stacks
      effect: read
      questions:
      - What web app runtimes and versions does App Service support overall?
      - Can I list Web app frameworks for Windows only?
      instructions:
      - text: List the frameworks available for Web apps.
      - text: Show Web app stacks for OS {stackOsType} across all regions.
        slots:
          stackOsType: query.stackOsType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/availableStacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List application stacks available to a subscription
      effect: read
      questions:
      - Which App Service application stacks are available to my subscription?
      - Can I check subscription-scoped frameworks, for example on-premises stacks?
      instructions:
      - text: List the application frameworks available in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show {osTypeSelected} stacks available to subscription {subscriptionId}.
        slots:
          osTypeSelected: query.osTypeSelected
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Purview/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if a Purview account name is available
      effect: read
      questions:
      - Is a Microsoft Purview account name still free to use?
      - How can I verify a Purview account name before creating the account?
      instructions:
      - text: Check whether Purview account name {name} is available in subscription {subscriptionId}.
        slots:
          name: requestBody.name
          subscriptionId: path.subscriptionId
      - text: Verify the Purview name {name} of type {type} is not taken.
        slots:
          name: requestBody.name
          type: requestBody.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/sourcecontrols'].get
  update:
    x-apievangelist-phrasing:
      intent: List source controls available to Azure websites
      effect: read
      questions:
      - Which source control providers are connected for my App Service websites?
      - Can I see all the source control tokens configured for web apps?
      instructions:
      - text: List the source controls available for Azure websites.
      - text: Show all App Service source control connections as of API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/sourcecontrols/{sourceControlType}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the source control token for a provider
      effect: read
      questions:
      - How do I check the source control token App Service stores for one provider?
      - What is configured for a given source control type on my websites?
      instructions:
      - text: Get the source control token for {sourceControlType}.
        slots:
          sourceControlType: path.sourceControlType
      - text: Show the App Service source control settings for type {sourceControlType}.
        slots:
          sourceControlType: path.sourceControlType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/sourcecontrols/{sourceControlType}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update the source control token for a provider
      effect: write
      questions:
      - Can I refresh the source control token App Service uses for deployments?
      - Which fields does updating a source control token require?
      instructions:
      - text: Update the source control token for {sourceControlType} in {location}.
        slots:
          sourceControlType: path.sourceControlType
          location: requestBody.location
      - text: Replace the {sourceControlType} source control settings with {properties}.
        slots:
          sourceControlType: path.sourceControlType
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/publishingUsers/web'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the App Service publishing user
      effect: read
      questions:
      - What publishing user is set for my App Service deployments?
      - How do I see the deployment credentials username for web apps?
      instructions:
      - text: Get the App Service publishing user.
      - text: Show my web app deployment publishing user using API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Web/publishingUsers/web'].put
  update:
    x-apievangelist-phrasing:
      intent: Update the App Service publishing user
      effect: write
      questions:
      - Can I change the publishing user used for App Service deployments?
      - Which location must be sent when updating deployment credentials?
      instructions:
      - text: Update the App Service publishing user in {location} with {properties}.
        slots:
          location: requestBody.location
          properties: requestBody.properties
      - text: Change my web app deployment credentials to {properties}.
        slots:
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'