# 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 Node API version: 1.0.0 extends: openapi/microsoft-azure-node-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: 15 - target: $.paths['/Nodes'].get update: x-apievangelist-phrasing: intent: List the nodes in a Service Fabric cluster effect: read questions: - Which nodes are in my Service Fabric cluster and are they all up? - Can I list only the nodes that are down or disabled? - How many nodes can I page through per request with a continuation token? instructions: - text: List every node in the Service Fabric cluster. - text: Show cluster nodes with status {NodeStatusFilter}, at most {MaxResults} per page. slots: NodeStatusFilter: query.NodeStatusFilter MaxResults: query.MaxResults method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}'].get update: x-apievangelist-phrasing: intent: Get details about one cluster node effect: read questions: - What is the status, ID and uptime of a specific Service Fabric node? - Can I look up one node's details by its name? instructions: - text: Get node info for {nodeName}. slots: nodeName: path.nodeName - text: Show uptime and status details of cluster node {nodeName}. slots: nodeName: path.nodeName method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/GetHealth'].get update: x-apievangelist-phrasing: intent: Get a node's health effect: read questions: - Is a particular Service Fabric node healthy right now? - Can I see only the error-level health events reported on a node? instructions: - text: Check the health of node {nodeName}. slots: nodeName: path.nodeName - text: Show health events on {nodeName} filtered to state {EventsHealthStateFilter}. slots: nodeName: path.nodeName EventsHealthStateFilter: query.EventsHealthStateFilter method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/GetHealth'].post update: x-apievangelist-phrasing: intent: Evaluate node health with a custom health policy effect: read questions: - Can I evaluate a node's health against my own cluster health policy instead of the default? - Would a node count as unhealthy under a stricter health policy? instructions: - text: Evaluate health of node {nodeName} using cluster health policy {ClusterHealthPolicy}. slots: nodeName: path.nodeName ClusterHealthPolicy: body.ClusterHealthPolicy - text: Re-check {nodeName} against an overridden health policy {ClusterHealthPolicy}. slots: nodeName: path.nodeName ClusterHealthPolicy: body.ClusterHealthPolicy method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/ReportHealth'].post update: x-apievangelist-phrasing: intent: Send a health report on a node effect: write questions: - How do I report a custom health warning against a Service Fabric node? - Can a health report on a node be sent immediately rather than batched by the gateway? instructions: - text: Report health {HealthInformation} on node {nodeName}. slots: HealthInformation: body.HealthInformation nodeName: path.nodeName - text: Send health report {HealthInformation} for {nodeName} with immediate set to {Immediate}. slots: HealthInformation: body.HealthInformation nodeName: path.nodeName Immediate: query.Immediate method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/GetLoadInformation'].get update: x-apievangelist-phrasing: intent: Get a node's load and capacity metrics effect: read questions: - How much load is a node carrying against its defined capacity metrics? - Which metrics have load or capacity on a given node? instructions: - text: Get load information for node {nodeName}. slots: nodeName: path.nodeName - text: Show the metric load vs capacity on {nodeName}. slots: nodeName: path.nodeName method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/Deactivate'].post update: x-apievangelist-phrasing: intent: Deactivate a cluster node effect: write questions: - How do I take a Service Fabric node out of rotation for maintenance? - Can I escalate a node's deactivation intent from Pause to Restart once it's in progress? instructions: - text: Deactivate node {nodeName} with intent {DeactivationIntentDescription}. slots: nodeName: path.nodeName DeactivationIntentDescription: body.DeactivationIntentDescription - text: Pause cluster node {nodeName} using deactivation intent {DeactivationIntentDescription}. slots: nodeName: path.nodeName DeactivationIntentDescription: body.DeactivationIntentDescription method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/Activate'].post update: x-apievangelist-phrasing: intent: Reactivate a deactivated cluster node effect: write questions: - How do I bring a deactivated node back so it can host replicas again? - Can a node I paused for maintenance be activated again? instructions: - text: Activate node {nodeName}. slots: nodeName: path.nodeName - text: Put deactivated node {nodeName} back into service. slots: nodeName: path.nodeName method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/RemoveNodeState'].post update: x-apievangelist-phrasing: intent: Tell the cluster a node's persisted state is lost effect: destructive questions: - What do I do after a node's disk was wiped and its persisted state can't be recovered? - Can I let Service Fabric move on from replicas lost with a crashed node's hard disk? instructions: - text: Mark the persisted state on node {nodeName} as permanently lost. slots: nodeName: path.nodeName - text: Notify the cluster that down node {nodeName} lost its disk state. slots: nodeName: path.nodeName method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/Restart'].post update: x-apievangelist-phrasing: intent: Restart a cluster node effect: write questions: - How do I restart a Service Fabric node that is already running? - Can I reboot a specific node instance in the cluster? instructions: - text: Restart node {nodeName} with {RestartNodeDescription}. slots: nodeName: path.nodeName RestartNodeDescription: body.RestartNodeDescription - text: Reboot cluster node {nodeName} using restart description {RestartNodeDescription}. slots: nodeName: path.nodeName RestartNodeDescription: body.RestartNodeDescription method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/RemoveConfigurationOverrides'].delete update: x-apievangelist-phrasing: intent: Remove all configuration overrides on a node effect: destructive questions: - Can I clear every configuration override I set on a node? - How do I reset a node back to its cluster configuration with no overrides? instructions: - text: Remove all configuration overrides on node {nodeName}. slots: nodeName: path.nodeName - text: Clear the config parameter overrides from {nodeName}. slots: nodeName: path.nodeName method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/GetConfigurationOverrides'].get update: x-apievangelist-phrasing: intent: List configuration overrides on a node effect: read questions: - Which configuration settings are overridden on a particular node? - Does this node have any config parameter overrides in place? instructions: - text: List configuration overrides on node {nodeName}. slots: nodeName: path.nodeName - text: Show which config parameters are overridden for {nodeName}. slots: nodeName: path.nodeName method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/AddConfigurationParameterOverrides'].post update: x-apievangelist-phrasing: intent: Add configuration overrides to a node effect: write questions: - How do I override a configuration parameter on one node only? - Can I force configuration overrides onto a node? instructions: - text: Add configuration overrides {ConfigParameterOverrideList} to node {nodeName}. slots: ConfigParameterOverrideList: body.ConfigParameterOverrideList nodeName: path.nodeName - text: Apply overrides {ConfigParameterOverrideList} on {nodeName} with force {Force}. slots: ConfigParameterOverrideList: body.ConfigParameterOverrideList nodeName: path.nodeName Force: query.Force method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/RemoveNodeTags'].post update: x-apievangelist-phrasing: intent: Remove tags from a node effect: write questions: - How do I take placement tags off a Service Fabric node? - Can I strip several tags from one node at once? instructions: - text: Remove tags {NodeTags} from node {nodeName}. slots: NodeTags: body.NodeTags nodeName: path.nodeName - text: Untag {nodeName}, dropping {NodeTags}. slots: nodeName: path.nodeName NodeTags: body.NodeTags method: generated generated: '2026-09-26' - target: $.paths['/Nodes/{nodeName}/$/AddNodeTags'].post update: x-apievangelist-phrasing: intent: Add tags to a node effect: write questions: - Can I label a node with tags for service placement? - What's the way to attach new tags to an existing cluster node? instructions: - text: Add tags {NodeTags} to node {nodeName}. slots: NodeTags: body.NodeTags nodeName: path.nodeName - text: Tag cluster node {nodeName} with {NodeTags}. slots: nodeName: path.nodeName NodeTags: body.NodeTags method: generated generated: '2026-09-26'