# 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 Scheduled Query Rules API
  version: 1.0.0
extends: openapi/microsoft-azure-scheduled-query-rules-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 11
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules/{ruleName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a legacy log search alert rule
      effect: read
      questions:
      - Can I read a log search alert rule through the older API version?
      - What query and schedule does a legacy log search rule use?
      instructions:
      - text: Get legacy log search rule {rule}.
        slots:
          rule: path.ruleName
      - text: Show the older-version log search alert definition for {rule}.
        slots:
          rule: path.ruleName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules/{ruleName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a legacy log search rule
      effect: write
      questions:
      - How do I create a log search alert rule using the legacy API?
      - Which fields does the older log search rule endpoint require?
      instructions:
      - text: Create legacy log search rule {rule} in {location} with {properties}.
        slots:
          rule: path.ruleName
          location: requestBody.location
          properties: requestBody.properties
      - text: Replace the older-style log search rule {rule} using {properties}, located in {location}.
        slots:
          rule: path.ruleName
          properties: requestBody.properties
          location: requestBody.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules/{ruleName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a legacy log search rule
      effect: destructive
      questions:
      - Can I delete a log search rule through the older API version?
      - Is removing a legacy log search alert permanent?
      instructions:
      - text: Delete legacy log search rule {rule}.
        slots:
          rule: path.ruleName
      - text: Remove the older-version log search alert {rule}.
        slots:
          rule: path.ruleName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules/{ruleName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a legacy log search rule
      effect: write
      questions:
      - Can I disable or retag a legacy log search rule without re-creating it?
      - Which properties can be patched on an older log search alert?
      instructions:
      - text: Update legacy log search rule {rule} with {properties}.
        slots:
          rule: path.ruleName
          properties: requestBody.properties
      - text: Set tags {tags} on older-version log search rule {rule}.
        slots:
          tags: requestBody.tags
          rule: path.ruleName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Insights/scheduledQueryRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List log search rules in a subscription
      effect: read
      questions:
      - Which log search alert rules exist across my whole subscription?
      - Can I filter subscription-wide log search rules?
      instructions:
      - text: List all log search rules in my subscription.
      - text: List subscription log search rules matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List legacy log search rules in a resource group
      effect: read
      questions:
      - What log search rules does a resource group have under the older API?
      - Can I filter the legacy resource-group listing of log search rules?
      instructions:
      - text: List legacy log search rules in my resource group.
      - text: List older-version log search rules in the resource group matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List scheduled query rules in a resource group
      effect: read
      questions:
      - Which scheduled query alert rules are defined in my resource group?
      - How do I list current-version scheduled query rules for a resource group?
      instructions:
      - text: List the scheduled query rules in my resource group.
      - text: Show every scheduled query rule definition in this resource group.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules/{ruleName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a scheduled query rule
      effect: read
      questions:
      - What does a particular scheduled query alert rule check and how often?
      - Can I view one scheduled query rule's full definition?
      instructions:
      - text: Get scheduled query rule {rule}.
        slots:
          rule: path.ruleName
      - text: Show the definition of scheduled query alert {rule}.
        slots:
          rule: path.ruleName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules/{ruleName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a scheduled query rule
      effect: write
      questions:
      - How do I create a scheduled query alert rule in Azure Monitor?
      - Can a scheduled query rule be given a managed identity?
      instructions:
      - text: Create scheduled query rule {rule} in {location} with {properties}.
        slots:
          rule: path.ruleName
          location: requestBody.location
          properties: requestBody.properties
      - text: Create scheduled query alert {rule} in {location} using {properties} and identity {identity}.
        slots:
          rule: path.ruleName
          location: requestBody.location
          properties: requestBody.properties
          identity: requestBody.identity
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules/{ruleName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a scheduled query rule
      effect: destructive
      questions:
      - How do I delete a scheduled query alert rule?
      - Can a deleted scheduled query rule be recovered?
      instructions:
      - text: Delete scheduled query rule {rule}.
        slots:
          rule: path.ruleName
      - text: Remove the scheduled query alert {rule}.
        slots:
          rule: path.ruleName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/scheduledQueryRules/{ruleName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a scheduled query rule
      effect: write
      questions:
      - Can I change a scheduled query rule's identity or tags in place?
      - Which settings of a scheduled query alert can be patched?
      instructions:
      - text: Update scheduled query rule {rule} with {properties}.
        slots:
          rule: path.ruleName
          properties: requestBody.properties
      - text: Set managed identity {identity} on scheduled query alert {rule}.
        slots:
          identity: requestBody.identity
          rule: path.ruleName
      method: generated
      generated: '2026-10-01'