# 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 Shared Private Link Resources API
  version: 1.0.0
extends: openapi/microsoft-azure-sharedprivatelinkresources-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}/sharedPrivateLinkResources'].get
  update:
    x-apievangelist-phrasing:
      intent: List shared private links of a database watcher
      effect: read
      questions:
      - Which shared private link resources has my database watcher set up?
      - How can I see the private links a Database Watcher uses to reach its targets?
      instructions:
      - text: List shared private link resources for database watcher {watcher}.
        slots:
          watcher: path.watcherName
      - text: Show the private links configured on watcher {watcher}.
        slots:
          watcher: path.watcherName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a database watcher's shared private link
      effect: read
      questions:
      - What is the status of one shared private link on my database watcher?
      - Has a watcher's shared private link been approved yet?
      instructions:
      - text: Show shared private link {link} on database watcher {watcher}.
        slots:
          link: path.sharedPrivateLinkResourceName
          watcher: path.watcherName
      - text: Check the approval state of watcher {watcher}'s private link {link}.
        slots:
          watcher: path.watcherName
          link: path.sharedPrivateLinkResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a shared private link for a database watcher
      effect: write
      questions:
      - How do I let a database watcher reach a SQL target over a private link?
      - Can I add a shared private link resource to my watcher?
      instructions:
      - text: Create shared private link {link} on database watcher {watcher} with properties {properties}.
        slots:
          link: path.sharedPrivateLinkResourceName
          watcher: path.watcherName
          properties: requestBody.properties
      - text: Add a private link named {link} to watcher {watcher}.
        slots:
          link: path.sharedPrivateLinkResourceName
          watcher: path.watcherName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DatabaseWatcher/watchers/{watcherName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a database watcher's shared private link
      effect: destructive
      questions:
      - How do I remove a shared private link from my database watcher?
      - Can I drop a watcher's private connection to a monitored target?
      instructions:
      - text: Delete shared private link {link} from database watcher {watcher}.
        slots:
          link: path.sharedPrivateLinkResourceName
          watcher: path.watcherName
      - text: Remove watcher {watcher}'s private link {link}.
        slots:
          watcher: path.watcherName
          link: path.sharedPrivateLinkResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a search service's shared private link
      effect: read
      questions:
      - What are the details of a shared private link managed by my Azure AI Search service?
      - Is the private link from my search service to a data source provisioned?
      instructions:
      - text: Show shared private link {link} on search service {search_service} in {resource_group}, subscription {subscription_id}.
        slots:
          link: path.sharedPrivateLinkResourceName
          search_service: path.searchServiceName
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
      - text: Get search service {search_service}'s private link {link}.
        slots:
          search_service: path.searchServiceName
          link: path.sharedPrivateLinkResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a search service shared private link
      effect: write
      questions:
      - How do I let my search service index a storage account over a private endpoint?
      - Can I update a shared private link used by my search indexers?
      instructions:
      - text: Create shared private link {link} on search service {search_service} in {resource_group}, subscription {subscription_id} with {properties}.
        slots:
          link: path.sharedPrivateLinkResourceName
          search_service: path.searchServiceName
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
          properties: requestBody.properties
      - text: Update search service {search_service}'s private link {link} to {properties}.
        slots:
          search_service: path.searchServiceName
          link: path.sharedPrivateLinkResourceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a search service shared private link
      effect: destructive
      questions:
      - How do I remove a shared private link from my search service?
      - Can I stop my search service reaching a data source privately?
      instructions:
      - text: Delete shared private link {link} from search service {search_service} in {resource_group}, subscription {subscription_id}.
        slots:
          link: path.sharedPrivateLinkResourceName
          search_service: path.searchServiceName
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
      - text: Remove the private link {link} managed by search service {search_service}.
        slots:
          link: path.sharedPrivateLinkResourceName
          search_service: path.searchServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources'].get
  update:
    x-apievangelist-phrasing:
      intent: List a search service's shared private links
      effect: read
      questions:
      - Which shared private links does my search service manage?
      - Can I list all private connections my search indexers use?
      instructions:
      - text: List shared private links on search service {search_service} in {resource_group}, subscription {subscription_id}.
        slots:
          search_service: path.searchServiceName
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
      - text: Show every private link managed by search service {search_service}.
        slots:
          search_service: path.searchServiceName
      method: generated
      generated: '2026-09-26'