# 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 Microsoft.KubernetesRuntime Storage Class…
  version: 1.0.0
extends: openapi/microsoft-azure-storageclass-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: 5
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/storageClasses'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage classes on a Kubernetes cluster
      effect: read
      questions:
      - Which storage classes are defined on my Arc-connected Kubernetes cluster?
      - Can I list the StorageClass resources under one cluster resource?
      instructions:
      - text: List storage classes under resource {uri}.
        slots:
          uri: path.resourceUri
      - text: Show every StorageClass resource on the cluster {uri}.
        slots:
          uri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/storageClasses/{storageClassName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a storage class
      effect: read
      questions:
      - What are the settings of one storage class on my cluster?
      - Can I look up a StorageClass resource by name?
      instructions:
      - text: Get storage class {name} under resource {uri}.
        slots:
          name: path.storageClassName
          uri: path.resourceUri
      - text: Show StorageClass {name} on cluster {uri}.
        slots:
          name: path.storageClassName
          uri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/storageClasses/{storageClassName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a storage class
      effect: write
      questions:
      - How do I create a new storage class on a Kubernetes cluster through Azure?
      - Can I define a storage class's properties when creating it?
      instructions:
      - text: Create storage class {name} under resource {uri}.
        slots:
          name: path.storageClassName
          uri: path.resourceUri
      - text: Create StorageClass {name} on cluster {uri} with properties {properties}.
        slots:
          name: path.storageClassName
          uri: path.resourceUri
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/storageClasses/{storageClassName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a storage class
      effect: destructive
      questions:
      - Can I delete a storage class from my cluster?
      - What happens to volumes when a StorageClass resource is removed?
      instructions:
      - text: Delete storage class {name} under resource {uri}.
        slots:
          name: path.storageClassName
          uri: path.resourceUri
      - text: Remove StorageClass {name} from cluster {uri}.
        slots:
          name: path.storageClassName
          uri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.KubernetesRuntime/storageClasses/{storageClassName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a storage class
      effect: write
      questions:
      - Can I change properties on an existing storage class?
      - Which fields of a StorageClass resource can be patched?
      instructions:
      - text: Update storage class {name} under resource {uri} with {properties}.
        slots:
          name: path.storageClassName
          uri: path.resourceUri
          properties: requestBody.properties
      - text: Patch the existing StorageClass {name} on cluster {uri}.
        slots:
          name: path.storageClassName
          uri: path.resourceUri
      method: generated
      generated: '2026-09-26'