# 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 Software Plan RP Hybrid Use Benefit API
  version: 1.0.0
extends: openapi/microsoft-azure-hybrid-use-benefit-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: 4
- target: $.paths['/{scope}/providers/Microsoft.SoftwarePlan/hybridUseBenefits/{planId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a hybrid use benefit plan
      effect: read
      questions:
      - What does my Azure Hybrid Benefit software plan look like at a given scope?
      - Can I look up a hybrid use benefit by its plan ID?
      instructions:
      - text: Get hybrid use benefit plan {plan} at scope {scope}.
        slots:
          plan: path.planId
          scope: path.scope
      - text: Show the details of hybrid benefit {plan}.
        slots:
          plan: path.planId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.SoftwarePlan/hybridUseBenefits/{planId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a hybrid use benefit plan
      effect: write
      questions:
      - How do I set up a new hybrid use benefit under a subscription or resource group?
      - Can I create an Azure Hybrid Benefit software plan at a specific scope?
      instructions:
      - text: Create hybrid use benefit {plan} at scope {scope}.
        slots:
          plan: path.planId
          scope: path.scope
      - text: Register a new hybrid benefit plan {plan} under {scope}.
        slots:
          plan: path.planId
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.SoftwarePlan/hybridUseBenefits/{planId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a hybrid use benefit plan
      effect: destructive
      questions:
      - Can I delete a hybrid use benefit I no longer qualify for?
      - How do I remove an Azure Hybrid Benefit plan from a scope?
      instructions:
      - text: Delete hybrid use benefit {plan} at scope {scope}.
        slots:
          plan: path.planId
          scope: path.scope
      - text: Remove hybrid benefit plan {plan} from {scope}.
        slots:
          plan: path.planId
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.SoftwarePlan/hybridUseBenefits/{planId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a hybrid use benefit plan
      effect: write
      questions:
      - How do I change an existing hybrid use benefit plan?
      - Can I edit a hybrid benefit plan after it has been created?
      instructions:
      - text: Update hybrid use benefit {plan} at scope {scope}.
        slots:
          plan: path.planId
          scope: path.scope
      - text: Modify existing hybrid benefit plan {plan} under {scope}.
        slots:
          plan: path.planId
          scope: path.scope
      method: generated
      generated: '2026-09-26'