# 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 Update Management Software Update…
  version: 1.0.0
extends: openapi/microsoft-azure-software-update-configuration-run-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: 2
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationRuns/{softwareUpdateConfigurationRunId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one software update deployment run
      effect: read
      questions:
      - Did a specific scheduled patch run succeed on my machines?
      - Can I look up a single software update configuration run by its ID?
      instructions:
      - text: Get software update run {softwareUpdateConfigurationRunId} in Automation account {automationAccountName}.
        slots:
          softwareUpdateConfigurationRunId: path.softwareUpdateConfigurationRunId
          automationAccountName: path.automationAccountName
      - text: Show the outcome of patch run {softwareUpdateConfigurationRunId}.
        slots:
          softwareUpdateConfigurationRunId: path.softwareUpdateConfigurationRunId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurationRuns'].get
  update:
    x-apievangelist-phrasing:
      intent: List software update deployment runs
      effect: read
      questions:
      - Which software update runs have happened in my Automation account?
      - Can I filter update runs, for example to failed ones, and page through them?
      instructions:
      - text: List software update configuration runs in Automation account {automationAccountName}.
        slots:
          automationAccountName: path.automationAccountName
      - text: Show the first {top} update runs matching {filter}.
        slots:
          top: query.$top
          filter: query.$filter
      method: generated
      generated: '2026-10-01'