# 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 Profiles API
  version: 1.0.0
extends: openapi/microsoft-azure-profiles-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: 17
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List all Front Door and CDN profiles in a subscription
      effect: read
      questions:
      - How do I see every Azure Front Door and CDN profile across my whole subscription?
      - Which CDN profiles exist in my subscription, regardless of resource group?
      instructions:
      - text: List all Front Door and CDN profiles in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show every CDN profile I have across subscription {sub}.
        slots:
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List Front Door and CDN profiles in a resource group
      effect: read
      questions:
      - Can I list only the Front Door and CDN profiles in one resource group?
      - What CDN profiles live in a specific resource group?
      instructions:
      - text: List the Front Door and CDN profiles in resource group {rg} of subscription {sub}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show CDN profiles in resource group {rg}.
        slots:
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Front Door or CDN profile
      effect: read
      questions:
      - How do I look up the SKU and state of one Front Door or CDN profile?
      - What are the settings of my CDN profile named 'contoso-cdn'?
      instructions:
      - text: Get Front Door/CDN profile {profile} in resource group {rg} of subscription {sub}.
        slots:
          profile: path.profileName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the SKU of CDN profile {profile}.
        slots:
          profile: path.profileName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Front Door or CDN profile
      effect: write
      questions:
      - How do I create a new Azure Front Door Premium profile?
      - Which SKU and location do I need to supply to set up a new CDN profile?
      instructions:
      - text: Create CDN profile {profile} in resource group {rg} of subscription {sub} with SKU {sku} in {location}.
        slots:
          profile: path.profileName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          sku: requestBody.sku
          location: requestBody.location
      - text: Set up a new Front Door Standard profile named {profile} using SKU {sku}.
        slots:
          profile: path.profileName
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Front Door or CDN profile
      effect: destructive
      questions:
      - What gets removed along with a CDN profile when I delete it — endpoints, origins, custom domains?
      - How do I tear down a Front Door profile I no longer use?
      instructions:
      - text: Delete CDN profile {profile} in resource group {rg} of subscription {sub}.
        slots:
          profile: path.profileName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Tear down Front Door profile {profile} and all its endpoints.
        slots:
          profile: path.profileName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Front Door or CDN profile
      effect: write
      questions:
      - Can I change the tags or managed identity on an existing CDN profile?
      - How do I modify settings on a Front Door profile after it's been created?
      instructions:
      - text: Update the tags on CDN profile {profile} in resource group {rg} of subscription {sub} to {tags}.
        slots:
          profile: path.profileName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          tags: requestBody.tags
      - text: Change the managed identity of Front Door profile {profile} to {identity}.
        slots:
          profile: path.profileName
          identity: requestBody.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/canMigrate'].post
  update:
    x-apievangelist-phrasing:
      intent: Check if a classic CDN profile can migrate
      effect: read
      questions:
      - Is my classic CDN profile eligible to move to Azure Front Door Standard or Premium?
      - How can I check migration readiness before converting a CDN profile to Front Door?
      instructions:
      - text: Check whether classic CDN profile {classic} in resource group {rg} of subscription {sub} can migrate to Front Door.
        slots:
          classic: requestBody.classicResourceReference
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Tell me if {classic} is eligible for Front Door migration.
        slots:
          classic: requestBody.classicResourceReference
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/migrate'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate a CDN profile to Front Door
      effect: write
      questions:
      - How do I start migrating a classic CDN profile to Azure Front Door Premium?
      - Can I map my existing WAF policies while migrating a CDN profile to Front Door?
      instructions:
      - text: Migrate classic profile {classic} in resource group {rg} of subscription {sub} to new Front Door profile {newName} with SKU {sku}.
        slots:
          classic: requestBody.classicResourceReference
          rg: path.resourceGroupName
          sub: path.subscriptionId
          newName: requestBody.profileName
          sku: requestBody.sku
      - text: Start the Front Door migration of {classic} using WAF mappings {waf}.
        slots:
          classic: requestBody.classicResourceReference
          waf: requestBody.migrationWebApplicationFirewallMappings
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/migrationCommit'].post
  update:
    x-apievangelist-phrasing:
      intent: Commit a Front Door profile migration
      effect: write
      questions:
      - After migrating a CDN profile to Front Door, how do I finalize the change?
      - What step makes a migrated Front Door profile permanent?
      instructions:
      - text: Commit the migration of Front Door profile {profile} in resource group {rg} of subscription {sub}.
        slots:
          profile: path.profileName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Finalize the migrated profile {profile}.
        slots:
          profile: path.profileName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/generateSsoUri'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a sign-in link for the CDN supplemental portal
      effect: read
      questions:
      - How do I open the CDN supplemental portal to reach features not yet in the Azure portal?
      - Can I generate a single sign-on URL for advanced CDN reports and rules engine settings?
      instructions:
      - text: Generate an SSO link to the supplemental portal for CDN profile {profile} in resource group {rg} of subscription {sub}.
        slots:
          profile: path.profileName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Give me a supplemental portal sign-in URI for profile {profile}.
        slots:
          profile: path.profileName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getSupportedOptimizationTypes'].post
  update:
    x-apievangelist-phrasing:
      intent: List optimization types a CDN profile supports
      effect: read
      questions:
      - Which optimization types can I choose when creating an endpoint on my CDN profile?
      - Does my profile support large file download or dynamic site acceleration optimization?
      instructions:
      - text: List supported optimization types for CDN profile {profile} in resource group {rg} of subscription {sub}.
        slots:
          profile: path.profileName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which endpoint optimization types profile {profile} allows.
        slots:
          profile: path.profileName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/checkResourceUsage'].post
  update:
    x-apievangelist-phrasing:
      intent: Check endpoint quota usage on a CDN profile
      effect: read
      questions:
      - How many endpoints have I used against the quota on my Front Door profile?
      - Am I close to the endpoint limit on a CDN profile?
      instructions:
      - text: Check endpoint quota and usage for profile {profile} in resource group {rg} of subscription {sub}.
        slots:
          profile: path.profileName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show how much of the endpoint quota CDN profile {profile} has consumed.
        slots:
          profile: path.profileName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/profiles/{profileName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a profile type in a Customer Insights hub
      effect: read
      questions:
      - How do I read a profile type definition in a Customer Insights hub?
      - Can I get a hub profile's display names in a particular locale?
      instructions:
      - text: Get profile {profile} in Customer Insights hub {hub}, resource group {rg}, subscription {sub}.
        slots:
          profile: path.profileName
          hub: path.hubName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show hub profile {profile} with names localized to {locale}.
        slots:
          profile: path.profileName
          locale: query.locale-code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/profiles/{profileName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Customer Insights hub profile
      effect: write
      questions:
      - How do I define a new customer profile type inside a Customer Insights hub?
      - Can I change the fields of an existing profile type in my hub?
      instructions:
      - text: Create or update profile {profile} in hub {hub}, resource group {rg}, subscription {sub} with properties {properties}.
        slots:
          profile: path.profileName
          hub: path.hubName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Add a profile type named {profile} to Customer Insights hub {hub}.
        slots:
          profile: path.profileName
          hub: path.hubName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/profiles/{profileName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Customer Insights hub profile
      effect: destructive
      questions:
      - How do I remove a profile type from a Customer Insights hub?
      - Can I delete a hub profile I defined by mistake?
      instructions:
      - text: Delete profile {profile} from Customer Insights hub {hub}, resource group {rg}, subscription {sub}.
        slots:
          profile: path.profileName
          hub: path.hubName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the {profile} profile type from hub {hub}.
        slots:
          profile: path.profileName
          hub: path.hubName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List profiles in a Customer Insights hub
      effect: read
      questions:
      - Which profile types are defined in my Customer Insights hub?
      - Can I list all hub profiles with names in a specific language?
      instructions:
      - text: List all profiles in Customer Insights hub {hub}, resource group {rg}, subscription {sub}.
        slots:
          hub: path.hubName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the profile types in hub {hub} localized to {locale}.
        slots:
          hub: path.hubName
          locale: query.locale-code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/profiles/{profileName}/getEnrichingKpis'].post
  update:
    x-apievangelist-phrasing:
      intent: Get KPIs that enrich a hub profile
      effect: read
      questions:
      - Which KPIs enrich a customer profile type in Customer Insights?
      - How do I see the interaction and relationship KPIs feeding a hub profile?
      instructions:
      - text: Get the enriching KPIs for profile {profile} in hub {hub}, resource group {rg}, subscription {sub}.
        slots:
          profile: path.profileName
          hub: path.hubName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which KPIs enrich hub profile {profile}.
        slots:
          profile: path.profileName
      method: generated
      generated: '2026-09-26'