API Evangelist conversational phrasing for Microsoft Azure Service Fabric Client Application Type 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 Application Type API
  version: 1.0.0
extends: openapi/microsoft-azure-applicationtype-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: 5
- target: $.paths['/ApplicationTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List application types in a Service Fabric cluster
      effect: read
      questions:
      - Which application types and versions are provisioned in my Service Fabric cluster?
      - Can I list only application types of a certain definition kind, like Compose?
      instructions:
      - text: List application types in the cluster, up to {max_results} results.
        slots:
          max_results: query.MaxResults
      - text: List application types of definition kind {kind_filter} without their parameters ({exclude_params}).
        slots:
          kind_filter: query.ApplicationTypeDefinitionKindFilter
          exclude_params: query.ExcludeApplicationParameters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ApplicationTypes/{applicationTypeName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application type's versions by name
      effect: read
      questions:
      - What versions of a specific application type are provisioned in the cluster?
      - Can I check whether one exact application type version is registered?
      instructions:
      - text: Get application type {app_type} from the cluster.
        slots:
          app_type: path.applicationTypeName
      - text: Check if version {version} of application type {app_type} is provisioned.
        slots:
          version: query.ApplicationTypeVersion
          app_type: path.applicationTypeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ApplicationTypes/$/Provision'].post
  update:
    x-apievangelist-phrasing:
      intent: Provision an application type in the cluster
      effect: write
      questions:
      - How do I register a new Service Fabric application type before creating applications from it?
      - Can I provision an application type from an sfpkg in an external store?
      instructions:
      - text: Provision an application type using {provision_description}.
        slots:
          provision_description: body.ProvisionApplicationTypeDescriptionBaseRequiredBodyParam
      - text: Register the application package described by {provision_description} with the cluster, timing out after {timeout} seconds.
        slots:
          provision_description: body.ProvisionApplicationTypeDescriptionBaseRequiredBodyParam
          timeout: query.timeout
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ApplicationTypes/{applicationTypeName}/$/Unprovision'].post
  update:
    x-apievangelist-phrasing:
      intent: Unprovision an application type
      effect: destructive
      questions:
      - How do I unregister an application type from my Service Fabric cluster?
      - Do all application instances need to be deleted before I can unprovision a type?
      instructions:
      - text: Unprovision application type {app_type} with {unprovision_info}.
        slots:
          app_type: path.applicationTypeName
          unprovision_info: body.UnprovisionApplicationTypeDescriptionInfo
      - text: Remove application type {app_type} version details {unprovision_info} from the cluster.
        slots:
          app_type: path.applicationTypeName
          unprovision_info: body.UnprovisionApplicationTypeDescriptionInfo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ApplicationTypes/{applicationTypeName}/$/GetApplicationManifest'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the manifest of an application type
      effect: read
      questions:
      - How do I read the application manifest XML for a provisioned application type?
      - Where can I see the manifest that defines an application type version?
      instructions:
      - text: Get the application manifest for {app_type} version {version}.
        slots:
          app_type: path.applicationTypeName
          version: query.ApplicationTypeVersion
      - text: Show the manifest XML of application type {app_type} at version {version}.
        slots:
          app_type: path.applicationTypeName
          version: query.ApplicationTypeVersion
      method: generated
      generated: '2026-09-26'