# 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 Events Store API
  version: 1.0.0
extends: openapi/microsoft-azure-eventsstore-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: 13
- target: $.paths['/EventsStore/Cluster/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List cluster-level events in a time range
      effect: read
      questions:
      - What cluster-level events happened in my Service Fabric cluster yesterday?
      - Can I filter cluster events by event type?
      instructions:
      - text: List cluster events between {start} and {end}.
        slots:
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show cluster events of type {types} from {start} to {end}.
        slots:
          types: query.EventsTypesFilter
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Containers/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List container events in a time range
      effect: read
      questions:
      - What container instance events were recorded in my cluster?
      - Can I see container events without the analysis events?
      instructions:
      - text: List container events between {start} and {end}.
        slots:
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show container instance events from {start} to {end}, excluding analysis events.
        slots:
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Nodes/{nodeName}/$/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events for one node
      effect: read
      questions:
      - What happened on a specific Service Fabric node during an outage?
      - Can I pull the event history of a single node?
      instructions:
      - text: List events for node {node} between {start} and {end}.
        slots:
          node: path.nodeName
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show node {node}'s event history since {start}.
        slots:
          node: path.nodeName
          start: query.StartTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Nodes/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events across all nodes
      effect: read
      questions:
      - Which node events happened across the whole cluster this week?
      - Can I get events for all nodes at once?
      instructions:
      - text: List events for all nodes between {start} and {end}.
        slots:
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show every node's events of type {types} since {start}.
        slots:
          types: query.EventsTypesFilter
          start: query.StartTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Applications/{applicationId}/$/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events for one application
      effect: read
      questions:
      - What events did a specific Service Fabric application emit?
      - Can I see an application's upgrade and health events over time?
      instructions:
      - text: List events for application {app} between {start} and {end}.
        slots:
          app: path.applicationId
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show application {app}'s events since {start}.
        slots:
          app: path.applicationId
          start: query.StartTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Applications/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events across all applications
      effect: read
      questions:
      - What application events occurred across the entire cluster?
      - Can I retrieve events for every application in one query?
      instructions:
      - text: List events for all applications between {start} and {end}.
        slots:
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show all applications' events of type {types} since {start}.
        slots:
          types: query.EventsTypesFilter
          start: query.StartTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Services/{serviceId}/$/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events for one service
      effect: read
      questions:
      - What events has a specific Service Fabric service produced?
      - Can I see the event timeline of a single service?
      instructions:
      - text: List events for service {service} between {start} and {end}.
        slots:
          service: path.serviceId
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show service {service}'s events since {start}.
        slots:
          service: path.serviceId
          start: query.StartTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Services/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events across all services
      effect: read
      questions:
      - Which service events happened across the cluster in a time window?
      - Can I get events for every service without naming them?
      instructions:
      - text: List events for all services between {start} and {end}.
        slots:
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show all services' events of type {types} since {start}.
        slots:
          types: query.EventsTypesFilter
          start: query.StartTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Partitions/{partitionId}/$/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events for one partition
      effect: read
      questions:
      - What events did a specific partition go through, like reconfigurations?
      - Can I see the event history of a single partition?
      instructions:
      - text: List events for partition {partition} between {start} and {end}.
        slots:
          partition: path.partitionId
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show partition {partition}'s events since {start}.
        slots:
          partition: path.partitionId
          start: query.StartTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Partitions/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events across all partitions
      effect: read
      questions:
      - Which partition events occurred across the whole cluster?
      - Can I get events for all partitions in one request?
      instructions:
      - text: List events for all partitions between {start} and {end}.
        slots:
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show every partition's events of type {types} since {start}.
        slots:
          types: query.EventsTypesFilter
          start: query.StartTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Partitions/{partitionId}/$/Replicas/{replicaId}/$/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events for one replica
      effect: read
      questions:
      - What happened to a specific replica of a partition?
      - Can I trace the events of a single replica over time?
      instructions:
      - text: List events for replica {replica} of partition {partition} between {start} and {end}.
        slots:
          replica: path.replicaId
          partition: path.partitionId
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show replica {replica}'s event history in partition {partition} since {start}.
        slots:
          replica: path.replicaId
          partition: path.partitionId
          start: query.StartTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/Partitions/{partitionId}/$/Replicas/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: List events for all replicas of a partition
      effect: read
      questions:
      - What events did all the replicas of one partition record?
      - Can I see replica events for a partition without naming each replica?
      instructions:
      - text: List events for all replicas of partition {partition} between {start} and {end}.
        slots:
          partition: path.partitionId
          start: query.StartTimeUtc
          end: query.EndTimeUtc
      - text: Show every replica event in partition {partition} since {start}.
        slots:
          partition: path.partitionId
          start: query.StartTimeUtc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/EventsStore/CorrelatedEvents/{eventInstanceId}/$/Events'].get
  update:
    x-apievangelist-phrasing:
      intent: Find events correlated with a given event
      effect: read
      questions:
      - Which other events are correlated with this Service Fabric event?
      - How do I trace related events from one event instance ID?
      instructions:
      - text: List events correlated with event instance {event}.
        slots:
          event: path.eventInstanceId
      - text: Show the events related to event {event}.
        slots:
          event: path.eventInstanceId
      method: generated
      generated: '2026-09-26'