This commit is contained in:
forgejo-actions 2026-10-25 18:33:40 +00:00
commit 88d5b278a3
8 changed files with 58 additions and 23 deletions

View file

@ -831,14 +831,18 @@ un état stable.</p>
</div>
<p>Trois règles pour un appelant robuste :</p>
<ul class="simple">
<li><p><strong>Toujours borner l’attente.</strong> Côté agent, <code class="docutils literal notranslate"><span class="pre">dispatcher.timeout_seconds</span></code> (300 s par défaut)
borne les opérations qui attendent une transition ; l’appelant doit avoir sa propre borne.</p></li>
<li><p><strong>Toujours borner l’attente.</strong> Côté agent, la section <code class="docutils literal notranslate"><span class="pre">times</span></code> de la configuration 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>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>
passe <code class="docutils literal notranslate"><span class="pre">running</span></code>, dans la limite de <code class="docutils literal notranslate"><span class="pre">times.timeout_subnet_start</span></code> ou <code class="docutils literal notranslate"><span class="pre">times.timeout_vms_start</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>. À la suppression, c’est l’inverse : une VM puis son subnet, ou un
subnet puis son VPC, peuvent être supprimés d’un coup ; le parent attend que ses enfants en
<code class="docutils literal notranslate"><span class="pre">deleting</span></code> soient supprimés (<code class="docutils literal notranslate"><span class="pre">times.timeout_subnet_stop</span></code>, <code class="docutils literal notranslate"><span class="pre">times.timeout_vpc_stop</span></code>), et passe
en <code class="docutils literal notranslate"><span class="pre">error</span></code> si l’un d’eux échoue.</p></li>
</ul>
</section>
<section id="codes-de-retour">
@ -875,8 +879,8 @@ en <code class="docutils literal notranslate"><span class="pre">error</span></co
<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, <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>
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 qui l’utilisent
encore, ni supprimées ni en <code class="docutils literal notranslate"><span class="pre">deleting</span></code></p></td>
</tr>
<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

View file

@ -561,7 +561,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VPC not deletable — only running or error states can be deleted, and all its subnets must be deleted first</p>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>VPC not deletable — only running or error states can be deleted, and all its subnets must be deleted or deleting; subnets still deleting are awaited by the asynchronous deletion</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">409</span> <span class="ne">Conflict</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>
@ -1179,7 +1179,7 @@ du contrat : en cas d’écart avec le reste de la documentation, c’est elle q
</pre></div>
</div>
</p></li>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>Subnet not deletable — only running or error states can be deleted, and no VM that is not deleted may still have an interface on it</p>
<li><p><span><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/409">409 Conflict</a></span> – <p>Subnet not deletable — only running or error states can be deleted, and every VM with an interface on it must be deleted or deleting; VMs still deleting are awaited by the asynchronous deletion</p>
<p><strong>Example response:</strong></p>
<div class="highlight-http notranslate"><div class="highlight"><pre><span></span><span class="kr">HTTP</span><span class="o">/</span><span class="m">1.1</span> <span class="m">409</span> <span class="ne">Conflict</span>
<span class="na">Content-Type</span><span class="o">:</span> <span class="l">application/json</span>