जावास्क्रिप्ट एसडीके के साथ फाइलों को स्टोर और सर्व करें
क्लाइंट.स्टोरेज के साथ प्रतिदिन स्टोरेज प्रवाहित होता है: बकेट प्रबंधन, एकल और मल्टीपार्ट अपलोड, स्ट्रीमिंग डाउनलोड, HMAC हस्ताक्षरित यूआरएल, और ट्रैश बहाली।
बाल्टी प्रबंधन#
एक बकेट फ़ाइलों को समूहित करता है और तय करता है कि वे सार्वजनिक हैं या नहीं। बकेट बनाने और हटाने के लिए service_role कुंजी की आवश्यकता होती है। लिस्टिंग बकेट के लिए एक साइन-इन उपयोगकर्ता या service_role कुंजी की आवश्यकता होती है (अनाम कुंजी 403 FORBIDDEN प्राप्त करती है)।
// एक सार्वजनिक बकेट बनाएं (कोई भी एपीआई कुंजी के बिना ऑब्जेक्ट पढ़ सकता है)
await admin.storage.createBucket('avatars', { public: true })
// एक निजी बकेट बनाएं (केवल ऑब्जेक्ट स्वामी या service_role ही पढ़ सकते हैं)
await admin.storage.createBucket('invoices', {
public: false,
fileSizeLimit: 10 * 1024 * 1024, // प्रति फ़ाइल 10 MiB सीमा
allowedMimeTypes: ['application/pdf'],
})
// सुलभ बाल्टियों की सूची बनाएं
const { data: buckets, error } = await admin.storage.listBuckets()
एक बकेट fileSizeLimit (बाइट्स में) और allowedMimeTypes को भी स्वीकार करता है। एक अपलोड जो बहुत बड़ा है वह 413 PAYLOAD_TOO_LARGE लौटाता है, और एक प्रकार जिसकी अनुमति नहीं है वह 400 BAD_REQUEST लौटाता है।
अपलोड करें, डाउनलोड करें, सूचीबद्ध करें, हटाएं#
const bucket = aura.storage.from('invoices')
// अपलोड करें: एक फ़ाइल, ब्लॉब, बफ़र, या Uint8Array
// फ़ाइलें > 5 MiB स्वचालित रूप से मल्टीपार्ट भागों में विभाजित हो जाती हैं
const { data, error } = await bucket.upload(`${user.id}/2026-10.pdf`, file, {
contentType: 'application/pdf',
onUploadProgress: (progress) => {
console.log(`Upload progress: ${progress.percentage}%`)
},
})
// → { कुंजी, बाल्टी, यूआरएल, आकार, सामग्री_प्रकार, ईटैग }
// वर्तमान उपयोगकर्ता के स्वामित्व वाली मौजूदा फ़ाइल को बदलें
await bucket.upload(`${user.id}/2026-10.pdf`, newFile, { upsert: true })
// किसी उपसर्ग/फ़ोल्डर के अंतर्गत फ़ाइलों को सूचीबद्ध करें
const { data: files } = await bucket.list({ prefix: `${user.id}/` })
// फ़ाइल को ब्लॉब के रूप में डाउनलोड करें
const { data: blob, error: downloadError } = await bucket.download(`${user.id}/2026-10.pdf`)
// संपूर्ण फ़ाइल को मेमोरी में लोड किए बिना स्ट्रीम डाउनलोड करें
const { data: stream } = await bucket.download(`${user.id}/2026-10.pdf`).asStream()
// एक फ़ाइल हटाएं (30-दिवसीय प्रतिधारण के साथ डिफ़ॉल्ट रूप से ट्रैश में ले जाया गया)
await bucket.remove([`${user.id}/2026-10.pdf`])
// स्थायी विलोपन (कचरे को बायपास करता है और तुरंत डिस्क कोटा मुक्त करता है)
await bucket.remove([`${user.id}/2026-10.pdf`], { permanent: true })
मुख्य रनटाइम व्यवहार:
- किसी मौजूदा पथ को अपलोड करने से
409 CONFLICTमिलता है जब तकupsert: trueप्रदान नहीं किया जाता है। - अज्ञात अपलोड को निजी और सार्वजनिक दोनों बकेट पर
403 FORBIDDENके साथ अस्वीकार कर दिया जाता है (लेखन के लिए प्रमाणित JWT या सेवा कुंजी की आवश्यकता होती है)। - पथ ट्रैवर्सल सुरक्षा:
..या अवैध वर्ण वाले पथ बिना संभाले गए अपवादों को फेंके बिना400 INVALID_PATHलौटाते हैं। - उपयोगकर्ता अलगाव: एक उपयोगकर्ता किसी अन्य उपयोगकर्ता (
owner_id = auth.uid()) के स्वामित्व वाली फ़ाइलों को अधिलेखित या हटा नहीं सकता है।${user.id}/...जैसे उपयोगकर्ता-स्कोप्ड फ़ोल्डरों का उपयोग करके संरचना पथ।
एक फ़ाइल साझा करें (सार्वजनिक और हस्ताक्षरित यूआरएल)#
// 1. सार्वजनिक बकेट: प्रत्यक्ष स्थायी यूआरएल (एपीआई कुंजियों के बिना परोसा गया)
const { data: { publicUrl } } = aura.storage.from('avatars').getPublicUrl('ada.png')
// → https://<slug>.localhost:8080/v1/storage/evatars/ada.png
// कस्टम फ़ाइल नाम के साथ अनुलग्नक के रूप में जबरदस्ती डाउनलोड करें
const downloadUrl = aura.storage.from('avatars').getPublicUrl('ada.png', {
download: 'avatar-ada.png',
})
// 2. निजी बकेट: HMAC कॉन्फ़िगर करने योग्य टीटीएल के साथ हस्ताक्षरित यूआरएल
const { data, error } = await aura.storage.from('invoices').createSignedUrl(
`${user.id}/2026-10.pdf`,
300, // 300 सेकंड (5 मिनट) के लिए वैध
{ download: true }
)
// data.signedUrl और data.url में HMAC हस्ताक्षरित URL होता है
// 3. गुप्त कुंजियाँ उजागर किए बिना सीधे ब्राउज़र अपलोड करें
// सर्वर-साइड (service_role):
const { data: uploadInfo } = await admin.storage.from('invoices').createSignedUploadUrl(
`${user.id}/document.pdf`,
600
)
// ब्राउज़र क्लाइंट (कोई API कुंजी आवश्यक नहीं):
await aura.storage.uploadToSignedUrl(uploadInfo.signedUrl, file, {
contentType: 'application/pdf',
})
हस्ताक्षरित यूआरएल HTTP विधि (GET या PUT), बाल्टी, कुंजी और समाप्ति टाइमस्टैम्प को सील करते हैं। एक बार समाप्त हो जाने पर या यदि ऑब्जेक्ट हटा दिया जाता है, तो अनुरोध 403 FORBIDDEN प्राप्त होते हैं।
कौन क्या कर सकता है (एक्सेस मैट्रिक्स)#
| कार्रवाई | अनाम कुंजी (anon) | साइन-इन किया हुआ उपयोगकर्ता (authenticated) | सेवा भूमिका (service_role) |
|---|---|---|---|
| सार्वजनिक बकेट में फ़ाइल पढ़ें | हाँ | हाँ | हाँ |
| एक निजी बकेट में फ़ाइल पढ़ें | नहीं (403) | केवल स्वामी (owner_id = auth.uid()) | हाँ |
| एक नई फ़ाइल अपलोड करें | नहीं (403) | हाँ (मालिक बन जाता है) | हाँ |
बदलें (upsert) या हटाएं | नहीं (403) | केवल स्वामी | हाँ |
| सार्वजनिक बकेट में फ़ाइलों की सूची बनाएं | हाँ | हाँ | हाँ |
| निजी बकेट में फ़ाइलों की सूची बनाएं | नहीं (403) | केवल स्वामी (RLS फ़िल्टर) | हाँ |
| बकेट बनाएं, अपडेट करें या हटाएं | नहीं (403) | नहीं (403) | हाँ |
| मिंट हस्ताक्षरित अपलोड यूआरएल | नहीं (403) | नहीं (403) | हाँ |
स्वामी की पहचान JWT विषय (auth.uid()) द्वारा की जाती है। सार्वजनिक और निजी दोनों बकेट पर, उपयोगकर्ता अन्य उपयोगकर्ताओं की वस्तुओं को अधिलेखित या नष्ट नहीं कर सकते।
स्थानांतरित करें, कॉपी करें, मेटाडेटा और ट्रैश करें#
// फ़ाइल की प्रतिलिपि बनाएँ (मूल सामग्री-प्रकार और कस्टम मेटाडेटा को सुरक्षित रखता है)
await admin.storage.copy('invoices', '2026/draft.pdf', '2026/archive.pdf')
// किसी फ़ाइल को स्थानांतरित करें या उसका नाम बदलें
await admin.storage.move('invoices', '2026/draft.pdf', '2026/final.pdf')
// ऑब्जेक्ट मेटाडेटा का निरीक्षण करें (आकार, MIME प्रकार, ETag, कस्टम मेटाडेटा)
const { data: meta } = await admin.storage.getMetadata('invoices', '2026/final.pdf')
// वर्तमान में कूड़ेदान में मौजूद वस्तुओं की सूची बनाएं (30-दिवसीय प्रतिधारण)
const { data: trashItems } = await admin.storage.from('invoices').listTrash()
// किसी ऑब्जेक्ट को ट्रैश से पुनर्स्थापित करें
await admin.storage.from('invoices').restore('2026/final.pdf')
वास्तविक समय छवि परिवर्तनों (आकार बदलना, प्रारूप रूपांतरण, रोटेशन) के लिए, स्टोरेज SDK संदर्भ देखें।