# 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 Iscsi Servers API
  version: 1.0.0
extends: openapi/microsoft-azure-iscsiservers-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.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers'].get
  update:
    x-apievangelist-phrasing:
      intent: List iSCSI servers on a StorSimple device
      effect: read
      questions:
      - Which iSCSI servers run on one of my StorSimple devices?
      - Can I see the iSCSI servers for a single device instead of the whole manager?
      instructions:
      - text: List iSCSI servers on device {deviceName} in StorSimple manager {managerName}.
        slots:
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Show iSCSI servers for device {deviceName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          deviceName: path.deviceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an iSCSI server's properties
      effect: read
      questions:
      - What are the settings of a particular iSCSI server?
      - How is one StorSimple iSCSI server configured?
      instructions:
      - text: Get iSCSI server {iscsiServerName} on device {deviceName} in manager {managerName}.
        slots:
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Show iSCSI server {iscsiServerName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          iscsiServerName: path.iscsiServerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an iSCSI server
      effect: write
      questions:
      - How do I add an iSCSI server to a StorSimple device?
      - Can I change the configuration of an existing iSCSI server?
      instructions:
      - text: Create iSCSI server {iscsiServerName} on device {deviceName} in manager {managerName}.
        slots:
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Update iSCSI server {iscsiServerName} in resource group {resourceGroupName}, subscription {subscriptionId} with {properties}.
        slots:
          iscsiServerName: path.iscsiServerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an iSCSI server
      effect: destructive
      questions:
      - How do I remove an iSCSI server from a StorSimple device?
      - Can I decommission an iSCSI server through the API?
      instructions:
      - text: Delete iSCSI server {iscsiServerName} from device {deviceName} in manager {managerName}.
        slots:
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Remove iSCSI server {iscsiServerName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          iscsiServerName: path.iscsiServerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/backup'].post
  update:
    x-apievangelist-phrasing:
      intent: Back up an iSCSI server now
      effect: write
      questions:
      - Can I trigger an on-demand backup of an iSCSI server?
      - How do I take a backup right away instead of waiting for the schedule?
      instructions:
      - text: Back up iSCSI server {iscsiServerName} on device {deviceName} in manager {managerName} now.
        slots:
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Start an immediate backup of iSCSI server {iscsiServerName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          iscsiServerName: path.iscsiServerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get metrics for an iSCSI server
      effect: read
      questions:
      - How is my iSCSI server performing over time?
      - Can I filter iSCSI server metrics by name or time range?
      instructions:
      - text: Get metrics for iSCSI server {iscsiServerName} on device {deviceName} in manager {managerName}.
        slots:
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Show iSCSI server {iscsiServerName} metrics in group {resourceGroupName}, subscription {subscriptionId}, filtered by {filter}.
        slots:
          iscsiServerName: path.iscsiServerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/metricsDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List metric definitions for an iSCSI server
      effect: read
      questions:
      - Which metrics are available to query for an iSCSI server?
      - What units and aggregations do iSCSI server metrics use?
      instructions:
      - text: List metric definitions for iSCSI server {iscsiServerName} on device {deviceName} in manager {managerName}.
        slots:
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
      - text: Show the available metric types for iSCSI server {iscsiServerName} in group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          iscsiServerName: path.iscsiServerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/iscsiservers'].get
  update:
    x-apievangelist-phrasing:
      intent: List all iSCSI servers in a StorSimple manager
      effect: read
      questions:
      - What iSCSI servers exist across every device in my StorSimple manager?
      - Can I get a manager-wide inventory of iSCSI servers?
      instructions:
      - text: List all iSCSI servers in StorSimple manager {managerName}.
        slots:
          managerName: path.managerName
      - text: Show every iSCSI server under manager {managerName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'