Mettre à jour un dossier avec l'API Grafana Cloud
Renomme 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.
- Identifiant
- grafana_update_folder
L'appel
POST https://connect.reportei.com/api/tools/grafana_update_folder/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"namespace": "<namespace>",
"name": "<name>",
"metadata": {},
"spec": {}
}
}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. |
| name | string | Oui | Uid of the folder, the metadata.name from List folders. |
| metadata | object | Oui | Identity and parent of the folder. |
| spec | object | Oui | Content of the folder. |
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_update_folder. 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.
- Lister les dossiersGETListe 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.
- 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.
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.
