Services

Un service, c’est une ressource qui tourne chez nous : un serveur de jeu, une application, une base de données, une instance. Toutes les routes de cette section vivent sous /api/resources et demandent un jeton de portée FULL.

Lister

GET /api/resources

{
  "items": [
    {
      "id": "cmu648fgr0001it3v57ywrfvj",
      "name": "Serveur MC",
      "family": "GAME",
      "status": "ACTIVE",
      "canPower": true,
      "address": "51.210.44.12:25565",
      "product": { "slug": "minecraft", "name": "Minecraft", "shortName": "AGS" },
      "runtime": { "id": "cmr…", "slug": "paper-1-21", "name": "Paper 1.21" },
      "host": { "id": "cmr25fjrv…", "label": "Gravelines — France", "locationLabel": "Gravelines" },
      "dimensions": { "cpuCores": 4, "ramGb": 8, "storageGb": 80 },
      "monthlyMillicents": 12400,
      "hourlyLabel": "0,017 €/h",
      "isFree": false,
      "createdAt": "2026-09-15T11:54:02.000Z"
    }
  ]
}

La liste ne contient jamais les services supprimés.

Les familles

family dit de quoi il s’agit, et commande ce que le service accepte.

`family`	Gamme	Ce que c’est
`GAME`	AGS	Un serveur de jeu sur notre daemon
`APP`	ACS	Une image Docker : la tienne, ou une du catalogue (les bases de données en sont)
`COMPUTE`	ACI	Une instance Linux en conteneur
`VIRTUAL_MACHINE`	AVM	Une machine virtuelle, ton propre noyau
`DEDICATED`	ABM	Une machine entière
`BUCKET`	AOS	Du stockage objet

Les états

status suit une machine à états unique, quelle que soit la famille.

`status`	Ce qu’il veut dire
`PROVISIONING`	En cours de création
`AWAITING_ADMIN`	Une intervention humaine est requise de notre côté
`ACTIVE`	En service, facturé au tarif plein
`SUSPENDED`	Suspendu, facturé au seul stockage
`DELETING`	Suppression en cours
`DELETED`	Supprimé — n’apparaît plus dans les listes
`FAILED`	La création a échoué ; `failureReason` dit pourquoi

Lire un service

GET /api/resources/{id}

{
  "id": "cmu4d89050001itk8fqh41egq",
  "name": "demo-app",
  "family": "APP",
  "status": "ACTIVE",
  "projectId": "prj_0d3b6964bcbe4fd8518f",
  "product": { "slug": "applications", "name": "Applications", "shortName": "ACS" },
  "runtime": null,
  "host": { "id": "cmr25fjrv…", "label": "Gravelines — France", "locationLabel": "Gravelines" },
  "maintenance": null,
  "dimensions": { "cpuCores": 1, "ramGb": 1, "storageGb": 15 },
  "pricing": {
    "monthlyMillicents": 1100,
    "storageMonthlyMillicents": 120,
    "billedMonthlyMillicents": 1100,
    "monthlyCents": 110,
    "minBalanceCents": 4,
    "hourlyLabel": "0,002 €/h",
    "isFree": false,
    "freeExpiresAt": null
  },
  "dates": { "createdAt": "2026-09-16T17:19:24.821Z", "suspendedAt": null, "deletedAt": null },
  "failureReason": null,
  "panelUrl": null,
  "address": null,
  "capabilities": ["files", "logs", "backups", "powerSignals", "variables"]
}

billedMonthlyMillicents est ce qui court maintenant : il vaut monthlyMillicents quand le service est actif, et storageMonthlyMillicents quand il est suspendu. C’est le seul des deux à regarder pour prévoir une dépense.

Les capacités

capabilities est la liste de ce que ce service-là accepte. Elle dépend de sa famille et de son état : une console n’existe que sur un service actif.

Capacité	Ouvre
`console`	La console
`consoleCommands`	L’envoi de commandes à la console
`powerSignals`	Marche et arrêt
`suspension`	Suspendre et rétablir
`files`	Le gestionnaire de fichiers
`logs`	Les journaux
`backups`	Les sauvegardes
`snapshots`, `snapshotRollback`	Les instantanés
`variables`	Les variables
`allocationLabels`	Les libellés de ports

Appeler une route dont la capacité manque rend un 400 explicite plutôt qu’un comportement silencieux :

{
  "statusCode": 400,
  "message": "Cette ressource ne propose pas le gestionnaire de fichiers."
}

Teste la capacité, pas la famille. Elle bouge avec l’état du service, et elle est la seule source à jour.

L’état en direct

GET /api/resources/metrics?ids=cmu4d89…,cmu648f…

{
  "cmu4d89050001itk8fqh41egq": {
    "state": "running",
    "cpuAllocationPercent": 0.4,
    "ramBytes": 16887808,
    "storageBytes": 48361472,
    "uptimeSeconds": 39957,
    "netRxBytes": 3308,
    "netTxBytes": 126
  }
}

state vaut running, stopped, starting, stopping, installing ou unknown. Un service que le nœud ne sait pas joindre rend null plutôt que de faire échouer l’appel entier.

state n’est pas status. status est la vie administrative du service (créé, suspendu, supprimé), state est ce que fait son conteneur à la seconde près. Un service ACTIVE peut très bien être stopped.

Jusqu’à 50 identifiants par appel. Au-delà, découpe.

Commencer

Piloter un service

Construire

Compte

Lister

Les familles

Les états

Lire un service

Les capacités

L’état en direct

​Lister

​Les familles

​Les états

​Lire un service

​Les capacités

​L’état en direct

Lister

Les familles

Les états

Lire un service

Les capacités

L’état en direct