用途：通过 Grafana 的 HTTP API 操作实例，包括搜索/读取仪表盘、执行数据源查询、查看告警规则与静默、创建注解、管理文件夹及创建/更新仪表盘。实例地址为 Grafana Cloud 的 https://<your-org>.grafana.net 或自托管地址，API 接口一致，仅基础 URL 不同。
主要能力与用法：认证由运行时注入，不必创建或刷新令牌；凭据变量仅用于保持请求格式，未设置时填任意占位值。示例： export GRAFANA_URL="https://grafana.example.com" export GRAFANA_TOKEN="placeholder" curl -sS "${GRAFANA_URL}/api/..." -H "Authorization: Bearer ${GRAFANA_TOKEN}" 自检可用 /api/user（200 表示正常，401 表示凭据未配置，应报告而非调试认证）。数据源查询用 /api/ds/query，先通过 /api/datasources 找 uid，Prometheus 用 expr、Loki 用 LogQL、SQL 用 rawSql；响应为 data frames，失败时 frames 为空、错误嵌在 results.<refId>.error。告警有两套接口：/api/prometheus/grafana/api/v1/rules 读取实时状态，/api/v1/provisioning/alert-rules 管理定义。静默用 /api/alertmanager/grafana/api/v2/silences，时间为 RFC-3339；注解时间为 Unix 毫秒。仪表盘创建更新用 /api/dashboards/db，更新需先 GET 再回传完整 JSON，版本冲突返回 412。
适用场景：查询指标或日志、核对面板背后的查询、排查告警与静默、以代码方式管理仪表盘和文件夹。
限制：各端点时间单位不统一（ds/query 与 annotations 用毫秒，告警状态历史用秒，静默用 RFC-3339），混用会返回空结果而非报错。搜索和文件夹支持 limit+page（1 起始），annotations 无 page，需收窄时间窗。自托管默认无每 token 限流，Grafana Cloud 可能返回 429，应遵守 Retry-After。403 表示角色不足（Viewer<Editor<Admin）。UID 区分大小写。完整端点目录见 references/api.md。