# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WebApps API Client Resource Health Metadata API
  version: 1.0.0
extends: openapi/microsoft-azure-functions-resourcehealthmetadata-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/resourceHealthMetadata'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource health metadata for a subscription
      effect: read
      questions:
      - What resource health categories are set for all the sites in my subscription?
      - Can I pull health metadata for every app in the subscription at once?
      instructions:
      - text: List resource health metadata for all sites in my subscription.
      - text: Show subscription-wide ResourceHealthMetadata for every app.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/resourceHealthMetadata'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource health metadata in a resource group
      effect: read
      questions:
      - Which health metadata categories apply to the sites in one resource group?
      - How do I limit resource health metadata to a single resource group?
      instructions:
      - text: List resource health metadata for the sites in this resource group.
      - text: Show ResourceHealthMetadata scoped to the current resource group only.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/resourceHealthMetadata'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource health metadata for an app
      effect: read
      questions:
      - What resource health metadata entries exist for my app as a collection?
      - Can I list every health metadata record for one site?
      instructions:
      - text: List the resource health metadata collection for app {name}.
        slots:
          name: path.name
      - text: Show all ResourceHealthMetadata records for site {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/resourceHealthMetadata/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the resource health category of an app
      effect: read
      questions:
      - Which resource health category does my app use?
      - What is the default health metadata for a site?
      instructions:
      - text: Get the resource health category for app {name}.
        slots:
          name: path.name
      - text: Show the default ResourceHealthMetadata of site {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/resourceHealthMetadata'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource health metadata for a slot
      effect: read
      questions:
      - What resource health metadata entries exist for a deployment slot?
      - Can I list health metadata for my staging slot as a collection?
      instructions:
      - text: List the resource health metadata collection for slot {slot} of app {name}.
        slots:
          slot: path.slot
          name: path.name
      - text: Show all ResourceHealthMetadata records for deployment slot {slot} in site {name}.
        slots:
          slot: path.slot
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/slots/{slot}/resourceHealthMetadata/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the resource health category of a slot
      effect: read
      questions:
      - Which resource health category does a deployment slot use?
      - What is the default health metadata for my staging slot?
      instructions:
      - text: Get the resource health category for slot {slot} of app {name}.
        slots:
          slot: path.slot
          name: path.name
      - text: Show the default ResourceHealthMetadata of deployment slot {slot} in site {name}.
        slots:
          slot: path.slot
          name: path.name
      method: generated
      generated: '2026-10-01'