# 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 Service Package API
  version: 1.0.0
extends: openapi/microsoft-azure-service-package-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: 6
- target: $.paths['/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages'].get
  update:
    x-apievangelist-phrasing:
      intent: List service packages deployed on a node
      effect: read
      questions:
      - Which service packages of an application are deployed on a Service Fabric node?
      - Can I see every deployed service package for an app on one node?
      instructions:
      - text: List service packages of application {applicationId} on node {nodeName}.
        slots:
          applicationId: path.applicationId
          nodeName: path.nodeName
      - text: Show deployed service packages for {applicationId} on Service Fabric node {nodeName}.
        slots:
          applicationId: path.applicationId
          nodeName: path.nodeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages/{servicePackageName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Find a deployed service package by exact name
      effect: read
      questions:
      - Is a service package with an exact name deployed on a given node?
      - Can I look up one deployed service package by its name?
      instructions:
      - text: Get deployed service package {servicePackageName} of application {applicationId} on node {nodeName}.
        slots:
          servicePackageName: path.servicePackageName
          applicationId: path.applicationId
          nodeName: path.nodeName
      - text: Find service package named {servicePackageName} for app {applicationId} on node {nodeName}.
        slots:
          servicePackageName: path.servicePackageName
          applicationId: path.applicationId
          nodeName: path.nodeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages/{servicePackageName}/$/GetHealth'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a deployed service package's health
      effect: read
      questions:
      - Is a deployed service package healthy on a node?
      - Can I filter the health events reported on a deployed service package by state?
      instructions:
      - text: Get the health of service package {servicePackageName} for application {applicationId} on node {nodeName}.
        slots:
          servicePackageName: path.servicePackageName
          applicationId: path.applicationId
          nodeName: path.nodeName
      - text: Show health events for package {servicePackageName} of {applicationId} on {nodeName} filtered by {EventsHealthStateFilter}.
        slots:
          servicePackageName: path.servicePackageName
          applicationId: path.applicationId
          nodeName: path.nodeName
          EventsHealthStateFilter: query.EventsHealthStateFilter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages/{servicePackageName}/$/GetHealth'].post
  update:
    x-apievangelist-phrasing:
      intent: Evaluate service package health with a custom policy
      effect: read
      questions:
      - Can I evaluate a deployed service package's health against my own application health policy?
      - What health would a service package report under a stricter policy?
      instructions:
      - text: Evaluate health of package {servicePackageName} of {applicationId} on node {nodeName} using my health policy.
        slots:
          servicePackageName: path.servicePackageName
          applicationId: path.applicationId
          nodeName: path.nodeName
      - text: Check {servicePackageName} health on {nodeName} for app {applicationId} with policy {ApplicationHealthPolicy}.
        slots:
          servicePackageName: path.servicePackageName
          nodeName: path.nodeName
          applicationId: path.applicationId
          ApplicationHealthPolicy: body.ApplicationHealthPolicy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages/{servicePackageName}/$/ReportHealth'].post
  update:
    x-apievangelist-phrasing:
      intent: Report health on a deployed service package
      effect: write
      questions:
      - How do I send a custom health report for a service package on a node?
      - Can a health report be sent immediately instead of batched?
      instructions:
      - text: Report health {HealthInformation} on package {servicePackageName} of {applicationId} on node {nodeName}.
        slots:
          HealthInformation: body.HealthInformation
          servicePackageName: path.servicePackageName
          applicationId: path.applicationId
          nodeName: path.nodeName
      - text: Immediately send health report {HealthInformation} for {servicePackageName} on node {nodeName}, app {applicationId}.
        slots:
          HealthInformation: body.HealthInformation
          servicePackageName: path.servicePackageName
          nodeName: path.nodeName
          applicationId: path.applicationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Nodes/{nodeName}/$/DeployServicePackage'].post
  update:
    x-apievangelist-phrasing:
      intent: Pre-download a service package's code to a node
      effect: write
      questions:
      - Can I download container images to a node before an application upgrade?
      - How do I pre-stage large code packages for a service manifest on a specific node?
      instructions:
      - text: Deploy service package {DeployServicePackageToNodeDescription} to node {nodeName}.
        slots:
          DeployServicePackageToNodeDescription: body.DeployServicePackageToNodeDescription
          nodeName: path.nodeName
      - text: Pre-download code packages for node {nodeName} ahead of the upgrade.
        slots:
          nodeName: path.nodeName
      method: generated
      generated: '2026-09-26'