# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for RedisManagementClient Linked Server API
  version: 1.0.0
extends: openapi/microsoft-azure-cache-for-redis-linkedserver-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/{name}/linkedServers'].get
  update:
    x-apievangelist-phrasing:
      intent: List a cache's linked geo-replication servers
      effect: read
      questions:
      - Which linked servers are attached to my Premium Redis cache?
      - How can I see every geo-replication link a cache currently has?
      instructions:
      - text: List all linked servers on Redis cache {name}.
        slots:
          name: path.name
      - text: Show me the geo-replication links configured for cache {name}.
        slots:
          name: path.name
      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 details of one linked server
      effect: read
      questions:
      - What are the details of a specific linked server on my Redis cache?
      - Can I check the role and status of one geo-replication link by its name?
      instructions:
      - text: Get linked server {linkedServerName} on Redis cache {name}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
      - text: Show the properties of the {linkedServerName} link for cache {name}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
      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 by linking a second Premium Redis cache?
      - Can I add a linked server to an Azure Cache for Redis instance?
      instructions:
      - text: Add linked server {linkedServerName} to Redis cache {name}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
      - text: 'Link cache {name} to another cache as {linkedServerName} using these link settings: {properties}.'
        slots:
          name: path.name
          linkedServerName: path.linkedServerName
          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 a geo-replication link between two Redis caches?
      - What happens when I unlink a secondary server from my Premium cache?
      instructions:
      - text: Remove linked server {linkedServerName} from Redis cache {name}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
      - text: Unlink {linkedServerName} and stop geo-replication for cache {name}.
        slots:
          linkedServerName: path.linkedServerName
          name: path.name
      method: generated
      generated: '2026-09-26'