# 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 HanaManagementClient Hana On Azure API
  version: 1.0.0
extends: openapi/microsoft-azure-hanaonazure-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: 10
- target: $.paths['/providers/Microsoft.HanaOnAzure/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List SAP HANA on Azure management operations
      effect: read
      questions:
      - Which management operations does the SAP HANA on Azure resource provider support?
      - Can I get the list of available HanaOnAzure operations for RBAC planning?
      instructions:
      - text: List the SAP HANA on Azure management operations.
      - text: Show every operation the HanaOnAzure provider exposes under API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.HanaOnAzure/sapMonitors'].get
  update:
    x-apievangelist-phrasing:
      intent: List SAP monitors in a subscription
      effect: read
      questions:
      - How do I find all the retired AMS Classic SAP monitors still in my subscription?
      - Which SAP monitors exist across my Azure subscription?
      instructions:
      - text: List all SAP monitors in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show any leftover AMS Classic SAP monitors in subscription {sub}.
        slots:
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an SAP monitor
      effect: read
      questions:
      - How do I look up the properties of one SAP monitor?
      - What state is my AMS Classic SAP monitor in?
      instructions:
      - text: Get SAP monitor {monitor} in resource group {rg} of subscription {sub}.
        slots:
          monitor: path.sapMonitorName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the properties of SAP monitor {monitor}.
        slots:
          monitor: path.sapMonitorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an SAP monitor
      effect: write
      questions:
      - Can I still create an SAP monitor now that AMS Classic is retired?
      - What do I need to supply to create a new SAP monitor resource?
      instructions:
      - text: Create SAP monitor {monitor} in resource group {rg} of subscription {sub} with settings {params}.
        slots:
          monitor: path.sapMonitorName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          params: body.sapMonitorParameter
      - text: Set up a new SAP monitor named {monitor}.
        slots:
          monitor: path.sapMonitorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an SAP monitor
      effect: destructive
      questions:
      - How do I clean up a retired AMS Classic SAP monitor?
      - Can I delete an SAP monitor and its resources?
      instructions:
      - text: Delete SAP monitor {monitor} in resource group {rg} of subscription {sub}.
        slots:
          monitor: path.sapMonitorName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the retired SAP monitor {monitor}.
        slots:
          monitor: path.sapMonitorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update the tags on an SAP monitor
      effect: write
      questions:
      - How do I change the tags on an SAP monitor?
      - Can I patch only the tags field of an SAP monitor?
      instructions:
      - text: Set the tags on SAP monitor {monitor} in resource group {rg} of subscription {sub} to {tags}.
        slots:
          monitor: path.sapMonitorName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          tags: body.tagsParameter
      - text: Retag SAP monitor {monitor} with {tags}.
        slots:
          monitor: path.sapMonitorName
          tags: body.tagsParameter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}/providerInstances'].get
  update:
    x-apievangelist-phrasing:
      intent: List provider instances in an SAP monitor
      effect: read
      questions:
      - Which provider instances are attached to my SAP monitor?
      - How do I see every data source configured under an SAP monitor?
      instructions:
      - text: List provider instances in SAP monitor {monitor}, resource group {rg}, subscription {sub}.
        slots:
          monitor: path.sapMonitorName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all provider instances under SAP monitor {monitor}.
        slots:
          monitor: path.sapMonitorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}/providerInstances/{providerInstanceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a provider instance of an SAP monitor
      effect: read
      questions:
      - How do I read the settings of one provider instance in an SAP monitor?
      - What type is the provider instance called 'hana-db1'?
      instructions:
      - text: Get provider instance {instance} in SAP monitor {monitor}, resource group {rg}, subscription {sub}.
        slots:
          instance: path.providerInstanceName
          monitor: path.sapMonitorName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the properties of provider instance {instance}.
        slots:
          instance: path.providerInstanceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}/providerInstances/{providerInstanceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a provider instance in an SAP monitor
      effect: write
      questions:
      - How do I add a new provider instance to an existing SAP monitor?
      - Can I attach another HANA database to an SAP monitor as a provider instance?
      instructions:
      - text: Create provider instance {instance} in SAP monitor {monitor}, resource group {rg}, subscription {sub} with {params}.
        slots:
          instance: path.providerInstanceName
          monitor: path.sapMonitorName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          params: body.providerInstanceParameter
      - text: Add provider instance {instance} to SAP monitor {monitor}.
        slots:
          instance: path.providerInstanceName
          monitor: path.sapMonitorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HanaOnAzure/sapMonitors/{sapMonitorName}/providerInstances/{providerInstanceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a provider instance from an SAP monitor
      effect: destructive
      questions:
      - How do I remove a provider instance from an SAP monitor?
      - Can I detach one data source without deleting the whole SAP monitor?
      instructions:
      - text: Delete provider instance {instance} from SAP monitor {monitor}, resource group {rg}, subscription {sub}.
        slots:
          instance: path.providerInstanceName
          monitor: path.sapMonitorName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove provider instance {instance} from monitor {monitor}.
        slots:
          instance: path.providerInstanceName
          monitor: path.sapMonitorName
      method: generated
      generated: '2026-09-26'