# 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 Ingestion Using Data Collection Rules API
  version: 1.0.0
extends: openapi/microsoft-azure-data-collection-rules-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/dataCollectionRules/{ruleId}/streams/{stream}'].post
  update:
    x-apievangelist-phrasing:
      intent: Ingest logs through a data collection rule
      effect: write
      questions:
      - Can I send custom log data straight into Azure Monitor with a data collection rule?
      - Can I upload gzip-compressed data to the Logs Ingestion API?
      instructions:
      - text: Upload records to stream {stream} of data collection rule {ruleId}.
        slots:
          stream: path.stream
          ruleId: path.ruleId
      - text: Ingest gzip-encoded ({encoding}) data into stream {stream} via rule {ruleId}.
        slots:
          encoding: header.Content-Encoding
          stream: path.stream
          ruleId: path.ruleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List data collection rules in a resource group
      effect: read
      questions:
      - Which Azure Monitor data collection rules are defined in one resource group?
      - Can I list only the DCRs that belong to a particular resource group?
      instructions:
      - text: List the data collection rules in my resource group.
      - text: Show resource-group-scoped DCRs.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Insights/dataCollectionRules'].get
  update:
    x-apievangelist-phrasing:
      intent: List data collection rules in a subscription
      effect: read
      questions:
      - What data collection rules exist across my entire subscription?
      - Is there a subscription-wide inventory of Azure Monitor DCRs?
      instructions:
      - text: List every data collection rule in my subscription.
      - text: Show all DCRs subscription-wide.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dataCollectionRuleName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data collection rule
      effect: read
      questions:
      - How do I see the data sources and destinations in one data collection rule?
      - What does a specific DCR collect and where does it send it?
      instructions:
      - text: Get data collection rule {dataCollectionRuleName}.
        slots:
          dataCollectionRuleName: path.dataCollectionRuleName
      - text: Show the sources and destinations defined in DCR {dataCollectionRuleName}.
        slots:
          dataCollectionRuleName: path.dataCollectionRuleName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dataCollectionRuleName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a data collection rule
      effect: write
      questions:
      - How do I create a data collection rule that sends VM logs to a Log Analytics workspace?
      - Can I redefine an existing DCR's data flows with a full new definition?
      instructions:
      - text: Create data collection rule {dataCollectionRuleName} in region {location}.
        slots:
          dataCollectionRuleName: path.dataCollectionRuleName
          location: requestBody.location
      - text: Define DCR {dataCollectionRuleName} in {location} with sources, destinations and flows {properties}.
        slots:
          dataCollectionRuleName: path.dataCollectionRuleName
          location: requestBody.location
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dataCollectionRuleName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data collection rule
      effect: destructive
      questions:
      - How do I delete a data collection rule I no longer need?
      - Can I remove a DCR together with the associations that point to it?
      instructions:
      - text: Delete data collection rule {dataCollectionRuleName}.
        slots:
          dataCollectionRuleName: path.dataCollectionRuleName
      - text: Delete DCR {dataCollectionRuleName} and set delete-associations to {deleteAssociations}.
        slots:
          dataCollectionRuleName: path.dataCollectionRuleName
          deleteAssociations: query.deleteAssociations
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dataCollectionRuleName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags or identity on a data collection rule
      effect: write
      questions:
      - Can I change only the tags on an existing data collection rule?
      - How do I add a managed identity to a DCR that's already deployed?
      instructions:
      - text: Set tags {tags} on data collection rule {dataCollectionRuleName}.
        slots:
          tags: requestBody.tags
          dataCollectionRuleName: path.dataCollectionRuleName
      - text: Assign managed identity {identity} to existing DCR {dataCollectionRuleName}.
        slots:
          identity: requestBody.identity
          dataCollectionRuleName: path.dataCollectionRuleName
      method: generated
      generated: '2026-10-01'