# 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 StorSimpleManagementClient File Servers API
  version: 1.0.0
extends: openapi/microsoft-azure-file-servers-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers'].get
  update:
    x-apievangelist-phrasing:
      intent: List file servers on a StorSimple device
      effect: read
      questions:
      - Which file servers are running on my StorSimple device?
      - Can I see the file servers configured on one device?
      instructions:
      - text: List file servers on device {device} under StorSimple manager {manager}, group {rg}, subscription {sub}.
        slots:
          device: path.deviceName
          manager: path.managerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the file servers hosted on StorSimple device {device}.
        slots:
          device: path.deviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a StorSimple file server
      effect: read
      questions:
      - What are the properties of one file server on my StorSimple device?
      - Can I look up a file server by name?
      instructions:
      - text: Get file server {server} on device {device}, manager {manager}, group {rg}, subscription {sub}.
        slots:
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the settings of StorSimple file server {server}.
        slots:
          server: path.fileServerName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a StorSimple file server
      effect: write
      questions:
      - How do I set up a new file server on a StorSimple device?
      - Can I change an existing file server's configuration?
      instructions:
      - text: Create file server {server} on device {device}, manager {manager}, group {rg}, subscription {sub} with {props}.
        slots:
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          props: requestBody.properties
      - text: Reconfigure StorSimple file server {server} using properties {props}.
        slots:
          server: path.fileServerName
          props: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a StorSimple file server
      effect: destructive
      questions:
      - Can I remove a file server from my StorSimple device?
      - What do I need to delete a StorSimple file server?
      instructions:
      - text: Delete file server {server} on device {device}, manager {manager}, group {rg}, subscription {sub}.
        slots:
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove StorSimple file server {server}.
        slots:
          server: path.fileServerName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}/backup'].post
  update:
    x-apievangelist-phrasing:
      intent: Back up a StorSimple file server now
      effect: write
      questions:
      - How do I trigger an immediate backup of a file server?
      - Can I take an on-demand backup of a StorSimple file server outside its schedule?
      instructions:
      - text: Back up file server {server} on device {device}, manager {manager}, group {rg}, subscription {sub} now.
        slots:
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Run an on-demand backup of StorSimple file server {server}.
        slots:
          server: path.fileServerName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}/metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get metrics for a StorSimple file server
      effect: read
      questions:
      - What performance metrics does my StorSimple file server report?
      - Can I filter file server metrics by time range or metric name?
      instructions:
      - text: Get metrics for file server {server} on device {device}, manager {manager}, group {rg}, subscription {sub}.
        slots:
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show StorSimple file server {server} metrics matching {filter}.
        slots:
          server: path.fileServerName
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}/metricsDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List metric definitions for a file server
      effect: read
      questions:
      - Which metrics are available to query for a StorSimple file server?
      - What metric definitions are aggregated at the file server level?
      instructions:
      - text: List metric definitions for file server {server} on device {device}, manager {manager}, group {rg}, subscription {sub}.
        slots:
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which metric types I can request for StorSimple file server {server}.
        slots:
          server: path.fileServerName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/fileservers'].get
  update:
    x-apievangelist-phrasing:
      intent: List all file servers in a StorSimple manager
      effect: read
      questions:
      - Which file servers exist across every device in my StorSimple manager?
      - Can I list file servers manager-wide instead of per device?
      instructions:
      - text: List all file servers in StorSimple manager {manager}, resource group {rg}, subscription {sub}.
        slots:
          manager: path.managerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every file server across the devices of manager {manager}.
        slots:
          manager: path.managerName
      method: generated
      generated: '2026-10-01'