# 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 ConfidentialLedger Managed CCF API
  version: 1.0.0
extends: openapi/microsoft-azure-managed-ccf-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConfidentialLedger/managedCCFs/{appName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Managed CCF app
      effect: read
      questions:
      - How can I see the properties of my Managed CCF confidential ledger app?
      - What state and endpoints does a Managed CCF resource report?
      instructions:
      - text: Get Managed CCF app {appName}.
        slots:
          appName: path.appName
      - text: Show the properties of confidential consortium app {appName}.
        slots:
          appName: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConfidentialLedger/managedCCFs/{appName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Managed CCF app
      effect: write
      questions:
      - How do I spin up a new Managed CCF network in Azure?
      - Which settings can I pass when creating a Managed CCF app?
      instructions:
      - text: Create Managed CCF app {appName}.
        slots:
          appName: path.appName
      - text: Create Managed CCF {appName} with properties {properties}.
        slots:
          appName: path.appName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConfidentialLedger/managedCCFs/{appName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Managed CCF app
      effect: destructive
      questions:
      - Can I delete a Managed CCF resource I no longer use?
      - What tears down an existing Managed CCF network?
      instructions:
      - text: Delete Managed CCF app {appName}.
        slots:
          appName: path.appName
      - text: Tear down the Managed CCF network {appName}.
        slots:
          appName: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConfidentialLedger/managedCCFs/{appName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Managed CCF app's properties
      effect: write
      questions:
      - How do I change properties such as node count on an existing Managed CCF?
      - Can I patch a Managed CCF app without recreating it?
      instructions:
      - text: Update Managed CCF app {appName} with properties {properties}.
        slots:
          appName: path.appName
          properties: requestBody.properties
      - text: Patch existing Managed CCF {appName}.
        slots:
          appName: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConfidentialLedger/managedCCFs'].get
  update:
    x-apievangelist-phrasing:
      intent: List Managed CCF apps in a resource group
      effect: read
      questions:
      - Which Managed CCF apps are in my resource group?
      - Can I filter the Managed CCF resources listed for one resource group?
      instructions:
      - text: List Managed CCF apps in this resource group.
      - text: List resource-group Managed CCF apps matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ConfidentialLedger/managedCCFs/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Managed CCF apps across a subscription
      effect: read
      questions:
      - How do I see every Managed CCF across my whole subscription?
      - Can I filter subscription-wide Managed CCF results?
      instructions:
      - text: List all Managed CCF apps in my subscription.
      - text: List subscription-wide Managed CCF resources matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConfidentialLedger/managedCCFs/{appName}/backup'].post
  update:
    x-apievangelist-phrasing:
      intent: Back up a Managed CCF app to storage
      effect: write
      questions:
      - How do I back up my Managed CCF ledger to a storage account?
      - Can I set a restore region when backing up a Managed CCF?
      instructions:
      - text: Back up Managed CCF app {appName} to {uri}.
        slots:
          appName: path.appName
          uri: requestBody.uri
      - text: Back up Managed CCF {appName} to SAS URI {uri} for restore in {restoreRegion}.
        slots:
          appName: path.appName
          uri: requestBody.uri
          restoreRegion: requestBody.restoreRegion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConfidentialLedger/managedCCFs/{appName}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a Managed CCF app from a backup
      effect: write
      questions:
      - How do I restore a Managed CCF network from a backup file share?
      - What do I need to spin up a restored Managed CCF in another region?
      instructions:
      - text: Restore Managed CCF {appName} from file share {fileShareName} at {uri} into region {restoreRegion}.
        slots:
          appName: path.appName
          fileShareName: requestBody.fileShareName
          uri: requestBody.uri
          restoreRegion: requestBody.restoreRegion
      - text: Recover Managed CCF {appName} in {restoreRegion} using backup share {fileShareName} at {uri}.
        slots:
          appName: path.appName
          restoreRegion: requestBody.restoreRegion
          fileShareName: requestBody.fileShareName
          uri: requestBody.uri
      method: generated
      generated: '2026-09-26'