# 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 Sql…
  version: 1.0.0
extends: openapi/microsoft-azure-sqlassessmentv2operations-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}/sqlAssessments'].get
  update:
    x-apievangelist-phrasing:
      intent: List SQL assessments for a migration group
      effect: read
      questions:
      - Which SQL migration assessments have been run for a group in my Azure Migrate project?
      - Can I see all SQL assessments under one assessment group?
      instructions:
      - text: List SQL assessments for group {groupName} in Azure Migrate project {projectName}.
        slots:
          groupName: path.groupName
          projectName: path.projectName
      - text: Show every SQL assessment in project {projectName}, group {groupName}.
        slots:
          projectName: path.projectName
          groupName: path.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/sqlAssessments/{assessmentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SQL migration assessment
      effect: read
      questions:
      - What did my SQL assessment recommend for moving databases to Azure?
      - Can I check the status and settings of one SQL assessment?
      instructions:
      - text: Get SQL assessment {assessmentName} for group {groupName} in project {projectName}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
      - text: Show the results of SQL assessment {assessmentName} (project {projectName}, group {groupName}).
        slots:
          assessmentName: path.assessmentName
          projectName: path.projectName
          groupName: path.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/sqlAssessments/{assessmentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a SQL migration assessment
      effect: write
      questions:
      - How do I assess a group of SQL servers for migration to Azure?
      - Can I set sizing and target preferences when creating a SQL assessment?
      instructions:
      - text: Create SQL assessment {assessmentName} for group {groupName} in project {projectName}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
      - text: Run a new SQL assessment {assessmentName} on group {groupName}, project {projectName}, with settings {properties}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/sqlAssessments/{assessmentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SQL migration assessment
      effect: destructive
      questions:
      - How do I delete an outdated SQL assessment from my migration project?
      - Can I remove one SQL assessment and keep the group it belongs to?
      instructions:
      - text: Delete SQL assessment {assessmentName} from group {groupName} in project {projectName}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
      - text: Remove the {assessmentName} SQL assessment (project {projectName}, group {groupName}).
        slots:
          assessmentName: path.assessmentName
          projectName: path.projectName
          groupName: path.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/sqlAssessments/{assessmentName}/downloadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a download URL for a SQL assessment report
      effect: read
      questions:
      - How do I download my SQL migration assessment as a report?
      - Can I get a link to share the SQL assessment report with my team?
      instructions:
      - text: Get the report download URL for SQL assessment {assessmentName} in group {groupName}, project {projectName}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
      - text: Give me a link to download the {assessmentName} SQL assessment report (project {projectName}, group {groupName}).
        slots:
          assessmentName: path.assessmentName
          projectName: path.projectName
          groupName: path.groupName
      method: generated
      generated: '2026-09-26'