# 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 StoragePoolManagement Iscsi Targets API
  version: 1.0.0
extends: openapi/microsoft-azure-iscsitargets-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StoragePool/diskPools/{diskPoolName}/iscsiTargets'].get
  update:
    x-apievangelist-phrasing:
      intent: List iSCSI targets in a disk pool
      effect: read
      questions:
      - Which iSCSI targets are exposed by my Azure disk pool?
      - Can I see all iSCSI targets for one disk pool at once?
      instructions:
      - text: List the iSCSI targets in disk pool {pool}, resource group {rg}.
        slots:
          pool: path.diskPoolName
          rg: path.resourceGroupName
      - text: Show every iSCSI target on disk pool {pool} in subscription {sub}, group {rg}.
        slots:
          pool: path.diskPoolName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StoragePool/diskPools/{diskPoolName}/iscsiTargets/{iscsiTargetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an iSCSI target
      effect: read
      questions:
      - What IQN and endpoints does a specific iSCSI target use?
      - How do I look up the LUNs and ACL mode of one iSCSI target?
      instructions:
      - text: Get iSCSI target {target} in disk pool {pool}, resource group {rg}.
        slots:
          target: path.iscsiTargetName
          pool: path.diskPoolName
          rg: path.resourceGroupName
      - text: Show the details of iSCSI target {target} on pool {pool} in subscription {sub}, group {rg}.
        slots:
          target: path.iscsiTargetName
          pool: path.diskPoolName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StoragePool/diskPools/{diskPoolName}/iscsiTargets/{iscsiTargetName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an iSCSI target
      effect: write
      questions:
      - How do I expose disks from a disk pool as a new iSCSI target?
      - Can I recreate an iSCSI target with a different ACL mode?
      instructions:
      - text: Create iSCSI target {target} in disk pool {pool}, resource group {rg} with {payload}.
        slots:
          target: path.iscsiTargetName
          pool: path.diskPoolName
          rg: path.resourceGroupName
          payload: body.iscsiTargetCreatePayload
      - text: Put iSCSI target {target} on pool {pool} in subscription {sub}, group {rg} using create payload {payload}.
        slots:
          target: path.iscsiTargetName
          pool: path.diskPoolName
          sub: path.subscriptionId
          rg: path.resourceGroupName
          payload: body.iscsiTargetCreatePayload
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StoragePool/diskPools/{diskPoolName}/iscsiTargets/{iscsiTargetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an iSCSI target
      effect: destructive
      questions:
      - How do I remove an iSCSI target from a disk pool?
      - Will deleting an iSCSI target disconnect the initiators using it?
      instructions:
      - text: Delete iSCSI target {target} from disk pool {pool}, resource group {rg}.
        slots:
          target: path.iscsiTargetName
          pool: path.diskPoolName
          rg: path.resourceGroupName
      - text: Remove iSCSI target {target} on pool {pool} in subscription {sub}, group {rg}.
        slots:
          target: path.iscsiTargetName
          pool: path.diskPoolName
          sub: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StoragePool/diskPools/{diskPoolName}/iscsiTargets/{iscsiTargetName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an iSCSI target
      effect: write
      questions:
      - How do I add LUNs or change static ACLs on an existing iSCSI target?
      - Can I modify an iSCSI target in place without recreating it?
      instructions:
      - text: Update iSCSI target {target} in disk pool {pool}, resource group {rg} with {payload}.
        slots:
          target: path.iscsiTargetName
          pool: path.diskPoolName
          rg: path.resourceGroupName
          payload: body.iscsiTargetUpdatePayload
      - text: Patch iSCSI target {target} on pool {pool} in subscription {sub}, group {rg} with update payload {payload}.
        slots:
          target: path.iscsiTargetName
          pool: path.diskPoolName
          sub: path.subscriptionId
          rg: path.resourceGroupName
          payload: body.iscsiTargetUpdatePayload
      method: generated
      generated: '2026-09-26'