# 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'