# 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 Microsoft.DatabaseWatcher Watchers API
  version: 1.0.0
extends: openapi/microsoft-azure-watchers-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DatabaseWatcher/watchers'].get
  update:
    x-apievangelist-phrasing:
      intent: List database watchers in a subscription
      effect: read
      questions:
      - Which database watchers are set up across my Azure subscription?
      - Can I see every database watcher without choosing a resource group?
      instructions:
      - text: List all database watchers in my subscription.
      - text: Show every database watcher across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers'].get
  update:
    x-apievangelist-phrasing:
      intent: List database watchers in a resource group
      effect: read
      questions:
      - What database watchers are in one resource group?
      - Can I scope the database watcher list to a resource group?
      instructions:
      - text: List database watchers in this resource group.
      - text: Show the database watchers in my resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a database watcher
      effect: read
      questions:
      - How can I view the configuration of one database watcher?
      - Is a particular database watcher running or stopped?
      instructions:
      - text: Get database watcher {watcherName}.
        slots:
          watcherName: path.watcherName
      - text: Show the status and settings of watcher {watcherName}.
        slots:
          watcherName: path.watcherName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a database watcher
      effect: write
      questions:
      - How do I create a database watcher to monitor my Azure SQL databases?
      - Can I give a new database watcher a managed identity?
      instructions:
      - text: Create database watcher {watcherName}.
        slots:
          watcherName: path.watcherName
      - text: Create watcher {watcherName} with identity {identity} and properties {properties}.
        slots:
          watcherName: path.watcherName
          identity: requestBody.identity
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a database watcher
      effect: destructive
      questions:
      - Can I delete a database watcher I no longer need?
      - What happens to monitoring when a database watcher is deleted?
      instructions:
      - text: Delete database watcher {watcherName}.
        slots:
          watcherName: path.watcherName
      - text: Remove the watcher {watcherName} permanently.
        slots:
          watcherName: path.watcherName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a database watcher
      effect: write
      questions:
      - Can I change tags or identity on an existing database watcher?
      - What settings of a database watcher can be patched?
      instructions:
      - text: Update tags on database watcher {watcherName} to {tags}.
        slots:
          watcherName: path.watcherName
          tags: requestBody.tags
      - text: Change the identity of existing watcher {watcherName} to {identity}.
        slots:
          watcherName: path.watcherName
          identity: requestBody.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start monitoring with a database watcher
      effect: write
      questions:
      - How do I start a database watcher monitoring its configured targets?
      - Can I turn monitoring back on for a stopped watcher?
      instructions:
      - text: Start database watcher {watcherName}.
        slots:
          watcherName: path.watcherName
      - text: Begin monitoring all targets of watcher {watcherName}.
        slots:
          watcherName: path.watcherName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop monitoring with a database watcher
      effect: write
      questions:
      - Can I pause a database watcher from monitoring its targets?
      - How do I stop a database watcher without deleting it?
      instructions:
      - text: Stop database watcher {watcherName}.
        slots:
          watcherName: path.watcherName
      - text: Halt monitoring of all targets for watcher {watcherName}.
        slots:
          watcherName: path.watcherName
      method: generated
      generated: '2026-09-26'