# 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 ML Management Client Commitment Plans…
  version: 1.0.0
extends: openapi/microsoft-azure-commitment-plans-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/commitmentPlans/{commitmentPlanName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Azure ML commitment plan
      effect: read
      questions:
      - What are the details of my Azure Machine Learning commitment plan?
      - Can I look up one ML commitment plan by name?
      instructions:
      - text: Get commitment plan {plan} in resource group {group}, subscription {subscription}.
        slots:
          plan: path.commitmentPlanName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the SKU and settings of ML commitment plan {plan}.
        slots:
          plan: path.commitmentPlanName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/commitmentPlans/{commitmentPlanName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an ML commitment plan
      effect: write
      questions:
      - How do I buy a new Azure ML commitment plan for my web services?
      - Which location and SKU do I need to set when creating a commitment plan?
      instructions:
      - text: Create commitment plan {plan} in {location} for group {group}, subscription {subscription}.
        slots:
          plan: path.commitmentPlanName
          location: requestBody.location
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Replace ML commitment plan {plan} in {location} with SKU {sku}.
        slots:
          plan: path.commitmentPlanName
          location: requestBody.location
          sku: requestBody.sku
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/commitmentPlans/{commitmentPlanName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an ML commitment plan
      effect: destructive
      questions:
      - Can I cancel and remove an Azure ML commitment plan?
      - What deletes an existing commitment plan from my resource group?
      instructions:
      - text: Remove commitment plan {plan} from resource group {group}, subscription {subscription}.
        slots:
          plan: path.commitmentPlanName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Delete the ML commitment plan named {plan}.
        slots:
          plan: path.commitmentPlanName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/commitmentPlans/{commitmentPlanName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change an ML commitment plan's SKU or tags
      effect: write
      questions:
      - Can I move my ML commitment plan to a bigger or smaller SKU?
      - Is there a way to update only the tags on a commitment plan?
      instructions:
      - text: Patch commitment plan {plan} in group {group}, subscription {subscription} to SKU {sku}.
        slots:
          plan: path.commitmentPlanName
          group: path.resourceGroupName
          subscription: path.subscriptionId
          sku: requestBody.sku
      - text: Retag existing ML commitment plan {plan} with {tags}.
        slots:
          plan: path.commitmentPlanName
          tags: requestBody.tags
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearning/commitmentPlans'].get
  update:
    x-apievangelist-phrasing:
      intent: List ML commitment plans in a subscription
      effect: read
      questions:
      - Which Azure ML commitment plans exist across my subscription?
      - Can I page through all commitment plans with a skip token?
      instructions:
      - text: List every ML commitment plan in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Continue the subscription-wide commitment plan list from token {skip_token}.
        slots:
          skip_token: query.$skipToken
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/commitmentPlans'].get
  update:
    x-apievangelist-phrasing:
      intent: List ML commitment plans in a resource group
      effect: read
      questions:
      - What ML commitment plans are in one particular resource group?
      - Can I limit the commitment plan list to a single resource group?
      instructions:
      - text: List commitment plans in resource group {group}, subscription {subscription}.
        slots:
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the ML commitment plans in group {group} starting at {skip_token}.
        slots:
          group: path.resourceGroupName
          skip_token: query.$skipToken
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/commitmentPlans/{commitmentPlanName}/usageHistory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get usage history for an ML commitment plan
      effect: read
      questions:
      - How much of my Azure ML commitment plan have I actually used over time?
      - Can I pull the usage history of a commitment plan page by page?
      instructions:
      - text: Get the usage history of commitment plan {plan} in group {group}, subscription {subscription}.
        slots:
          plan: path.commitmentPlanName
          group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show consumption records for ML commitment plan {plan}.
        slots:
          plan: path.commitmentPlanName
      method: generated
      generated: '2026-10-01'