[release-12.3.0] Restructure As code and developer resources (#113969)

Co-authored-by: Roberto Jiménez Sánchez <roberto.jimenez@grafana.com> Co-authored-by: Anna Urbiztondo <anna.urbiztondo@grafana.com>
2025-11-16 19:06:56 +00:00
parent 0898ec6045
commit 047da1442e
96 changed files with 8186 additions and 230 deletions
--- a/docs/sources/developer-resources/api-reference/http-api/datasource_lbac_rules.md
+++ b/docs/sources/developer-resources/api-reference/http-api/datasource_lbac_rules.md
@@ -0,0 +1,143 @@
+---
+aliases:
+  - ../../../http_api/datasource_lbac_rules/ # /docs/grafana/next/http_api/datasource_lbac_rules/
+  - ../../../developers/http_api/datasource_lbac_rules/ # /docs/grafana/next/developers/http_api/datasource_lbac_rules/
+canonical: https://grafana.com/docs/grafana/latest/developer-resources/api-reference/http-api/datasource_lbac_rules/
+description: Data Source LBAC rules API
+keywords:
+  - grafana
+  - http
+  - documentation
+  - api
+  - datasource
+  - lbac
+  - acl
+  - enterprise
+labels:
+  products:
+    - cloud
+title: Datasource LBAC rules HTTP API
+---
+
+# Data Source LBAC rules API
+
+LBAC (Label-Based Access Control) rules can be set for teams.
+
+## Get LBAC rules for a data source
+
+`GET /api/datasources/uid/:uid/lbac/teams`
+
+Gets all existing LBAC rules for the data source with the given `uid`.
+
+**Required permissions**
+
+| Action           | Scope                                                                                    |
+| ---------------- | ---------------------------------------------------------------------------------------- |
+| datasources:read | datasources:_<br>datasources:uid:_<br>datasources:uid:my_datasource (single data source) |
+
+### Examples
+
+**Example request:**
+
+```
+GET /api/datasources/uid/my_datasource/lbac/teams HTTP/1.1
+Accept: application/json
+Content-Type: application/json
+Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
+```
+
+**Example response:**
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json; charset=UTF-8
+Content-Length: 131
+
+```
+
+## Update LBAC rules for a data source
+
+`PUT /api/datasources/uid/:uid/lbac/teams`
+
+Updates LBAC rules for teams associated with the data source with the given `uid`. Here you submit a list of teams and the rules for each team.
+Deleting a team from the list will remove the team's LBAC rules. You have to submit all teams and their rules to be updated, to remove a team's rules, you have to submit the current list of rules without the team.
+
+**Required permissions**
+
+| Action                        | Scope                                                                                    |
+| ----------------------------- | ---------------------------------------------------------------------------------------- |
+| datasources:write             | datasources:_<br>datasources:uid:_<br>datasources:uid:my_datasource (single data source) |
+| datasources.permissions:write | datasources:_<br>datasources:uid:_<br>datasources:uid:my_datasource (single data source) |
+
+### Examples
+
+**Example request:**
+
+```http
+PUT /api/datasources/uid/my_datasource/lbac/teams
+Accept: application/json
+Content-Type: application/json
+Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
+
+{
+  "rules": [
+    {
+      "teamUId": "fdnd1pf4m9sxvc",
+      "rules": [
+        "{ service_name=\"bigquery-sync-mysql\" }"
+      ]
+    },
+    {
+      "teamUid": "dfed1p2m9sxvfc",
+      "rules": [
+        "{ service_name=\"api\" }"
+      ]
+    }
+  ]
+}
+```
+
+**Example response:**
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json; charset=UTF-8
+Content-Length: 35
+
+```
+      "rules": [
+        "{ service_name=\"api\" }"
+      ]
+    }
+  ]
+}
+```
+
+**Example response:**
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json; charset=UTF-8
+Content-Length: 35
+
+{
+  "id": 1,
+  "message": "Data source LBAC rules updated",
+  "name": "loki",
+  "rules": [
+    {
+      "teamUId": "fdnd1pf4m9sxvc",
+      "rules": [
+        "{ service_name=\"bigquery-sync-mysql\" }"
+      ]
+    },
+    {
+      "teamUid": "dfed1p2m9sxvfc",
+      "rules": [
+        "{ service_name=\"api\" }"
+      ]
+    }
+  ],
+  "uid": "ee1nm1t7spog0e",
+}
+```