# 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 Firewall Rules API
  version: 1.0.0
extends: openapi/microsoft-azure-cache-for-redis-redisfirewallrules-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{cacheName}/firewallRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List a cache's firewall rules
      effect: read
      questions:
      - Which IP ranges are allowed through my Redis cache firewall?
      - How can I review every firewall rule configured on a cache?
      instructions:
      - text: List all firewall rules on Redis cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Show the allowed IP ranges for cache {cacheName}.
        slots:
          cacheName: path.cacheName
      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
      effect: read
      questions:
      - What IP range does a specific firewall rule on my cache permit?
      - Can I check the start and end address of one named firewall rule?
      instructions:
      - text: Get firewall rule {ruleName} on Redis cache {cacheName}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
      - text: Show the IP range in rule {ruleName} for cache {cacheName}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
      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: Allow an IP range through the cache firewall
      effect: write
      questions:
      - How do I allow my office IP addresses to connect to a Redis cache?
      - Can I change the IP range on an existing cache firewall rule?
      instructions:
      - text: Create firewall rule {ruleName} on Redis cache {cacheName} allowing IP range {properties}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
          properties: requestBody.properties
      - text: Update rule {ruleName} on cache {cacheName} to permit a new address range.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
      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 firewall rule
      effect: destructive
      questions:
      - How do I block an IP range I previously allowed into my Redis cache?
      - Can I remove a single firewall rule without touching the others?
      instructions:
      - text: Delete firewall rule {ruleName} from Redis cache {cacheName}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
      - text: Remove the {ruleName} IP allowance on cache {cacheName}.
        slots:
          ruleName: path.ruleName
          cacheName: path.cacheName
      method: generated
      generated: '2026-09-26'