# 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 Assessed…
  version: 1.0.0
extends: openapi/microsoft-azure-assessedsqlrecommendedentityoperations-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: 2
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/sqlAssessments/{assessmentName}/recommendedAssessedEntities'].get
  update:
    x-apievangelist-phrasing:
      intent: List recommended SQL targets in a migration assessment
      effect: read
      questions:
      - Which Azure SQL targets does my SQL migration assessment recommend for each instance?
      - Can I page through recommended assessed entities and get a total count?
      instructions:
      - text: List recommended assessed entities for SQL assessment {assessmentName} in group {groupName} of project {projectName}.
        slots:
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
      - text: Show {pageSize} SQL recommendations from assessment {assessmentName} matching {filter}.
        slots:
          pageSize: query.pageSize
          assessmentName: path.assessmentName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/sqlAssessments/{assessmentName}/recommendedAssessedEntities/{recommendedAssessedEntityName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one recommended SQL entity from an assessment
      effect: read
      questions:
      - What target and readiness did the assessment recommend for a specific SQL instance?
      - Can I open a single recommended assessed entity by name?
      instructions:
      - text: Get recommended entity {recommendedAssessedEntityName} from SQL assessment {assessmentName} in group {groupName}, project {projectName}.
        slots:
          recommendedAssessedEntityName: path.recommendedAssessedEntityName
          assessmentName: path.assessmentName
          groupName: path.groupName
          projectName: path.projectName
      - text: Show the SQL recommendation for {recommendedAssessedEntityName} in assessment {assessmentName}.
        slots:
          recommendedAssessedEntityName: path.recommendedAssessedEntityName
          assessmentName: path.assessmentName
      method: generated
      generated: '2026-09-26'