f-80: doc: commandes, chemins et codes alignés sur le code, répertoire uefi, route reflectors, schémas régénérés #80
Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
parent
cbd3a8e65d
commit
9a3345f258
30 changed files with 271 additions and 190 deletions
|
|
@ -48,9 +48,10 @@ Trois règles pour un appelant robuste :
|
|||
borne les opérations qui attendent une transition ; l'appelant doit avoir sa propre borne.
|
||||
* **Traiter ``error`` comme terminal, pas comme un échec transitoire.** Un ``Execute`` en échec
|
||||
ne se rejoue pas tout seul.
|
||||
* **Ne pas enchaîner sans vérifier.** Créer un subnet dont le VPC est encore en ``creating``
|
||||
échoue en 422 ; démarrer une VM sur un subnet en ``creating`` ou ``running`` est en revanche
|
||||
accepté.
|
||||
* **Savoir ce qui s'enchaîne.** Créer un subnet dont le VPC est encore en ``creating``, ou
|
||||
démarrer une VM sur un subnet en ``creating``, est accepté : l'``Execute`` attend que le parent
|
||||
passe ``running``, dans la limite de ``dispatcher.timeout_seconds`` ; au-delà, la ressource passe
|
||||
en ``error``. Le refus en 422 ne vaut que pour un parent absent, en ``error`` ou en ``deleting``.
|
||||
|
||||
Codes de retour
|
||||
---------------
|
||||
|
|
@ -66,15 +67,23 @@ Codes de retour
|
|||
* - ``200``
|
||||
- lecture réussie (``GET``)
|
||||
* - ``400``
|
||||
- champ obligatoire manquant, corps invalide, ``iface_type`` inconnu, base64 invalide
|
||||
- champ obligatoire manquant, corps invalide, base64 invalide ; CIDR de VPC invalide,
|
||||
``l3vni`` hors plage ; ``interface_ip`` absent (``bridge``, ``public_ip``) ou fourni
|
||||
(``vxlan``) ; interface de VM sans ``mac``, nombre d'interfaces ``primary`` différent de 1
|
||||
* - ``404``
|
||||
- ressource inexistante
|
||||
* - ``405``
|
||||
- méthode non prise en charge ; corps ``{"error": "method not allowed"}``, mais servi en
|
||||
``text/plain`` par ``/vpcs`` et ``/subnets`` (et leurs ``/{name}``), en JSON par ``/vms``
|
||||
* - ``409``
|
||||
- conflit d'existence ou d'état : ressource déjà créée, ou suppression depuis un état qui
|
||||
ne l'autorise pas ; pour un VPC, subnets encore présents ; pour un subnet, VM non
|
||||
supprimées qui l'utilisent encore
|
||||
ne l'autorise pas ; pour un VPC, subnets encore présents, ``l3vni`` déjà utilisée par un
|
||||
autre VPC, ou ``l3vni`` demandée sans section ``bgp`` ; pour un subnet, VM non supprimées
|
||||
qui l'utilisent encore
|
||||
* - ``422``
|
||||
- dépendance absente ou pas prête : VPC parent d'un subnet, subnet d'une VM
|
||||
- dépendance absente ou inutilisable : VPC parent d'un subnet, subnet d'une VM, absent, en
|
||||
``error`` ou en ``deleting`` ; ``mode`` de subnet inconnu ; CIDR ``vxlan`` invalide ou plus
|
||||
petit que ``/29`` ; IP de VM hors du CIDR du subnet ou réservée
|
||||
* - ``500``
|
||||
- erreur interne
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue