# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for RedisManagementClient Private Endpoint Connections API
  version: 1.0.0
extends: openapi/microsoft-azure-cache-for-redis-private-endpoint-connections-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-02'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{cacheName}/privateEndpointConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List a cache's private endpoint connections
      effect: read
      questions:
      - Which private endpoints are connected to my Redis cache?
      - How can I see all pending and approved private endpoint connections for a cache?
      instructions:
      - text: List all private endpoint connections on Redis cache {cacheName}.
        slots:
          cacheName: path.cacheName
      - text: Show every private endpoint connected to cache {cacheName} with its state.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-10-02'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{cacheName}/privateEndpointConnections/{privateEndpointConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one private endpoint connection
      effect: read
      questions:
      - What is the approval state of a specific private endpoint connection on my cache?
      - Can I look up the details of a single private endpoint connection by name?
      instructions:
      - text: Get private endpoint connection {privateEndpointConnectionName} on Redis cache {cacheName}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          cacheName: path.cacheName
      - text: Show the connection state of one private endpoint attached to cache {cacheName}.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-10-02'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{cacheName}/privateEndpointConnections/{privateEndpointConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject a private endpoint connection
      effect: write
      questions:
      - How do I approve a pending private endpoint connection to my Redis cache?
      - Can I change the state of an existing private endpoint connection to rejected?
      instructions:
      - text: Approve pending private endpoint connection {privateEndpointConnectionName} on Redis cache {cacheName}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          cacheName: path.cacheName
      - text: Update the connection state of a private endpoint on cache {cacheName}.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-10-02'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{cacheName}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a private endpoint connection
      effect: destructive
      questions:
      - How do I remove a private endpoint connection from my Redis cache?
      - Can I disconnect a private endpoint that should no longer reach the cache?
      instructions:
      - text: Delete private endpoint connection {privateEndpointConnectionName} from Redis cache {cacheName}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          cacheName: path.cacheName
      - text: Disconnect the named private endpoint from cache {cacheName}.
        slots:
          cacheName: path.cacheName
      method: generated
      generated: '2026-10-02'