← Cloudflare Durable Objects / durable-objects / reference

Umístění dat

Jurisdikce se používají k vytvoření Durable Objects které běží a ukládají data pouze v rámci daného regionu, aby vyhověly místním předpisům, jako je GDPR ↗ nebo FedRAMP ↗.

Workers mohou přistupovat k Durable Objects omezeným na určitou jurisdikci odkudkoli na světě. Omezení jurisdikce určuje pouze to, kde daný Durable Object běží a ukládá data. Zvažte použití Regional Services pro řízení regionů, ze kterých Cloudflare odpovídá na požadavky.

Durable Objects lze omezit na konkrétní jurisdikci vytvořením DurableObjectNamespace omezené na danou jurisdikci. Všechny Metody Durable Object ID jsou platné pro ID v rámci namespace omezeného na jurisdikci.

const euSubnamespace = env.MY_DURABLE_OBJECT.jurisdiction("eu");
const euId = euSubnamespace.newUniqueId();

• Stejný název může v různých jurisdikcích představovat odlišná ID.

  const euId1 = env.MY_DURABLE_OBJECT.idFromName("my-name");
  const euId2 = env.MY_DURABLE_OBJECT.jurisdiction("eu").idFromName("my-name");
  console.assert(!euId1.equal(euId2), "This should always be true");

• K chybě dojde, pokud jurisdikce na vašem DurableObjectNamespace a jurisdikci na DurableObjectId jsou odlišné.

• K chybě nedojde, pokud DurableObjectNamespace není přiřazen k žádné jurisdikci.

• Všechny Metody Durable Object ID jsou platné pro ID v rámci namespace omezeného na jurisdikci.

  const euSubnamespace = env.MY_DURABLE_OBJECT.jurisdiction("eu");
  const euId = euSubnamespace.idFromName(name);
  const stub = env.MY_DURABLE_OBJECT.get(euId);

Jurisdikce Durable Object je uvnitř objektu dostupná přes ctx.id.jurisdiction. Hodnota zůstává zachována napříč toString() a idFromString() round-tripů a je dostupná také uvnitř obslužné rutiny alarmů pro alarmy naplánované na 2026-03-15 nebo později, což je vhodné pro logiku uvnitř Durable Object, která zohledňuje region.

Durable Objects, stejně jako každé stavové API, obvykle zvyšují latenci odpovědi, protože požadavky musí být přeposlány do datacentra, kde se nachází daný Durable Object neboli stav.

Durable Objects v současnosti po vytvoření nemění umístění¹. Durable Object se ve výchozím nastavení vytvoří v datacentru poblíž místa, odkud přišel počáteční get() požadavek odeslán. Nemusí jít o stejné datové centrum, ve kterém get() požadavek odeslán, ve většině případů však bude v její těsné blízkosti.

Nápovědy k umístění jsou mechanismus, kterým lze určit, kde by se měl Durable Object nacházet, bez ohledu na to, odkud přišel počáteční get() požadavek přichází.

Chcete-li vytvářet Durable Objects ručně na jiném místě, uveďte volitelný locationHint parametr na get(). Pouze první volání get() pro konkrétní objekt bude respektovat tento hint.

let durableObjectStub = OBJECT_NAMESPACE.get(id, { locationHint: "enam" });

¹ Dynamické přemísťování existujících Durable Objects se plánuje do budoucna.

² Durable Objects se v tomto umístění aktuálně nevytvářejí. Místo toho se Durable Object vytvoří v nejbližším umístění, které Durable Objects podporuje. Durable Objects s nápovědou na Jižní Ameriku se tak například vytvářejí ve Východní Severní Americe.

³ apac-ne (severovýchodní Asie a Tichomoří) a apac-se (jihovýchodní Asie a Tichomoří) jsou užší podregiony v rámci apac (Asie a Tichomoří). Upřednostněte apac pro obecné umístění v regionu Asie a Tichomoří. Zvolte apac-ne nebo apac-se pouze pokud jsou vaši uživatelé soustředění na severovýchodě nebo jihovýchodě regionu a chcete pro ně minimalizovat latenci.

• Více o tom, kde se Durable Objects nacházejí, zjistíte na webu: Kde Durable Objects sídlí ↗.