This commit is contained in:
forgejo-actions 2026-10-24 14:45:23 +00:00
commit b20e16ee62
28 changed files with 289 additions and 180 deletions

View file

@ -834,9 +834,10 @@ un état stable.</p>
borne les opérations qui attendent une transition ; l’appelant doit avoir sa propre borne.</p></li>
<li><p><strong>Traiter ``error`` comme terminal, pas comme un échec transitoire.</strong> Un <code class="docutils literal notranslate"><span class="pre">Execute</span></code> en échec
ne se rejoue pas tout seul.</p></li>
<li><p><strong>Ne pas enchaîner sans vérifier.</strong> Créer un subnet dont le VPC est encore en <code class="docutils literal notranslate"><span class="pre">creating</span></code>
échoue en 422 ; démarrer une VM sur un subnet en <code class="docutils literal notranslate"><span class="pre">creating</span></code> ou <code class="docutils literal notranslate"><span class="pre">running</span></code> est en revanche
accepté.</p></li>
<li><p><strong>Savoir ce qui s’enchaîne.</strong> Créer un subnet dont le VPC est encore en <code class="docutils literal notranslate"><span class="pre">creating</span></code>, ou
démarrer une VM sur un subnet en <code class="docutils literal notranslate"><span class="pre">creating</span></code>, est accepté : l”<code class="docutils literal notranslate"><span class="pre">Execute</span></code> attend que le parent
passe <code class="docutils literal notranslate"><span class="pre">running</span></code>, dans la limite de <code class="docutils literal notranslate"><span class="pre">dispatcher.timeout_seconds</span></code> ; au-delà, la ressource passe
en <code class="docutils literal notranslate"><span class="pre">error</span></code>. Le refus en 422 ne vaut que pour un parent absent, en <code class="docutils literal notranslate"><span class="pre">error</span></code> ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code>.</p></li>
</ul>
</section>
<section id="codes-de-retour">
@ -859,20 +860,29 @@ accepté.</p></li>
<td><p>lecture réussie (<code class="docutils literal notranslate"><span class="pre">GET</span></code>)</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">400</span></code></p></td>
<td><p>champ obligatoire manquant, corps invalide, <code class="docutils literal notranslate"><span class="pre">iface_type</span></code> inconnu, base64 invalide</p></td>
<td><p>champ obligatoire manquant, corps invalide, base64 invalide ; CIDR de VPC invalide,
<code class="docutils literal notranslate"><span class="pre">l3vni</span></code> hors plage ; <code class="docutils literal notranslate"><span class="pre">interface_ip</span></code> absent (<code class="docutils literal notranslate"><span class="pre">bridge</span></code>, <code class="docutils literal notranslate"><span class="pre">public_ip</span></code>) ou fourni
(<code class="docutils literal notranslate"><span class="pre">vxlan</span></code>) ; interface de VM sans <code class="docutils literal notranslate"><span class="pre">mac</span></code>, nombre d’interfaces <code class="docutils literal notranslate"><span class="pre">primary</span></code> différent de 1</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">404</span></code></p></td>
<td><p>ressource inexistante</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">409</span></code></p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">405</span></code></p></td>
<td><p>méthode non prise en charge ; corps <code class="docutils literal notranslate"><span class="pre">{&quot;error&quot;:</span> <span class="pre">&quot;method</span> <span class="pre">not</span> <span class="pre">allowed&quot;}</span></code>, mais servi en
<code class="docutils literal notranslate"><span class="pre">text/plain</span></code> par <code class="docutils literal notranslate"><span class="pre">/vpcs</span></code> et <code class="docutils literal notranslate"><span class="pre">/subnets</span></code> (et leurs <code class="docutils literal notranslate"><span class="pre">/{name}</span></code>), en JSON par <code class="docutils literal notranslate"><span class="pre">/vms</span></code></p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">409</span></code></p></td>
<td><p>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</p></td>
ne l’autorise pas ; pour un VPC, subnets encore présents, <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> déjà utilisée par un
autre VPC, ou <code class="docutils literal notranslate"><span class="pre">l3vni</span></code> demandée sans section <code class="docutils literal notranslate"><span class="pre">bgp</span></code> ; pour un subnet, VM non supprimées
qui l’utilisent encore</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">422</span></code></p></td>
<td><p>dépendance absente ou pas prête : VPC parent d’un subnet, subnet d’une VM</p></td>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">422</span></code></p></td>
<td><p>dépendance absente ou inutilisable : VPC parent d’un subnet, subnet d’une VM, absent, en
<code class="docutils literal notranslate"><span class="pre">error</span></code> ou en <code class="docutils literal notranslate"><span class="pre">deleting</span></code> ; <code class="docutils literal notranslate"><span class="pre">mode</span></code> de subnet inconnu ; CIDR <code class="docutils literal notranslate"><span class="pre">vxlan</span></code> invalide ou plus
petit que <code class="docutils literal notranslate"><span class="pre">/29</span></code> ; IP de VM hors du CIDR du subnet ou réservée</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">500</span></code></p></td>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">500</span></code></p></td>
<td><p>erreur interne</p></td>
</tr>
</tbody>