# 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 StorageActionsManagementClient Storage…
  version: 1.0.0
extends: openapi/microsoft-azure-storagetasks-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a storage task
      effect: read
      questions:
      - How do I see the conditions and actions defined in a storage task?
      - What properties does one of my Azure Storage Actions tasks have?
      instructions:
      - text: Get storage task {storageTaskName}.
        slots:
          storageTaskName: path.storageTaskName
      - text: Show the definition of storage task {storageTaskName}.
        slots:
          storageTaskName: path.storageTaskName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a storage task
      effect: write
      questions:
      - How do I create a storage task that runs actions on blobs matching conditions?
      - What happens if I create a storage task that already exists with different properties?
      instructions:
      - text: Create storage task {storageTaskName} with properties {properties}.
        slots:
          storageTaskName: path.storageTaskName
          properties: requestBody.properties
      - text: Create storage task {storageTaskName} using managed identity {identity}.
        slots:
          storageTaskName: path.storageTaskName
          identity: requestBody.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a storage task
      effect: destructive
      questions:
      - How do I remove a storage task I no longer need?
      - Can I delete a Storage Actions task resource?
      instructions:
      - text: Delete storage task {storageTaskName}.
        slots:
          storageTaskName: path.storageTaskName
      - text: Remove the storage task resource {storageTaskName}.
        slots:
          storageTaskName: path.storageTaskName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a storage task
      effect: write
      questions:
      - How do I change the tags or actions of an existing storage task?
      - Can I patch a storage task's identity without recreating it?
      instructions:
      - text: Update tags on storage task {storageTaskName} to {tags}.
        slots:
          storageTaskName: path.storageTaskName
          tags: requestBody.tags
      - text: Patch the existing storage task {storageTaskName} with properties {properties}.
        slots:
          storageTaskName: path.storageTaskName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.StorageActions/storageTasks'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage tasks in a subscription
      effect: read
      questions:
      - Which storage tasks exist across my entire subscription?
      - Can I get a subscription-wide list of Storage Actions tasks?
      instructions:
      - text: List all storage tasks in my subscription.
      - text: Show every storage task across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage tasks in a resource group
      effect: read
      questions:
      - Which storage tasks are in a particular resource group?
      - Can I see only the storage tasks belonging to one resource group?
      instructions:
      - text: List the storage tasks in this resource group.
      - text: Show storage tasks scoped to my resource group only.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}/storageTaskAssignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List assignments of a storage task
      effect: read
      questions:
      - Which storage accounts is a given storage task assigned to?
      - How do I page through the assignments of a storage task?
      instructions:
      - text: List the assignments of storage task {storageTaskName}.
        slots:
          storageTaskName: path.storageTaskName
      - text: Show up to {maxpagesize} assignments for storage task {storageTaskName}.
        slots:
          maxpagesize: query.$maxpagesize
          storageTaskName: path.storageTaskName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageActions/storageTasks/{storageTaskName}/reports'].get
  update:
    x-apievangelist-phrasing:
      intent: Get run reports for a storage task
      effect: read
      questions:
      - Did my storage task runs succeed on each assigned account?
      - Can I filter the run report summaries of a storage task?
      instructions:
      - text: Show the run report summary for storage task {storageTaskName}.
        slots:
          storageTaskName: path.storageTaskName
      - text: Get run reports for storage task {storageTaskName} matching {filter}.
        slots:
          storageTaskName: path.storageTaskName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.StorageActions/locations/{location}/previewActions'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview which objects a storage task would match
      effect: read
      questions:
      - How can I test storage task conditions against sample blob metadata before running it?
      - Which objects would my storage task conditions match?
      instructions:
      - text: Preview storage task conditions {properties} in region {location}.
        slots:
          properties: requestBody.properties
          location: path.location
      - text: Dry-run these conditions against object metadata in {location}.
        slots:
          location: path.location
      method: generated
      generated: '2026-09-26'