# 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 Configuration…
  version: 1.0.0
extends: openapi/microsoft-azure-configurationassignments-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: 17
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a maintenance assignment on a child resource
      effect: read
      questions:
      - Which maintenance configuration is assigned to a resource nested under a parent, like a VM in a scale set?
      - How do I check the maintenance assignment on a child resource?
      instructions:
      - text: Get assignment {configurationAssignmentName} on child {resourceName} of {resourceParentName}, group {resourceGroupName}, sub {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceName: path.resourceName
          resourceParentName: path.resourceParentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show assignment {configurationAssignmentName} for child {resourceType} {resourceName} of {resourceParentType} {resourceParentName} from provider {providerName}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceType: path.resourceType
          resourceName: path.resourceName
          resourceParentType: path.resourceParentType
          resourceParentName: path.resourceParentName
          providerName: path.providerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign maintenance config to a child resource
      effect: write
      questions:
      - How do I attach a maintenance configuration to a scale set instance or other nested resource?
      - Can I register a maintenance schedule on a resource that sits under a parent resource?
      instructions:
      - text: Assign {configurationAssignmentName} to child {resourceName} of {resourceParentName}, group {resourceGroupName}, sub {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceName: path.resourceName
          resourceParentName: path.resourceParentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Register assignment {configurationAssignmentName} on {providerName} {resourceParentType}/{resourceType} {resourceParentName}/{resourceName}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          providerName: path.providerName
          resourceParentType: path.resourceParentType
          resourceType: path.resourceType
          resourceParentName: path.resourceParentName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove maintenance config from a child resource
      effect: destructive
      questions:
      - How do I unregister a maintenance configuration from a nested resource?
      - Can I detach a maintenance assignment from a scale set instance?
      instructions:
      - text: Unregister {configurationAssignmentName} from child {resourceName} of {resourceParentName}, group {resourceGroupName}, sub {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceName: path.resourceName
          resourceParentName: path.resourceParentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove maintenance assignment {configurationAssignmentName} from {providerName} {resourceParentType}/{resourceType} {resourceParentName}/{resourceName}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          providerName: path.providerName
          resourceParentType: path.resourceParentType
          resourceType: path.resourceType
          resourceParentName: path.resourceParentName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a maintenance assignment on a resource
      effect: read
      questions:
      - What maintenance configuration is assigned to a top-level resource like a VM or dedicated host?
      - How do I look up one maintenance assignment on a specific resource?
      instructions:
      - text: Get maintenance assignment {configurationAssignmentName} on {resourceType} {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceType: path.resourceType
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show assignment {configurationAssignmentName} for {providerName} resource {resourceName}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          providerName: path.providerName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign maintenance config to a resource
      effect: write
      questions:
      - How do I put a virtual machine under a maintenance configuration schedule?
      - Can I register a maintenance configuration directly on a top-level resource?
      instructions:
      - text: Assign maintenance to {resourceType} {resourceName} in {resourceGroupName}, subscription {subscriptionId}, as {configurationAssignmentName}.
        slots:
          resourceType: path.resourceType
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          configurationAssignmentName: path.configurationAssignmentName
      - text: Register assignment {configurationAssignmentName} on {providerName} resource {resourceName}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          providerName: path.providerName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove maintenance config from a resource
      effect: destructive
      questions:
      - How do I take a VM out of its maintenance configuration?
      - Can I unregister one maintenance assignment from a top-level resource?
      instructions:
      - text: Unregister assignment {configurationAssignmentName} from {resourceType} {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceType: path.resourceType
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the maintenance assignment {configurationAssignmentName} from {providerName} resource {resourceName}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          providerName: path.providerName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/configurationAssignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List maintenance assignments on a child resource
      effect: read
      questions:
      - Which maintenance configurations are assigned to a resource nested under a parent?
      - Can I see all assignments on one scale set instance?
      instructions:
      - text: List maintenance assignments on child {resourceName} under parent {resourceParentName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceName: path.resourceName
          resourceParentName: path.resourceParentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show all assignments for {providerName} {resourceParentType}/{resourceType} {resourceParentName}/{resourceName}.
        slots:
          providerName: path.providerName
          resourceParentType: path.resourceParentType
          resourceType: path.resourceType
          resourceParentName: path.resourceParentName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/configurationAssignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List maintenance assignments on a resource
      effect: read
      questions:
      - Which maintenance configurations are applied to a particular virtual machine?
      - Can I list every maintenance assignment on one top-level resource?
      instructions:
      - text: List maintenance assignments on {resourceType} {resourceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceType: path.resourceType
          resourceName: path.resourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show all configuration assignments for {providerName} resource {resourceName}.
        slots:
          providerName: path.providerName
          resourceName: path.resourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Maintenance/configurationAssignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List all maintenance assignments in a subscription
      effect: read
      questions:
      - What maintenance configuration assignments exist across my whole subscription?
      - Can I get a subscription-wide inventory of maintenance assignments?
      instructions:
      - text: List every maintenance configuration assignment in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show all resources in subscription {subscriptionId} that have a maintenance assignment.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a subscription-scoped maintenance assignment
      effect: read
      questions:
      - How do I read a maintenance assignment that is scoped to the whole subscription?
      - What does a given subscription-level configuration assignment contain?
      instructions:
      - text: Get subscription-level maintenance assignment {configurationAssignmentName} in {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          subscriptionId: path.subscriptionId
      - text: Show the subscription-scoped assignment {configurationAssignmentName}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a subscription-scoped maintenance assignment
      effect: write
      questions:
      - How do I apply a maintenance configuration to my entire subscription?
      - Can I create or replace a maintenance assignment at subscription scope?
      instructions:
      - text: Create maintenance assignment {configurationAssignmentName} covering subscription {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          subscriptionId: path.subscriptionId
      - text: Replace subscription assignment {configurationAssignmentName} with properties {properties}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a subscription-scoped maintenance assignment
      effect: destructive
      questions:
      - How do I remove a maintenance assignment that covers my whole subscription?
      - Can I unregister a subscription-scoped configuration assignment?
      instructions:
      - text: Delete subscription-level maintenance assignment {configurationAssignmentName} from {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          subscriptionId: path.subscriptionId
      - text: Unregister the subscription-scoped assignment {configurationAssignmentName}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a subscription-scoped maintenance assignment
      effect: write
      questions:
      - How do I partially update an existing subscription-level maintenance assignment?
      - Can I change just the properties of a subscription assignment with a patch?
      instructions:
      - text: Patch subscription-level assignment {configurationAssignmentName} in {subscriptionId} with {properties}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Update the location of subscription assignment {configurationAssignmentName} to {location}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          location: requestBody.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resource group maintenance assignment
      effect: read
      questions:
      - How do I view a maintenance assignment applied to an entire resource group?
      - What is in the configuration assignment scoped to one resource group?
      instructions:
      - text: Get resource group assignment {configurationAssignmentName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the maintenance assignment {configurationAssignmentName} scoped to group {resourceGroupName}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a resource group maintenance assignment
      effect: write
      questions:
      - How do I apply a maintenance configuration to every resource in a resource group?
      - Can I create a configuration assignment at resource group scope?
      instructions:
      - text: Create maintenance assignment {configurationAssignmentName} for resource group {resourceGroupName} in subscription {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Put resource group {resourceGroupName} under assignment {configurationAssignmentName} with {properties}.
        slots:
          resourceGroupName: path.resourceGroupName
          configurationAssignmentName: path.configurationAssignmentName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a resource group maintenance assignment
      effect: destructive
      questions:
      - How do I remove a maintenance assignment from a resource group?
      - Can I unregister the configuration assignment scoped to one resource group?
      instructions:
      - text: Delete resource group assignment {configurationAssignmentName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Unregister maintenance assignment {configurationAssignmentName} from group {resourceGroupName}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a resource group maintenance assignment
      effect: write
      questions:
      - How do I partially update a maintenance assignment scoped to a resource group?
      - Can I patch the properties of an existing resource group assignment?
      instructions:
      - text: Patch resource group assignment {configurationAssignmentName} in {resourceGroupName}, subscription {subscriptionId}, with {properties}.
        slots:
          configurationAssignmentName: path.configurationAssignmentName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      - text: Update the location on group {resourceGroupName} assignment {configurationAssignmentName} to {location}.
        slots:
          resourceGroupName: path.resourceGroupName
          configurationAssignmentName: path.configurationAssignmentName
          location: requestBody.location
      method: generated
      generated: '2026-09-26'