# 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 SecurityUserConfiguration User Rules API
  version: 1.0.0
extends: openapi/microsoft-azure-userrules-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/networkManagers/{networkManagerName}/securityUserConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}/rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List user rules in a security rule collection
      effect: read
      questions:
      - Which security user rules are in a rule collection of my network manager?
      - Can I page through user rules with a top limit and skip token?
      instructions:
      - text: List user rules in collection {ruleCollectionName} of configuration {configurationName} on network manager {networkManagerName} in {resourceGroupName}.
        slots:
          ruleCollectionName: path.ruleCollectionName
          configurationName: path.configurationName
          networkManagerName: path.networkManagerName
          resourceGroupName: path.resourceGroupName
      - text: Show the first {top} user rules in rule collection {ruleCollectionName}.
        slots:
          top: query.$top
          ruleCollectionName: path.ruleCollectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityUserConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}/rules/{ruleName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a security user rule
      effect: read
      questions:
      - What does a specific security user rule in my network manager allow or deny?
      - Can I look up one user rule by name?
      instructions:
      - text: Get user rule {ruleName} in collection {ruleCollectionName} of configuration {configurationName} on {networkManagerName} in {resourceGroupName}.
        slots:
          ruleName: path.ruleName
          ruleCollectionName: path.ruleCollectionName
          configurationName: path.configurationName
          networkManagerName: path.networkManagerName
          resourceGroupName: path.resourceGroupName
      - text: Show security user rule {ruleName} from rule collection {ruleCollectionName}.
        slots:
          ruleName: path.ruleName
          ruleCollectionName: path.ruleCollectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityUserConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}/rules/{ruleName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a security user rule
      effect: write
      questions:
      - How do I add a security user rule to a network manager rule collection?
      - Can I overwrite an existing user rule with new settings?
      instructions:
      - text: Create {kind} user rule {ruleName} in collection {ruleCollectionName} of configuration {configurationName} on {networkManagerName} in {resourceGroupName}.
        slots:
          kind: requestBody.kind
          ruleName: path.ruleName
          ruleCollectionName: path.ruleCollectionName
          configurationName: path.configurationName
          networkManagerName: path.networkManagerName
          resourceGroupName: path.resourceGroupName
      - text: Update security user rule {ruleName} in rule collection {ruleCollectionName}.
        slots:
          ruleName: path.ruleName
          ruleCollectionName: path.ruleCollectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityUserConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}/rules/{ruleName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a security user rule
      effect: destructive
      questions:
      - How do I delete a user rule from a network manager security configuration?
      - Can I force-delete a user rule even if its configuration is deployed?
      instructions:
      - text: Delete user rule {ruleName} from collection {ruleCollectionName} of configuration {configurationName} on {networkManagerName} in {resourceGroupName}.
        slots:
          ruleName: path.ruleName
          ruleCollectionName: path.ruleCollectionName
          configurationName: path.configurationName
          networkManagerName: path.networkManagerName
          resourceGroupName: path.resourceGroupName
      - text: Force delete security user rule {ruleName} with force set to {force}.
        slots:
          ruleName: path.ruleName
          force: query.force
      method: generated
      generated: '2026-09-26'