# 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 Network…
  version: 1.0.0
extends: openapi/microsoft-azure-networksecuritygroups-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityGroups/{networkSecurityGroupName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a network security group
      effect: read
      questions:
      - What security rules are on a particular network security group?
      - Which subnets and NICs is a given NSG attached to?
      instructions:
      - text: Get network security group {nsg} in resource group {resource_group}, subscription {subscription}.
        slots:
          nsg: path.networkSecurityGroupName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the rules of NSG {nsg}.
        slots:
          nsg: path.networkSecurityGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityGroups/{networkSecurityGroupName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a network security group
      effect: write
      questions:
      - How do I create a network security group to control traffic to my VMs?
      - Can I replace the security rules of an existing NSG in one call?
      instructions:
      - text: Create network security group {nsg} in {location} in resource group {resource_group}, subscription {subscription}.
        slots:
          nsg: path.networkSecurityGroupName
          location: requestBody.location
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Update NSG {nsg} in {location} with rules {properties}.
        slots:
          nsg: path.networkSecurityGroupName
          location: requestBody.location
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityGroups/{networkSecurityGroupName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a network security group
      effect: destructive
      questions:
      - How do I delete a network security group I no longer need?
      - Can I remove an NSG from a resource group?
      instructions:
      - text: Delete network security group {nsg} in resource group {resource_group}, subscription {subscription}.
        slots:
          nsg: path.networkSecurityGroupName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove NSG {nsg}.
        slots:
          nsg: path.networkSecurityGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Network/networkSecurityGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List all network security groups in a subscription
      effect: read
      questions:
      - Which network security groups exist across my entire subscription?
      - Can I audit every NSG in all resource groups at once?
      instructions:
      - text: List all network security groups in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show every NSG across all resource groups of subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List network security groups in a resource group
      effect: read
      questions:
      - Which network security groups are in one resource group?
      - Can I list only the NSGs belonging to a specific resource group?
      instructions:
      - text: List network security groups in resource group {resource_group}, subscription {subscription}.
        slots:
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the NSGs inside {resource_group}.
        slots:
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'