# 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 FrontDoorManagementClient Front Doors API
  version: 1.0.0
extends: openapi/microsoft-azure-frontdoors-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: 11
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/frontDoors'].get
  update:
    x-apievangelist-phrasing:
      intent: List all Front Doors in a subscription
      effect: read
      questions:
      - Which Front Door profiles exist across my whole Azure subscription?
      - Can I see every Front Door I own regardless of resource group?
      instructions:
      - text: List every Front Door in my subscription.
      - text: Show all Front Doors across all resource groups.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors'].get
  update:
    x-apievangelist-phrasing:
      intent: List Front Doors in a resource group
      effect: read
      questions:
      - What Front Doors are deployed in one particular resource group?
      - Can I scope the Front Door list to a single resource group?
      instructions:
      - text: List the Front Doors in resource group {group}.
        slots:
          group: path.resourceGroupName
      - text: Show Front Doors that live in group {group}.
        slots:
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Front Door by name
      effect: read
      questions:
      - How is a specific Front Door configured?
      - Can I fetch one Front Door's settings by its name?
      instructions:
      - text: Get Front Door {front_door} in group {group}.
        slots:
          front_door: path.frontDoorName
          group: path.resourceGroupName
      - text: Show the configuration of Front Door {front_door} from resource group {group}.
        slots:
          front_door: path.frontDoorName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Front Door
      effect: write
      questions:
      - How do I create a new Azure Front Door in a resource group?
      - Can I replace an existing Front Door's routing and backend properties?
      instructions:
      - text: Create Front Door {front_door} in group {group} with properties {properties}.
        slots:
          front_door: path.frontDoorName
          group: path.resourceGroupName
          properties: requestBody.properties
      - text: Put Front Door {front_door} in resource group {group}.
        slots:
          front_door: path.frontDoorName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Front Door
      effect: destructive
      questions:
      - How can I tear down a Front Door I no longer need?
      - Can I delete a Front Door by name from a resource group?
      instructions:
      - text: Delete Front Door {front_door} in group {group}.
        slots:
          front_door: path.frontDoorName
          group: path.resourceGroupName
      - text: Remove the Front Door {front_door} from resource group {group}.
        slots:
          front_door: path.frontDoorName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}/frontendEndpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List frontend endpoints of a Front Door
      effect: read
      questions:
      - Which hostnames and frontend endpoints does my Front Door serve?
      - Can I list all frontend endpoints on one Front Door?
      instructions:
      - text: List the frontend endpoints on Front Door {front_door} in group {group}.
        slots:
          front_door: path.frontDoorName
          group: path.resourceGroupName
      - text: Show every frontend host on {front_door} (group {group}).
        slots:
          front_door: path.frontDoorName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}/frontendEndpoints/{frontendEndpointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Front Door frontend endpoint
      effect: read
      questions:
      - Is HTTPS provisioned on a particular Front Door frontend endpoint?
      - What are the settings of one frontend endpoint by name?
      instructions:
      - text: Get frontend endpoint {endpoint} on Front Door {front_door} in group {group}.
        slots:
          endpoint: path.frontendEndpointName
          front_door: path.frontDoorName
          group: path.resourceGroupName
      - text: Show the HTTPS state of endpoint {endpoint} on {front_door}, group {group}.
        slots:
          endpoint: path.frontendEndpointName
          front_door: path.frontDoorName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}/purge'].post
  update:
    x-apievangelist-phrasing:
      intent: Purge cached content from a Front Door
      effect: destructive
      questions:
      - How do I clear cached files from Front Door after a deploy?
      - Can I purge only certain content paths from the Front Door cache?
      instructions:
      - text: Purge {paths} from the cache of Front Door {front_door} in group {group}.
        slots:
          paths: requestBody.contentPaths
          front_door: path.frontDoorName
          group: path.resourceGroupName
      - text: Invalidate cached content paths {paths} on Front Door {front_door} in group {group}.
        slots:
          front_door: path.frontDoorName
          paths: requestBody.contentPaths
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}/frontendEndpoints/{frontendEndpointName}/enableHttps'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable HTTPS on a Front Door frontend endpoint
      effect: write
      questions:
      - How do I turn on HTTPS for a custom domain on Front Door?
      - Can I bring my own Key Vault certificate instead of a Front Door managed one?
      instructions:
      - text: Enable HTTPS on endpoint {endpoint} of Front Door {front_door} in group {group}.
        slots:
          endpoint: path.frontendEndpointName
          front_door: path.frontDoorName
          group: path.resourceGroupName
      - text: Turn on HTTPS for {endpoint} on {front_door} (group {group}) using certificate source {source} and Key Vault settings {kv}.
        slots:
          endpoint: path.frontendEndpointName
          front_door: path.frontDoorName
          group: path.resourceGroupName
          source: requestBody.certificateSource
          kv: requestBody.keyVaultCertificateSourceParameters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}/frontendEndpoints/{frontendEndpointName}/disableHttps'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable HTTPS on a Front Door frontend endpoint
      effect: write
      questions:
      - How can I switch off HTTPS for a custom domain on Front Door?
      - Can I stop serving HTTPS traffic on one frontend endpoint?
      instructions:
      - text: Disable HTTPS on endpoint {endpoint} of Front Door {front_door} in group {group}.
        slots:
          endpoint: path.frontendEndpointName
          front_door: path.frontDoorName
          group: path.resourceGroupName
      - text: Turn off HTTPS traffic for {endpoint} on {front_door}, group {group}.
        slots:
          endpoint: path.frontendEndpointName
          front_door: path.frontDoorName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}/validateCustomDomain'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a custom domain's DNS for Front Door
      effect: read
      questions:
      - Does my custom domain's DNS point at the right Front Door endpoint?
      - Can I check a hostname's CNAME mapping before adding it to Front Door?
      instructions:
      - text: Validate that {host} maps to Front Door {front_door} in group {group}.
        slots:
          host: requestBody.hostName
          front_door: path.frontDoorName
          group: path.resourceGroupName
      - text: Check the DNS mapping of custom domain {host} for {front_door} (group {group}).
        slots:
          host: requestBody.hostName
          front_door: path.frontDoorName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'