# 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 SubscriptionDefinitionsClient Subscription…
  version: 1.0.0
extends: openapi/microsoft-azure-subscriptiondefinitions-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: 5
- target: $.paths['/providers/Microsoft.Subscription/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Microsoft.Subscription API operations
      effect: read
      questions:
      - Which operations does the Microsoft.Subscription provider support?
      - Can I list the available subscription API operations?
      instructions:
      - text: List all Microsoft.Subscription API operations.
      - text: Show the operations offered by the subscription resource provider.
      - text: List Microsoft.Subscription operations for API version {version}.
        slots:
          version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Subscription/subscriptionDefinitions/{subscriptionDefinitionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a subscription definition
      effect: read
      questions:
      - What does one of my Azure subscription definitions contain?
      - Can I look up a subscription definition by name?
      instructions:
      - text: Get subscription definition {def}.
        slots:
          def: path.subscriptionDefinitionName
      - text: Show the Azure subscription definition named {def}.
        slots:
          def: path.subscriptionDefinitionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Subscription/subscriptionDefinitions/{subscriptionDefinitionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a subscription definition
      effect: write
      questions:
      - How do I create an Azure subscription programmatically through a definition?
      - Can I define a new subscription with specific properties?
      instructions:
      - text: Create subscription definition {def}.
        slots:
          def: path.subscriptionDefinitionName
      - text: Create Azure subscription definition {def} with properties {props}.
        slots:
          def: path.subscriptionDefinitionName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Subscription/subscriptionDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List subscription definitions
      effect: read
      questions:
      - What subscription definitions exist for my subscription?
      - Can I see all Azure subscription definitions at once?
      instructions:
      - text: List my subscription definitions.
      - text: Show every Azure subscription definition.
      - text: List subscription definitions using API version {version}.
        slots:
          version: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Subscription/subscriptionOperations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the status of a subscription definition creation
      effect: read
      questions:
      - Has my subscription definition creation finished yet?
      - Where do I check the progress of a subscription definition PUT?
      instructions:
      - text: Get the status of subscription operation {op}.
        slots:
          op: path.operationId
      - text: Check whether subscription definition operation {op} has completed.
        slots:
          op: path.operationId
      method: generated
      generated: '2026-09-26'