# 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 Commitment Plans Management Client…
  version: 1.0.0
extends: openapi/microsoft-azure-commitmentassociations-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/commitmentPlans/{commitmentPlanName}/commitmentAssociations/{commitmentAssociationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Machine Learning commitment association
      effect: read
      questions:
      - How do I look up one commitment association on an Azure ML commitment plan?
      - Which web service is tied to a given commitment association?
      instructions:
      - text: Get commitment association {commitmentAssociationName} on plan {commitmentPlanName}.
        slots:
          commitmentAssociationName: path.commitmentAssociationName
          commitmentPlanName: path.commitmentPlanName
      - text: Show association {commitmentAssociationName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          commitmentAssociationName: path.commitmentAssociationName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/commitmentPlans/{commitmentPlanName}/commitmentAssociations'].get
  update:
    x-apievangelist-phrasing:
      intent: List commitment associations for a commitment plan
      effect: read
      questions:
      - What commitment associations belong to my Azure ML commitment plan?
      - Can I page through a plan's associations with a continuation token?
      instructions:
      - text: List the commitment associations on plan {commitmentPlanName}.
        slots:
          commitmentPlanName: path.commitmentPlanName
      - text: List associations for plan {commitmentPlanName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          commitmentPlanName: path.commitmentPlanName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/commitmentPlans/{commitmentPlanName}/commitmentAssociations/{commitmentAssociationName}/move'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a commitment association to another plan
      effect: write
      questions:
      - Can I re-parent a commitment association to a different commitment plan?
      - How do I shift a web service's billing to another ML commitment plan?
      instructions:
      - text: Move commitment association {commitmentAssociationName} from plan {commitmentPlanName} to plan {destinationPlanId}.
        slots:
          commitmentAssociationName: path.commitmentAssociationName
          commitmentPlanName: path.commitmentPlanName
          destinationPlanId: requestBody.destinationPlanId
      - text: Re-parent association {commitmentAssociationName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          commitmentAssociationName: path.commitmentAssociationName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'