# 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 Azure Migrate Assessment Service Avs…
  version: 1.0.0
extends: openapi/microsoft-azure-avsassessmentsoperations-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/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/avsAssessments'].get
  update:
    x-apievangelist-phrasing:
      intent: List AVS assessments in a group
      effect: read
      questions:
      - Which Azure VMware Solution assessments exist for a machine group in Azure Migrate?
      - How do I see all AVS assessments under an assessment project group?
      instructions:
      - text: List AVS assessments in group {group} of project {project}.
        slots:
          group: path.groupName
          project: path.projectName
      - text: Show every VMware Solution assessment for group {group} in project {project}.
        slots:
          group: path.groupName
          project: path.projectName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/avsAssessments/{assessmentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an AVS assessment
      effect: read
      questions:
      - What did a specific AVS assessment conclude about my machines?
      - Can I retrieve one VMware Solution assessment by name?
      instructions:
      - text: Get AVS assessment {assessment} in group {group}, project {project}.
        slots:
          assessment: path.assessmentName
          group: path.groupName
          project: path.projectName
      - text: Show the results of assessment {assessment} for group {group} in {project}.
        slots:
          assessment: path.assessmentName
          group: path.groupName
          project: path.projectName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/avsAssessments/{assessmentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an AVS assessment
      effect: write
      questions:
      - How do I create an Azure VMware Solution assessment for a group of servers?
      - Can I set assessment properties when creating an AVS assessment?
      instructions:
      - text: Create AVS assessment {assessment} for group {group} in project {project}.
        slots:
          assessment: path.assessmentName
          group: path.groupName
          project: path.projectName
      - text: Create assessment {assessment} in {project}/{group} with settings {properties}.
        slots:
          assessment: path.assessmentName
          project: path.projectName
          group: path.groupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/avsAssessments/{assessmentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an AVS assessment
      effect: destructive
      questions:
      - Can I delete an AVS assessment I no longer need?
      - Is removing a VMware Solution assessment permanent?
      instructions:
      - text: Delete AVS assessment {assessment} in group {group}, project {project}.
        slots:
          assessment: path.assessmentName
          group: path.groupName
          project: path.projectName
      - text: Remove assessment {assessment} from {project}/{group}.
        slots:
          assessment: path.assessmentName
          project: path.projectName
          group: path.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/avsAssessments/{assessmentName}/downloadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an AVS assessment report download URL
      effect: read
      questions:
      - Where can I download an AVS assessment as a report?
      - Can I export a VMware Solution assessment to a file?
      instructions:
      - text: Get the report download URL for assessment {assessment} in group {group}, project {project}.
        slots:
          assessment: path.assessmentName
          group: path.groupName
          project: path.projectName
      - text: Give me a link to download AVS assessment {assessment} from {project}/{group}.
        slots:
          assessment: path.assessmentName
          project: path.projectName
          group: path.groupName
      method: generated
      generated: '2026-09-26'