# 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 Endpoint Connection Controller API
  version: 1.0.0
extends: openapi/microsoft-azure-privateendpointconnectioncontroller-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.OffAzure/masterSites/{siteName}/privateEndpointConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List private endpoint connections on a master site
      effect: read
      questions:
      - Which private endpoint connections are attached to my Azure Migrate master site?
      - Can I see all private links on an OffAzure master site at once?
      instructions:
      - text: List private endpoint connections on master site {siteName}.
        slots:
          siteName: path.siteName
      - text: Show every private link connection for master site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/privateEndpointConnections/{peConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a master site private endpoint connection
      effect: read
      questions:
      - What is the approval state of a private endpoint connection on my master site?
      - Can I inspect one private link connection on an OffAzure master site by name?
      instructions:
      - text: Get private endpoint connection {peConnectionName} on master site {siteName}.
        slots:
          peConnectionName: path.peConnectionName
          siteName: path.siteName
      - text: Show master site {siteName} private link {peConnectionName}.
        slots:
          siteName: path.siteName
          peConnectionName: path.peConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/privateEndpointConnections/{peConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a master site private endpoint connection
      effect: write
      questions:
      - How do I approve or set up a private endpoint connection on my Azure Migrate master site?
      - Can I change the connection state of a master site private link?
      instructions:
      - text: Create private endpoint connection {peConnectionName} on master site {siteName}.
        slots:
          peConnectionName: path.peConnectionName
          siteName: path.siteName
      - text: Set master site {siteName} connection {peConnectionName} to properties {properties}.
        slots:
          siteName: path.siteName
          peConnectionName: path.peConnectionName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/privateEndpointConnections/{peConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a master site private endpoint connection
      effect: destructive
      questions:
      - Can I remove a private endpoint connection from my Azure Migrate master site?
      - How do I disconnect a private link from an OffAzure master site?
      instructions:
      - text: Delete private endpoint connection {peConnectionName} from master site {siteName}.
        slots:
          peConnectionName: path.peConnectionName
          siteName: path.siteName
      - text: Remove master site {siteName} private link {peConnectionName}.
        slots:
          siteName: path.siteName
          peConnectionName: path.peConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/migrateProjects/{migrateProjectName}/privateEndpointConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List private endpoint connections on a migrate project
      effect: read
      questions:
      - Which private endpoint connections exist under my Azure Migrate project?
      - Can I list all private links for a migrate project in one call?
      instructions:
      - text: List private endpoint connections for migrate project {migrateProjectName}.
        slots:
          migrateProjectName: path.migrateProjectName
      - text: Show every private link on migrate project {migrateProjectName}.
        slots:
          migrateProjectName: path.migrateProjectName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/migrateProjects/{migrateProjectName}/privateEndpointConnections/{peConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a migrate project private endpoint connection
      effect: read
      questions:
      - What does one private endpoint connection on my migrate project look like?
      - Can I check the status of a named private link on an Azure Migrate project?
      instructions:
      - text: Get private endpoint connection {peConnectionName} on migrate project {migrateProjectName}.
        slots:
          peConnectionName: path.peConnectionName
          migrateProjectName: path.migrateProjectName
      - text: Show migrate project {migrateProjectName} private link {peConnectionName}.
        slots:
          migrateProjectName: path.migrateProjectName
          peConnectionName: path.peConnectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/migrateProjects/{migrateProjectName}/privateEndpointConnections/{peConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a migrate project private endpoint
      effect: write
      questions:
      - How do I add or update a private endpoint connection on my Azure Migrate project?
      - Does creating a migrate project private endpoint overwrite one with the same name?
      instructions:
      - text: Create or update private endpoint connection {peConnectionName} on migrate project {migrateProjectName}.
        slots:
          peConnectionName: path.peConnectionName
          migrateProjectName: path.migrateProjectName
      - text: Update migrate project {migrateProjectName} connection {peConnectionName} with properties {properties}.
        slots:
          migrateProjectName: path.migrateProjectName
          peConnectionName: path.peConnectionName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/migrateProjects/{migrateProjectName}/privateEndpointConnections/{peConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a migrate project private endpoint
      effect: destructive
      questions:
      - Can I delete a private endpoint from my Azure Migrate project?
      - What happens if I delete a migrate project private endpoint that does not exist?
      instructions:
      - text: Delete private endpoint connection {peConnectionName} from migrate project {migrateProjectName}.
        slots:
          peConnectionName: path.peConnectionName
          migrateProjectName: path.migrateProjectName
      - text: Remove migrate project {migrateProjectName} private link {peConnectionName}.
        slots:
          migrateProjectName: path.migrateProjectName
          peConnectionName: path.peConnectionName
      method: generated
      generated: '2026-09-26'