# 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 Operationalization Clusters API
  version: 1.0.0
extends: openapi/microsoft-azure-operationalizationclusters-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: 11
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningCompute/operationalizationClusters/{clusterName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Machine Learning operationalization cluster
      effect: read
      questions:
      - What does my Machine Learning Compute operationalization cluster look like?
      - Does fetching an operationalization cluster return its credentials?
      instructions:
      - text: Get operationalization cluster {cluster} in {rg} of subscription {sub}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the resource view of ML compute cluster {cluster} in {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningCompute/operationalizationClusters/{clusterName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an operationalization cluster
      effect: write
      questions:
      - How do I create a Machine Learning operationalization cluster for model deployment?
      - Which location must I give when creating an operationalization cluster?
      instructions:
      - text: Create operationalization cluster {cluster} in {rg} of subscription {sub} in region {location}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
      - text: Create or replace ML compute cluster {cluster} in {rg} with properties {properties}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningCompute/operationalizationClusters/{clusterName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an operationalization cluster
      effect: destructive
      questions:
      - Can I delete a Machine Learning operationalization cluster I no longer use?
      - What gets removed when I delete an ML compute operationalization cluster?
      instructions:
      - text: Delete operationalization cluster {cluster} in {rg} of subscription {sub}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove ML compute cluster {cluster} from {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningCompute/operationalizationClusters/{clusterName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on an operationalization cluster
      effect: write
      questions:
      - Can I change just the tags on an operationalization cluster?
      - Which properties can the PATCH call change on an ML compute cluster?
      instructions:
      - text: Set tags {tags} on operationalization cluster {cluster} in {rg} of subscription {sub}.
        slots:
          tags: requestBody.tags
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Retag ML compute cluster {cluster} in {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningCompute/operationalizationClusters/{clusterName}/listKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Get credentials for an operationalization cluster
      effect: read
      questions:
      - Where do I get the storage, ACR and ACS credentials for my operationalization cluster?
      - Why does fetching an ML compute cluster's keys take a while?
      instructions:
      - text: Get the keys for operationalization cluster {cluster} in {rg} of subscription {sub}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Fetch storage, container registry and container service credentials for cluster {cluster} in {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningCompute/operationalizationClusters/{clusterName}/checkUpdate'].post
  update:
    x-apievangelist-phrasing:
      intent: Check for system updates on an operationalization cluster
      effect: read
      questions:
      - Are system service updates available for my operationalization cluster?
      - Can I check an ML compute cluster for pending system updates using the checkUpdate call?
      instructions:
      - text: Run checkUpdate on operationalization cluster {cluster} in {rg} of subscription {sub}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check if cluster {cluster} in {rg} has system updates waiting, via checkUpdate.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningCompute/operationalizationClusters/{clusterName}/updateSystem'].post
  update:
    x-apievangelist-phrasing:
      intent: Update system services on an operationalization cluster
      effect: write
      questions:
      - How do I apply system updates to an operationalization cluster using updateSystem?
      - Can I upgrade the system services on my ML compute cluster with the updateSystem action?
      instructions:
      - text: Run updateSystem on operationalization cluster {cluster} in {rg} of subscription {sub}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Apply system updates to cluster {cluster} in {rg} with updateSystem.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningCompute/operationalizationClusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List operationalization clusters in a resource group
      effect: read
      questions:
      - Which operationalization clusters are in a given resource group?
      - Can I page through ML compute clusters in a resource group with a skip token?
      instructions:
      - text: List operationalization clusters in resource group {rg} of subscription {sub}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the next page of ML compute clusters in {rg} after token {token}.
        slots:
          rg: path.resourceGroupName
          token: query.$skiptoken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningCompute/operationalizationClusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List operationalization clusters in a subscription
      effect: read
      questions:
      - What operationalization clusters do I have across my whole subscription?
      - Can I list every ML compute operationalization cluster I own?
      instructions:
      - text: List all operationalization clusters in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show the next page of subscription-wide ML compute clusters in {sub} after token {token}.
        slots:
          sub: path.subscriptionId
          token: query.$skiptoken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningCompute/operationalizationClusters/{clusterName}/checkSystemServicesUpdatesAvailable'].post
  update:
    x-apievangelist-phrasing:
      intent: Check for system services updates on an ML cluster
      effect: read
      questions:
      - Is there a newer version of system services for my operationalization cluster, via checkSystemServicesUpdatesAvailable?
      - Which call reports whether system services updates are available on an ML compute cluster?
      instructions:
      - text: Check whether system services updates are available for operationalization cluster {cluster} in {rg} of subscription {sub}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Call checkSystemServicesUpdatesAvailable for cluster {cluster} in {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningCompute/operationalizationClusters/{clusterName}/updateSystemServices'].post
  update:
    x-apievangelist-phrasing:
      intent: Update system services via updateSystemServices
      effect: write
      questions:
      - How do I apply system services updates with the updateSystemServices action?
      - Can I upgrade system services on an operationalization cluster using updateSystemServices?
      instructions:
      - text: Update system services on operationalization cluster {cluster} in {rg} of subscription {sub} via updateSystemServices.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Call updateSystemServices for cluster {cluster} in {rg}.
        slots:
          cluster: path.clusterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'