# 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 Azure Machine Learning Services Workspace…
  version: 1.0.0
extends: openapi/microsoft-azure-workspaceprivateendpointconnections-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.MachineLearningServices/workspaces/{workspaceName}/privateEndpointConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List private endpoint connections on an ML workspace
      effect: read
      questions:
      - Which private endpoints are connected to my Azure Machine Learning workspace?
      - How can I see pending private endpoint connection requests for a workspace?
      instructions:
      - text: List private endpoint connections on workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      - text: Show every private link connection to ML workspace {workspaceName}.
        slots:
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a private endpoint connection on an ML workspace
      effect: read
      questions:
      - How do I check whether a specific private endpoint connection was approved?
      - What state is one private link connection to my workspace in?
      instructions:
      - text: Get private endpoint connection {connection} on workspace {workspaceName}.
        slots:
          connection: path.privateEndpointConnectionName
          workspaceName: path.workspaceName
      - text: Show the approval status of connection {connection} to ML workspace {workspaceName}.
        slots:
          connection: path.privateEndpointConnectionName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject a workspace private endpoint connection
      effect: write
      questions:
      - How do I approve a pending private endpoint request on my ML workspace?
      - Can I reject a private endpoint connection someone requested to my workspace?
      instructions:
      - text: Approve private endpoint connection {connection} on workspace {workspaceName}.
        slots:
          connection: path.privateEndpointConnectionName
          workspaceName: path.workspaceName
      - text: Reject connection {connection} to ML workspace {workspaceName} by setting its state in {properties}.
        slots:
          connection: path.privateEndpointConnectionName
          workspaceName: path.workspaceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a workspace private endpoint connection
      effect: destructive
      questions:
      - How do I remove a private endpoint connection from my ML workspace?
      - Can I disconnect a private link from a workspace entirely?
      instructions:
      - text: Delete private endpoint connection {connection} from workspace {workspaceName}.
        slots:
          connection: path.privateEndpointConnectionName
          workspaceName: path.workspaceName
      - text: Disconnect private link {connection} from ML workspace {workspaceName}.
        slots:
          connection: path.privateEndpointConnectionName
          workspaceName: path.workspaceName
      method: generated
      generated: '2026-09-26'