contact@ffxf.net
Console
Chaque outil correspond à un point d'accès de l'API et exige le périmètre de ce point
d'accès. Les réponses sont le JSON de l'API ; les erreurs gardent leur
code, leurs détails et le request_id, avec une indication de
la marche à suivre.
Catalogue, sans clé
| Outil | Arguments | Renvoie |
|---|---|---|
list_regions | aucun | Les régions où les machines peuvent tourner. |
list_plans | region | Les offres, leurs ressources, leurs prix à l'heure et au mois. |
list_images | region, plan, category | Systèmes et images d'applications ; le slug est ce qu'attend create_vm. |
Compte
| Outil | Arguments | Périmètre |
|---|---|---|
get_account | aucun | billing.read |
Solde, consommation horaire et autonomie, quota, budget mensuel.
Machines
| Outil | Arguments | Périmètre |
|---|---|---|
list_vms | status, region, billing, cursor, limit | vms.read |
get_vm | vm | vms.read |
get_vm_metrics | vm, timeframe | vms.read |
estimate_vm | plan, region, image, hostname, billing, ssh_keys, options | vms.create |
create_vm | comme estimate_vm, plus payment, password_delivery, idempotency_key | vms.create |
power_vm | vm, type : start, shutdown, reboot, stop | vms.action |
rename_vm | vm, hostname | vms.action |
reinstall_vm | vm, image, confirm_hostname, ssh_keys, password_delivery | vms.action |
destroy_vm | vm, confirm_hostname, when | vms.destroy |
estimate_vm fait toutes les vérifications d'une commande et la chiffre,
sans rien créer. create_vm tire sa clé d'idempotence de la commande
elle-même : un agent qui relance le même appel après une coupure retrouve la première
réponse, pas une seconde machine. reinstall_vm et destroy_vm
effacent le disque et refusent d'agir si confirm_hostname n'est pas le nom
d'hôte exact de la machine.
Actions
| Outil | Arguments | Périmètre |
|---|---|---|
get_action | action | vms.read |
list_vm_actions | vm | vms.read |
La création, la réinstallation et les changements d'alimentation tournent en
arrière-plan et renvoient une action : interrogez get_action jusqu'à ce
que son état quitte running. Une nouvelle machine est prête en moins de
deux minutes.
Réseau et clés SSH
| Outil | Arguments | Périmètre |
|---|---|---|
get_vm_network | vm | vms.read |
set_reverse_dns | vm, address, hostname (null efface) | network.write |
list_ssh_keys | aucun | sshkeys.write ou vms.read |
add_ssh_key | name, public_key | sshkeys.write |
delete_ssh_key | key | sshkeys.write |
Ce que le serveur MCP ne fait pas
Restaurer ou supprimer une sauvegarde, ouvrir une session de console et ajouter des adresses IPv6 restent dans l'API et la console : ces gestes sont rares, et une erreur y coûte cher. Les factures, moyens de paiement et tickets ne sont accessibles à aucune clé.