# 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 MicrosoftScanningClient Managed Virtual…
  version: 1.0.0
extends: openapi/microsoft-azure-managedvirtualnetworks-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: 7
- target: $.paths['/managedvirtualnetworks/{managedVirtualNetworkName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed virtual network
      effect: read
      questions:
      - How do I look up one managed virtual network in my workspace?
      - What properties does a managed virtual network expose?
      instructions:
      - text: Get managed virtual network {managedVirtualNetworkName}.
        slots:
          managedVirtualNetworkName: path.managedVirtualNetworkName
      - text: Show the details of managed VNet {managedVirtualNetworkName}.
        slots:
          managedVirtualNetworkName: path.managedVirtualNetworkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/managedvirtualnetworks/{managedVirtualNetworkName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a managed virtual network
      effect: write
      questions:
      - How do I create a managed virtual network for my account?
      - Can I overwrite an existing managed virtual network definition?
      instructions:
      - text: Create managed virtual network {managedVirtualNetworkName}.
        slots:
          managedVirtualNetworkName: path.managedVirtualNetworkName
      - text: Create or replace managed VNet {managedVirtualNetworkName} with the supplied properties.
        slots:
          managedVirtualNetworkName: path.managedVirtualNetworkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/managedvirtualnetworks/{managedVirtualNetworkName}/managedprivateendpoints/{managedPrivateEndpointName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed private endpoint
      effect: read
      questions:
      - How can I check the status of a managed private endpoint?
      - What resource does a given managed private endpoint connect to?
      instructions:
      - text: Get managed private endpoint {managedPrivateEndpointName} in {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      - text: Show private endpoint {managedPrivateEndpointName} inside managed VNet {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/managedvirtualnetworks/{managedVirtualNetworkName}/managedprivateendpoints/{managedPrivateEndpointName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a managed private endpoint
      effect: write
      questions:
      - How do I add a managed private endpoint to reach a data store privately?
      - Can I redefine a managed private endpoint that already exists?
      instructions:
      - text: Create managed private endpoint {managedPrivateEndpointName} in {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      - text: Create or replace private endpoint {managedPrivateEndpointName} on managed VNet {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/managedvirtualnetworks/{managedVirtualNetworkName}/managedprivateendpoints/{managedPrivateEndpointName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed private endpoint
      effect: destructive
      questions:
      - How do I remove a managed private endpoint?
      - Will deleting a managed private endpoint cut off private access to the target?
      instructions:
      - text: Delete managed private endpoint {managedPrivateEndpointName} from {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      - text: Remove private endpoint {managedPrivateEndpointName} on managed VNet {managedVirtualNetworkName}.
        slots:
          managedPrivateEndpointName: path.managedPrivateEndpointName
          managedVirtualNetworkName: path.managedVirtualNetworkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/managedvirtualnetworks'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed virtual networks
      effect: read
      questions:
      - Which managed virtual networks does my account have?
      - Can I see all managed VNets at once?
      instructions:
      - text: List my managed virtual networks.
      - text: Show every managed VNet on the account using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/managedvirtualnetworks/{managedVirtualNetworkName}/managedprivateendpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed private endpoints in a network
      effect: read
      questions:
      - What managed private endpoints exist in a managed virtual network?
      - Can I list every private endpoint under one managed VNet?
      instructions:
      - text: List managed private endpoints in {managedVirtualNetworkName}.
        slots:
          managedVirtualNetworkName: path.managedVirtualNetworkName
      - text: Show all private endpoints under managed VNet {managedVirtualNetworkName}.
        slots:
          managedVirtualNetworkName: path.managedVirtualNetworkName
      method: generated
      generated: '2026-09-26'