# 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 Caches API
  version: 1.0.0
extends: openapi/microsoft-azure-caches-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: 16
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/caches'].get
  update:
    x-apievangelist-phrasing:
      intent: List caches in a subscription
      effect: read
      questions:
      - Which HPC caches do I have across my whole subscription?
      - How can I see every storage cache I have access to in Azure?
      instructions:
      - text: List all storage caches in my subscription.
      - text: Show every HPC cache I can access subscription-wide.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches'].get
  update:
    x-apievangelist-phrasing:
      intent: List caches in a resource group
      effect: read
      questions:
      - What storage caches live in one resource group?
      - Can I narrow the cache list down to a single resource group?
      instructions:
      - text: List the storage caches in my resource group.
      - text: Show HPC caches scoped to this resource group only.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cache
      effect: read
      questions:
      - What is the current state and configuration of a specific cache?
      - Where can I see one HPC cache's details by name?
      instructions:
      - text: Get cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Show the configuration and health of cache {cacheName}.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a cache
      effect: write
      questions:
      - What do I need to provision a new HPC cache with a chosen SKU and location?
      - Can I provision a storage cache with a managed identity?
      instructions:
      - text: Create cache {cacheName} in {location} with SKU {sku}.
        slots:
          cacheName: path.cacheName
          location: requestBody.location
          sku: requestBody.sku
      - text: Create or fully replace cache {cacheName}.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a cache
      effect: destructive
      questions:
      - Can I get rid of an HPC cache I no longer need?
      - Is cache deletion immediate or scheduled?
      instructions:
      - text: Delete cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Schedule storage cache {cacheName} for deletion.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a cache
      effect: write
      questions:
      - Can I change the tags on an existing cache without recreating it?
      - What settings can I patch on a running HPC cache?
      instructions:
      - text: Update the tags on existing cache {cacheName} to {tags}.
        slots:
          cacheName: path.cacheName
          tags: requestBody.tags
      - text: Patch the properties of cache {cacheName}.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/debugInfo'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate cache debug info for support
      effect: write
      questions:
      - Can I have a cache produce diagnostic data for a support case?
      - Can I tell a cache to write out debug info for Microsoft support?
      instructions:
      - text: Generate debug info on cache {cacheName} for support.
        slots:
          cacheName: path.cacheName
      - text: Have cache {cacheName} write a support diagnostics bundle.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/flush'].post
  update:
    x-apievangelist-phrasing:
      intent: Flush dirty cache data to storage
      effect: write
      questions:
      - Is there a way to push all unwritten cache data back to its storage targets?
      - Will clients see errors while a cache flush is running?
      instructions:
      - text: Flush cache {cacheName} to its storage targets.
        slots:
          cacheName: path.cacheName
      - text: Write all dirty data in cache {cacheName} back to storage.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a stopped cache
      effect: write
      questions:
      - What brings a stopped HPC cache back to active?
      - Can I restart a cache I stopped to save costs?
      instructions:
      - text: Start cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Move stopped cache {cacheName} back to the Active state.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop an active cache
      effect: write
      questions:
      - Can I shut down an HPC cache that is currently active?
      - Can I pause a cache by putting it into the Stopped state?
      instructions:
      - text: Stop cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Transition active cache {cacheName} to Stopped.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/startPrimingJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a cache priming job
      effect: write
      questions:
      - How do I pre-load files into a cache before a workload runs?
      - Does the cache have to be healthy to start a priming job?
      instructions:
      - text: Start priming job {primingJobName} on cache {cacheName} using manifest {primingManifestUrl}.
        slots:
          primingJobName: requestBody.primingJobName
          cacheName: path.cacheName
          primingManifestUrl: requestBody.primingManifestUrl
      - text: Warm cache {cacheName} with the file list at {primingManifestUrl}.
        slots:
          cacheName: path.cacheName
          primingManifestUrl: requestBody.primingManifestUrl
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/stopPrimingJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop and remove a priming job
      effect: destructive
      questions:
      - Is it possible to cancel a cache priming job entirely?
      - Can I delete a priming job I no longer want to run?
      instructions:
      - text: Stop priming job {primingJobId} on cache {cacheName}.
        slots:
          primingJobId: requestBody.primingJobId
          cacheName: path.cacheName
      - text: Cancel and delete priming job {primingJobId} for cache {cacheName}.
        slots:
          primingJobId: requestBody.primingJobId
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/pausePrimingJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause a priming job
      effect: write
      questions:
      - Can I temporarily pause a priming job without cancelling it?
      - What happens to a cache priming job while it is paused?
      instructions:
      - text: Pause priming job {primingJobId} on cache {cacheName}.
        slots:
          primingJobId: requestBody.primingJobId
          cacheName: path.cacheName
      - text: Put cache {cacheName}'s priming job {primingJobId} on hold.
        slots:
          cacheName: path.cacheName
          primingJobId: requestBody.primingJobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/resumePrimingJob'].post
  update:
    x-apievangelist-phrasing:
      intent: Resume a paused priming job
      effect: write
      questions:
      - Can I continue a priming job I paused earlier?
      - Can a paused cache warm-up job pick up where it left off?
      instructions:
      - text: Resume priming job {primingJobId} on cache {cacheName}.
        slots:
          primingJobId: requestBody.primingJobId
          cacheName: path.cacheName
      - text: Continue the paused warm-up job {primingJobId} for cache {cacheName}.
        slots:
          primingJobId: requestBody.primingJobId
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/upgrade'].post
  update:
    x-apievangelist-phrasing:
      intent: Upgrade cache firmware
      effect: write
      questions:
      - Is there a firmware update I can apply to my HPC cache?
      - What happens if I request a firmware upgrade when none is available?
      instructions:
      - text: Upgrade the firmware on cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Apply any pending firmware update to cache {cacheName}.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.StorageCache/caches/{cacheName}/spaceAllocation'].post
  update:
    x-apievangelist-phrasing:
      intent: Update cache space allocation
      effect: write
      questions:
      - Can I change how cache space is divided among storage targets?
      - Which call rebalances space allocation on an HPC cache?
      instructions:
      - text: Update the space allocation for cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Rebalance storage target space on cache {cacheName}.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'