キャンセル

説明

cancel プラグインは各リクエストにキャンセルするコンテキストを作成します。5001 ミリ秒後にトリガーされるタイムアウトを追加します。

5001 という数字は DNS クライアントのデフォルトタイムアウトが 5 秒であるため、それ以降はあきらめるため、選択されました。

キャンセル状態に関心のあるプラグインは、コンテキストで plugin.Done() を呼び出す必要があります。コンテキストがタイムアウトによりキャンセルされた場合、プラグインはクライアントに何かを書き戻したり、CoreDNS もそれを行ってはいけないことを示す値を返す必要があります。それにはゼロの戻り値で十分です。

構文

cancel [TIMEOUT]

• TIMEOUT ではカスタムタイムアウトを設定できます。デフォルトのタイムアウトは 5001 ミリ秒（5001 ms）です。

例

example.org {
    cancel
    whoami
}

またはカスタムタイムアウトで

example.org {
    cancel 1s
    whoami
}

関連項目

コンテキストパッケージの Go ドキュメント。