API Evangelist conversational phrasing for Microsoft Azure Service Fabric Client Partition API

# 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 Partition API
  version: 1.0.0
extends: openapi/microsoft-azure-partition-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: 18
- target: $.paths['/$/GetLoadedPartitionInfoList'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the most or least loaded partitions
      effect: read
      questions:
      - Which Service Fabric partitions are the most loaded for a given metric?
      - Can I list the least loaded partitions of one service?
      instructions:
      - text: List partitions ordered by load on metric {metric}.
        slots:
          metric: query.MetricName
      - text: Show the top {max} partitions of service {service} by {metric} load.
        slots:
          max: query.MaxResults
          service: query.ServiceName
          metric: query.MetricName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Services/{serviceId}/$/GetPartitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a service's partitions
      effect: read
      questions:
      - What partitions does my Service Fabric service have?
      - How can I see the status and health of every partition in a service?
      instructions:
      - text: List the partitions of service {service}.
        slots:
          service: path.serviceId
      - text: Show partition status and health for every partition of {service}.
        slots:
          service: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Partitions/{partitionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of one partition
      effect: read
      questions:
      - What partitioning scheme and key range does this partition use?
      - Can I get the status of a single partition by its ID?
      instructions:
      - text: Get the details of partition {partition}.
        slots:
          partition: path.partitionId
      - text: Show the key range and status of partition {partition}.
        slots:
          partition: path.partitionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Partitions/{partitionId}/$/GetServiceName'].get
  update:
    x-apievangelist-phrasing:
      intent: Find which service owns a partition
      effect: read
      questions:
      - Which service does this partition ID belong to?
      - How do I resolve a partition ID to its service name?
      instructions:
      - text: Tell me the service name for partition {partition}.
        slots:
          partition: path.partitionId
      - text: Look up the owning service of partition {partition}.
        slots:
          partition: path.partitionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Partitions/{partitionId}/$/GetHealth'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a partition's health
      effect: read
      questions:
      - Is my Service Fabric partition healthy right now?
      - Can I filter a partition's health events to only errors?
      instructions:
      - text: Get the health of partition {partition}.
        slots:
          partition: path.partitionId
      - text: Show partition {partition} health events filtered by state {filter}.
        slots:
          partition: path.partitionId
          filter: query.EventsHealthStateFilter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Partitions/{partitionId}/$/GetHealth'].post
  update:
    x-apievangelist-phrasing:
      intent: Evaluate partition health with a custom policy
      effect: read
      questions:
      - Can I evaluate a partition's health against my own application health policy?
      - How do I override the manifest health policy when checking a partition?
      instructions:
      - text: Evaluate partition {partition} health using policy {policy}.
        slots:
          partition: path.partitionId
          policy: body.ApplicationHealthPolicy
      - text: Check partition {partition} health with a custom application health policy.
        slots:
          partition: path.partitionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Partitions/{partitionId}/$/ReportHealth'].post
  update:
    x-apievangelist-phrasing:
      intent: Report a health event on a partition
      effect: write
      questions:
      - How do I send a custom health report for a Service Fabric partition?
      - Can a partition health report bypass batching and go immediately?
      instructions:
      - text: Report health {report} on partition {partition}.
        slots:
          report: body.HealthInformation
          partition: path.partitionId
      - text: Send health report {report} for partition {partition} immediately.
        slots:
          report: body.HealthInformation
          partition: path.partitionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Partitions/{partitionId}/$/GetLoadInformation'].get
  update:
    x-apievangelist-phrasing:
      intent: Get load metrics reported by a partition
      effect: read
      questions:
      - What load metrics has this partition reported, and when?
      - How much load is one specific partition carrying?
      instructions:
      - text: Get the load information for partition {partition}.
        slots:
          partition: path.partitionId
      - text: Show the reported load metric values of partition {partition}.
        slots:
          partition: path.partitionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Partitions/{partitionId}/$/ResetLoad'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset a partition's load to the default
      effect: write
      questions:
      - How do I reset a partition's load back to the service default?
      - Can I clear the reported load on one partition?
      instructions:
      - text: Reset the load of partition {partition} to its default.
        slots:
          partition: path.partitionId
      - text: Clear the current reported load on partition {partition}.
        slots:
          partition: path.partitionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Partitions/{partitionId}/$/Recover'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover one partition stuck in quorum loss
      effect: destructive
      questions:
      - How do I recover a single partition that is stuck in quorum loss?
      - Can forcing recovery of one partition cause data loss?
      instructions:
      - text: Recover partition {partition} from quorum loss.
        slots:
          partition: path.partitionId
      - text: Force quorum-loss recovery on partition {partition}; its down replicas are gone.
        slots:
          partition: path.partitionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Services/$/{serviceId}/$/GetPartitions/$/Recover'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover all partitions of one service
      effect: destructive
      questions:
      - How do I recover every partition of a service stuck in quorum loss?
      - Can I recover a whole service's partitions in one call?
      instructions:
      - text: Recover all partitions of service {service} from quorum loss.
        slots:
          service: path.serviceId
      - text: Force quorum-loss recovery for service {service}.
        slots:
          service: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/$/RecoverSystemPartitions'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover system service partitions
      effect: destructive
      questions:
      - How do I recover Service Fabric system services stuck in quorum loss?
      - Can I recover only the cluster's system partitions?
      instructions:
      - text: Recover the cluster's system service partitions from quorum loss, timing out after {timeout} seconds.
        slots:
          timeout: query.timeout
      - text: Force recovery of the system services in my cluster.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/$/RecoverAllPartitions'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover every partition in the cluster
      effect: destructive
      questions:
      - Is there a way to recover all partitions across the whole cluster at once?
      - What is the risk of recovering every partition in a cluster?
      instructions:
      - text: Recover all partitions in the cluster from quorum loss with a {timeout}-second timeout.
        slots:
          timeout: query.timeout
      - text: Force quorum-loss recovery for every service partition in the cluster.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Partitions/{partitionId}/$/MovePrimaryReplica'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a partition's primary replica
      effect: write
      questions:
      - How do I move the primary replica of a stateful partition to another node?
      - Can I move a primary replica while ignoring placement constraints?
      instructions:
      - text: Move the primary replica of partition {partition} to node {node}.
        slots:
          partition: path.partitionId
          node: query.NodeName
      - text: Move partition {partition}'s primary to a random node.
        slots:
          partition: path.partitionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Partitions/{partitionId}/$/MoveSecondaryReplica'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a partition's secondary replica
      effect: write
      questions:
      - How do I move a secondary replica off a specific node?
      - Can I choose which node a secondary replica moves to?
      instructions:
      - text: Move the secondary replica of partition {partition} from node {from} to node {to}.
        slots:
          partition: path.partitionId
          from: query.CurrentNodeName
          to: query.NewNodeName
      - text: Move partition {partition}'s secondary off node {from}.
        slots:
          partition: path.partitionId
          from: query.CurrentNodeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/$/UpdatePartitionLoad'].post
  update:
    x-apievangelist-phrasing:
      intent: Set load values for partitions
      effect: write
      questions:
      - Can I push load and predicted load values for several partitions at once?
      - How do I update partition load metrics from outside the service?
      instructions:
      - text: Update partition loads with {loads}.
        slots:
          loads: body.PartitionMetricLoadDescriptionList
      - text: Set load and predicted load for the partitions and metrics in {loads}.
        slots:
          loads: body.PartitionMetricLoadDescriptionList
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Services/{serviceId}/$/GetPartitions/{partitionId}/$/MoveInstance'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a stateless service instance
      effect: write
      questions:
      - How do I move a stateless service instance to a different node?
      - Can I relocate an instance of a stateless partition?
      instructions:
      - text: Move the instance of partition {partition} in service {service} to node {to}.
        slots:
          partition: path.partitionId
          service: path.serviceId
          to: query.NewNodeName
      - text: Move the stateless instance on node {from} for partition {partition} of {service}.
        slots:
          from: query.CurrentNodeName
          partition: path.partitionId
          service: path.serviceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Services/{serviceId}/$/GetPartitions/{partitionId}/$/MoveAuxiliaryReplica'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a partition's auxiliary replica
      effect: write
      questions:
      - How do I move an auxiliary replica of a stateful service?
      - Can I let Service Fabric pick a random node for the auxiliary replica?
      instructions:
      - text: Move the auxiliary replica of partition {partition} in service {service} to node {to}.
        slots:
          partition: path.partitionId
          service: path.serviceId
          to: query.NewNodeName
      - text: Move an auxiliary replica of {partition} in {service} to a random node.
        slots:
          partition: path.partitionId
          service: path.serviceId
      method: generated
      generated: '2026-09-26'