# 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 NetworkSecurityPerimeter Nsp Profiles API
  version: 1.0.0
extends: openapi/microsoft-azure-nspprofiles-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/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles/{profileName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a network security perimeter profile
      effect: read
      questions:
      - How do I view one profile inside my network security perimeter?
      - What access rules are attached to an NSP profile?
      instructions:
      - text: Get NSP profile {profile} in perimeter {perimeter}, resource group {rg}.
        slots:
          profile: path.profileName
          perimeter: path.networkSecurityPerimeterName
          rg: path.resourceGroupName
      - text: Show network security perimeter {perimeter}'s profile {profile} in group {rg}.
        slots:
          perimeter: path.networkSecurityPerimeterName
          profile: path.profileName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles/{profileName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an NSP profile
      effect: write
      questions:
      - How do I add a new profile to a network security perimeter?
      - Can I change an existing perimeter profile's properties?
      instructions:
      - text: Create NSP profile {profile} in perimeter {perimeter}, resource group {rg}.
        slots:
          profile: path.profileName
          perimeter: path.networkSecurityPerimeterName
          rg: path.resourceGroupName
      - text: Update perimeter {perimeter} profile {profile} in group {rg} with {properties}.
        slots:
          perimeter: path.networkSecurityPerimeterName
          profile: path.profileName
          rg: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles/{profileName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an NSP profile
      effect: destructive
      questions:
      - How do I remove a profile from my network security perimeter?
      - What happens to associated resources when an NSP profile is deleted?
      instructions:
      - text: Delete NSP profile {profile} from perimeter {perimeter}, resource group {rg}.
        slots:
          profile: path.profileName
          perimeter: path.networkSecurityPerimeterName
          rg: path.resourceGroupName
      - text: Remove the {profile} profile of network security perimeter {perimeter} in group {rg}.
        slots:
          profile: path.profileName
          perimeter: path.networkSecurityPerimeterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List profiles in a network security perimeter
      effect: read
      questions:
      - Which profiles are defined in my network security perimeter?
      - Can I page through NSP profiles with a top count and skip token?
      instructions:
      - text: List the profiles in perimeter {perimeter}, resource group {rg}.
        slots:
          perimeter: path.networkSecurityPerimeterName
          rg: path.resourceGroupName
      - text: Show the first {top} NSP profiles of perimeter {perimeter} in group {rg}.
        slots:
          top: query.$top
          perimeter: path.networkSecurityPerimeterName
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'