# 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 Apply Updates…
  version: 1.0.0
extends: openapi/microsoft-azure-applyupdates-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/applyUpdates/{applyUpdateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Track maintenance updates on a child resource
      effect: read
      questions:
      - How do I check maintenance update progress on a resource that sits under a parent resource?
      - Can I track an apply-update run for a nested resource like a VM scale set instance?
      instructions:
      - text: Track update {applyUpdateName} on {resourceType} {resourceName} under {resourceParentType} {resourceParentName}.
        slots:
          applyUpdateName: path.applyUpdateName
          resourceType: path.resourceType
          resourceName: path.resourceName
          resourceParentType: path.resourceParentType
          resourceParentName: path.resourceParentName
      - text: Get apply-update {applyUpdateName} for child {resourceName} of {resourceParentName} ({providerName}) in {resourceGroupName}, sub {subscriptionId}.
        slots:
          applyUpdateName: path.applyUpdateName
          resourceName: path.resourceName
          resourceParentName: path.resourceParentName
          providerName: path.providerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/applyUpdates/{applyUpdateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Track maintenance updates on a resource
      effect: read
      questions:
      - How can I see whether pending maintenance was applied to a top-level resource?
      - What status does a specific maintenance apply-update have on my host?
      instructions:
      - text: Track update {applyUpdateName} on {resourceType} {resourceName}.
        slots:
          applyUpdateName: path.applyUpdateName
          resourceType: path.resourceType
          resourceName: path.resourceName
      - text: Get apply-update {applyUpdateName} for {providerName} resource {resourceName} in {resourceGroupName}, sub {subscriptionId}.
        slots:
          applyUpdateName: path.applyUpdateName
          providerName: path.providerName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/applyUpdates/{applyUpdateName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Apply or cancel a named maintenance update
      effect: write
      questions:
      - Can I cancel a specific scheduled maintenance update on a resource?
      - How do I create or modify a named apply-update record for my resource?
      instructions:
      - text: Apply or cancel update {applyUpdateName} on {resourceType} {resourceName}.
        slots:
          applyUpdateName: path.applyUpdateName
          resourceType: path.resourceType
          resourceName: path.resourceName
      - text: Set named update {applyUpdateName} for {providerName} {resourceName} in {resourceGroupName}, sub {subscriptionId}.
        slots:
          applyUpdateName: path.applyUpdateName
          providerName: path.providerName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/applyUpdates/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Apply pending maintenance to a child resource
      effect: write
      questions:
      - How do I push pending platform maintenance to a resource nested under a parent?
      - Can I trigger maintenance now for an instance inside a scale set?
      instructions:
      - text: Apply pending maintenance to {resourceType} {resourceName} under {resourceParentType} {resourceParentName}.
        slots:
          resourceType: path.resourceType
          resourceName: path.resourceName
          resourceParentType: path.resourceParentType
          resourceParentName: path.resourceParentName
      - text: Apply updates now to child {resourceName} of {resourceParentName} ({providerName}) in {resourceGroupName}, sub {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceParentName: path.resourceParentName
          providerName: path.providerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/applyUpdates/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Apply pending maintenance to a resource
      effect: write
      questions:
      - How do I apply waiting maintenance to a dedicated host right away instead of waiting?
      - Can I self-trigger platform updates on a top-level resource?
      instructions:
      - text: Apply pending maintenance to {resourceType} {resourceName} now.
        slots:
          resourceType: path.resourceType
          resourceName: path.resourceName
      - text: Apply default updates to {providerName} resource {resourceName} in {resourceGroupName}, sub {subscriptionId}.
        slots:
          providerName: path.providerName
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'