# 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 Faults API
  version: 1.0.0
extends: openapi/microsoft-azure-faults-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: 10
- target: $.paths['/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/StartDataLoss'].post
  update:
    x-apievangelist-phrasing:
      intent: Induce data loss on a partition for testing
      effect: destructive
      questions:
      - How do I simulate data loss on a Service Fabric partition?
      - What's the difference between partial and full data loss modes?
      instructions:
      - text: Start {mode} data loss on partition {partition} of service {service} with operation {operation_id}.
        slots:
          mode: query.DataLossMode
          partition: path.partitionId
          service: path.serviceId
          operation_id: query.OperationId
      - text: Induce data loss on partition {partition} in service {service}.
        slots:
          partition: path.partitionId
          service: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/GetDataLossProgress'].get
  update:
    x-apievangelist-phrasing:
      intent: Check progress of a data loss test
      effect: read
      questions:
      - How can I tell whether my induced data loss operation has completed?
      - Where do I track a data loss fault I started on a partition?
      instructions:
      - text: Get data loss progress for operation {operation_id} on partition {partition} of {service}.
        slots:
          operation_id: query.OperationId
          partition: path.partitionId
          service: path.serviceId
      - text: Check how the data loss test {operation_id} is going.
        slots:
          operation_id: query.OperationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/StartQuorumLoss'].post
  update:
    x-apievangelist-phrasing:
      intent: Induce quorum loss on a stateful partition
      effect: destructive
      questions:
      - Can I force a temporary quorum loss on a stateful service partition?
      - How long can an induced quorum loss last?
      instructions:
      - text: Start {mode} quorum loss on partition {partition} of {service} for {duration} seconds.
        slots:
          mode: query.QuorumLossMode
          partition: path.partitionId
          service: path.serviceId
          duration: query.QuorumLossDuration
      - text: Induce quorum loss on partition {partition} with operation {operation_id}.
        slots:
          partition: path.partitionId
          operation_id: query.OperationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/GetQuorumLossProgress'].get
  update:
    x-apievangelist-phrasing:
      intent: Check progress of a quorum loss test
      effect: read
      questions:
      - Is my induced quorum loss still running on the partition?
      - How do I get the state of a quorum loss fault operation?
      instructions:
      - text: Get quorum loss progress for operation {operation_id} on partition {partition} of {service}.
        slots:
          operation_id: query.OperationId
          partition: path.partitionId
          service: path.serviceId
      - text: Check the status of quorum loss test {operation_id}.
        slots:
          operation_id: query.OperationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/StartRestart'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart replicas of a partition to test failover
      effect: write
      questions:
      - How do I restart some or all replicas of a partition to test failover?
      - Which restart mode must I use on a stateless service partition?
      instructions:
      - text: Restart {mode} replicas of partition {partition} in {service} with operation {operation_id}.
        slots:
          mode: query.RestartPartitionMode
          partition: path.partitionId
          service: path.serviceId
          operation_id: query.OperationId
      - text: Restart all instances of partition {partition} of service {service}.
        slots:
          partition: path.partitionId
          service: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/GetRestartProgress'].get
  update:
    x-apievangelist-phrasing:
      intent: Check progress of a partition restart
      effect: read
      questions:
      - Has my partition restart test finished yet?
      - How do I track a replica restart I kicked off on a partition?
      instructions:
      - text: Get restart progress for operation {operation_id} on partition {partition} of {service}.
        slots:
          operation_id: query.OperationId
          partition: path.partitionId
          service: path.serviceId
      - text: Check whether partition restart {operation_id} is complete.
        slots:
          operation_id: query.OperationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Faults/Nodes/{nodeName}/$/StartTransition/'].post
  update:
    x-apievangelist-phrasing:
      intent: Start or stop a cluster node
      effect: write
      questions:
      - Can I stop a Service Fabric node for a set time and then bring it back?
      - What node instance id do I need to start or stop a cluster node?
      instructions:
      - text: '{transition} node {node} instance {instance_id} for {stop_seconds} seconds under operation {operation_id}.'
        slots:
          transition: query.NodeTransitionType
          node: path.nodeName
          instance_id: query.NodeInstanceId
          stop_seconds: query.StopDurationInSeconds
          operation_id: query.OperationId
      - text: Stop cluster node {node} temporarily.
        slots:
          node: path.nodeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Faults/Nodes/{nodeName}/$/GetTransitionProgress'].get
  update:
    x-apievangelist-phrasing:
      intent: Check progress of a node start or stop
      effect: read
      questions:
      - How do I know when a node I stopped or started has finished transitioning?
      - Where can I see the progress of a node transition?
      instructions:
      - text: Get transition progress for node {node} under operation {operation_id}.
        slots:
          node: path.nodeName
          operation_id: query.OperationId
      - text: Check if node {node} has finished starting or stopping.
        slots:
          node: path.nodeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Faults/'].get
  update:
    x-apievangelist-phrasing:
      intent: List user-induced fault operations
      effect: read
      questions:
      - Which fault operations have I started on the cluster?
      - Can I filter fault operations by type and state?
      instructions:
      - text: List fault operations with type filter {type_filter} and state filter {state_filter}.
        slots:
          type_filter: query.TypeFilter
          state_filter: query.StateFilter
      - text: Show all running chaos fault operations of type {type_filter}.
        slots:
          type_filter: query.TypeFilter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Faults/$/Cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a user-induced fault operation
      effect: destructive
      questions:
      - How do I stop a data loss or quorum loss test that's in progress?
      - What does forcing a fault cancellation do versus a graceful cancel?
      instructions:
      - text: Cancel fault operation {operation_id} with force set to {force}.
        slots:
          operation_id: query.OperationId
          force: query.Force
      - text: Gracefully cancel fault test {operation_id}.
        slots:
          operation_id: query.OperationId
      method: generated
      generated: '2026-09-26'