Create the Azure dashboard resource before using Grafana's content-update API

Source facts

Azure Monitor dashboards with Grafana supports only a subset of Grafana APIs. Import and deletion are Azure Resource Manager operations, not Grafana API operations. The documented import workflow first creates the Azure dashboard resource, empty by default, and then uses the Grafana data-plane POST /api/dashboards/db/ operation to update its content. Dashboard deletion requires the ARM operation without a Grafana deletion call. Microsoft Learn.

Applicability

Use this workflow boundary when adapting an existing Grafana automation client to Azure Monitor dashboards. Do not assume that an endpoint compatible with content updates exposes the complete dashboard resource lifecycle.

DSE recommendation

Separate Azure resource creation from Grafana content update and track the result of each stage. Have the automation owner define what happens if the resource exists but its intended content was not applied. Preserve the selected dashboard identity across the stages and avoid retry logic that creates unrelated empty resources. Keep deletion behind its own approved lifecycle action.

Verification

In a test scope, inspect the Azure resource after creation and then retrieve the dashboard after the content update. Compare its identity and expected panels with the approved source artifact. Exercise the partial-failure path to confirm the job reports an incomplete deployment rather than success from resource creation alone. Test cleanup only on an explicitly designated disposable dashboard, and retain the separate operation outcomes with the release evidence.

Official references

Microsoft Learn: Calling Azure Monitor Grafana APIs. Source reviewed September 9, 2026.