# 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 Disks API
  version: 1.0.0
extends: openapi/microsoft-azure-iscsidisks-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: 7
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/disks'].get
  update:
    x-apievangelist-phrasing:
      intent: List all iSCSI disks on a StorSimple device
      effect: read
      questions:
      - Which iSCSI disks exist across every iSCSI server on a StorSimple device?
      - Can I see all the disks a device exposes, regardless of iSCSI server?
      instructions:
      - text: List iSCSI disks on device {deviceName} in manager {managerName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show every disk on StorSimple device {deviceName} under manager {managerName}.
        slots:
          deviceName: path.deviceName
          managerName: path.managerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/disks'].get
  update:
    x-apievangelist-phrasing:
      intent: List the disks on one iSCSI server
      effect: read
      questions:
      - What disks are attached to a specific iSCSI server on my device?
      - Can I narrow the disk list to a single iSCSI server?
      instructions:
      - text: List disks on iSCSI server {iscsiServerName} of device {deviceName}, manager {managerName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show disks served by iSCSI server {iscsiServerName} on {deviceName}.
        slots:
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/disks/{diskName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an iSCSI disk's properties
      effect: read
      questions:
      - What size and access settings does one iSCSI disk have?
      - Can I look up a single iSCSI disk by name?
      instructions:
      - text: Get iSCSI disk {diskName} on server {iscsiServerName}, device {deviceName}, manager {managerName}, group {resourceGroupName}, sub {subscriptionId}.
        slots:
          diskName: path.diskName
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the properties of disk {diskName} on iSCSI server {iscsiServerName}.
        slots:
          diskName: path.diskName
          iscsiServerName: path.iscsiServerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/disks/{diskName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an iSCSI disk
      effect: write
      questions:
      - How do I provision a new iSCSI disk on a StorSimple iSCSI server?
      - Can I change the settings of an existing iSCSI disk?
      instructions:
      - text: Create disk {diskName} ({properties}) on {iscsiServerName}, device {deviceName}, manager {managerName}, RG {resourceGroupName}, sub {subscriptionId}.
        slots:
          diskName: path.diskName
          properties: requestBody.properties
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Update disk {diskName} on iSCSI server {iscsiServerName} with properties {properties}.
        slots:
          diskName: path.diskName
          iscsiServerName: path.iscsiServerName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/disks/{diskName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an iSCSI disk
      effect: destructive
      questions:
      - Can I remove an iSCSI disk I no longer use?
      - What deletes a disk from a StorSimple iSCSI server?
      instructions:
      - text: Delete iSCSI disk {diskName} from server {iscsiServerName}, device {deviceName}, manager {managerName}, group {resourceGroupName}, sub {subscriptionId}.
        slots:
          diskName: path.diskName
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove disk {diskName} from iSCSI server {iscsiServerName}.
        slots:
          diskName: path.diskName
          iscsiServerName: path.iscsiServerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/disks/{diskName}/metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get metrics for an iSCSI disk
      effect: read
      questions:
      - How is an iSCSI disk performing over time?
      - Can I filter the metrics I pull for an iSCSI disk?
      instructions:
      - text: Get metrics for disk {diskName} on server {iscsiServerName}, device {deviceName}, manager {managerName}, group {resourceGroupName}, sub {subscriptionId}.
        slots:
          diskName: path.diskName
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show iSCSI disk {diskName} metrics matching {filter}.
        slots:
          diskName: path.diskName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorSimple/managers/{managerName}/devices/{deviceName}/iscsiservers/{iscsiServerName}/disks/{diskName}/metricsDefinitions'].get
  update:
    x-apievangelist-phrasing:
      intent: List metric definitions for an iSCSI disk
      effect: read
      questions:
      - Which metrics are available to query for an iSCSI disk?
      - What metric names and aggregations does an iSCSI disk define?
      instructions:
      - text: List metric definitions for disk {diskName} on {iscsiServerName}, device {deviceName}, manager {managerName}, group {resourceGroupName}, sub {subscriptionId}.
        slots:
          diskName: path.diskName
          iscsiServerName: path.iscsiServerName
          deviceName: path.deviceName
          managerName: path.managerName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show which metrics can be queried on iSCSI disk {diskName}.
        slots:
          diskName: path.diskName
      method: generated
      generated: '2026-09-26'