# 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 RedisManagementClient Redis API
  version: 1.0.0
extends: openapi/microsoft-azure-redis-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: 25
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cache/CheckNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether a Redis cache name is available
      effect: read
      questions:
      - Is the Redis cache name I want already taken?
      - Can I confirm a cache name is valid before I create the cache in Azure?
      instructions:
      - text: Check if the Redis cache name {name} is free in subscription {subscriptionId}.
        slots:
          name: requestBody.name
          subscriptionId: path.subscriptionId
      - text: Validate cache name {name} with resource type {type} before provisioning.
        slots:
          name: requestBody.name
          type: requestBody.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{name}/listUpgradeNotifications'].get
  update:
    x-apievangelist-phrasing:
      intent: List upgrade notifications for a Redis cache
      effect: read
      questions:
      - Are there any pending upgrade notices for my Redis cache?
      - How far back can I look at upgrade notifications on a cache?
      instructions:
      - text: Show upgrade notifications for Redis cache {name} in resource group {resourceGroupName} from the last {history} days.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          history: query.history
      - text: List upgrade notices for cache {name} in subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the details of a Redis cache
      effect: read
      questions:
      - What SKU, host name and settings does my Redis cache have?
      - Where can I see the full resource description of one Azure Cache for Redis instance?
      instructions:
      - text: Get Redis cache {name} in resource group {resourceGroupName}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Show the configuration of cache {name} in subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      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 Redis cache in a specific region?
      - Will recreating an existing Redis cache cause downtime?
      - Can I pin a new cache to availability zones?
      instructions:
      - text: Create Redis cache {name} in {location} under resource group {resourceGroupName}.
        slots:
          name: path.name
          location: requestBody.location
          resourceGroupName: path.resourceGroupName
      - text: Provision cache {name} in subscription {subscriptionId} across zones {zones}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
          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 remove a Redis cache I no longer need?
      - Can I tear down an Azure Cache for Redis instance through the API?
      instructions:
      - text: Delete Redis cache {name} from resource group {resourceGroupName}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Remove cache {name} in subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      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:
      - Can I change a Redis cache's settings without recreating it?
      - How do I add tags to a cache that already exists?
      instructions:
      - text: Update tags on existing Redis cache {name} in resource group {resourceGroupName} to {tags}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          tags: requestBody.tags
      - text: Patch the properties of cache {name} in subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      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:
      - Which Redis caches live in this resource group?
      - What caches does one of my resource groups contain?
      instructions:
      - text: List the Redis caches in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      - text: Show every cache in group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Cache/Redis'].get
  update:
    x-apievangelist-phrasing:
      intent: List all Redis caches in a subscription
      effect: read
      questions:
      - How many Redis caches do I have across my whole subscription?
      - Can I see every cache in the subscription regardless of resource group?
      instructions:
      - text: List all Redis caches in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Inventory every cache across all resource groups of {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      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 the access keys of a Redis cache
      effect: read
      questions:
      - Where do I get the primary and secondary access keys for my Redis cache?
      - What permission do I need to read a cache's access keys?
      instructions:
      - text: Get the access keys for Redis cache {name} in resource group {resourceGroupName}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Fetch the connection keys of cache {name} in subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      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 Redis cache access key
      effect: destructive
      questions:
      - How do I rotate the access key of a Redis cache?
      - Can I regenerate only the secondary key and leave the primary alone?
      instructions:
      - text: Regenerate the {keyType} key for Redis cache {name} in resource group {resourceGroupName}.
        slots:
          keyType: requestBody.keyType
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Rotate the {keyType} access key on cache {name} in subscription {subscriptionId}.
        slots:
          keyType: requestBody.keyType
          name: path.name
          subscriptionId: path.subscriptionId
      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 a reboot of Redis cache nodes
      effect: destructive
      questions:
      - Can I reboot just one shard of my Redis cache?
      - Could force-rebooting a Redis node lose data?
      instructions:
      - text: Reboot the {rebootType} of Redis cache {name} in resource group {resourceGroupName}.
        slots:
          rebootType: requestBody.rebootType
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Force reboot shard {shardId} of cache {name} in subscription {subscriptionId}.
        slots:
          shardId: requestBody.shardId
          name: path.name
          subscriptionId: path.subscriptionId
      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 Redis cache
      effect: write
      questions:
      - How do I load an RDB file from blob storage into my Redis cache?
      - What file formats can I import into a cache?
      instructions:
      - text: Import {files} into Redis cache {name} in resource group {resourceGroupName}.
        slots:
          files: requestBody.files
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Load data from {files} in {format} format into cache {name} in subscription {subscriptionId}.
        slots:
          files: requestBody.files
          format: requestBody.format
          name: path.name
          subscriptionId: path.subscriptionId
      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 a Redis cache's data to blob storage
      effect: write
      questions:
      - Can I back up my Redis cache's data to a storage container?
      - What prefix will exported cache blobs get?
      instructions:
      - text: Export Redis cache {name} in resource group {resourceGroupName} to container {container} with prefix {prefix}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
          container: requestBody.container
          prefix: requestBody.prefix
      - text: Dump the data of cache {name} in subscription {subscriptionId} to blobs named {prefix}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
          prefix: requestBody.prefix
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{cacheName}/firewallRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List firewall rules on a Redis cache
      effect: read
      questions:
      - Which IP ranges are allowed through my Redis cache firewall?
      - What firewall rules are configured on a cache?
      instructions:
      - text: List firewall rules on Redis cache {cacheName} in resource group {resourceGroupName}.
        slots:
          cacheName: path.cacheName
          resourceGroupName: path.resourceGroupName
      - text: Show all IP allow rules for cache {cacheName} in subscription {subscriptionId}.
        slots:
          cacheName: path.cacheName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{cacheName}/firewallRules/{ruleName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one firewall rule on a Redis cache
      effect: read
      questions:
      - What IP range does a specific Redis firewall rule allow?
      - Can I look up a single cache firewall rule by its name?
      instructions:
      - text: Get firewall rule {ruleName} on Redis cache {cacheName} in resource group {resourceGroupName}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
          resourceGroupName: path.resourceGroupName
      - text: Show the IP range of rule {ruleName} for cache {cacheName} in subscription {subscriptionId}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{cacheName}/firewallRules/{ruleName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Redis cache firewall rule
      effect: write
      questions:
      - How do I allow my office IP range to reach my Redis cache?
      - Can I change the start and end IP of an existing cache firewall rule?
      instructions:
      - text: Add firewall rule {ruleName} to Redis cache {cacheName} in resource group {resourceGroupName}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
          resourceGroupName: path.resourceGroupName
      - text: Set rule {ruleName} on cache {cacheName} in subscription {subscriptionId} to allow {properties}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{cacheName}/firewallRules/{ruleName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Redis cache firewall rule
      effect: destructive
      questions:
      - How do I revoke an IP range's access to my Redis cache?
      - Can I remove a single firewall rule from a cache?
      instructions:
      - text: Delete firewall rule {ruleName} from Redis cache {cacheName} in resource group {resourceGroupName}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
          resourceGroupName: path.resourceGroupName
      - text: Remove IP rule {ruleName} on cache {cacheName} in subscription {subscriptionId}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{cacheName}/patchSchedules'].get
  update:
    x-apievangelist-phrasing:
      intent: List the patch schedules of a Redis cache
      effect: read
      questions:
      - Does my Redis cache have a maintenance patch schedule set?
      - How many patch schedules can one cache have?
      instructions:
      - text: List patch schedules for Redis cache {cacheName} in resource group {resourceGroupName}.
        slots:
          cacheName: path.cacheName
          resourceGroupName: path.resourceGroupName
      - text: Enumerate maintenance schedules on cache {cacheName} in subscription {subscriptionId}.
        slots:
          cacheName: path.cacheName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{name}/patchSchedules/{default}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the patching schedule of a Premium Redis cache
      effect: read
      questions:
      - When is my Premium Redis cache scheduled to be patched?
      - What day and hour window does the default patch schedule use?
      instructions:
      - text: Get the {default} patch schedule of Redis cache {name} in resource group {resourceGroupName}.
        slots:
          default: path.default
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Show the maintenance window for cache {name} in subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{name}/patchSchedules/{default}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the patching schedule of a Premium Redis cache
      effect: write
      questions:
      - How do I choose which weekday my Redis cache gets patched?
      - Can I move the maintenance window of a Premium cache to the weekend?
      instructions:
      - text: Set the {default} patch schedule of Redis cache {name} in resource group {resourceGroupName} to {properties}.
        slots:
          default: path.default
          name: path.name
          resourceGroupName: path.resourceGroupName
          properties: requestBody.properties
      - text: Replace the maintenance window of cache {name} in subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{name}/patchSchedules/{default}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the patching schedule of a Redis cache
      effect: destructive
      questions:
      - How do I clear a custom patch schedule from my Redis cache?
      - Can I drop the maintenance window I set on a Premium cache?
      instructions:
      - text: Delete the {default} patch schedule from Redis cache {name} in resource group {resourceGroupName}.
        slots:
          default: path.default
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Remove the maintenance window from cache {name} in subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{name}/linkedServers/{linkedServerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a linked server of a Redis cache
      effect: read
      questions:
      - What role and location does a geo-replication linked server have?
      - Can I see the details of one linked server on my Premium cache?
      instructions:
      - text: Get linked server {linkedServerName} of Redis cache {name} in resource group {resourceGroupName}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Show the geo-replication link {linkedServerName} on cache {name} in subscription {subscriptionId}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{name}/linkedServers/{linkedServerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Link a server to a Redis cache for geo-replication
      effect: write
      questions:
      - How do I set up geo-replication between two Premium Redis caches?
      - Can I add a secondary linked cache to an existing primary?
      instructions:
      - text: Link server {linkedServerName} to Redis cache {name} in resource group {resourceGroupName}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Add {linkedServerName} as a geo-replica of cache {name} in subscription {subscriptionId} with {properties}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{name}/linkedServers/{linkedServerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a linked server from a Redis cache
      effect: destructive
      questions:
      - How do I break geo-replication between two Redis caches?
      - Can I unlink a secondary server from a Premium cache?
      instructions:
      - text: Unlink server {linkedServerName} from Redis cache {name} in resource group {resourceGroupName}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Delete geo-replication link {linkedServerName} on cache {name} in subscription {subscriptionId}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/Redis/{name}/linkedServers'].get
  update:
    x-apievangelist-phrasing:
      intent: List the linked servers of a Redis cache
      effect: read
      questions:
      - Which caches are geo-replicated with my Premium Redis cache?
      - Does this cache have any linked servers at all?
      instructions:
      - text: List linked servers of Redis cache {name} in resource group {resourceGroupName}.
        slots:
          name: path.name
          resourceGroupName: path.resourceGroupName
      - text: Show all geo-replication links for cache {name} in subscription {subscriptionId}.
        slots:
          name: path.name
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'