ログ保持の有効化

デフォルトでは、HTTPリクエストログは保持されません。Logpull APIを初めて使用する際には、保持を有効にする必要があります。また、いつでも保持をオフにすることができます。保持がオフにされた後は、以前に保存されたログは保持期間が満了するまで利用可能であることに注意してください（データ保持期間を参照）。

エンドポイント

ログ保持を管理するためのエンドポイントは2つあります：

• GET /logs/control/retention/flag - 保持がオンかどうかを返します
• POST /logs/control/retention/flag - 保持をオンまたはオフにします

注意

POST呼び出しを行うには、Super Administrator、Administrator、またはLog Shareなどのゾーンスコープのedit権限が必要です。

cURLを使用したAPIリクエストの例

ログ保持がオンになっているか確認する：

curl -s -H "X-Auth-Email: <EMAIL>" -H "X-Auth-Key: <API_KEY>" -X GET "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/logs/control/retention/flag" | jq .

レスポンス：

{
  "errors": [],
  "messages": [],
  "result": {
    "flag": false
  },
  "success": true
}

ログ保持をオンにする：

LinuxまたはmacOSの場合：

curl -s -H "X-Auth-Email: <EMAIL>" -H "X-Auth-Key: <API_KEY>" -X POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/logs/control/retention/flag" -d'{"flag":true}' | jq .

Windowsのコマンドプロンプトの場合：

curl.exe -s -H "X-Auth-Email: <EMAIL>" -H "X-Auth-Key: <API_KEY>" POST "https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/logs/control/retention/flag" -d "{""flag"":true}"

WindowsでのAPI呼び出しに関するさらなるヘルプについては、WindowsでのAPI呼び出しの方法を参照してください。

パラメータ

• flag - trueまたはfalseのいずれかであることができます

レスポンス：

{
  "errors": [],
  "messages": [],
  "result": {
    "flag": true
  },
  "success": true
}

監査

ログ保持のオンまたはオフの切り替えは、Cloudflare監査ログに記録されます。