API Evangelist conversational phrasing for Microsoft Azure ExtensionTypesClient Cluster Extension…

# 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 ExtensionTypesClient Cluster Extension…
  version: 1.0.0
extends: openapi/microsoft-azure-clusterextensiontypes-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.KubernetesConfiguration/locations/{location}/extensionTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List Kubernetes extension types in a region
      effect: read
      questions:
      - Which Arc-enabled Kubernetes extension types are offered in a given Azure region?
      - Can I narrow the regional extension type catalog to one publisher or release train?
      instructions:
      - text: List the extension types available in location {location}.
        slots:
          location: path.location
      - text: List regional extension types from publisher {publisher} on release train {train}.
        slots:
          publisher: query.publisherId
          train: query.releaseTrain
      - text: Show regional extension types that support cluster type {clusterType}.
        slots:
          clusterType: query.clusterType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.KubernetesConfiguration/locations/{location}/extensionTypes/{extensionTypeName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an extension type for a region
      effect: read
      questions:
      - What does the regional catalog say about a specific Kubernetes extension type?
      - How do I look up one extension type's details for a location rather than a cluster?
      instructions:
      - text: Get extension type {type} for location {location}.
        slots:
          type: path.extensionTypeName
          location: path.location
      - text: Describe regional extension type {type}.
        slots:
          type: path.extensionTypeName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.KubernetesConfiguration/locations/{location}/extensionTypes/{extensionTypeName}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of an extension type in a region
      effect: read
      questions:
      - Which versions of an extension type are published in a region?
      - Can I see only the latest regional version for a given major version?
      instructions:
      - text: List versions of extension type {type} published in region {location}.
        slots:
          type: path.extensionTypeName
          location: path.location
      - text: List versions of extension type {type} in major version {major} on release train {train}.
        slots:
          type: path.extensionTypeName
          major: query.majorVersion
          train: query.releaseTrain
      - text: Show only the latest regional version of extension type {type} (showLatest {latest}).
        slots:
          type: path.extensionTypeName
          latest: query.showLatest
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.KubernetesConfiguration/locations/{location}/extensionTypes/{extensionTypeName}/versions/{versionNumber}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a regional extension type version
      effect: read
      questions:
      - What are the details of one specific version of an extension type in a region?
      - Can I check a single published version of an extension type for a location?
      instructions:
      - text: Get version {version} of extension type {type} for location {location}.
        slots:
          type: path.extensionTypeName
          version: path.versionNumber
          location: path.location
      - text: Describe regional release {version} of extension type {type}.
        slots:
          type: path.extensionTypeName
          version: path.versionNumber
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/extensionTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List extension types installable on a cluster
      effect: read
      questions:
      - Which extensions can I install on my own Kubernetes cluster?
      - Can I filter the extensions installable on my cluster by publisher, offer or plan?
      instructions:
      - text: List the extension types I can install on cluster {clusterName} ({clusterRp}/{clusterResourceName}).
        slots:
          clusterName: path.clusterName
          clusterRp: path.clusterRp
          clusterResourceName: path.clusterResourceName
      - text: List cluster-installable extension types from publisher {publisher} with plan {plan}.
        slots:
          publisher: query.publisherId
          plan: query.planId
      - text: Show extension types installable on my cluster for offer {offer}.
        slots:
          offer: query.offerId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/extensionTypes/{extensionTypeName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an extension type installable on a cluster
      effect: read
      questions:
      - Is a particular extension type installable on my cluster's region and type?
      - How do I look up one extension type as it applies to my specific cluster?
      instructions:
      - text: Get installable extension type {type} for cluster {clusterName} of kind {clusterRp}/{clusterResourceName}.
        slots:
          type: path.extensionTypeName
          clusterName: path.clusterName
          clusterRp: path.clusterRp
          clusterResourceName: path.clusterResourceName
      - text: Check whether extension type {type} can be installed on this cluster.
        slots:
          type: path.extensionTypeName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/extensionTypes/{extensionTypeName}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List installable versions of an extension on a cluster
      effect: read
      questions:
      - Which versions of an extension can I install on my cluster?
      - Can I see only the newest installable version for my cluster?
      instructions:
      - text: List versions of extension type {type} installable on cluster {clusterName} ({clusterRp}/{clusterResourceName}).
        slots:
          type: path.extensionTypeName
          clusterName: path.clusterName
          clusterRp: path.clusterRp
          clusterResourceName: path.clusterResourceName
      - text: List installable versions of {type} for my cluster on release train {train}.
        slots:
          type: path.extensionTypeName
          train: query.releaseTrain
      - text: Show the latest version of {type} my cluster can install, major version {major}.
        slots:
          type: path.extensionTypeName
          major: query.majorVersion
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/extensionTypes/{extensionTypeName}/versions/{versionNumber}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an installable extension version for a cluster
      effect: read
      questions:
      - Can I check details of one extension version before installing it on my cluster?
      - What does a specific installable version of an extension offer my cluster?
      instructions:
      - text: Get installable version {version} of extension type {type} for cluster {clusterName} under {clusterRp}/{clusterResourceName}.
        slots:
          type: path.extensionTypeName
          version: path.versionNumber
          clusterName: path.clusterName
          clusterRp: path.clusterRp
          clusterResourceName: path.clusterResourceName
      - text: Check if my cluster can install release {version} of {type}.
        slots:
          type: path.extensionTypeName
          version: path.versionNumber
      method: generated
      generated: '2026-10-01'