# 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 Managed Lustre client Aml Filesystems API
  version: 1.0.0
extends: openapi/microsoft-azure-amlfilesystems-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/amlFilesystems'].get
  update:
    x-apievangelist-phrasing:
      intent: List AML file systems in a subscription
      effect: read
      questions:
      - Which Azure Managed Lustre file systems do I have access to across my subscription?
      - Can I see all AML file systems without picking a resource group?
      instructions:
      - text: List every AML file system in my subscription.
      - text: Show all Azure Managed Lustre file systems I can access across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems'].get
  update:
    x-apievangelist-phrasing:
      intent: List AML file systems in a resource group
      effect: read
      questions:
      - Which Managed Lustre file systems are in a particular resource group?
      - Can I limit the AML file system list to one resource group?
      instructions:
      - text: List the AML file systems in this resource group.
      - text: Show Azure Managed Lustre file systems scoped to my resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an AML file system
      effect: read
      questions:
      - What is the configuration and state of a specific AML file system?
      - Can I look up one Managed Lustre file system by name?
      instructions:
      - text: Get AML file system {amlFilesystemName}.
        slots:
          amlFilesystemName: path.amlFilesystemName
      - text: Show the details of Managed Lustre file system {amlFilesystemName}.
        slots:
          amlFilesystemName: path.amlFilesystemName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an AML file system
      effect: write
      questions:
      - How do I create an Azure Managed Lustre file system with a chosen SKU and zones?
      - Can I provision an AML file system with a managed identity?
      instructions:
      - text: Create AML file system {amlFilesystemName} with SKU {sku} in zones {zones}.
        slots:
          amlFilesystemName: path.amlFilesystemName
          sku: requestBody.sku
          zones: requestBody.zones
      - text: Provision Managed Lustre file system {amlFilesystemName} using properties {properties}.
        slots:
          amlFilesystemName: path.amlFilesystemName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an AML file system
      effect: destructive
      questions:
      - How do I delete an Azure Managed Lustre file system?
      - Is an AML file system removed immediately or scheduled for deletion?
      instructions:
      - text: Delete AML file system {amlFilesystemName}.
        slots:
          amlFilesystemName: path.amlFilesystemName
      - text: Schedule Managed Lustre file system {amlFilesystemName} for deletion.
        slots:
          amlFilesystemName: path.amlFilesystemName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags or settings of an AML file system
      effect: write
      questions:
      - Can I change the tags on an existing Managed Lustre file system?
      - Is it possible to patch settings on an AML file system that's already running?
      instructions:
      - text: Update the tags on AML file system {amlFilesystemName} to {tags}.
        slots:
          amlFilesystemName: path.amlFilesystemName
          tags: requestBody.tags
      - text: Patch existing Managed Lustre file system {amlFilesystemName} with {properties}.
        slots:
          amlFilesystemName: path.amlFilesystemName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}/archive'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive data from an AML file system
      effect: write
      questions:
      - How do I archive data from my Managed Lustre file system back to blob storage?
      - Can I archive only one path of an AML file system?
      instructions:
      - text: Archive data from AML file system {amlFilesystemName}.
        slots:
          amlFilesystemName: path.amlFilesystemName
      - text: Archive path {filesystemPath} on Managed Lustre file system {amlFilesystemName}.
        slots:
          filesystemPath: requestBody.filesystemPath
          amlFilesystemName: path.amlFilesystemName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}/cancelArchive'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel an AML file system archive
      effect: destructive
      questions:
      - Can I stop an archive job that's running on my AML file system?
      - What cancels archiving data from a Managed Lustre file system?
      instructions:
      - text: Cancel the running archive on AML file system {amlFilesystemName}.
        slots:
          amlFilesystemName: path.amlFilesystemName
      - text: Stop archiving data from Managed Lustre file system {amlFilesystemName}.
        slots:
          amlFilesystemName: path.amlFilesystemName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/checkAmlFSSubnets'].post
  update:
    x-apievangelist-phrasing:
      intent: Check subnets are valid for an AML file system
      effect: read
      questions:
      - Will my subnet work for creating a Managed Lustre file system?
      - Can I validate a subnet against a given storage capacity and SKU before creating an AML file system?
      instructions:
      - text: Check whether subnet {filesystemSubnet} is valid for an AML file system in {location}.
        slots:
          filesystemSubnet: requestBody.filesystemSubnet
          location: requestBody.location
      - text: Validate subnet {filesystemSubnet} for a {storageCapacityTiB} TiB Managed Lustre file system with SKU {sku}.
        slots:
          filesystemSubnet: requestBody.filesystemSubnet
          storageCapacityTiB: requestBody.storageCapacityTiB
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/getRequiredAmlFSSubnetsSize'].post
  update:
    x-apievangelist-phrasing:
      intent: Get IP addresses needed for an AML file system
      effect: read
      questions:
      - How many IP addresses does my subnet need for a Managed Lustre file system?
      - What subnet size is required for a given AML storage capacity and SKU?
      instructions:
      - text: Tell me how many IP addresses an AML file system of {storageCapacityTiB} TiB with SKU {sku} needs.
        slots:
          storageCapacityTiB: requestBody.storageCapacityTiB
          sku: requestBody.sku
      - text: Calculate the required subnet size for a {storageCapacityTiB} TiB Managed Lustre file system.
        slots:
          storageCapacityTiB: requestBody.storageCapacityTiB
      method: generated
      generated: '2026-09-26'