Tovanix
Tovanix

API لتخزين الكائنات

تخزين كائنات متوافق مع S3. أصدر بيانات اعتماد منفصلة لكل حاوية واربط أي SDK لـS3 مباشرةً، دون رسوم لنقل البيانات الصادر عند القراءة.

  • بيانات الاعتماد: Access Key / Secret Key لكل حاوية وصالحان لها وحدها؛ يُعرض السر مرة واحدة ويستغرق تفعيل المفتاح الجديد نحو دقيقة
  • إعداد SDK: تكون region دائمًا auto مع عنونة virtual-host؛ أمثلة Node.js / Python / Go / PHP / aws-cli
  • CORS: مطلوب قبل الرفع أوالقراءة مباشرةً من المتصفح؛ يجب أن يكون origin نطاقًا محددًا وليس قيمة شاملة
  • الروابط الموقعة مؤقتًا: يمكن توقيع الرفع والتنزيل لتقديم رابط محدود المدة للمتصفح بدل المفتاح
  • الحدود والأسعار: 5 GiB لكل PUT منفرد وحتى 10000 جزء للرفع متعدد الأجزاء؛ تُحسب رسوم التخزين من الاستخدام اليومي الفعلي، والحذف والنقل الصادر مجانيان

نظرة عامة

تخزين كائنات متوافق S3، بيانات لكل حاوية وأي SDK، وخروج مجاني.

تعمل إعدادات aws-sdk وboto3 وs3cmd وrclone؛ بدّل النقطة والمنطقة إلى auto.

بيانات الاعتماد

أصدرها لكل حاوية من تخزين الكائنات ← الحاويات ← المفاتيح. بيانات الاعتماد محصورة في تلك الحاوية ولا تستطيع الوصول إلى حاوياتك الأخرى.

  • Endpoint — نقطة S3، مثل https://<account>.r2.cloudflarestorage.com
  • Bucket — الاسم الفعلي للحاوية ببادئة النظام، يختلف عن اسمك المستعار
  • Access Key ID — Access Key ID
  • Secret Access Key — Secret Access Key يظهر مرة عند الإنشاء
  • Region — دائمًا auto. استخدام us-east-1 ونحوه يفشل التوقيع بـ403 SignatureDoesNotMatch.

بيانات الاعتماد الصادرة حديثًا تحتاج نحو دقيقة للوصول إلى حافة التخزين؛ وتعيد الاستدعاءات 401 Unauthorized حتى ذلك الحين. هذا ليس مفتاحًا خاطئًا — انتظر وأعد المحاولة. وهو أسهل ما يُشخَّص خطأً في أول تكامل.

لا نخزّن Secret Access Key أبدًا، فلا يمكن استرجاعه بعد إغلاق النافذة. فقدانه يعني حذف المفتاح وإصدار مفتاح جديد، وهو ما يعطّل تكاملك الحي في الأثناء — احفظه فورًا في مدير الأسرار لديك.

إعداد SDK

ضع القيم الأربع في SDK لديك.

استخدم عنونة virtual-host (الافتراضية)؛ ولا تفعّل path-style. الخطأ في ذلك يظهر على شكل 404 / NoSuchBucket، ويبدو كأنه خطأ إملائي في اسم الحاوية.

CORS

لا يستطيع المتصفح مخاطبة الحاوية مباشرةً (رفع أو قراءة من واجهتك الأمامية) قبل ضبط CORS — يُحظر الطلب قبل إرساله أصلًا، فترى خطأ CORS في وحدة تحكم المتصفح ولا ترى شيئًا من جهة الخادم. اضبطه من الحاويات ← الإعدادات ← CORS.

تتيح العلامة العامة لأي موقع القراءة والكتابة ببيانات زوارك دون سجل وصول قابل للفحص. حدّد نطاقات بعينها.

عناوين موقّعة مسبقًا

سلّم المتصفح عناوين URL محدودة المدة بدلًا من إرسال بيانات الاعتماد إلى الواجهة الأمامية. يمكن التوقيع المسبق للرفع والتنزيل معًا، فلا تمر الملفات الكبيرة بخوادمك إطلاقًا.

الحدود

  • 5 GiB لكل PUT، والأكبر برفع متعدد الأجزاء
  • حتى ~4.995 TiB للكائن متعدد الأجزاء، أقصى 10,000 جزء
  • مفاتيح حتى 1024 بايت
  • كتابة متزامنة واحدة بالثانية للمفتاح نفسه

التسعير

دون زيادة ضمن حصة الخطة؛ بعدها الأسعار التالية.

  • التخزين — $0.03 / GB·شهر — حسب الفعلي اليومي لا الذروة
  • $9.00 / 1M — عمليات كتابة وقوائم PutObject, ListObjects, multipart وغيرها
  • $0.72 / 1M — عمليات قراءة GetObject, HeadObject وغيرها
  • الخروج — مجاني — عرض نطاق القراءة مجاني، أبرز فرق التكلفة عن التقليدي
  • الحذف — مجاني — حذف الكائنات والحاويات وإلغاء الرفع مجاني

أرخص لكل GB، لكنه يفرض حدًا أدنى للاحتفاظ مدته 30 يومًا (الحذف قبل ذلك يُحاسَب عليه كـ 30 يومًا) ويحصّل رسم استرجاع عند كل قراءة. في حاوية تُقرأ يوميًا ترتفع الفاتورة ولا تنخفض — يناسب الأرشيف والنسخ الاحتياطية حيث تكتب كثيرًا وتقرأ نادرًا.

الأسئلة الشائعة

لماذا تُرجع بيانات الاعتماد الجديدة 401 باستمرار؟

تحتاج بيانات الاعتماد الجديدة نحو دقيقة للوصول إلى عُقد التخزين، وتُرجع الاستدعاءات خلال هذه الفترة 401 Unauthorized. لا يعني ذلك بالضرورة أن المفتاح خطأ؛ انتظر قليلًا وأعد المحاولة. يسهل تشخيص هذه الحالة خطأً عند أول تكامل.

ما قيمة region المطلوبة، وما سبب SignatureDoesNotMatch؟

تكون region دائمًا auto. تؤدي us-east-1 أوالقيم المشابهة إلى توقيع غير صحيح، وتُرجع الطلبات 403 SignatureDoesNotMatch. أبقِ عنونة virtual-host ولا تفعل path-style؛ يظهر هذا الخطأ بوصفه 404 NoSuchBucket.

صفحات ذات صلة: وثائق الواجهة البرمجية · الخدمات السحابية من Tovanix · استخدام النطاقات

جارٍ التحميل…