# 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 MaintenanceManagementClient Maintenance…
  version: 1.0.0
extends: openapi/microsoft-azure-maintenanceconfigurations-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Maintenance/maintenanceConfigurations/{resourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a maintenance configuration
      effect: read
      questions:
      - What does one of my maintenance configurations contain?
      - Can I look up a maintenance configuration record by name?
      instructions:
      - text: Get maintenance configuration {config} in resource group {rg}, subscription {sub}.
        slots:
          config: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the maintenance window settings in configuration {config}.
        slots:
          config: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Maintenance/maintenanceConfigurations/{resourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a maintenance configuration
      effect: write
      questions:
      - How do I create a maintenance configuration for scheduled updates?
      - Can I overwrite an existing maintenance configuration record in one call?
      instructions:
      - text: Create maintenance configuration {config} in resource group {rg}, subscription {sub} in {location} with {props}.
        slots:
          config: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          location: requestBody.location
          props: requestBody.properties
      - text: Create or fully replace maintenance configuration {config} tagged {tags}.
        slots:
          config: path.resourceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Maintenance/maintenanceConfigurations/{resourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a maintenance configuration
      effect: destructive
      questions:
      - Can I delete a maintenance configuration I no longer use?
      - What identifies the maintenance configuration record to remove?
      instructions:
      - text: Delete maintenance configuration {config} in resource group {rg}, subscription {sub}.
        slots:
          config: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the maintenance configuration record {config}.
        slots:
          config: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Maintenance/maintenanceConfigurations/{resourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a maintenance configuration
      effect: write
      questions:
      - Can I change only part of an existing maintenance configuration?
      - Which fields of a maintenance configuration can I patch?
      instructions:
      - text: Patch maintenance configuration {config} in resource group {rg}, subscription {sub} with {props}.
        slots:
          config: path.resourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          props: requestBody.properties
      - text: Update just the tags on existing maintenance configuration {config} to {tags}.
        slots:
          config: path.resourceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Maintenance/maintenanceConfigurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List maintenance configurations in a subscription
      effect: read
      questions:
      - Which maintenance configurations exist across my whole subscription?
      - Can I see every maintenance schedule I have defined subscription-wide?
      instructions:
      - text: List all maintenance configurations in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show every maintenance configuration record across subscription {sub}.
        slots:
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Maintenance/maintenanceConfigurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List maintenance configurations in a resource group
      effect: read
      questions:
      - What maintenance configurations are in one resource group?
      - Can I narrow maintenance configurations to a single resource group?
      instructions:
      - text: List maintenance configurations in resource group {rg}, subscription {sub}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the maintenance schedules defined inside resource group {rg}.
        slots:
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'