Lister les dossiers avec l'API Grafana Cloud
Liste les dossiers de la stack que le jeton peut voir, chacun avec metadata.name, l'uid que demandent les champs de dossier des autres outils, le dossier parent dans l'annotation grafana.app/folder du metadata et le titre dans spec. Quand metadata.continue arrive, envoyez-le comme continue pour la page suivante.
- Identifiant
- grafana_list_folders
L'appel
POST https://connect.reportei.com/api/tools/grafana_list_folders/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"namespace": "<namespace>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| namespace | string | Oui | stacks- followed by the instance ID shown under Details of the Grafana instance in the Grafana Cloud portal, for example stacks-123456. |
| limit | integer | Non | Maximum number of folders to return. |
| continue | string | Non | The metadata.continue token of the previous response, with the same limit. |
Connexions possibles
Votre client connecte son compte Grafana Cloud une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
À la connexion, votre client indique aussi {stack} : l'adresse de son compte sur l'API de l'app.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/grafana_list_folders. Il devient la définition de tool de votre agent sans conversion.
Autres tools Grafana Cloud
- Lister les dashboardsGETListe les dashboards de la stack. Chaque élément contient metadata.name, l'uid que demandent les autres outils, l'uid du dossier dans l'annotation grafana.app/folder du metadata et tout le JSON du dashboard dans spec, avec son title. Gardez limit petit ; quand metadata.continue arrive, envoyez-le comme continue pour la page suivante.
- Obtenir un dashboardGETRenvoie un dashboard : metadata, avec l'uid dans name, le resourceVersion et l'annotation de dossier, et le JSON du dashboard dans spec, avec title, panels, variables et plage de temps.
- Créer un dashboardPOSTCrée un dashboard à partir de son JSON dans spec, à la racine ou dans un dossier. Envoyez metadata.name avec l'uid voulu, ou metadata.generateName avec un préfixe pour un uid aléatoire. Un uid déjà utilisé répond 409.
- Mettre à jour un dashboardPUTRemplace un dashboard par une nouvelle version de son JSON. Lisez-le d'abord avec Get dashboard, modifiez spec et renvoyez le spec entier, car les champs omis sont supprimés. Envoyez le resourceVersion lu pour ne pas écraser un changement plus récent ; un resourceVersion périmé répond 409.
- Créer un dossierPOSTCrée un dossier à la racine ou dans un autre dossier. Envoyez metadata.name avec l'uid voulu, ou metadata.generateName avec un préfixe pour un uid aléatoire.
- Mettre à jour un dossierPUTRenomme un dossier ou le déplace sous un autre. Envoyez le titre et, s'il y en a un, le parent dans l'annotation grafana.app/folder, car l'appel remplace le dossier.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
