# 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 Rules API
  version: 1.0.0
extends: openapi/microsoft-azure-adminrules-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/{ruleCollectionName}/rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List security admin rules in a rule collection
      effect: read
      questions:
      - Which security admin rules are in a rule collection of my network manager?
      - Can I page through admin rules in a security admin configuration?
      instructions:
      - text: List admin rules in rule collection {collection} of configuration {config}, manager {manager}, group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          config: path.configurationName
          collection: path.ruleCollectionName
      - text: Show the first {top} admin rules of collection {collection} in config {config} on {manager} ({resource_group}).
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          config: path.configurationName
          collection: path.ruleCollectionName
          top: query.$top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}/rules/{ruleName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a security admin rule
      effect: read
      questions:
      - What is configured on one particular security admin rule?
      - Can I look up a single admin rule in a rule collection?
      instructions:
      - text: Get admin rule {rule} in collection {collection}, configuration {config}, manager {manager}, group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          config: path.configurationName
          collection: path.ruleCollectionName
          rule: path.ruleName
      - text: Show the settings of admin rule {rule} in {collection} ({config}, {manager}, {resource_group}).
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          config: path.configurationName
          collection: path.ruleCollectionName
          rule: path.ruleName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}/rules/{ruleName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a security admin rule
      effect: write
      questions:
      - How do I add a security admin rule to a rule collection in Network Manager?
      - Can I create either a custom or default admin rule?
      instructions:
      - text: Create admin rule {rule} of kind {kind} in collection {collection}, config {config}, manager {manager}, group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          config: path.configurationName
          collection: path.ruleCollectionName
          rule: path.ruleName
          kind: requestBody.kind
      - text: Update the {kind} security admin rule {rule} in {collection} of {config} on {manager} in {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          config: path.configurationName
          collection: path.ruleCollectionName
          rule: path.ruleName
          kind: requestBody.kind
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}/rules/{ruleName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a security admin rule
      effect: destructive
      questions:
      - Can I delete a security admin rule even when it's deployed?
      - How do I remove an admin rule from a rule collection?
      instructions:
      - text: Delete admin rule {rule} from collection {collection}, config {config}, manager {manager}, group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          config: path.configurationName
          collection: path.ruleCollectionName
          rule: path.ruleName
      - text: Force-remove admin rule {rule} in {collection} ({config}, {manager}, {resource_group}) with force {force}.
        slots:
          resource_group: path.resourceGroupName
          manager: path.networkManagerName
          config: path.configurationName
          collection: path.ruleCollectionName
          rule: path.ruleName
          force: query.force
      method: generated
      generated: '2026-09-26'