# 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 Service Fabric Client Chaos API
  version: 1.0.0
extends: openapi/microsoft-azure-chaos-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: 6
- target: $.paths['/Tools/Chaos'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Chaos status in a Service Fabric cluster
      effect: read
      questions:
      - Is Chaos currently running in my Service Fabric cluster?
      - What parameters is the current Chaos run using, and is the schedule active?
      instructions:
      - text: Show whether Chaos is running in the cluster.
      - text: Get the Chaos status and parameters with a {timeout}-second timeout.
        slots:
          timeout: query.timeout
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Tools/Chaos/$/Start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start Chaos fault injection in a cluster
      effect: write
      questions:
      - How do I start Chaos testing to inject faults into my Service Fabric cluster?
      - What happens if I try to start Chaos while it is already running?
      instructions:
      - text: Start Chaos in the cluster with parameters {params}.
        slots:
          params: body.ChaosParameters
      - text: Kick off a Chaos run using {params} and a {timeout}-second request timeout.
        slots:
          params: body.ChaosParameters
          timeout: query.timeout
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Tools/Chaos/$/Stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop Chaos and pause its schedule
      effect: write
      questions:
      - How do I stop Chaos from injecting new faults into my cluster?
      - Do in-flight faults keep running after Chaos is stopped?
      instructions:
      - text: Stop Chaos in the cluster.
      - text: Halt the Chaos run and put its schedule in a stopped state with a {timeout}-second timeout.
        slots:
          timeout: query.timeout
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Tools/Chaos/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Chaos events for a time range
      effect: read
      questions:
      - What faults did Chaos inject into my cluster during a given time window?
      - Can I page through Chaos events with a continuation token?
      instructions:
      - text: Get Chaos events between {start} and {end}.
        slots:
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Fetch the next {max} Chaos events after continuation token {token}.
        slots:
          max: query.MaxResults
          token: query.ContinuationToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Tools/Chaos/Schedule'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Chaos schedule
      effect: read
      questions:
      - When is Chaos scheduled to run in my Service Fabric cluster?
      - Which version of the Chaos schedule is in use right now?
      instructions:
      - text: Show the current Chaos schedule and its version.
      - text: Get the Chaos schedule definition with a {timeout}-second timeout.
        slots:
          timeout: query.timeout
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Tools/Chaos/Schedule'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the Chaos schedule
      effect: write
      questions:
      - How do I schedule Chaos to run automatically at set times?
      - Why would updating the Chaos schedule fail on a version mismatch?
      instructions:
      - text: Set the Chaos schedule to {schedule}.
        slots:
          schedule: body.ChaosSchedule
      - text: Replace the automatic Chaos run schedule with {schedule} using a {timeout}-second timeout.
        slots:
          schedule: body.ChaosSchedule
          timeout: query.timeout
      method: generated
      generated: '2026-09-26'