API Evangelist conversational phrasing for RedisManagementClient Redis Resources API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for RedisManagementClient Redis Resources API
  version: 1.0.0
extends: openapi/microsoft-azure-cache-for-redis-redisresources-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: 14
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cache/redis'].get
  update:
    x-apievangelist-phrasing:
      intent: List all Redis caches in a subscription
      effect: read
      questions:
      - Which Redis caches exist across my whole Azure subscription?
      - How can I inventory every cache I run, regardless of resource group?
      instructions:
      - text: List every Redis cache in my subscription.
      - text: Show all caches across all resource groups in this subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis'].get
  update:
    x-apievangelist-phrasing:
      intent: List Redis caches in a resource group
      effect: read
      questions:
      - What Redis caches are in a specific resource group?
      - How do I see only the caches belonging to one resource group?
      instructions:
      - text: List the Redis caches in this resource group.
      - text: Show all caches deployed to the current resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Redis cache's details
      effect: read
      questions:
      - What SKU, host name and provisioning state does my Redis cache have?
      - Can I look up one cache's configuration by its name?
      instructions:
      - text: Get the details of Redis cache {name}.
        slots:
          name: path.name
      - text: Show the host name, ports and SKU for cache {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a Redis cache
      effect: write
      questions:
      - How do I provision a new Azure Cache for Redis instance?
      - Can I deploy a cache across specific availability zones?
      - Will recreating an existing cache with new settings cause downtime?
      instructions:
      - text: Create Redis cache {name} in {location} with properties {properties}.
        slots:
          name: path.name
          location: requestBody.location
          properties: requestBody.properties
      - text: Create cache {name} in {location} spread across zones {zones}.
        slots:
          name: path.name
          location: requestBody.location
          zones: requestBody.zones
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Redis cache
      effect: destructive
      questions:
      - How do I permanently delete an Azure Redis cache I no longer use?
      - Can I tear down a cache resource entirely?
      instructions:
      - text: Delete Redis cache {name}.
        slots:
          name: path.name
      - text: Tear down the cache resource named {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update settings on an existing Redis cache
      effect: write
      questions:
      - How do I scale or change settings on a cache without recreating it?
      - Can I add tags or a managed identity to an existing Redis cache?
      instructions:
      - text: Update Redis cache {name} with properties {properties}.
        slots:
          name: path.name
          properties: requestBody.properties
      - text: Set tags {tags} on existing cache {name}.
        slots:
          tags: requestBody.tags
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}/export'].post
  update:
    x-apievangelist-phrasing:
      intent: Export cache data to blob storage
      effect: write
      questions:
      - How do I back up my Redis data to a storage blob container?
      - Can I export a cache snapshot using managed identity instead of a SAS URL?
      instructions:
      - text: Export data from Redis cache {name} to container {container} with file prefix {prefix}.
        slots:
          name: path.name
          container: requestBody.container
          prefix: requestBody.prefix
      - text: Export cache {name} to {container} as {format} files named {prefix}.
        slots:
          name: path.name
          container: requestBody.container
          format: requestBody.format
          prefix: requestBody.prefix
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{cacheName}/flush'].post
  update:
    x-apievangelist-phrasing:
      intent: Flush all keys from a cache
      effect: destructive
      questions:
      - How do I wipe every key from my Redis cache at once?
      - Can I clear all cached data without deleting the cache resource?
      instructions:
      - text: Flush all keys from Redis cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Empty cache {cacheName} of all its data.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}/forceReboot'].post
  update:
    x-apievangelist-phrasing:
      intent: Force reboot Redis nodes
      effect: destructive
      questions:
      - How do I reboot the primary or replica node of my Redis cache?
      - Can I restart just one shard in a clustered cache, and could I lose data?
      instructions:
      - text: Reboot the {rebootType} of Redis cache {name}.
        slots:
          rebootType: requestBody.rebootType
          name: path.name
      - text: Force reboot shard {shardId} on clustered cache {name}.
        slots:
          shardId: requestBody.shardId
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import data files into a cache
      effect: write
      questions:
      - How do I load an RDB file from blob storage into my Redis cache?
      - Can I restore cache data from files I exported earlier?
      instructions:
      - text: Import files {files} into Redis cache {name}.
        slots:
          files: requestBody.files
          name: path.name
      - text: Restore cache {name} from {format} files {files}.
        slots:
          name: path.name
          format: requestBody.format
          files: requestBody.files
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}/listKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a cache's access keys
      effect: read
      questions:
      - Where do I get the primary and secondary access keys for my Redis cache?
      - Why does reading a cache's keys need write permission on the resource?
      instructions:
      - text: Get the access keys for Redis cache {name}.
        slots:
          name: path.name
      - text: Show the current primary and secondary keys of cache {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}/listUpgradeNotifications'].get
  update:
    x-apievangelist-phrasing:
      intent: Get upgrade notifications for a cache (deprecated)
      effect: read
      questions:
      - Have there been any recent upgrade notifications for my Redis cache?
      - Can I look back a set number of minutes for cache upgrade notices?
      instructions:
      - text: List upgrade notifications for Redis cache {name} from the last {history} minutes.
        slots:
          name: path.name
          history: query.history
      - text: Check the deprecated upgrade notice feed for cache {name} over {history} minutes.
        slots:
          name: path.name
          history: query.history
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{cacheName}/privateLinkResources'].get
  update:
    x-apievangelist-phrasing:
      intent: List private link resources for a cache
      effect: read
      questions:
      - What private link resources do I need to create before adding a private endpoint to my cache?
      - Which group IDs and DNS zone names does a cache expose for Private Link?
      instructions:
      - text: List the private link resources for Redis cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Show the Private Link group IDs cache {cacheName} supports.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}/regenerateKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a cache access key
      effect: destructive
      questions:
      - How do I rotate the primary access key on my Redis cache?
      - Can I regenerate only the secondary key so clients on the primary keep working?
      instructions:
      - text: Regenerate the {keyType} access key for Redis cache {name}.
        slots:
          keyType: requestBody.keyType
          name: path.name
      - text: Rotate cache {name}'s {keyType} key.
        slots:
          name: path.name
          keyType: requestBody.keyType
      method: generated
      generated: '2026-09-26'