# 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 Monitors Resource API
  version: 1.0.0
extends: openapi/microsoft-azure-monitorsresource-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: 14
- target: $.paths['/providers/Microsoft.Datadog/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Datadog resource provider operations
      effect: read
      questions:
      - What operations does the Microsoft.Datadog resource provider support?
      - Can I get the list of actions available for Datadog monitors in the 2020-02-01-preview API?
      instructions:
      - text: List all operations offered by the Microsoft.Datadog provider.
      - text: Show me the Datadog integration's available provider operations.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Datadog/monitors'].get
  update:
    x-apievangelist-phrasing:
      intent: List Datadog monitors in a subscription
      effect: read
      questions:
      - How do I see every Datadog monitor resource across my whole subscription?
      - Which Datadog monitors exist in this Azure subscription?
      instructions:
      - text: List all Datadog monitors in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every Datadog monitor resource across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Datadog/monitors'].get
  update:
    x-apievangelist-phrasing:
      intent: List Datadog monitors in a resource group
      effect: read
      questions:
      - Which Datadog monitors live in a particular resource group?
      - Can I narrow the list of Datadog monitors down to one resource group?
      instructions:
      - text: List Datadog monitors in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the Datadog monitor resources under {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Datadog/monitors/{monitorName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Datadog monitor
      effect: read
      questions:
      - How do I read the properties of one Datadog monitor resource?
      - What SKU and tags does a specific Datadog monitor have?
      instructions:
      - text: Get Datadog monitor {monitorName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
      - text: Show the settings of Datadog monitor {monitorName} in {resourceGroupName}.
        slots:
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Datadog/monitors/{monitorName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Datadog monitor
      effect: write
      questions:
      - How do I create a Datadog monitor resource in Azure?
      - Can I pick the region and SKU when setting up a Datadog monitor?
      instructions:
      - text: Create Datadog monitor {monitorName} in resource group {resourceGroupName} in {location}, subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
          location: requestBody.location
      - text: Create Datadog monitor {monitorName} in {resourceGroupName} at {location} with SKU {sku}.
        slots:
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
          location: requestBody.location
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Datadog/monitors/{monitorName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Datadog monitor
      effect: destructive
      questions:
      - How do I remove a Datadog monitor resource I no longer use?
      - Can I tear down a Datadog monitor in a given resource group?
      instructions:
      - text: Delete Datadog monitor {monitorName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
      - text: Remove the Datadog monitor {monitorName} from {resourceGroupName}.
        slots:
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Datadog/monitors/{monitorName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Datadog monitor
      effect: write
      questions:
      - Can I change the tags or SKU on an existing Datadog monitor?
      - How do I update the properties of a Datadog monitor after it's created?
      instructions:
      - text: In subscription {subscriptionId}, set the tags on Datadog monitor {monitorName} in {resourceGroupName} to {tags}.
        slots:
          subscriptionId: path.subscriptionId
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
          tags: requestBody.tags
      - text: Change Datadog monitor {monitorName} in {resourceGroupName} to SKU {sku}.
        slots:
          monitorName: path.monitorName
          resourceGroupName: path.resourceGroupName
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Elastic/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Elastic resource provider operations
      effect: read
      questions:
      - What operations does the Microsoft.Elastic resource provider expose?
      - Which actions can I perform on Elastic monitors in Azure?
      instructions:
      - text: List all operations offered by the Microsoft.Elastic provider.
      - text: Show me the Elastic integration's available provider operations.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Elastic/monitors'].get
  update:
    x-apievangelist-phrasing:
      intent: List Elastic monitors in a subscription
      effect: read
      questions:
      - How can I see all Elastic monitor resources in my subscription?
      - Which Elastic monitors are deployed across this subscription?
      instructions:
      - text: List all Elastic monitors in my subscription.
      - text: Show every Elastic monitor resource subscription-wide.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Elastic/monitors'].get
  update:
    x-apievangelist-phrasing:
      intent: List Elastic monitors in a resource group
      effect: read
      questions:
      - Can I list only the Elastic monitors in one resource group?
      - What Elastic monitor resources are in my current resource group?
      instructions:
      - text: List the Elastic monitors in my resource group.
      - text: Show Elastic monitor resources scoped to the resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Elastic/monitors/{monitorName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Elastic monitor
      effect: read
      questions:
      - How do I view the properties of a specific Elastic monitor?
      - What does the configuration of one Elastic monitor look like?
      instructions:
      - text: Get Elastic monitor {monitorName}.
        slots:
          monitorName: path.monitorName
      - text: Show the settings for Elastic monitor {monitorName}.
        slots:
          monitorName: path.monitorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Elastic/monitors/{monitorName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an Elastic monitor
      effect: write
      questions:
      - How do I create an Elastic monitor resource in Azure?
      - Can I set a managed identity and SKU when creating an Elastic monitor?
      instructions:
      - text: Create Elastic monitor {monitorName} in {location}.
        slots:
          monitorName: path.monitorName
          location: requestBody.location
      - text: Create Elastic monitor {monitorName} in {location} with SKU {sku} and tags {tags}.
        slots:
          monitorName: path.monitorName
          location: requestBody.location
          sku: requestBody.sku
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Elastic/monitors/{monitorName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Elastic monitor
      effect: destructive
      questions:
      - How do I delete an Elastic monitor resource?
      - Can I remove an Elastic monitor I set up by mistake?
      instructions:
      - text: Delete Elastic monitor {monitorName}.
        slots:
          monitorName: path.monitorName
      - text: Tear down the Elastic monitor {monitorName}.
        slots:
          monitorName: path.monitorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Elastic/monitors/{monitorName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Elastic monitor's tags
      effect: write
      questions:
      - Is updating tags the only change I can make to an Elastic monitor?
      - How do I retag an existing Elastic monitor?
      instructions:
      - text: Set the tags on Elastic monitor {monitorName} to {tags}.
        slots:
          monitorName: path.monitorName
          tags: requestBody.tags
      - text: Retag Elastic monitor {monitorName} with {tags}.
        slots:
          monitorName: path.monitorName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'