取消

描述

cancel 外掛程式會為每個請求建立一個取消上下文。它會新增一個逾時時間，該逾時時間會在 5001 毫秒後觸發。

選擇 5001 這個數字是因為 DNS 用戶端的預設逾時時間為 5 秒，超過該時間它們就會放棄。

如果外掛程式對取消狀態感興趣，應該在上下文上呼叫 plugin.Done()。如果上下文因為逾時而取消，則外掛程式不應將任何內容寫回客戶端，並返回一個值，指示 CoreDNS 也不應這樣做；返回零值即可。

語法

cancel [TIMEOUT]

• TIMEOUT 允許設定自訂的逾時時間。預設逾時時間為 5001 毫秒 (5001 ms)

範例

example.org {
    cancel
    whoami
}

或使用自訂的逾時時間

example.org {
    cancel 1s
    whoami
}

另請參閱

context 套件的 Go 文件。