# 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 Purview devops policies REST API Document…
  version: 1.0.0
extends: openapi/microsoft-azure-devopspolicy-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: 7
- target: $.paths['/devops-policies'].get
  update:
    x-apievangelist-phrasing:
      intent: List all DevOps policies
      effect: read
      questions:
      - What DevOps policies are defined in Microsoft Purview?
      - Can I see every DevOps data policy in one list?
      instructions:
      - text: List all DevOps policies.
      - text: Show every Purview DevOps policy that exists.
      - text: List the DevOps policies using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devops-policies/{purviewResourceName}/sql-security-auditor-roles'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the SQL Security Auditor DevOps policy
      effect: read
      questions:
      - Who is granted the SQL Security Auditor role by a Purview DevOps policy?
      - How do I read the SQL security auditor policy for a data source?
      instructions:
      - text: Get the SQL Security Auditor DevOps policy for {resource}.
        slots:
          resource: path.purviewResourceName
      - text: Show the security auditor role decision rules on {resource}.
        slots:
          resource: path.purviewResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devops-policies/{purviewResourceName}/sql-security-auditor-roles'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace the SQL Security Auditor policy
      effect: write
      questions:
      - Can I grant the SQL Security Auditor role through a DevOps policy?
      - How do I replace the decision rules on a SQL security auditor policy safely with an ETag?
      instructions:
      - text: Create the SQL Security Auditor DevOps policy on {resource} with decision rules {rules}.
        slots:
          resource: path.purviewResourceName
          rules: requestBody.decisionRules
      - text: Replace the security auditor policy for {resource} with rules {rules}, only if ETag matches {etag}.
        slots:
          resource: path.purviewResourceName
          rules: requestBody.decisionRules
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devops-policies/{purviewResourceName}/sql-security-auditor-roles'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the SQL Security Auditor DevOps policy
      effect: destructive
      questions:
      - Can I revoke the SQL Security Auditor DevOps policy on a data source?
      - Does deleting a security auditor policy require the current ETag?
      instructions:
      - text: Delete the SQL Security Auditor DevOps policy on {resource} with ETag {etag}.
        slots:
          resource: path.purviewResourceName
          etag: header.If-Match
      - text: Remove the security auditor role policy from {resource}, matching ETag {etag}.
        slots:
          resource: path.purviewResourceName
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devops-policies/{purviewResourceName}/sql-perf-monitor-roles'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the SQL Performance Monitor DevOps policy
      effect: read
      questions:
      - Who can monitor SQL performance under a Purview DevOps policy?
      - How do I read the SQL performance monitor policy for a data source?
      instructions:
      - text: Get the SQL Performance Monitor DevOps policy for {resource}.
        slots:
          resource: path.purviewResourceName
      - text: Show the perf monitor role decision rules on {resource}.
        slots:
          resource: path.purviewResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devops-policies/{purviewResourceName}/sql-perf-monitor-roles'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace the SQL Performance Monitor policy
      effect: write
      questions:
      - Can I grant SQL performance monitoring access through a DevOps policy?
      - How do I overwrite a SQL perf monitor policy's decision rules with an ETag check?
      instructions:
      - text: Create the SQL Performance Monitor DevOps policy on {resource} with decision rules {rules}.
        slots:
          resource: path.purviewResourceName
          rules: requestBody.decisionRules
      - text: Replace the perf monitor policy for {resource} with rules {rules}, only if ETag matches {etag}.
        slots:
          resource: path.purviewResourceName
          rules: requestBody.decisionRules
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devops-policies/{purviewResourceName}/sql-perf-monitor-roles'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the SQL Performance Monitor DevOps policy
      effect: destructive
      questions:
      - Can I revoke the SQL Performance Monitor DevOps policy on a data source?
      - Does removing a perf monitor policy need the current ETag?
      instructions:
      - text: Delete the SQL Performance Monitor DevOps policy on {resource} with ETag {etag}.
        slots:
          resource: path.purviewResourceName
          etag: header.If-Match
      - text: Remove the perf monitor role policy from {resource}, matching ETag {etag}.
        slots:
          resource: path.purviewResourceName
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'