INTEGRITY Dokumentace

Cache Reserve

Cache Reserve je rozsáhlé trvalé datové úložiště implementováno nad R2. Stisknutím jediného tlačítka v dashboardu se obsah vašeho webu vhodný pro ukládání do mezipaměti zapíše do Cache Reserve.

Stejně jako Tiered Cache vytváří hierarchii mezipamětí mezi vašimi návštěvníky a vaším originem, Cache Reserve funguje jako nejvyšší úroveň této hierarchie a vyhrazuje úložný prostor pro vaše prostředky tak dlouho, jak potřebujete. Díky tomu se váš obsah obsluhuje z mezipaměti déle a origin je chráněn před zbytečnými poplatky za egress.

Obsah doručený z originu se cestou zpět ke klientovi ukládá do mezipaměti Cache Reserve a v edge datacentrech (T1 = vyšší úroveň, T2 = nižší úroveň)

Obsah v Cache Reserve se považuje za aktuální na základě Edge Cache TTL nastavení, nebo nastavení vašeho origin serveru Cache-Control hlaviček, pokud není nastaveno Edge Cache TTL. Po vypršení doby platnosti Cloudflare při dalším požadavku ověří platnost položky u vašeho origin serveru. Jde o stejné chování jako u běžné CDN sítě Cloudflare.

Doba uchování určuje, jak dlouho aktivum zůstává v Cache Reserve, než je odstraněno. Cache Reserve začíná s dobou uchování 30 dní. Pokud si aktivum nikdo nevyžádá během této doby, je z Cache Reserve odstraněno. Vyžádání aktiva dobu uchování resetuje.

Prostředky musí splňují určitá kritéria použít Cache Reserve.

Cache Reserve je produkt zpoplatněný podle využití a ceny je popsáno níže. Cache Reserve sice vyžaduje placený tarif, uživatelé ale mohou i nadále zdarma používat CDN síť Cloudflare (bez funkce Cache Reserve).

Zapnutí Cache Reserve

Vyžaduje se placený plán Cache Reserve.

  1. V dashboardu Cloudflare přejděte na Cache Reserve stránce.

    Přejděte na Cache Reserve ↗
  2. Vyberte Zapnutí synchronizace úložiště.

Viz API pro změnu nastavení Cache Reserve s dalšími informacemi.

Pokud jste zákazníkem s plánem Enterprise a máte zájem o Cache Reserve, obraťte se na svůj account team, který vám pomůže s konfigurací.

Způsobilost prostředků pro Cache Reserve

Ne všechny prostředky jsou způsobilé pro Cache Reserve. Aby mohl být prostředek do Cache Reserve zařazen, musí:

Chování vymazávání

Informace o odstranění všech dat z Cache Reserve najdete v Tlačítko pro vymazání Cache Reserve.

Upozorňujeme, že Purge Everything provede soft purge na Cache Reserve a neaktualizuje metadata nastavená pomocí Cache Response Rules (například značky mezipaměti). Chcete-li tato metadata obnovit, vymažte jednotlivé prostředky nebo počkejte, až zcela vyprší jejich platnost.

Limity

Použití

Stejně jako standardní CDN, i Cache Reserve využívá cf-cache-status hlavičku k označení stavy odpovědi cache jako MISS, HIT, a REVALIDATED. Zásahy i výpadky mezipaměti Cache Reserve se započítávají do poměru zásahů mezipaměti v dashboardu.

Jednotlivé vzorkované požadavky, které Cache Reserve naplnily nebo z něj byly obslouženy, si můžete prohlédnout přes CacheReserveUsed pole Logpush.

Měsíční využití operací a úložiště Cache Reserve si můžete prohlédnout v dashboardu.

Ceny

Cache Reserve účtuje na základě celkového objemu uložených dat spolu se dvěma třídami operací nad těmito daty:

Ve většině případů má výpadek (miss) Cache Reserve za následek jednu operaci class A a jednu operaci class B, zatímco zásah (hit) Cache Reserve má za následek jednu operaci class B. U prostředků větších než 1 GB vzniká více operací úměrně jejich velikosti.

Ceny Cache Reserve

Sazby
Úložiště$0.015 / GB-měsíc
Operace Class A (zápisy)$4.50 / milion požadavků
Operace Class B (čtení)$0.36 / milion požadavků

Využití úložiště

Úložiště se účtuje pomocí jednotky gigabajt-měsíc (GB-měsíc) jako fakturační metriky. GB-měsíc se vypočítá zaznamenáním celkového počtu uložených bajtů po dobu daného měsíce.

Například:

Operace

Operace provádí Cache Reserve jménem uživatele, a to za účelem zápisu dat z origin serveru do Cache Reserve a jejich předání dál dalším částem sítě Cloudflare. Tyto operace spravuje interně Cloudflare.

operace Class A (zápisy)

Operace Class A se provádějí na základě výpadků mezipaměti (cache miss) v CDN Cloudflare. Když nelze požadavek obsloužit z mezipaměti, načte se z originu a při cestě zpět k návštěvníkovi se zapíše do Cache Reserve i do našich edge mezipamětí.

operace Class B (čtení)

Operace Class B se provádějí, když je potřeba načíst data z Cache Reserve v reakci na výpadek v edge mezipaměti.

Vymazání

Vymazání prostředků je bezplatná operace.

Cache Reserve se okamžitě vymaže společně s edge mezipamětí, když odešlete požadavek na vymazání podle URL. Více informací najdete v konfigurace cache s podrobnostmi.

Ostatní metody vymazání, jako je vymazání podle tagu, hostitele nebo předpony, případně Purge Everything, vynutí pokus o znovu ověřit u následného požadavku na prostředek Cache Reserve. Mějte na paměti, že u takto vyčištěných prostředků budou nadále vznikat náklady na úložiště, dokud nevyprší jejich retenční TTL.

Příklady fakturace Cache Reserve

Příklad 1

Za předpokladu, že se na začátku měsíce do Cache Reserve zapíše 1 000 prostředků (každý o velikosti 1 GB) a každý z nich se přečte 1 000krát, odhadované náklady za daný měsíc by byly:

Použití Fakturovatelné množství Cena
Operace Class B (1 000 objektů) * (1 000 čtení na objekt) 1,000,000 $0.36
Operace Class A (1 000 objektů) * (1 zápis na objekt) 1,000 $4.50
Úložiště (1 000 objektů) * (1 GB na objekt) 1,000 GB-měsíců $15.00
CELKEM $19.86

Příklad 2

Za předpokladu, že se v Cache Reserve nachází 1 000 000 prostředků (každý o velikosti 1 MB), a:

odhadované náklady za měsíc by byly:

Použití Fakturovatelné množství Cena
Operace Class B (1 000 000 objektů) * (2 čtení za den) * (30 dní) 60,000,000 $21.60
Operace Class A (1 000 000 objektů) * (1 zápis za den) * (30 dní) 30,000,000 $135.00
Úložiště (1 000 000 objektů) * (1 MB na objekt) 1,000 GB-měsíců $15.00
CELKEM $171.60

Tipy a osvědčené postupy

Cache Reserve je určeno pro použití s Tiered Cache zapnutý kvůli maximální ochraně originu. Používání Cache Reserve bez Tiered Cache může vést k vyšším nákladům na operace s úložištěm. Pokud se pokusíte zapnout Cache Reserve bez Tiered Cache, Cloudflare dashboard vás na to upozorní.

Cache Reserve Analytics

Cache Reserve Analytics poskytuje přehled o využívání Cache Reserve. Umožňuje zjistit, jaký obsah je v Cache Reserve uložen, jak často se k němu přistupuje, jak dlouho je tam uložen a kolik egressu z vašeho originu vám šetří.

V Přehled sekci, v části Cache Reserve, máte přístup k následujícím metrikám:

Tlačítko pro vymazání Cache Reserve

Veškerá data uložená v Cache Reserve můžete odstranit v dashboardu nebo přes API. Chcete-li vymazat Cache Reserve, postupujte takto:

Mějte na paměti, že dokončení odstranění může trvat až 24 hodin.

  1. V dashboardu Cloudflare přejděte na Cache Reserve stránce.

    Přejděte na Cache Reserve ↗
  2. V Delete Cache Reserve Data, vyberte Delete Storage.

Chcete-li odstranit data Cache Reserve prostřednictvím API, použijte následující ukázkové požadavky. Další informace najdete v Dokumentace API.

Požadavek 1: Zjištění stavu Cache Reserve

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

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Zone Settings Write
  • Zone Settings Read
  • Zone Read
  • Zone Write
Získat nastavení Cache Reserve
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/cache/cache_reserve" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
Odpověď
{
	"result": {
		"editable": true,
		"id": "cache_reserve",
		"value": "off"
	},
	"success": true,
	"errors": [],
	"messages": []
}

Pokud je Cache Reserve vypnutá, můžete pokračovat operací Cache Reserve Clear.

Požadavek 2: Spuštění Cache Reserve Clear

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

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Zone Settings Write
  • Zone Write
Start Cache Reserve Clear
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/cache/cache_reserve_clear" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
Odpověď
{
	"result": {
		"id": "cache_reserve_clear",
		"start_ts": "2024-06-02T10:00:00.12345Z",
		"state": "In-progress"
	},
	"success": true,
	"errors": [],
	"messages": []
}