# 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 NetworkResourceProviderClient Subnets API
  version: 1.0.0
extends: openapi/microsoft-azure-subnets-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.Network/virtualnetworks/{virtualNetworkName}/subnets/{subnetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a subnet in a virtual network
      effect: read
      questions:
      - What address prefix and settings does a particular subnet have?
      - Can I look up one subnet of a virtual network by name?
      instructions:
      - text: Get subnet {subnetName} in vnet {virtualNetworkName}, resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          subnetName: path.subnetName
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show details of subnet {subnetName} on {virtualNetworkName}.
        slots:
          subnetName: path.subnetName
          virtualNetworkName: path.virtualNetworkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualnetworks/{virtualNetworkName}/subnets/{subnetName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a subnet
      effect: write
      questions:
      - How do I add a new subnet to an existing virtual network?
      - Can I change the properties of a subnet that's already there?
      instructions:
      - text: Create subnet {subnetName} in vnet {virtualNetworkName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          subnetName: path.subnetName
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Update subnet {subnetName} of {virtualNetworkName} with properties {properties}.
        slots:
          subnetName: path.subnetName
          virtualNetworkName: path.virtualNetworkName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualnetworks/{virtualNetworkName}/subnets/{subnetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a subnet
      effect: destructive
      questions:
      - Can I remove a subnet from a virtual network?
      - What deletes an unused subnet?
      instructions:
      - text: Delete subnet {subnetName} from vnet {virtualNetworkName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          subnetName: path.subnetName
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove subnet {subnetName} off {virtualNetworkName}.
        slots:
          subnetName: path.subnetName
          virtualNetworkName: path.virtualNetworkName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualnetworks/{virtualNetworkName}/subnets'].get
  update:
    x-apievangelist-phrasing:
      intent: List subnets in a virtual network
      effect: read
      questions:
      - Which subnets does my virtual network have?
      - Can I list every subnet carved out of one vnet?
      instructions:
      - text: List subnets in vnet {virtualNetworkName}, group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          virtualNetworkName: path.virtualNetworkName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Enumerate all subnets of virtual network {virtualNetworkName}.
        slots:
          virtualNetworkName: path.virtualNetworkName
      method: generated
      generated: '2026-09-26'