# 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 Storage Cache Mgmt Client Storage Targets…
  version: 1.0.0
extends: openapi/microsoft-azure-storagetargets-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/storageTargets/{storageTargetName}/dnsRefresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh DNS for a cache storage target
      effect: write
      questions:
      - Can I make a storage target pick up new DNS information for its backend?
      - What triggers a DNS refresh on an HPC Cache storage target?
      instructions:
      - text: Refresh DNS for storage target {storageTargetName} on cache {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      - text: Tell storage target {storageTargetName} in {cacheName} to re-resolve its DNS.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/storageTargets'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage targets attached to a cache
      effect: read
      questions:
      - Which storage targets are attached to my cache?
      - How do I see all backend storage targets for one cache?
      instructions:
      - text: List storage targets for cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Show every backend storage target configured on {cacheName}.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/storageTargets/{storageTargetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one storage target from a cache
      effect: read
      questions:
      - What are the settings of a specific storage target on my cache?
      - Can I check the state of one named storage target?
      instructions:
      - text: Get storage target {storageTargetName} from cache {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      - text: Show the configuration of storage target {storageTargetName} on {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/storageTargets/{storageTargetName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a cache storage target
      effect: write
      questions:
      - How do I add a new backend storage target to my cache?
      - What happens if I update a storage target while the cache is unhealthy?
      instructions:
      - text: Create storage target {storageTargetName} on cache {cacheName} with properties {properties}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
          properties: requestBody.properties
      - text: Update storage target {storageTargetName} on {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/storageTargets/{storageTargetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a storage target from a cache
      effect: destructive
      questions:
      - Can I remove a storage target without losing data that still needs flushing?
      - Is there a force option to delete a storage target immediately?
      instructions:
      - text: Remove storage target {storageTargetName} from cache {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      - text: Force-delete storage target {storageTargetName} on {cacheName} with force {force}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/storageTargets/{storageTargetName}/flush'].post
  update:
    x-apievangelist-phrasing:
      intent: Flush dirty cache data to a storage target
      effect: write
      questions:
      - How do I force the cache to write all pending changes back to backend storage?
      - Will clients get errors while a storage target flush is running?
      instructions:
      - text: Flush all dirty data for storage target {storageTargetName} on cache {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      - text: Write cached changes back to backend storage for {storageTargetName} in {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/storageTargets/{storageTargetName}/suspend'].post
  update:
    x-apievangelist-phrasing:
      intent: Suspend client access to a storage target
      effect: write
      questions:
      - Can I temporarily block client access to one storage target?
      - What pauses traffic to a storage target without deleting it?
      instructions:
      - text: Suspend storage target {storageTargetName} on cache {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      - text: Pause client access to {storageTargetName} in {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/storageTargets/{storageTargetName}/resume'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume a suspended storage target
      effect: write
      questions:
      - How do I bring a suspended storage target back online for clients?
      - Can I re-enable client access after suspending a storage target?
      instructions:
      - text: Resume storage target {storageTargetName} on cache {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      - text: Restore client access to the suspended target {storageTargetName} in {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/storageTargets/{storageTargetName}/invalidate'].post
  update:
    x-apievangelist-phrasing:
      intent: Discard all cached data for a storage target
      effect: destructive
      questions:
      - Can I throw away stale cached files so they are refetched from the backend?
      - What does invalidating a storage target do to the cached data?
      instructions:
      - text: Invalidate all cached data for storage target {storageTargetName} on cache {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      - text: Drop cached files for {storageTargetName} in {cacheName} so they reload from the back end.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/storageTargets/{storageTargetName}/restoreDefaults'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a storage target's default settings
      effect: write
      questions:
      - Can I reset a storage target's settings back to their defaults?
      - Is there a way to undo custom settings on one storage target?
      instructions:
      - text: Restore default settings on storage target {storageTargetName} in cache {cacheName}.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      - text: Reset {storageTargetName} on {cacheName} to its default configuration.
        slots:
          storageTargetName: path.storageTargetName
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'