# 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 Groups…
  version: 1.0.0
extends: openapi/microsoft-azure-groupsoperations-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'].get
  update:
    x-apievangelist-phrasing:
      intent: List machine groups in an assessment project
      effect: read
      questions:
      - Which machine groups are in my Azure Migrate assessment project?
      - How do I list groups for one assessment project?
      instructions:
      - text: List groups in assessment project {project}.
        slots:
          project: path.projectName
      - text: Show all machine groups under {project}.
        slots:
          project: path.projectName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a machine group
      effect: read
      questions:
      - How do I view one group in an assessment project?
      - What machines and status does a migration group have?
      instructions:
      - text: Get group {group} in assessment project {project}.
        slots:
          group: path.groupName
          project: path.projectName
      - text: Show details of machine group {group}.
        slots:
          group: path.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a machine group for assessment
      effect: write
      questions:
      - How do I create a new group of machines to assess for migration?
      - What properties go into a new assessment group?
      instructions:
      - text: Create group {group} in assessment project {project}.
        slots:
          group: path.groupName
          project: path.projectName
      - text: Set up machine group {group} in {project} with {properties}.
        slots:
          group: path.groupName
          project: path.projectName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a machine group
      effect: destructive
      questions:
      - Can I delete a group from my assessment project?
      - What happens to assessments when a machine group is removed?
      instructions:
      - text: Delete group {group} from assessment project {project}.
        slots:
          group: path.groupName
          project: path.projectName
      - text: Remove machine group {group}.
        slots:
          group: path.groupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/updateMachines'].post
  update:
    x-apievangelist-phrasing:
      intent: Add or remove machines in a group
      effect: write
      questions:
      - How do I add machines to an existing assessment group?
      - Can I remove machines from a group without deleting it?
      instructions:
      - text: Update machines in group {group} of project {project} using {properties}.
        slots:
          group: path.groupName
          project: path.projectName
          properties: requestBody.properties
      - text: Add or remove machines in group {group}.
        slots:
          group: path.groupName
      method: generated
      generated: '2026-09-26'