# 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 Private Link Resource API
  version: 1.0.0
extends: openapi/microsoft-azure-privatelinkresource-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.Batch/batchAccounts/{accountName}/privateLinkResources'].get
  update:
    x-apievangelist-phrasing:
      intent: List private link resources of a Batch account
      effect: read
      questions:
      - Which private link resources does my Batch account expose for private endpoints?
      - Can I cap the number of private link resources returned for a Batch account?
      instructions:
      - text: List private link resources for Batch account {account} in resource group {resource_group}, subscription {subscription}.
        slots:
          account: path.accountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show up to {max} private link resources on Batch account {account}.
        slots:
          max: query.maxresults
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/privateLinkResources/{privateLinkResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a private link resource of a Batch account
      effect: read
      questions:
      - What group ID and required members does a Batch account private link resource have?
      - Can I look up one private link resource on my Batch account by name?
      instructions:
      - text: Get private link resource {resource} on Batch account {account} in resource group {resource_group}, subscription {subscription}.
        slots:
          resource: path.privateLinkResourceName
          account: path.accountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show Batch private link resource {resource} for account {account}.
        slots:
          resource: path.privateLinkResourceName
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName}/privateLinkResources'].get
  update:
    x-apievangelist-phrasing:
      intent: List privately linkable resources of a Purview account
      effect: read
      questions:
      - Which privately linkable resources does my Purview account offer?
      - What sub-resources can I target with a private endpoint on a Purview account?
      instructions:
      - text: List privately linkable resources for Purview account {account} in resource group {resource_group}, subscription {subscription}.
        slots:
          account: path.accountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the private endpoint targets on Purview account {account}.
        slots:
          account: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName}/privateLinkResources/{groupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Purview linkable resource by group ID
      effect: read
      questions:
      - What does the privately linkable resource for a given group ID look like on Purview?
      - Can I fetch one Purview private link resource using its group identifier?
      instructions:
      - text: Get the privately linkable resource with group ID {group_id} on Purview account {account} in resource group {resource_group}, subscription {subscription}.
        slots:
          group_id: path.groupId
          account: path.accountName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show Purview account {account} linkable resource for group {group_id}.
        slots:
          account: path.accountName
          group_id: path.groupId
      method: generated
      generated: '2026-09-26'