Microsoft Azure Cdn · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Microsoft Azure Cdn Subscriptions API

8 actions 8 updates phrasing extends openapi/microsoft-azure-cdn-subscriptions-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Microsoft Azure Cdn's API. It is a proposal applied on top of the contract, not a document Microsoft Azure Cdn publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 8

$.info
$.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/cdnWebApplicationFirewallManagedRuleSets'].get
$.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/checkNameAvailability'].post
$.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/checkResourceUsage'].post
$.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/validateProbe'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/canMigrate'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/checkEndpointNameAvailability'].post
$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/migrate'].post

OpenAPI Overlay

Raw ↑
# 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 Cdn Subscriptions API
  version: 1.0.0
extends: openapi/microsoft-azure-cdn-subscriptions-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/cdnWebApplicationFirewallManagedRuleSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List available CDN WAF managed rule sets
      effect: read
      questions:
      - Which managed rule sets can I enable in a CDN web application firewall policy?
      - What versions of the default managed WAF rules are available for CDN?
      instructions:
      - text: List all available managed rule sets for CDN WAF policies.
      - text: Show me the managed firewall rule sets I can apply.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a CDN name's availability in my subscription
      effect: read
      questions:
      - Is a CDN endpoint name free to use within my Azure subscription?
      - Can I validate a globally unique CDN name scoped to my subscription?
      instructions:
      - text: Check within my subscription whether {name} is available as a {type}.
        slots:
          name: requestBody.name
          type: requestBody.type
      - text: Test if CDN name {name} of type {type} is free for my subscription.
        slots:
          name: requestBody.name
          type: requestBody.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/checkResourceUsage'].post
  update:
    x-apievangelist-phrasing:
      intent: Check CDN profile quota for my subscription
      effect: read
      questions:
      - How many CDN profiles am I allowed in my subscription and how many do I use?
      - Am I close to the subscription-wide CDN profile quota?
      instructions:
      - text: Check the CDN profile quota and usage for my subscription.
      - text: Show subscription-level resource usage for CDN profiles.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cdn/validateProbe'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a dynamic site acceleration probe path
      effect: read
      questions:
      - Is my probe file reachable on the origin for dynamic site acceleration?
      - Can I test a probe URL before saving it on an endpoint?
      instructions:
      - text: Validate the probe URL {probe}.
        slots:
          probe: requestBody.probeURL
      - text: Check that probe path {probe} is valid and the file can be accessed.
        slots:
          probe: requestBody.probeURL
      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:
      - Can my classic CDN profile be moved to Front Door Standard or Premium?
      - What blocks a classic profile from migrating, identified by its resource reference?
      instructions:
      - text: Check whether classic resource {resource} can migrate to Front Door Standard or Premium.
        slots:
          resource: requestBody.classicResourceReference
      - text: Run a migration eligibility check on {resource} in this resource group.
        slots:
          resource: requestBody.classicResourceReference
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/checkEndpointNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check an AFD endpoint name in a resource group
      effect: read
      questions:
      - Is an Azure Front Door endpoint name available in my resource group?
      - Can I control the reuse scope of the auto-generated endpoint hostname?
      instructions:
      - text: Check if AFD endpoint name {name} of type {type} is available in this resource group.
        slots:
          name: requestBody.name
          type: requestBody.type
      - text: Test endpoint name {name} as {type} with reuse scope {scope} at resource group level.
        slots:
          name: requestBody.name
          type: requestBody.type
          scope: requestBody.autoGeneratedDomainNameLabelScope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/migrate'].post
  update:
    x-apievangelist-phrasing:
      intent: Migrate a classic resource to a new Front Door profile
      effect: write
      questions:
      - How do I start migrating a classic Front Door or CDN resource into a new profile?
      - Does a migration need to be committed after it runs?
      instructions:
      - text: Migrate {resource} into new profile {newprofile} with SKU {sku}.
        slots:
          resource: requestBody.classicResourceReference
          newprofile: requestBody.profileName
          sku: requestBody.sku
      - text: Start migration of {resource} to profile {newprofile} on SKU {sku} using WAF mappings {waf}.
        slots:
          resource: requestBody.classicResourceReference
          newprofile: requestBody.profileName
          sku: requestBody.sku
          waf: requestBody.migrationWebApplicationFirewallMappings
      method: generated
      generated: '2026-09-26'