# 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 PrivateLinkServicesForPowerBIClient Power…
  version: 1.0.0
extends: openapi/microsoft-azure-powerbiresources-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.PowerBI/privateLinkServicesForPowerBI/{azureResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Power BI private link service resources
      effect: read
      questions:
      - How do I see the Power BI private link service configured for my Azure resource?
      - Which private link resources exist for Power BI under a given resource name?
      instructions:
      - text: Get the Power BI private link resources for {azureResourceName} in {resourceGroupName} (subscription {subscriptionId}).
        slots:
          azureResourceName: path.azureResourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show Power BI private link service {azureResourceName} in resource group {resourceGroupName}.
        slots:
          azureResourceName: path.azureResourceName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBI/privateLinkServicesForPowerBI/{azureResourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Power BI private link service
      effect: write
      questions:
      - How do I set up a private link service so Power BI traffic stays off the public internet?
      - Can I tie a Power BI private link resource to a specific tenant ID?
      instructions:
      - text: Create Power BI private link service {azureResourceName} in {resourceGroupName} (subscription {subscriptionId}).
        slots:
          azureResourceName: path.azureResourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Create private link service {azureResourceName} for Power BI in {location} for tenant {tenantId}.
        slots:
          azureResourceName: path.azureResourceName
          location: requestBody.location
          tenantId: header.x-ms-client-tenant-id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBI/privateLinkServicesForPowerBI/{azureResourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Power BI private link service
      effect: destructive
      questions:
      - How do I remove a Power BI private link service resource?
      - Will deleting the Power BI private link service break private access to reports?
      instructions:
      - text: Delete Power BI private link service {azureResourceName} in {resourceGroupName} (subscription {subscriptionId}).
        slots:
          azureResourceName: path.azureResourceName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the Power BI private link resource {azureResourceName} from {resourceGroupName}.
        slots:
          azureResourceName: path.azureResourceName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerBI/privateLinkServicesForPowerBI/{azureResourceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Power BI private link service
      effect: write
      questions:
      - Can I change tags on an existing Power BI private link service?
      - How do I patch the settings of a Power BI private link resource already deployed?
      instructions:
      - text: Update tags on Power BI private link service {azureResourceName} to {tags} in {resourceGroupName} (subscription {subscriptionId}).
        slots:
          azureResourceName: path.azureResourceName
          tags: requestBody.tags
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Patch existing Power BI private link {azureResourceName} in {resourceGroupName} with {properties}.
        slots:
          azureResourceName: path.azureResourceName
          resourceGroupName: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'