# 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.ResourceHealth Availability…
  version: 1.0.0
extends: openapi/microsoft-azure-availabilitystatuses-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/availabilityStatuses'].get
  update:
    x-apievangelist-phrasing:
      intent: List health of all resources in a subscription
      effect: read
      questions:
      - Which resources in my subscription are currently unavailable or degraded?
      - Can I filter Resource Health statuses across the whole subscription?
      instructions:
      - text: List the current availability status of every resource in my subscription.
      - text: Show subscription-wide resource health matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ResourceHealth/availabilityStatuses'].get
  update:
    x-apievangelist-phrasing:
      intent: List health of resources in a resource group
      effect: read
      questions:
      - Is anything in one resource group reporting a health problem?
      - What is the availability status of each resource in my resource group?
      instructions:
      - text: List availability status for all resources in my resource group.
      - text: Show resource group health statuses expanded with {expand}.
        slots:
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ResourceHealth/availabilityStatuses/current'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the current health of one resource
      effect: read
      questions:
      - Is my specific resource healthy right now?
      - What is the current Resource Health status of one VM?
      instructions:
      - text: Get the current availability status of {resource_uri}.
        slots:
          resource_uri: path.resourceUri
      - text: Check whether resource {resource_uri} is available right now.
        slots:
          resource_uri: path.resourceUri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{resourceUri}/providers/Microsoft.ResourceHealth/availabilityStatuses'].get
  update:
    x-apievangelist-phrasing:
      intent: List a resource's health history
      effect: read
      questions:
      - When did my resource go down in the past, and what events affected it?
      - Can I see the historical availability transitions for one resource?
      instructions:
      - text: List past availability transitions for {resource_uri}.
        slots:
          resource_uri: path.resourceUri
      - text: Show the health history of {resource_uri} filtered by {filter}.
        slots:
          resource_uri: path.resourceUri
          filter: query.$filter
      method: generated
      generated: '2026-09-26'