# 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 SecurityAdminConfiguration Admin Rule…
  version: 1.0.0
extends: openapi/microsoft-azure-adminrulecollections-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}/securityAdminConfigurations/{configurationName}/ruleCollections'].get
  update:
    x-apievangelist-phrasing:
      intent: List rule collections in a security admin config
      effect: read
      questions:
      - Which rule collections are in my network manager's security admin configuration?
      - Can I page through admin rule collections a set number at a time?
      instructions:
      - text: List rule collections in security admin configuration {configurationName} of network manager {networkManagerName} in group {resourceGroupName}.
        slots:
          configurationName: path.configurationName
          networkManagerName: path.networkManagerName
          resourceGroupName: path.resourceGroupName
      - text: Show the first {top} admin rule collections in config {configurationName}.
        slots:
          top: query.$top
          configurationName: path.configurationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a security admin rule collection
      effect: read
      questions:
      - Which network groups does a particular admin rule collection apply to?
      - Can I look up one rule collection in a security admin configuration?
      instructions:
      - text: Get rule collection {ruleCollectionName} in config {configurationName} of network manager {networkManagerName}, group {resourceGroupName}.
        slots:
          ruleCollectionName: path.ruleCollectionName
          configurationName: path.configurationName
          networkManagerName: path.networkManagerName
          resourceGroupName: path.resourceGroupName
      - text: Show admin rule collection {ruleCollectionName}.
        slots:
          ruleCollectionName: path.ruleCollectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an admin rule collection
      effect: write
      questions:
      - How do I add a new rule collection to a security admin configuration?
      - Can I change which network groups an admin rule collection targets?
      instructions:
      - text: Create rule collection {ruleCollectionName} in config {configurationName} of network manager {networkManagerName}, group {resourceGroupName}.
        slots:
          ruleCollectionName: path.ruleCollectionName
          configurationName: path.configurationName
          networkManagerName: path.networkManagerName
          resourceGroupName: path.resourceGroupName
      - text: Set admin rule collection {ruleCollectionName} properties to {properties}.
        slots:
          ruleCollectionName: path.ruleCollectionName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an admin rule collection
      effect: destructive
      questions:
      - How do I remove a rule collection from a security admin configuration?
      - Can I force-delete a rule collection even if it's deployed?
      instructions:
      - text: Delete rule collection {ruleCollectionName} from config {configurationName} of network manager {networkManagerName}, group {resourceGroupName}.
        slots:
          ruleCollectionName: path.ruleCollectionName
          configurationName: path.configurationName
          networkManagerName: path.networkManagerName
          resourceGroupName: path.resourceGroupName
      - text: Force-delete admin rule collection {ruleCollectionName} with force set to {force}.
        slots:
          ruleCollectionName: path.ruleCollectionName
          force: query.force
      method: generated
      generated: '2026-09-26'