# 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 ContainerServiceFleetClient Update Runs API
  version: 1.0.0
extends: openapi/microsoft-azure-updateruns-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns'].get
  update:
    x-apievangelist-phrasing:
      intent: List update runs for a Kubernetes fleet
      effect: read
      questions:
      - What update runs exist on my Kubernetes Fleet Manager fleet?
      - Can I see all the upgrade rollouts defined for one fleet?
      instructions:
      - text: List update runs for fleet {fleetName}.
        slots:
          fleetName: path.fleetName
      - text: Show every update run on Kubernetes fleet {fleetName}.
        slots:
          fleetName: path.fleetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a fleet update run
      effect: read
      questions:
      - How far along is a specific fleet update run?
      - What stages and members are in one update run?
      instructions:
      - text: Get update run {updateRunName} on fleet {fleetName}.
        slots:
          updateRunName: path.updateRunName
          fleetName: path.fleetName
      - text: Show the progress of fleet {fleetName} update run {updateRunName}.
        slots:
          fleetName: path.fleetName
          updateRunName: path.updateRunName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a fleet update run
      effect: write
      questions:
      - How do I define an upgrade rollout across the clusters in my fleet?
      - Can I prevent overwriting an existing update run when creating one?
      instructions:
      - text: Create update run {updateRunName} on fleet {fleetName} with {properties}.
        slots:
          updateRunName: path.updateRunName
          fleetName: path.fleetName
          properties: requestBody.properties
      - text: Define a new fleet {fleetName} upgrade rollout named {updateRunName}.
        slots:
          fleetName: path.fleetName
          updateRunName: path.updateRunName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a fleet update run
      effect: destructive
      questions:
      - Can I delete an update run I no longer need?
      - Is it possible to remove a fleet update run only if its etag matches?
      instructions:
      - text: Delete update run {updateRunName} from fleet {fleetName}.
        slots:
          updateRunName: path.updateRunName
          fleetName: path.fleetName
      - text: Remove fleet {fleetName} update run {updateRunName} if etag is {ifMatch}.
        slots:
          fleetName: path.fleetName
          updateRunName: path.updateRunName
          ifMatch: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}/skip'].post
  update:
    x-apievangelist-phrasing:
      intent: Skip parts of a fleet update run
      effect: write
      questions:
      - Can I skip a member, group or stage in an ongoing fleet update run?
      - How do I bypass the wait after a stage in an update run?
      instructions:
      - text: Skip targets {targets} in update run {updateRunName} on fleet {fleetName}.
        slots:
          targets: requestBody.targets
          updateRunName: path.updateRunName
          fleetName: path.fleetName
      - text: Skip stage wait {targets} for fleet {fleetName} run {updateRunName}.
        slots:
          targets: requestBody.targets
          fleetName: path.fleetName
          updateRunName: path.updateRunName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a fleet update run
      effect: write
      questions:
      - How do I kick off an update run I've already created?
      - Can I start rolling an upgrade across my fleet now?
      instructions:
      - text: Start update run {updateRunName} on fleet {fleetName}.
        slots:
          updateRunName: path.updateRunName
          fleetName: path.fleetName
      - text: Begin the fleet {fleetName} upgrade rollout {updateRunName}.
        slots:
          fleetName: path.fleetName
          updateRunName: path.updateRunName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a fleet update run
      effect: write
      questions:
      - Can I halt a fleet upgrade that's in progress?
      - How do I stop an update run that's rolling out a bad version?
      instructions:
      - text: Stop update run {updateRunName} on fleet {fleetName}.
        slots:
          updateRunName: path.updateRunName
          fleetName: path.fleetName
      - text: Halt fleet {fleetName} rollout {updateRunName} now.
        slots:
          fleetName: path.fleetName
          updateRunName: path.updateRunName
      method: generated
      generated: '2026-09-26'