INTEGRITY Dokumentace

← Cloudflare Logs / logs / logpull

Povolení uchovávání protokolů

Ve výchozím nastavení se protokoly HTTP požadavků neuchovávají. Při prvním použití Logpull API budete muset uchovávání povolit. Kdykoli je také můžete vypnout. Po vypnutí uchovávání zůstanou dříve uložené protokoly dostupné až do vypršení doby uchovávání (viz Doba uchovávání dat).

Endpointy

Pro správu uchovávání protokolů existují dva koncové body:

Příklady požadavků API pomocí cURL

Zkontrolujte stav uchovávání protokolů

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Logs Write
  • Logs Read
Získání příznaku uchovávání protokolů
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/logs/control/retention/flag" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
curl.exe "https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/control/retention/flag" ^
--header "Authorization: Bearer <API_TOKEN>"
$uri = "https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/control/retention/flag"
$headers = @{"Authorization" = "Bearer <API_TOKEN>"}
Invoke-RestMethod -Uri $uri -Method Get -Headers $headers

Pokud má zóna uchovávání protokolů povoleno získáte hodnotu true, zatímco hodnota false se vrátí, když je disabled.

Zapnout uchovávání protokolů

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Logs Write
Aktualizace příznaku uchovávání protokolů
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/logs/control/retention/flag" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"flag": true
	}'
curl.exe "https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/control/retention/flag" ^
--request POST ^
--header "Authorization: Bearer <API_TOKEN>" ^
--header "Content-Type: application/json" ^
--data "{""flag"": true}"
$uri = "https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/control/retention/flag"
$headers = @{"Authorization" = "Bearer <API_TOKEN>"}
$bodyFlag = @{flag = $true} | ConvertTo-Json
Invoke-RestMethod -Uri $uri -Method Post -Headers $headers -Body $bodyFlag -ContentType "application/json"

Odpověď (povoleno)

{
	"flag": true
}

Vypnout uchovávání protokolů

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Logs Write
Aktualizace příznaku uchovávání protokolů
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/logs/control/retention/flag" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"flag": false
	}'
curl.exe "https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/control/retention/flag" ^
--header "Authorization: Bearer <API_TOKEN>" ^
--header "Content-Type: application/json" ^
--data "{""flag"": false}"
$uri = "https://api.cloudflare.com/client/v4/zones/{zone_id}/logs/control/retention/flag"
$headers = @{"Authorization" = "Bearer <API_TOKEN>"}
$bodyFlag = @{flag = $false} | ConvertTo-Json
Invoke-RestMethod -Uri $uri -Method Post -Headers $headers -Body $bodyFlag -ContentType "application/json"

Zakázaná odpověď

{
	"flag": false
}

Audit

Zapnutí nebo vypnutí uchovávání protokolů se zaznamenává do Cloudflare Audit Logs.