📘 תיעוד 262

מיקום הנתונים

עודכן לאחרונה: 19 באוגוסט 2026

למד כיצד נקבע המיקום של נתונים המאוחסנים ב-R2, ועל הקלטים השונים הזמינים שקובעים את המיקום הפיזי שבו מאוחסנים אובייקטים בדליים שלך.

#אוטומטי (מומלץ)

כשיוצרים דלי חדש, מיקום הנתונים מוגדר כברירת מחדל ל-Automatic. כרגע, אפשרות זו בוחרת מיקום לדלי באזור הזמין הקרוב ביותר לבקשת יצירת הדלי, לפי המיקום של מי ששולח את הבקשה.

#רמזי מיקום

רמזי מיקום הם פרמטרים אופציונליים שאפשר לספק בזמן יצירת דלי, כדי לציין את המיקום הגאוגרפי העיקרי שממנו צפוי שהגישה לנתונים תתבצע.

שימוש ברמזי מיקום יכול להיות בחירה טובה כשמצפים שרוב הגישה לנתונים בדלי תגיע ממיקום שונה מהמקום שממנו יוצאת בקשת יצירת הדלי. יש לזכור שרמזי מיקום הם מאמץ מיטבי ולא ערובה, ויש להשתמש בהם רק כדרך לייעל ביצועים על ידי הצבת תוכן שמתעדכן באופן קבוע קרוב יותר למשתמשים.

#הגדרת רמזים דרך לוח הבקרה של Cloudflare

אפשר לבחור ליצור את הדלי באופן אוטומטי באזור הזמין הקרוב ביותר לפי המיקום שלך, או לבחור מיקום מסוים מהרשימה.

1. בלוח הבקרה של Cloudflare, עבור אל הדף R2 object storage. מעבר אל Overview ↗
2. בחר Create bucket.
3. הזן שם לדלי.
4. תחת Location, השאר את None מסומן לבחירה אוטומטית, או בחר אזור מהרשימה.
5. בחר Create bucket כדי להשלים את תהליך יצירת הדלי.

#הגדרת רמזים דרך ה-S3 API

אפשר להגדיר את רמז המיקום דרך הפרמטר LocationConstraint באמצעות ה-S3 API:

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

עיין בדוגמאות לדוגמאות נוספות מ-SDK אחרים של S3.

#רמזים זמינים

המיקומים הבאים נתמכים כרמזים:

#שיקולים נוספים

רמזי מיקום מכובדים רק בפעם הראשונה שבה נוצר דלי בשם נתון. אם מוחקים ויוצרים מחדש דלי באותו שם, ייעשה שימוש במיקום המקורי של הדלי.

#הגבלות שיפוט

הגבלות שיפוט מבטיחות שאובייקטים בדלי מאוחסנים בתוך שיפוט מסוים.

השתמש בהגבלות שיפוט כשצריך להבטיח שהנתונים מאוחסנים ומעובדים בתוך שיפוט כדי לעמוד בדרישות תושבות נתונים, כולל תקנות מקומיות כגון GDPR ↗︎ או FedRAMP ↗︎.

#הגדרת שיפוט דרך לוח הבקרה של Cloudflare

1. בלוח הבקרה של Cloudflare, עבור אל הדף R2 object storage. מעבר אל Overview ↗
2. בחר Create bucket.
3. הזן שם לדלי.
4. תחת Location, בחר Specify jurisdiction ובחר שיפוט מהרשימה.
5. בחר Create bucket כדי להשלים את תהליך יצירת הדלי.

#שימוש בשיפוטים מ-Workers

כדי לגשת לדלי R2 ששייכים לשיפוט מ-Workers, צריך לציין את השיפוט וגם את שם הדלי כחלק מה-bindings בקובץ ההגדרות של 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>"

למידע נוסף על תחילת העבודה, עיין בשימוש ב-R2 מ-Workers.

#שימוש בשיפוטים עם ה-S3 API

כשמתקשרים עם משאבי R2 ששייכים לשיפוט מוגדר באמצעות ה-S3 API או SDK תואמי S3 קיימים, חובה לציין את השיפוט בנקודת הקצה של S3:

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

אפשר להשתמש בנקודת הקצה הייעודית לשיפוט עבור כל פעולות ה-S3 API הנתמכות. כשמשתמשים בנקודת קצה של שיפוט, לא תהיה אפשרות לגשת למשאבי R2 מחוץ לשיפוט הזה.

הדוגמה הבאה מראה כיצד ליצור דלי R2 בשיפוט eu באמצעות חבילת @aws-sdk/client-s3 ↗︎ עבור 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",
	}),
);

עיין בדוגמאות לדוגמאות נוספות מ-SDK אחרים של S3.

#שיפוטים זמינים

השיפוטים הבאים נתמכים:

הערה

לקוחות Cloudflare Enterprise יכולים לפנות לצוות החשבון שלהם או ל-תמיכת Cloudflare כדי לקבל גישה לשיפוט FedRAMP.

#מגבלות

השירותים הבאים אינם מתקשרים עם משאבי R2 שיש להם שיפוטים מוקצים:

• Logpush. כפתרון עוקף למגבלה זו, אפשר להגדיר משימת Logpush באמצעות נקודת קצה תואמת S3 כדי לאחסן יומנים בדלי R2 בשיפוט לפי בחירתך.

#שיקולים נוספים

לאחר שדלי R2 נוצר, אי אפשר לשנות את השיפוט.