← Cloudflare R2 / r2 / reference

Umístění dat

Přečtěte si, jak se určuje umístění dat uložených v R2, a jaké různé vstupy ovlivňují fyzické umístění, kde jsou objekty ve vašich bucketech uloženy.

Když vytvoříte nový bucket, umístění dat je ve výchozím nastavení nastaveno na Automatic. V současnosti tato možnost vybere umístění bucketu v nejbližším dostupném regionu vzhledem k požadavku na vytvoření bucketu na základě polohy volajícího.

Location Hints jsou volitelné parametry, které můžete zadat při vytváření bucketu a které určují primární geografickou oblast, odkud očekáváte přístup k datům.

Location Hints se vyplatí použít, pokud očekáváte, že většina přístupů k datům v bucketu bude přicházet z jiné lokality, než odkud byl odeslán požadavek na vytvoření bucketu. Mějte na paměti, že Location Hints fungují na bázi nejlepší snahy, nikoli jako záruka, a měly by sloužit pouze k optimalizaci výkonu tím, že pravidelně aktualizovaný obsah umístí blíže k uživatelům.

Bucket můžete nechat automaticky vytvořit v nejbližším dostupném regionu podle vaší polohy, nebo vybrat konkrétní lokalitu ze seznamu.

1. V dashboardu Cloudflare přejděte na Objektové úložiště R2 stránce.

   Přejděte na Přehled ↗

2. Vyberte Vytvořit bucket.

3. Zadejte název bucketu.

4. V části Umístění, ponechte Žádné vybráno pro automatický výběr, nebo zvolte region ze seznamu.

5. Vyberte Vytvořit bucket abyste dokončili proces vytvoření bucketu.

Location Hint můžete nastavit přes LocationConstraint parametr pomocí S3 API:

await S3.send(
	new CreateBucketCommand({
		Bucket: "YOUR_BUCKET_NAME",
		CreateBucketConfiguration: {
			LocationConstraint: "WNAM",
		},
	}),
);

Viz Příklady pro další příklady z jiných S3 SDK.

Podporovány jsou následující nápovědy umístění:

Location Hints se uplatní pouze při prvním vytvoření bucketu s daným názvem. Pokud bucket se stejným názvem smažete a znovu vytvoříte, použije se umístění původního bucketu.

Omezení jurisdikce zaručují, že objekty v bucketu jsou uloženy v konkrétní jurisdikci.

Použijte funkci Jurisdictional Restrictions, pokud potřebujete zajistit, že jsou data uložena a zpracována v rámci určité jurisdikce a splňují požadavky na rezidenci dat, včetně místních předpisů, jako je GDPR ↗ nebo FedRAMP ↗.

1. V dashboardu Cloudflare přejděte na Objektové úložiště R2 stránce.

   Přejděte na Přehled ↗

2. Vyberte Vytvořit bucket.

3. Zadejte název bucketu.

4. V části Umístění, vyberte Zadání jurisdikce a ze seznamu vyberte jurisdikci.

5. Vyberte Vytvořit bucket abyste dokončili proces vytvoření bucketu.

Chcete-li přistupovat k bucketům R2 patřícím do jurisdikce z Workers, budete muset kromě názvu bucketu uvést i jurisdikci jako součást vašeho vazby ve vašem Konfigurační soubor Wrangler:

{
	"r2_buckets": [
		{
			"binding": "MY_BUCKET",
			"bucket_name": "<YOUR_BUCKET_NAME>",
			"jurisdiction": "<JURISDICTION>"
		}
	]
}

[[r2_buckets]]
binding = "MY_BUCKET"
bucket_name = "<YOUR_BUCKET_NAME>"
jurisdiction = "<JURISDICTION>"

Informace o tom, jak začít, naleznete v Použití R2 z Workers.

Při práci s prostředky R2, které patří do definované jurisdikce, prostřednictvím S3 API nebo stávajících SDK kompatibilních s S3 musíte zadat jurisdikce ve vašem koncovém bodu S3:

https://<ACCOUNT_ID>.<JURISDICTION>.r2.cloudflarestorage.com

Svůj koncový bod specifický pro jurisdikci můžete použít pro jakoukoli podporované operace S3 API. Při použití jurisdiction endpoint nebudete moci přistupovat k prostředkům R2 mimo danou jurisdikci.

Následující příklad ukazuje, jak vytvořit bucket R2 v eu jurisdikce pomocí @aws-sdk/client-s3 ↗ balíček pro JavaScript.

import { S3Client, CreateBucketCommand } from "@aws-sdk/client-s3";
const S3 = new S3Client({
	endpoint: "https://<account_id>.eu.r2.cloudflarestorage.com",
	credentials: {
		accessKeyId: "<access_key_id>",
		secretAccessKey: "<access_key_secret>",
	},
	region: "auto",
});
await S3.send(
	new CreateBucketCommand({
		Bucket: "YOUR_BUCKET_NAME",
	}),
);

Viz Příklady pro další příklady z jiných S3 SDK.

Podporovány jsou následující jurisdikce:

Následující služby nepracují s prostředky R2 s přiřazenou jurisdikcí:

• Logpush. Jako řešení tohoto omezení můžete nastavit Úloha Logpush s koncovým bodem kompatibilním s S3 k ukládání protokolů v bucketu R2 v jurisdikci dle vašeho výběru.

Jakmile je bucket R2 vytvořen, jurisdikci již nelze změnit.