# 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 Fleet Update…
  version: 1.0.0
extends: openapi/microsoft-azure-fleetupdatestrategies-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateStrategies'].get
  update:
    x-apievangelist-phrasing:
      intent: List a fleet's update strategies
      effect: read
      questions:
      - Which update strategies are defined for my Kubernetes Fleet Manager fleet?
      - Where can I see the staged rollout plans for a fleet?
      instructions:
      - text: List update strategies for fleet {fleetName}.
        slots:
          fleetName: path.fleetName
      - text: Show every rollout strategy defined on fleet {fleetName}.
        slots:
          fleetName: path.fleetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateStrategies/{updateStrategyName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a fleet update strategy
      effect: read
      questions:
      - What stages and groups are in one fleet update strategy?
      - What does a specific fleet rollout strategy look like?
      instructions:
      - text: Get update strategy {updateStrategyName} in fleet {fleetName}.
        slots:
          updateStrategyName: path.updateStrategyName
          fleetName: path.fleetName
      - text: Show the stages of rollout strategy {updateStrategyName} on fleet {fleetName}.
        slots:
          updateStrategyName: path.updateStrategyName
          fleetName: path.fleetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateStrategies/{updateStrategyName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a fleet update strategy
      effect: write
      questions:
      - How do I define a staged upgrade strategy for clusters in a fleet?
      - Can I use an ETag so I don't overwrite someone else's strategy change?
      instructions:
      - text: Create update strategy {updateStrategyName} in fleet {fleetName} with {properties}.
        slots:
          updateStrategyName: path.updateStrategyName
          fleetName: path.fleetName
          properties: requestBody.properties
      - text: Create rollout strategy {updateStrategyName} on fleet {fleetName} only if none exists (If-None-Match {ifNoneMatch}).
        slots:
          updateStrategyName: path.updateStrategyName
          fleetName: path.fleetName
          ifNoneMatch: header.If-None-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateStrategies/{updateStrategyName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a fleet update strategy
      effect: destructive
      questions:
      - Can I remove an update strategy from my fleet?
      - Can I delete a rollout strategy only if it hasn't changed since I read it?
      instructions:
      - text: Delete update strategy {updateStrategyName} from fleet {fleetName}.
        slots:
          updateStrategyName: path.updateStrategyName
          fleetName: path.fleetName
      - text: Remove rollout strategy {updateStrategyName} on fleet {fleetName} if its ETag is {ifMatch}.
        slots:
          updateStrategyName: path.updateStrategyName
          fleetName: path.fleetName
          ifMatch: header.If-Match
      method: generated
      generated: '2026-09-26'