# 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 Updates API
  version: 1.0.0
extends: openapi/microsoft-azure-updates-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/updates'].get
  update:
    x-apievangelist-phrasing:
      intent: List maintenance updates for a child resource
      effect: read
      questions:
      - Which pending maintenance updates apply to a resource nested under a parent resource?
      - Can I check maintenance updates for a child resource like a VM scale set instance?
      instructions:
      - text: List updates for {resourceType} {resourceName} under {resourceParentType} {resourceParentName} ({providerName}) in group {resourceGroupName}.
        slots:
          resourceType: path.resourceType
          resourceName: path.resourceName
          resourceParentType: path.resourceParentType
          resourceParentName: path.resourceParentName
          providerName: path.providerName
          resourceGroupName: path.resourceGroupName
      - text: Show pending updates for child resource {resourceName} under parent {resourceParentName} in subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceParentName: path.resourceParentName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/updates'].get
  update:
    x-apievangelist-phrasing:
      intent: List maintenance updates for a top-level resource
      effect: read
      questions:
      - Which maintenance updates are pending for a top-level resource such as a dedicated host?
      - Can I see maintenance updates for a resource that has no parent resource?
      instructions:
      - text: List maintenance updates for top-level {resourceType} {resourceName} of provider {providerName} in resource group {resourceGroupName}.
        slots:
          resourceType: path.resourceType
          resourceName: path.resourceName
          providerName: path.providerName
          resourceGroupName: path.resourceGroupName
      - text: Show pending maintenance on standalone resource {resourceName} in subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Update.Admin/updateLocations/{updateLocation}/updates'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Stack updates at an update location
      effect: read
      questions:
      - Which Azure Stack Hub updates are available at my update location?
      - Can I see every update an Azure Stack admin can apply?
      instructions:
      - text: List the Azure Stack updates available at update location {updateLocation}.
        slots:
          updateLocation: path.updateLocation
      - text: Show all admin updates for my Azure Stack region.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Update.Admin/updateLocations/{updateLocation}/updates/{updateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Azure Stack update
      effect: read
      questions:
      - What are the details and state of a specific Azure Stack update?
      - Can I check one update's version and prerequisites before applying it?
      instructions:
      - text: Get the details of Azure Stack update {updateName} at update location {updateLocation}.
        slots:
          updateName: path.updateName
          updateLocation: path.updateLocation
      - text: Show the state of Azure Stack admin update {updateName}.
        slots:
          updateName: path.updateName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Update.Admin/updateLocations/{updateLocation}/updates/{updateName}/Apply'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply an Azure Stack update
      effect: write
      questions:
      - How do I install an Azure Stack Hub update at an update location?
      - Can I start applying a specific admin update to my Azure Stack region?
      instructions:
      - text: Apply Azure Stack update {updateName} at update location {updateLocation}.
        slots:
          updateName: path.updateName
          updateLocation: path.updateLocation
      - text: Start installing Azure Stack admin update {updateName}.
        slots:
          updateName: path.updateName
      method: generated
      generated: '2026-10-01'