# 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 Azure Red Hat OpenShift Client Open Shift…
  version: 1.0.0
extends: openapi/microsoft-azure-openshiftclusters-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.RedHatOpenShift/openShiftClusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List OpenShift clusters in a subscription
      effect: read
      questions:
      - Which Azure Red Hat OpenShift clusters are running across my whole subscription?
      - Can I inventory every OpenShift cluster without picking a resource group?
      instructions:
      - text: List all OpenShift clusters in my subscription.
      - text: Show every Red Hat OpenShift cluster subscription-wide.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RedHatOpenShift/openShiftClusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List OpenShift clusters in a resource group
      effect: read
      questions:
      - What OpenShift clusters are deployed in one particular resource group?
      - Can I narrow my OpenShift cluster list to a single resource group?
      instructions:
      - text: List the OpenShift clusters in my current resource group.
      - text: Show Red Hat OpenShift clusters scoped to this resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RedHatOpenShift/openShiftClusters/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an OpenShift cluster
      effect: read
      questions:
      - What are the properties and provisioning state of one OpenShift cluster?
      - Can I look up a single Azure Red Hat OpenShift cluster by name?
      instructions:
      - text: Get OpenShift cluster {resourceName}.
        slots:
          resourceName: path.resourceName
      - text: Show the configuration of cluster {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RedHatOpenShift/openShiftClusters/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an OpenShift cluster
      effect: write
      questions:
      - How do I deploy a new Azure Red Hat OpenShift cluster?
      - Can I submit a full cluster definition to create or overwrite an OpenShift cluster?
      instructions:
      - text: Create OpenShift cluster {resourceName} with properties {properties}.
        slots:
          resourceName: path.resourceName
          properties: requestBody.properties
      - text: Deploy a new Red Hat OpenShift cluster called {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RedHatOpenShift/openShiftClusters/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an OpenShift cluster
      effect: destructive
      questions:
      - Can I tear down an OpenShift cluster I no longer need?
      - What happens when I delete an Azure Red Hat OpenShift cluster?
      instructions:
      - text: Delete OpenShift cluster {resourceName}.
        slots:
          resourceName: path.resourceName
      - text: Tear down Red Hat OpenShift cluster {resourceName} permanently.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RedHatOpenShift/openShiftClusters/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing OpenShift cluster's tags or settings
      effect: write
      questions:
      - Can I change the tags on an OpenShift cluster without resubmitting the whole definition?
      - How do I patch a few properties of a running OpenShift cluster?
      instructions:
      - text: Set tags {tags} on existing OpenShift cluster {resourceName}.
        slots:
          tags: requestBody.tags
          resourceName: path.resourceName
      - text: Patch cluster {resourceName} with properties {properties}.
        slots:
          resourceName: path.resourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RedHatOpenShift/openShiftClusters/{resourceName}/listAdminCredentials'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the admin kubeconfig for an OpenShift cluster
      effect: read
      questions:
      - Where do I get the admin kubeconfig for my OpenShift cluster?
      - Can I pull cluster-admin kubectl access for an Azure Red Hat OpenShift cluster?
      instructions:
      - text: Get the admin kubeconfig for OpenShift cluster {resourceName}.
        slots:
          resourceName: path.resourceName
      - text: Download cluster-admin kubeconfig of {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RedHatOpenShift/openShiftClusters/{resourceName}/listCredentials'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the login credentials of an OpenShift cluster
      effect: read
      questions:
      - What's the kubeadmin username and password for my OpenShift cluster?
      - Can I retrieve the console login credentials of a cluster?
      instructions:
      - text: List the login credentials for OpenShift cluster {resourceName}.
        slots:
          resourceName: path.resourceName
      - text: Show the kubeadmin username and password of {resourceName}.
        slots:
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'