# 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 FluxConfigurationClient Flux API
  version: 1.0.0
extends: openapi/microsoft-azure-flux-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/fluxConfigurations/{fluxConfigurationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Flux configuration
      effect: read
      questions:
      - What is the sync status of one Flux configuration on my cluster?
      - Which Git source does a given Flux configuration pull from?
      instructions:
      - text: Get Flux configuration {fluxConfigurationName} on {clusterRp}/{clusterResourceName} cluster {clusterName}.
        slots:
          fluxConfigurationName: path.fluxConfigurationName
          clusterRp: path.clusterRp
          clusterResourceName: path.clusterResourceName
          clusterName: path.clusterName
      - text: Show the Git source and sync status of Flux configuration {fluxConfigurationName}.
        slots:
          fluxConfigurationName: path.fluxConfigurationName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/fluxConfigurations/{fluxConfigurationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Flux GitOps configuration
      effect: write
      questions:
      - How do I set up GitOps with Flux on my Kubernetes cluster?
      - Can I create a Flux configuration that syncs from my Git repo?
      instructions:
      - text: Create Flux configuration {fluxConfigurationName} with {properties} on {clusterRp}/{clusterResourceName} cluster {clusterName}.
        slots:
          fluxConfigurationName: path.fluxConfigurationName
          properties: requestBody.properties
          clusterRp: path.clusterRp
          clusterResourceName: path.clusterResourceName
          clusterName: path.clusterName
      - text: Set up GitOps on this cluster with a new Flux configuration named {fluxConfigurationName}.
        slots:
          fluxConfigurationName: path.fluxConfigurationName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/fluxConfigurations/{fluxConfigurationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Flux configuration
      effect: destructive
      questions:
      - Can I stop Flux from syncing my cluster from the source repo?
      - Can I force-delete a Flux configuration that is stuck?
      instructions:
      - text: Delete Flux configuration {fluxConfigurationName} from {clusterRp}/{clusterResourceName} cluster {clusterName}.
        slots:
          fluxConfigurationName: path.fluxConfigurationName
          clusterRp: path.clusterRp
          clusterResourceName: path.clusterResourceName
          clusterName: path.clusterName
      - text: Delete Flux configuration {fluxConfigurationName} with force delete {forceDelete}.
        slots:
          fluxConfigurationName: path.fluxConfigurationName
          forceDelete: query.forceDelete
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/fluxConfigurations/{fluxConfigurationName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing Flux configuration
      effect: write
      questions:
      - How do I change the branch or kustomizations of an existing Flux configuration?
      - Can I patch a Flux configuration without recreating it?
      instructions:
      - text: Update existing Flux configuration {fluxConfigurationName} on {clusterRp}/{clusterResourceName} cluster {clusterName} with {properties}.
        slots:
          fluxConfigurationName: path.fluxConfigurationName
          clusterRp: path.clusterRp
          clusterResourceName: path.clusterResourceName
          clusterName: path.clusterName
          properties: requestBody.properties
      - text: Change the settings of Flux configuration {fluxConfigurationName} already on the cluster.
        slots:
          fluxConfigurationName: path.fluxConfigurationName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/fluxConfigurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Flux configurations on a cluster
      effect: read
      questions:
      - Which Flux configurations are installed on my cluster?
      - What GitOps configurations exist on a cluster?
      instructions:
      - text: List all Flux configurations on {clusterRp}/{clusterResourceName} cluster {clusterName}.
        slots:
          clusterRp: path.clusterRp
          clusterResourceName: path.clusterResourceName
          clusterName: path.clusterName
      - text: Show every GitOps Flux configuration installed on the cluster.
      method: generated
      generated: '2026-10-01'