# 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 DataBoxEdgeManagementClient Monitoring…
  version: 1.0.0
extends: openapi/microsoft-azure-monitoringconfig-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.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/roles/{roleName}/monitoringConfig'].get
  update:
    x-apievangelist-phrasing:
      intent: List metric configurations for a Data Box Edge role
      effect: read
      questions:
      - Which metric configurations are set on a role of my Azure Stack Edge device?
      - How do I see monitoring config for an edge role?
      instructions:
      - text: List metric configurations for role {role} on device {device} in group {group}.
        slots:
          role: path.roleName
          device: path.deviceName
          group: path.resourceGroupName
      - text: Show monitoring configs of role {role} on {device} (subscription {sub}, group {group}).
        slots:
          role: path.roleName
          device: path.deviceName
          sub: path.subscriptionId
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/roles/{roleName}/monitoringConfig/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a role's default metric configuration
      effect: read
      questions:
      - What metrics is the default monitoring config collecting for an edge role?
      - Can I read the default metric configuration of a Data Box Edge role?
      instructions:
      - text: Get the default metric configuration of role {role} on device {device} in group {group}.
        slots:
          role: path.roleName
          device: path.deviceName
          group: path.resourceGroupName
      - text: Show default monitoring config for {role} on {device}, subscription {sub}, group {group}.
        slots:
          role: path.roleName
          device: path.deviceName
          sub: path.subscriptionId
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/roles/{roleName}/monitoringConfig/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a role's metric configuration
      effect: write
      questions:
      - How do I configure which metrics an Azure Stack Edge role emits?
      - Can I update the monitoring config on an edge device role?
      instructions:
      - text: Set metric configuration {properties} for role {role} on device {device} in group {group}.
        slots:
          properties: requestBody.properties
          role: path.roleName
          device: path.deviceName
          group: path.resourceGroupName
      - text: Update default monitoring config of {role} on {device} (subscription {sub}, group {group}).
        slots:
          role: path.roleName
          device: path.deviceName
          sub: path.subscriptionId
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/roles/{roleName}/monitoringConfig/default'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a role's metric configuration
      effect: destructive
      questions:
      - Can I remove the metric configuration from an edge role?
      - How do I stop custom metric collection on a Data Box Edge role?
      instructions:
      - text: Delete the metric configuration of role {role} on device {device} in group {group}.
        slots:
          role: path.roleName
          device: path.deviceName
          group: path.resourceGroupName
      - text: Remove monitoring config from {role} on {device}, subscription {sub}, group {group}.
        slots:
          role: path.roleName
          device: path.deviceName
          sub: path.subscriptionId
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'