# 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 Shares API
  version: 1.0.0
extends: openapi/microsoft-azure-file-shares-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}/shares'].get
  update:
    x-apievangelist-phrasing:
      intent: List file shares on a StorSimple file server
      effect: read
      questions:
      - Which file shares are hosted on one of my StorSimple file servers?
      - Can I see the shares for a single file server rather than the whole device?
      instructions:
      - text: List file shares on file server {server} of device {device} in StorSimple manager {manager}.
        slots:
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
      - text: Show shares on StorSimple file server {server} in resource group {rg}, subscription {sub}.
        slots:
          server: path.fileServerName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}/shares/{shareName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a StorSimple file share
      effect: read
      questions:
      - What are the properties of a particular StorSimple file share?
      - Can I check the status of one share on my file server?
      instructions:
      - text: Get file share {share} on file server {server}, device {device}, StorSimple manager {manager}.
        slots:
          share: path.shareName
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
      - text: Show the properties of StorSimple share {share} in resource group {rg}, subscription {sub}.
        slots:
          share: path.shareName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}/shares/{shareName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a StorSimple file share
      effect: write
      questions:
      - How do I create a new file share on a StorSimple file server?
      - Can I change the settings of an existing StorSimple share?
      instructions:
      - text: Create file share {share} on file server {server}, device {device}, StorSimple manager {manager} with {properties}.
        slots:
          share: path.shareName
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
          properties: requestBody.properties
      - text: Update StorSimple share {share} in resource group {rg}, subscription {sub} to use properties {properties}.
        slots:
          share: path.shareName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}/shares/{shareName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a StorSimple file share
      effect: destructive
      questions:
      - How do I delete a file share from a StorSimple file server?
      - Can I remove one share without deleting the whole file server?
      instructions:
      - text: Delete file share {share} from file server {server}, device {device}, StorSimple manager {manager}.
        slots:
          share: path.shareName
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
      - text: Remove StorSimple share {share} in resource group {rg}, subscription {sub}.
        slots:
          share: path.shareName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}/shares/{shareName}/metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get usage metrics for a StorSimple file share
      effect: read
      questions:
      - How much capacity is a StorSimple file share using over time?
      - Can I filter file share metrics to a time window?
      instructions:
      - text: Get metrics for share {share} on file server {server}, device {device}, StorSimple manager {manager}.
        slots:
          share: path.shareName
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
      - text: Show StorSimple share {share} metrics matching {filter} in resource group {rg}, subscription {sub}.
        slots:
          share: path.shareName
          filter: query.$filter
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/fileservers/{fileServerName}/shares/{shareName}/metricsDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List metric definitions for a StorSimple file share
      effect: read
      questions:
      - Which metrics can I query for a StorSimple file share?
      - What metric names are aggregated at the share level?
      instructions:
      - text: List metric definitions for share {share} on file server {server}, device {device}, StorSimple manager {manager}.
        slots:
          share: path.shareName
          server: path.fileServerName
          device: path.deviceName
          manager: path.managerName
      - text: Show which metrics are available for StorSimple share {share} in resource group {rg}, subscription {sub}.
        slots:
          share: path.shareName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/shares'].get
  update:
    x-apievangelist-phrasing:
      intent: List all file shares on a StorSimple device
      effect: read
      questions:
      - What file shares exist across every file server on a StorSimple device?
      - Can I get a device-wide list of StorSimple shares in one call?
      instructions:
      - text: List all file shares on device {device} in StorSimple manager {manager}.
        slots:
          device: path.deviceName
          manager: path.managerName
      - text: Show every share on StorSimple device {device} in resource group {rg}, subscription {sub}.
        slots:
          device: path.deviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      method: generated
      generated: '2026-10-01'