# 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-guestconfigurationassignmentreports-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}/reports'].get
  update:
    x-apievangelist-phrasing:
      intent: List compliance reports for a VM guest assignment
      effect: read
      questions:
      - What compliance reports has a guest configuration assignment produced on my virtual machine?
      - Can I see a VM's guest configuration reports, newest first?
      instructions:
      - text: List reports for guest configuration assignment {assignment} on VM {vm}.
        slots:
          assignment: path.guestConfigurationAssignmentName
          vm: path.vmName
      - text: Show the latest compliance reports of virtual machine assignment {assignment}.
        slots:
          assignment: path.guestConfigurationAssignmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{guestConfigurationAssignmentName}/reports/{reportId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one VM guest configuration report
      effect: read
      questions:
      - Why was my virtual machine marked non-compliant in a particular report?
      - Can I open a specific guest configuration report for a VM by report id?
      instructions:
      - text: Show report {report_id} for assignment {assignment} on VM {vm}.
        slots:
          report_id: path.reportId
          assignment: path.guestConfigurationAssignmentName
          vm: path.vmName
      - text: Get the virtual machine compliance details in report {report_id}.
        slots:
          report_id: path.reportId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}/reports'].get
  update:
    x-apievangelist-phrasing:
      intent: List compliance reports for a scale set assignment
      effect: read
      questions:
      - What guest configuration reports exist for my VM scale set assignment?
      - Can I list VMSS compliance reports with the most recent first?
      instructions:
      - text: List reports for guest configuration assignment {assignment} on scale set {vmss}.
        slots:
          assignment: path.name
          vmss: path.vmssName
      - text: Show VMSS compliance reports for assignment {assignment}.
        slots:
          assignment: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}/providers/Microsoft.GuestConfiguration/guestConfigurationAssignments/{name}/reports/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one scale set guest configuration report
      effect: read
      questions:
      - What did a single guest configuration report say about my scale set?
      - Can I fetch one VMSS compliance report by its id?
      instructions:
      - text: Show report {report_id} for assignment {assignment} on scale set {vmss}.
        slots:
          report_id: path.id
          assignment: path.name
          vmss: path.vmssName
      - text: Get VMSS guest configuration report {report_id}.
        slots:
          report_id: path.id
      method: generated
      generated: '2026-10-01'