# 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 API
  version: 1.0.0
extends: openapi/microsoft-azure-private-link-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 16
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/workspaces/{workspaceName}/privateEndpointConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List private endpoint connections on a desktop workspace
      effect: read
      questions:
      - Which private endpoint connections are attached to my Azure Virtual Desktop workspace?
      - Can I see every private endpoint linked to an AVD workspace?
      instructions:
      - text: List the private endpoint connections on Virtual Desktop workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Show all private endpoints connected to AVD workspace {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a private endpoint connection on a desktop workspace
      effect: read
      questions:
      - How do I check the approval state of one private endpoint connection on my AVD workspace?
      - What details does a single workspace private endpoint connection return?
      instructions:
      - text: Get private endpoint connection {connection} on Virtual Desktop workspace {workspace}.
        slots:
          connection: path.privateEndpointConnectionName
          workspace: path.workspaceName
      - text: Check the status of a specific private endpoint on AVD workspace {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject a workspace private endpoint
      effect: write
      questions:
      - How do I approve a pending private endpoint request on my Virtual Desktop workspace?
      - Can I reject a private endpoint connection someone opened to my AVD workspace?
      instructions:
      - text: Approve pending private endpoint connection {connection} on Virtual Desktop workspace {workspace}.
        slots:
          connection: path.privateEndpointConnectionName
          workspace: path.workspaceName
      - text: Reject a private endpoint request against AVD workspace {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a private endpoint connection from a workspace
      effect: destructive
      questions:
      - How do I remove a private endpoint connection from an Azure Virtual Desktop workspace?
      - Can I disconnect a private endpoint from my AVD workspace for good?
      instructions:
      - text: Remove private endpoint connection {connection} from Virtual Desktop workspace {workspace}.
        slots:
          connection: path.privateEndpointConnectionName
          workspace: path.workspaceName
      - text: Disconnect and delete the private endpoint on AVD workspace {workspace}.
        slots:
          workspace: path.workspaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/workspaces/{workspaceName}/privateLinkResources'].get
  update:
    x-apievangelist-phrasing:
      intent: List private link resources for a desktop workspace
      effect: read
      questions:
      - What private link resources (group IDs) can I target on my AVD workspace?
      - Can I page through a workspace's private link resources in descending order?
      instructions:
      - text: List the private link resources available for Virtual Desktop workspace {workspace}.
        slots:
          workspace: path.workspaceName
      - text: Show {page_size} private link sub-resources per page for AVD workspace {workspace}.
        slots:
          page_size: query.pageSize
          workspace: path.workspaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/privateLinkResources'].get
  update:
    x-apievangelist-phrasing:
      intent: List private link resources for a host pool
      effect: read
      questions:
      - What private link resources can I connect to on my Azure Virtual Desktop host pool?
      - Which sub-resources does a host pool expose for Private Link?
      instructions:
      - text: List the private link resources available for host pool {host_pool}.
        slots:
          host_pool: path.hostPoolName
      - text: Show host pool {host_pool} Private Link sub-resources, skipping the first {skip}.
        slots:
          host_pool: path.hostPoolName
          skip: query.initialSkip
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/privateEndpointConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List private endpoint connections on a host pool
      effect: read
      questions:
      - Which private endpoints are connected to my AVD host pool?
      - Can I list host pool private endpoint connections a page at a time?
      instructions:
      - text: List the private endpoint connections on host pool {host_pool}.
        slots:
          host_pool: path.hostPoolName
      - text: Show {page_size} private endpoint connections per page for AVD host pool {host_pool}.
        slots:
          page_size: query.pageSize
          host_pool: path.hostPoolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/privateEndpointConnections/{privateEndpointConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a private endpoint connection on a host pool
      effect: read
      questions:
      - How do I check whether a private endpoint on my host pool was approved?
      - What does one host pool private endpoint connection look like?
      instructions:
      - text: Get private endpoint connection {connection} on host pool {host_pool}.
        slots:
          connection: path.privateEndpointConnectionName
          host_pool: path.hostPoolName
      - text: Check the approval status of a private endpoint on AVD host pool {host_pool}.
        slots:
          host_pool: path.hostPoolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/privateEndpointConnections/{privateEndpointConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject a host pool private endpoint
      effect: write
      questions:
      - How do I approve a private endpoint request against my Virtual Desktop host pool?
      - Can I reject a pending private endpoint on a host pool?
      instructions:
      - text: Approve pending private endpoint connection {connection} on host pool {host_pool}.
        slots:
          connection: path.privateEndpointConnectionName
          host_pool: path.hostPoolName
      - text: Reject the private endpoint request made to AVD host pool {host_pool}.
        slots:
          host_pool: path.hostPoolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a private endpoint connection from a host pool
      effect: destructive
      questions:
      - How do I remove a private endpoint from an Azure Virtual Desktop host pool?
      - Can I permanently disconnect a host pool private endpoint?
      instructions:
      - text: Remove private endpoint connection {connection} from host pool {host_pool}.
        slots:
          connection: path.privateEndpointConnectionName
          host_pool: path.hostPoolName
      - text: Delete the private endpoint attached to AVD host pool {host_pool}.
        slots:
          host_pool: path.hostPoolName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces/{namespaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Notification Hubs private endpoint connection
      effect: read
      questions:
      - How do I look up a private endpoint connection on my Notification Hubs namespace?
      - What is the state of a given private endpoint on a Notification Hubs namespace?
      instructions:
      - text: Get private endpoint connection {connection} on Notification Hubs namespace {namespace}.
        slots:
          connection: path.privateEndpointConnectionName
          namespace: path.namespaceName
      - text: Show the status of endpoint connection {connection} for namespace {namespace}.
        slots:
          connection: path.privateEndpointConnectionName
          namespace: path.namespaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces/{namespaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Notification Hubs private endpoint connection
      effect: write
      questions:
      - How do I approve or reject a private endpoint on a Notification Hubs namespace?
      - Can I change the connection state of a notification namespace private endpoint?
      instructions:
      - text: Update private endpoint connection {connection} on Notification Hubs namespace {namespace} with {properties}.
        slots:
          connection: path.privateEndpointConnectionName
          namespace: path.namespaceName
          properties: requestBody.properties
      - text: Approve endpoint connection {connection} on notification namespace {namespace}.
        slots:
          connection: path.privateEndpointConnectionName
          namespace: path.namespaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces/{namespaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Notification Hubs private endpoint connection
      effect: destructive
      questions:
      - How do I delete a private endpoint connection from a Notification Hubs namespace?
      - Can I cut off a private endpoint's access to my notification namespace?
      instructions:
      - text: Delete private endpoint connection {connection} from Notification Hubs namespace {namespace}.
        slots:
          connection: path.privateEndpointConnectionName
          namespace: path.namespaceName
      - text: Remove endpoint connection {connection} on notification namespace {namespace}.
        slots:
          connection: path.privateEndpointConnectionName
          namespace: path.namespaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces/{namespaceName}/privateEndpointConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List private endpoints on a Notification Hubs namespace
      effect: read
      questions:
      - Which private endpoints are connected to my Notification Hubs namespace?
      - Can I see all pending and approved endpoint connections for a notification namespace?
      instructions:
      - text: List all private endpoint connections on Notification Hubs namespace {namespace}.
        slots:
          namespace: path.namespaceName
      - text: Show every endpoint connection for notification namespace {namespace}.
        slots:
          namespace: path.namespaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces/{namespaceName}/privateLinkResources/{subResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Notification Hubs private link sub-resource
      effect: read
      questions:
      - How do I get the group ID details of one private link sub-resource on a Notification Hubs namespace?
      - What DNS zone and required members does a notification namespace sub-resource have?
      instructions:
      - text: Get private link sub-resource {sub_resource} for Notification Hubs namespace {namespace}.
        slots:
          sub_resource: path.subResourceName
          namespace: path.namespaceName
      - text: Show the group ID info for {sub_resource} on notification namespace {namespace}.
        slots:
          sub_resource: path.subResourceName
          namespace: path.namespaceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces/{namespaceName}/privateLinkResources'].get
  update:
    x-apievangelist-phrasing:
      intent: List Notification Hubs private link group IDs
      effect: read
      questions:
      - Which private link group IDs can I target on my Notification Hubs namespace?
      - What sub-resources does a notification namespace offer for Private Link?
      instructions:
      - text: List the private link resources (group IDs) for Notification Hubs namespace {namespace}.
        slots:
          namespace: path.namespaceName
      - text: Show available Private Link sub-resources on notification namespace {namespace}.
        slots:
          namespace: path.namespaceName
      method: generated
      generated: '2026-10-01'