# 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 GuestConfiguration Guest Configuration…
  version: 1.0.0
extends: openapi/microsoft-azure-guestconfigurationassignments-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a guest configuration assignment on a VM
      effect: read
      questions:
      - What does a specific guest configuration assignment on my virtual machine look like?
      - Can I check the compliance details of one guest configuration assigned to a single VM?
      instructions:
      - text: Show guest configuration assignment {guestConfigurationAssignmentName} on virtual machine {vmName}.
        slots:
          guestConfigurationAssignmentName: path.guestConfigurationAssignmentName
          vmName: path.vmName
      - text: Get the details of VM guest configuration assignment {guestConfigurationAssignmentName}.
        slots:
          guestConfigurationAssignmentName: path.guestConfigurationAssignmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign a guest configuration to a VM
      effect: write
      questions:
      - How do I attach a guest configuration policy to a single virtual machine?
      - Can I update an existing guest configuration assignment on a VM in place?
      instructions:
      - text: Assign guest configuration {guestConfigurationAssignmentName} to virtual machine {vmName}.
        slots:
          guestConfigurationAssignmentName: path.guestConfigurationAssignmentName
          vmName: path.vmName
      - text: Create or update VM guest configuration assignment {guestConfigurationAssignmentName} with properties {properties}.
        slots:
          guestConfigurationAssignmentName: path.guestConfigurationAssignmentName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a guest configuration assignment from a VM
      effect: destructive
      questions:
      - How can I detach a guest configuration from one of my virtual machines?
      - Will deleting a VM's guest configuration assignment stop its compliance reporting?
      instructions:
      - text: Delete guest configuration assignment {guestConfigurationAssignmentName} from virtual machine {vmName}.
        slots:
          guestConfigurationAssignmentName: path.guestConfigurationAssignmentName
          vmName: path.vmName
      - text: Remove the VM guest configuration assignment named {guestConfigurationAssignmentName}.
        slots:
          guestConfigurationAssignmentName: path.guestConfigurationAssignmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List guest configuration assignments in a subscription
      effect: read
      questions:
      - Which guest configuration assignments exist across my whole Azure subscription?
      - Can I see every guest configuration assignment in a subscription at once?
      instructions:
      - text: List all guest configuration assignments in my subscription.
      - text: Show me every guest configuration assignment across the entire subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List guest configuration assignments in a resource group
      effect: read
      questions:
      - What guest configuration assignments are in one resource group?
      - Can I limit the guest configuration assignment list to a single resource group?
      instructions:
      - text: List the guest configuration assignments in my resource group.
      - text: Show every guest configuration assignment scoped to this resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List guest configuration assignments for a VM
      effect: read
      questions:
      - Which guest configurations are assigned to a particular virtual machine?
      - How do I see all the guest configuration assignments on one VM?
      instructions:
      - text: List the guest configuration assignments on virtual machine {vmName}.
        slots:
          vmName: path.vmName
      - text: Show every guest configuration assigned to this single VM.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a guest configuration assignment on a scale set
      effect: read
      questions:
      - What does a guest configuration assignment on my VM scale set contain?
      - Can I inspect one guest configuration assigned to a virtual machine scale set?
      instructions:
      - text: Show guest configuration assignment {name} on VM scale set {vmssName}.
        slots:
          name: path.name
          vmssName: path.vmssName
      - text: Get the details of VMSS guest configuration assignment {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign a guest configuration to a VM scale set
      effect: write
      questions:
      - How do I apply a guest configuration to an entire VM scale set?
      - Can I change the guest configuration assignment already on a scale set?
      instructions:
      - text: Assign guest configuration {name} to VM scale set {vmssName}.
        slots:
          name: path.name
          vmssName: path.vmssName
      - text: Create or update VMSS guest configuration assignment {name} with properties {properties}.
        slots:
          name: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a guest configuration from a VM scale set
      effect: destructive
      questions:
      - How can I take a guest configuration off a virtual machine scale set?
      - Is it possible to delete one guest configuration assignment from a VMSS?
      instructions:
      - text: Delete guest configuration assignment {name} from VM scale set {vmssName}.
        slots:
          name: path.name
          vmssName: path.vmssName
      - text: Remove the VMSS guest configuration assignment named {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List guest configuration assignments for a scale set
      effect: read
      questions:
      - Which guest configurations are assigned to my VM scale set?
      - What guest configuration assignments does a particular VMSS have?
      instructions:
      - text: List the guest configuration assignments on VM scale set {vmssName}.
        slots:
          vmssName: path.vmssName
      - text: Show every guest configuration assigned to this VMSS.
      method: generated
      generated: '2026-10-01'