TsgcHTTP3Server › メソッド › SendGoAway

SendGoAway メソッド

HTTP/3 接続を適切に終了させるための GOAWAY フレームを送信します。

構文

procedure SendGoAway(const aQUICConn: TsgcQUICServerConnection; aLastStreamId: Int64);

パラメータ

名前タイプ説明
aQUICConnconst TsgcQUICServerConnection終了させる QUIC 接続。
aLastStreamIdInt64サーバーが処理する最後のリクエストストリームの識別子。より大きいストリーム ID のリクエストは処理されず、クライアントが新しい接続で再試行できます。

解説

SendGoAway は HTTP/3 GOAWAY フレームを送信して接続のグレースフルシャットダウンを開始します。サーバーが処理する最大リクエストストリーム番号をピアに伝えるため、クライアントは新しいリクエストストリームの開始を停止し、aLastStreamId を超えるものは別の接続で安全に再試行できます。

指定されたストリーム ID 以下の処理中リクエストは完了まで継続されます。それらが終了した後にのみ接続を閉じてください。これにより、たとえば再起動前やプールからノードを削除する際に、アクティブなリクエストを突然リセットすることなく、サーバーがトラフィックをクリーンにドレインできます。

使用例


// stop accepting new requests, finish the ones already in flight
oServer.SendGoAway(aConnection, aStreamId);

メソッドに戻る