Azure Data Factory · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for DataFactoryManagementClient Managed Virtual Networks API

4 actions 4 updates phrasing extends openapi/microsoft-azure-data-factory-managedvirtualnetworks-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Azure Data Factory's API. It is a proposal applied on top of the contract, not a document Azure Data Factory publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 4

$.info

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/managedVirtualNetworks'].get

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/managedVirtualNetworks/{managedVirtualNetworkName}'].get

$.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/managedVirtualNetworks/{managedVirtualNetworkName}'].put

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DataFactoryManagementClient Managed Virtual Networks API
  version: 1.0.0
extends: openapi/microsoft-azure-data-factory-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/managedVirtualNetworks'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed virtual networks in a factory
      effect: read
      questions:
      - Which managed virtual networks does my data factory have?
      - Can I list the managed VNets configured for a factory?
      instructions:
      - text: List the managed virtual networks in factory {factory}.
        slots:
          factory: path.factoryName
      - text: Show all managed VNets for {factory}.
        slots:
          factory: path.factoryName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/managedVirtualNetworks/{managedVirtualNetworkName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed virtual network
      effect: read
      questions:
      - How do I look up the details of one managed virtual network?
      - Can I fetch a managed VNet only if its ETag has changed?
      instructions:
      - text: Get managed virtual network {vnet} in factory {factory}.
        slots:
          factory: path.factoryName
          vnet: path.managedVirtualNetworkName
      - text: Fetch managed VNet {vnet} in {factory} unless it matches ETag {etag}.
        slots:
          factory: path.factoryName
          vnet: path.managedVirtualNetworkName
          etag: header.if-none-match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}/managedVirtualNetworks/{managedVirtualNetworkName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a managed virtual network
      effect: write
      questions:
      - How do I create a managed virtual network for my data factory?
      - Can I update a managed VNet's properties with an ETag check?
      instructions:
      - text: Create managed virtual network {vnet} in factory {factory} with properties {properties}.
        slots:
          factory: path.factoryName
          vnet: path.managedVirtualNetworkName
          properties: requestBody.properties
      - text: Update managed VNet {vnet} in {factory} to {properties} if its ETag is {etag}.
        slots:
          factory: path.factoryName
          vnet: path.managedVirtualNetworkName
          properties: requestBody.properties
          etag: header.if-match
      method: generated
      generated: '2026-09-26'