در
در اینجا دو نکته کلیدی وجود دارد که باید بدانید:
Cloud Storage for Firebase (حتی باکتهای پیشفرض) اکنون مستلزم آن است که پروژهها در طرح قیمتگذاری Blaze که به صورت پرداخت در محل است، قرار داشته باشند. استفاده رایگان حتی در طرح قیمتگذاری Blaze نیز همچنان در دسترس است.
تمام Cloud Storage for Firebase که پس از
سپتامبر ۲۰۲۴ ایجاد شدهاند، فرمت نامی برابر با دارند.PROJECT_ID .firebasestorage.app
برای جزئیات بیشتر در مورد تغییرات، سوالات متداول زیر را مرور کنید:
- الزامات صورتحساب و تجربه مورد انتظار
- تغییرات در Cloud Storage for Firebase
- تغییرات مربوط به تعاملات برنامهنویسی (مانند REST APIها و Terraform)
- تغییرات برای «منابع پیشفرض Google Cloud »
الزامات صورتحساب و رفع مشکلات
برای استفاده از Cloud Storage for Firebase ، پروژه فایربیس شما باید در طرح قیمتگذاری Blaze با پرداخت به ازای استفاده باشد. استفاده رایگان حتی در طرح قیمتگذاری Blaze نیز در دسترس است.
اگر پروژه Firebase شما در طرح قیمتگذاری Spark باشد، به هیچ یک از مخازن Cloud Storage (از جمله مخازن پیشفرض) دسترسی نخواهید داشت و فراخوانیهای API شما به مخازن، خطاهای ۴۰۲ یا ۴۰۳ را برمیگرداند.
چگونه دسترسی را بازیابی کنیم
برای بازیابی دسترسی و کیفیت خدمات به منابع و دادههای Cloud Storage ، طرح قیمتگذاری Blaze را به صورت پرداخت در حین استفاده ارتقا دهید. استفاده رایگان حتی در طرح قیمتگذاری Blaze، از جمله برای نسخه قدیمی شما، همچنان در دسترس است.*.appspot.com به صورت پیشفرض ذخیره میشود.
عدم دسترسی در کنسول
اگر پروژه شما در طرح قیمتگذاری Spark باشد، دیگر به Bucket خود در کنسول Firebase و کنسول Google Cloud دسترسی نخواهید داشت. در عوض، به صفحه فرود Cloud Storage هدایت میشوید که در آنجا میتوانید به طرح قیمتگذاری Blaze ارتقا دهید.
خطاهای ۴۰۲ و ۴۰۳
اگر پروژه شما در طرح قیمتگذاری Spark باشد، فراخوانیهای شما به APIهای Cloud Storage (مانند فراخوانی از برنامه شما) با شکست مواجه شده و خطاهای ۴۰۲ یا ۴۰۳ را برمیگرداند. دستورالعملهای مربوط به نحوه بازیابی دسترسی در بالا را دنبال کنید یا گزینههای عیبیابی بیشتر را در زیر بررسی کنید.
خطاهای ۴۰۲
"error": {
"code": 402,
"message": "Cloud Storage for Firebase no longer supports Firebase projects that are on the no-cost Spark pricing plan. Please upgrade to the pay-as-you-go Blaze pricing plan to maintain access to your default bucket and all other Cloud Storage resources. For details, see our FAQ: https://firebase.google.com/docs/storage/faqs-storage-changes-announced-sept-2024"
}
یا
storage/quota-exceeded: Firebase Storage: Quota for bucket '{project-id}.appspot.com' exceeded, please view quota on https://firebase.google.com/pricing/. (storage/quota-exceeded)
خطاهای ۴۰۳
<Error>
<Code>UserProjectAccountProblem</Code>
<Message>The project to be billed is associated with an absent billing account.</Message>
<Details>The billing account for the owning project is disabled in state absent</Details>
</Error>
یا
storage/unauthorized: User does not have permission to access {path}
عیبیابی
اگر با مشکلی مواجه شدید، این منابع عیبیابی را بررسی کنید. اگر هیچ یک از موارد زیر به مشکل شما کمک نکرد، با پشتیبانی Firebase تماس بگیرید .
عیبیابی تنظیمات صورتحساب
مستندات Cloud Billing برای مشکلات رایج صورتحساب و پرداخت، راهنماییهایی برای عیبیابی ارائه میدهد. به عنوان مثال، اگر کارت نقدی یا اعتباری هندی شما پذیرفته نمیشود ، میتوانید راهحلهایی پیدا کنید.
عیبیابی مجوزهای حساب سرویس
برای اینکه Cloud Storage for Firebase به درستی کار کند، یک حساب کاربری سرویس در پروژه فایربیس شما به مجوزهای IAM خاصی نیاز دارد.
اگر در کنسول Firebase در مورد مجوزهای این حساب سرویس خطایی دریافت میکنید، اغلب به این دلیل است که حساب سرویس از پروژه Firebase شما حذف شده است. برای حل این مشکل، مراحل شرح داده شده در این سوالات متداول را دنبال کنید.
سوالات متداول طرح قیمت گذاری
برای استفاده از Cloud Storage for Firebase ، پروژه فایربیس شما باید در طرح قیمتگذاری Blaze با پرداخت به ازای استفاده باشد. استفاده رایگان حتی در طرح قیمتگذاری Blaze نیز در دسترس است.
ما درک میکنیم که این تغییرات به زمان شما برای ارزیابی و ایجاد تغییرات در پروژه Firebase و گردشهای کاری شما نیاز دارد. در صورت داشتن هرگونه سؤال، لطفاً با پشتیبانی Firebase تماس بگیرید.
الزامات صورتحساب زیر برای همه پروژههایی که از Cloud Storage for Firebase استفاده میکنند، اعمال میشود:
برای تهیه یک باکت پیشفرض جدید با استفاده از کنسول Firebase یا REST API، پروژه شما باید در طرح قیمتگذاری Blaze با پرداخت به ازای استفاده باشد.
تمام سطلهای پیشفرض ارائه شده پس از
سپتامبر ۲۰۲۴ دارای این مشخصات هستند:این باکتها از قیمتگذاری و نحوهی استفاده Google Cloud Storage پیروی میکنند که یک سطح «همیشه رایگان» برای باکتها در نظر گرفته است.
US-CENTRAL1،US-EAST1، وUS-WEST1.قالب نام سطلها به صورت زیر است:
PROJECT_ID .firebasestorage.app(به جای مورد قبلی)PROJECT_ID .appspot.com).
برای حفظ دسترسی به باکت پیشفرض و سایر منابع Cloud Storage ، پروژه شما باید در طرح قیمتگذاری Blaze با پرداخت در محل باشد. هرگونه
حتی در طرح قیمتگذاری Blaze، باکت پیشفرض *.appspot.comسطح استفاده رایگان فعلی خود را حفظ میکند.
درباره اینکه اگر به طرح قیمتگذاری Blaze ارتقا ندهید چه اتفاقی میافتد، بیشتر بدانید. در صورت داشتن هرگونه سوال، لطفاً با پشتیبانی Firebase تماس بگیرید.
فایربیس تلاش میکند تا محصولات و اکوسیستم خود را ایمن و مطمئن نگه دارد. به عنوان بخشی از این تلاش، ما در حال ایجاد تغییراتی در Cloud Storage for Firebase و انجام اقدامات پیشگیرانه برای جلوگیری از سوءاستفاده در پلتفرم خود هستیم. این شامل بهروزرسانی زیرساختهای ما برای هماهنگی بهتر با سهمیه و صورتحساب Google Cloud Storage میشود.
بله. اگر داریدPROJECT_ID .appspot.com استفاده میکنید و طرح قیمتگذاری Blaze را به صورت پرداخت در حین استفاده ارتقا میدهید، سطح استفاده رایگان فعلی سطل پیشفرض خود را، همانطور که در زیر توضیح داده شده است، حفظ میکنید. هرگونه استفاده بیش از این استفاده رایگان، طبق قیمتگذاری Google App Engine محاسبه میشود.
- ۵ گیگابایت ذخیره شده
- ۱ گیگابایت دانلود در روز
- ۲۰،۰۰۰ آپلود در روز
- ۵۰،۰۰۰ دانلود در روز
از PROJECT_ID .firebasestorage.app و آنها از قیمتگذاری و استفاده از Google Cloud Storage پیروی میکنند، که یک ردیف "همیشه رایگان" برای سطلها در ... فراهم میکند.US-CENTRAL1 ،US-EAST1 ، وUS-WEST1 .
برای ارتقاء پروژه خود به طرح قیمتگذاری پرداخت در محل Blaze، باید پروژه خود را به یک حساب Cloud Billing متصل کنید. میتوانید از گردش کار کنسول Firebase برای ارتقاء طرح قیمتگذاری خود استفاده کنید .
برای ارتقاء طرح قیمتگذاری، باید نقش IAM مالک پروژه خود را داشته باشید.
اگر سوالی دارید، لطفاً با پشتیبانی Firebase تماس بگیرید.
برای استفاده از Cloud Storage for Firebase یا برای حفظ دسترسی بهPROJECT_ID .appspot.com به صورت پیشفرض، شما باید طرح قیمتگذاری Blaze را به صورت پرداخت در محل ارتقا دهید. این الزام از
برای ارتقاء پروژه خود، آن را به یک حساب Cloud Billing متصل کنید. میتوانید از گردش کار کنسول Firebase برای ارتقاء طرح قیمتگذاری خود استفاده کنید .
اگر هنوز یک فضای Cloud Storage پیشفرض در پروژه خود فراهم نکردهاید، نمیتوانید آن را فراهم کنید، مگر اینکه پروژه شما در طرح قیمتگذاری Blaze باشد.
اگر از قبل باکتهایی دارید و پروژه شما در طرح قیمتگذاری Blaze نیست، موارد زیر اتفاق میافتد:
شما دسترسی خواندن/نوشتن به تمام منابع Cloud Storage خود، از جمله سطل پیشفرض خود را از دست میدهید.
شما نمیتوانید در کنسول Firebase یا کنسول Google Cloud ، باکتها را مشاهده کنید یا به دادههای آنها دسترسی داشته باشید.
هرگونه دادهای در سطلهای شما باقی خواهد ماند، اما تا زمانی که به طرح قیمتگذاری Blaze ارتقا ندهید، غیرقابل دسترسی خواهد بود.
اگر سوالی دارید، لطفاً با پشتیبانی Firebase تماس بگیرید.
اگر شما یکPROJECT_ID .appspot.com به صورت پیشفرض در دسترس است، و شما با مصرفی بیش از سطوح استفاده رایگان که در زیر توضیح داده شده است، به طرح قیمتگذاری Blaze ارتقا میدهید، سپس هزینه اضافی طبق قیمتگذاری Google App Engine در چرخه صورتحساب بعدی شما محاسبه خواهد شد.
- ۵ گیگابایت ذخیره شده
- ۱ گیگابایت دانلود در روز
- ۲۰،۰۰۰ آپلود در روز
- ۵۰،۰۰۰ دانلود در روز
اگر سوالی دارید، لطفاً با پشتیبانی Firebase تماس بگیرید.
تغییرات برای فضای Cloud Storage پیشفرض
برای جزئیات بیشتر در مورد این الزامات، سوالات متداول زیر را بررسی کنید. در صورت داشتن هرگونه سوال، لطفاً با پشتیبانی Firebase تماس بگیرید.
خیر. وقتی به طرح قیمتگذاری Blaze ارتقا میدهید، نام فضای Cloud Storage پیشفرض شما تغییر نمیکند .
اگر سطل پیشفرض خود را قبل از
سپتامبر ۲۰۲۴ ایجاد کردهاید ، قالب نام سطل پیشفرض شما به صورت زیر است:PROJECT_ID .appspot.comتنها استثنا این است که اگر اطلاعات خود را حذف کنید
باکت ایجاد کنید و یک باکت پیشفرض جدید ایجاد کنید.*.appspot.comرااگر سطل پیشفرض خود را اخیراً ( بعد از
سپتامبر ۲۰۲۴ ) ایجاد کردهاید ، قالب نام سطل پیشفرض شما به صورت زیر است:PROJECT_ID .firebasestorage.app
یک سطل حذف شده با استفاده از API مربوط به Cloud Storage Buckets: restore تا زمانی که زمان حذف سخت آن سپری نشده باشد، قابل بازیابی است.
اگر اطلاعات خود را حذف کنیدPROJECT_ID .appspot.com ، نمیتوانید سطلی با همان نام و فرمت ایجاد کنید.
در عوض، میتوانید یک سطل Cloud Storage پیشفرض جدید (اگر پروژه شما در طرح قیمتگذاری Blaze است) ایجاد کنید که قالب نام آن ... باشد.PROJECT_ID .firebasestorage.app . این برنامه از قیمتگذاری و نحوهی استفاده Google Cloud Storage پیروی میکند که یک لایهی «همیشه رایگان» برای باکتها در ... فراهم میکند.US-CENTRAL1 ،US-EAST1 ، وUS-WEST1 .
خیر. نیازی به بهروزرسانی کدبیس برنامهتان ندارید .
همه موجودPROJECT_ID .appspot.com فرمت نام خود را حفظ میکنند.
تا زمانی که پروژه شما در طرح قیمتگذاری Blaze با پرداخت در محل باشد، کدبیس شما به تعامل با ... ادامه خواهد داد.PROJECT_ID .appspot.com به عنوان باکت پیشفرض استفاده میشود.
خیر. نیازی نیست دادههای خود را از سیستم خود خارج کنید.PROJECT_ID .appspot.com به صورت پیشفرض در باکت قرار دارد.
تا زمانی که پروژه خود را به طرح قیمتگذاری پرداخت در محل Blaze ارتقا دهید، به سطل خود دسترسی خواهید داشت و هیچ وقفهای در سرویسدهی نخواهید دید.
تغییرات مربوط به تعاملات برنامهنویسی (مانند REST APIها و Terraform)
اگر از طریق برنامهنویسی (مثلاً با استفاده از REST API یا Terraform) با Cloud Storage for Firebase کار میکنید یا آن را فراهم میکنید، تغییرات زیر را بررسی کنید تا ببینید آیا نیاز به تغییر چیزی در گردشهای کاری یا برنامههای خود دارید یا خیر.
برای جزئیات بیشتر در مورد این الزامات، سوالات متداول زیر را بررسی کنید. در صورت داشتن هرگونه سوال، لطفاً با پشتیبانی Firebase تماس بگیرید.
تغییرات زیر برای APIهای REST که شامل Cloud Storage for Firebase میشوند، اعمال میشود:
نقطه پایانی
projects.defaultBucket.createتغییر کرده است:برای فراخوانی این نقطه پایانی، پروژه شما باید در طرح قیمتگذاری Blaze با شرایط پرداخت به ازای استفاده باشد.
سطلهای پیشفرض ارائه شده توسط این نقطه پایانی، قالب نامی به صورت زیر دارند:
PROJECT_ID .firebasestorage.app(به جای مورد قبلی)PROJECT_ID .appspot.com).این سطلهای پیشفرض از قیمتگذاری و میزان استفاده Google Cloud Storage پیروی میکنند که یک ردیف «همیشه رایگان» برای سطلها در ... فراهم میکند.
US-CENTRAL1،US-EAST1، وUS-WEST1.
نقاط پایانی
projects.defaultLocation.finalizeوprojects.availableLocations.listخاموش شدهاند و خطاهای404: METHOD_NOT_FOUNDرا برمیگردانند.در عوض، برای تنظیم مکان یک منبع به صورت برنامهنویسی، باید از APIهای مختص منبع استفاده کنید. به عنوان مثال، مکانهای باکت پیشفرض Cloud Storage و نمونه پیشفرض Cloud Firestore را در طول آمادهسازی جداگانه آنها، هنگام فراخوانی
projects.defaultBucket.createوprojects.databases.create، به ترتیب تنظیم کنید. برای جزئیات بیشتر در مورد جایگزینی APIها و مکانهای REST، به سوالات متداول مراجعه کنید: چگونه میتوانم مکان یک "منبع پیشفرض Google Cloud " را تنظیم یا دریافت کنم؟
تغییرات زیر در استفاده از Terraform با Cloud Storage for Firebase اعمال میشود:
شما دیگر نمیتوانید با استفاده از Terraform، Cloud Storage for Firebase فراهم کنید. دلیل این امر این است که دیگر نمیتوانید این باکت را از طریق Google App Engine فراهم کنید. در عوض، میتوانید یکی از موارد زیر را انجام دهید:
با فراخوانی
projects.defaultBucket.create، باکت را آماده کنید. این API هنوز از طریق Terraform در دسترس نیست.سطل را از طریق کنسول Firebase آماده کنید. برای شروع، در کنسول Firebase به Databases & Storage > Storage بروید.
علاوه بر این، به نکات زیر در مورد*.firebasestorage.app باکتهای پیشفرض (که پس از
برای تهیهی یک فضای Cloud Storage پیشفرض، پروژهی شما باید در طرح قیمتگذاری پرداخت در محل Blaze باشد.
دیگر نیازی نیست قبل از مخزن Cloud Storage پیشفرض، نمونه پیشفرض Cloud Firestore خود را آماده کنید.
مکانی که برای نمونه پیشفرض Cloud Firestore خود انتخاب میکنید، برای مخزن Cloud Storage پیشفرض شما قابل استفاده نیست (این بدان معناست که نمونه پیشفرض Cloud Firestore و مخزن Cloud Storage پیشفرض شما میتوانند در مکانهای مختلفی باشند).
قالب نام باکت پیشفرض Cloud Storage به صورت زیر است:
PROJECT_ID .firebasestorage.app(به جای مورد قبلی)PROJECT_ID .appspot.com).
تغییرات برای «منابع پیشفرض Google Cloud »
«منابع پیشفرض Google Cloud » هرگونه منبع پروژه مرتبط با Google App Engine از جمله موارد زیر است:
- نمونه پیشفرض Cloud Firestore
- Cloud Storage for Firebase (بهویژه آنهایی که فرمت نامشان ... است)
PROJECT_ID .appspot.com) - Google Cloud Scheduler (بهطور خاص برای توابع زمانبندیشده نسل اول)
با تغییرات زیادی که در طول سالها در اکوسیستم فایربیس رخ داده، ارتباط منابع مرتبط با فایربیس با Google App Engine نیز در حال تغییر بوده است.
برای جزئیات بیشتر در مورد این الزامات، سوالات متداول زیر را بررسی کنید. در صورت داشتن هرگونه سوال، لطفاً با پشتیبانی Firebase تماس بگیرید.
«مکان منابع پیشفرض Google Cloud » تنظیم مکان برای هرگونه منبع پروژه مرتبط با Google App Engine است، از جمله موارد زیر:
- نمونه پیشفرض Cloud Firestore
- Cloud Storage for Firebase (بهویژه آنهایی که فرمت نامشان ... است)
PROJECT_ID .appspot.com) - Google Cloud Scheduler (بهطور خاص برای توابع زمانبندیشده نسل اول)
وقتی هر یک از این منابع را در پروژه خود تنظیم میکنید، به طور موقت مکان برنامه Google App Engine را در پروژه خود تنظیم میکنید. این به نوبه خود، مکان همه منابع مرتبط با Google App Engine را تعیین میکند.
به موارد زیر توجه کنید:
هر باکت Cloud Storage پیشفرض که قبل از
سپتامبر ۲۰۲۴ ارائه شده باشد (با فرمت نام ...PROJECT_ID .appspot.com) با Google App Engine مرتبط است. این به معنی موارد زیر است:- مکان سطل، مکان منابع مرتبط با Google App Engine را تعیین میکند (مانند مکان نمونه پیشفرض Cloud Firestore ).
هر باکت Cloud Storage پیشفرض که پس از
سپتامبر ۲۰۲۴ ارائه شده باشد (با فرمت نام ...PROJECT_ID .firebasestorage.app) با Google App Engine مرتبط نیست . این به معنی موارد زیر است:تأمین فضای Cloud Storage پیشفرض شما، مکان منابع مرتبط با Google App Engine را تعیین نمیکند (مانند مکان نمونه پیشفرض Cloud Firestore ).
تأمین نمونه پیشفرض Cloud Firestore شما، مکان سطل Cloud Storage پیشفرض پروژه شما را تعیین نمیکند.
مکانهای موجود برای فضای Cloud Storage پیشفرض شما، همان مکانهای موجود برای Google Cloud Storage هستند (و محدود به مکانهای موجود برای Google App Engine نیستند).
«منابع پیشفرض Google Cloud » هرگونه منبع پروژه مرتبط با Google App Engine از جمله موارد زیر است:
- نمونه پیشفرض Cloud Firestore
- Cloud Storage for Firebase (بهویژه آنهایی که فرمت نامشان ... است)
PROJECT_ID .appspot.com) - Google Cloud Scheduler (بهطور خاص برای توابع زمانبندیشده نسل اول)
مفهوم «منابع پیشفرض Google Cloud » در مورد باکتهای پیشفرض Cloud Storage با فرمت نام ... صدق نمیکند.PROJECT_ID .firebasestorage.app و این سطلها با Google App Engine مرتبط نیستند . برای کسب اطلاعات بیشتر، سوالات متداول را مرور کنید: چه اتفاقی برای «مکان منابع پیشفرض Google Cloud » افتاد؟
اگر میخواهید مکان هر منبعی را در یک پروژه تنظیم یا دریافت کنید، باید مستقیماً با آن منبع تعامل داشته باشید.
Cloud Storage for Firebase
در کنسول Firebase :
- مکان یک مخزن Cloud Storage پیشفرض را در بخش ذخیرهسازی کنسول Firebase تنظیم و پیدا کنید.
استفاده از API های REST:
هنگام فراخوانی
projects.defaultBucket.create، مکان یک باکت Cloud Storage پیشفرض را در حین آمادهسازی آن تنظیم کنید.توجه داشته باشید که فراخوانی این نقطه پایانی نیاز به طرح قیمتگذاری پرداخت به ازای استفاده Blaze دارد. بنابراین قبل از تلاش برای ایجاد یک سطل پیشفرض، مطمئن شوید که پروژه به یک حساب Cloud Billing متصل است (برای مثال، با استفاده از
projects.updateBillingInfo).با استفاده از
projects.buckets.getمکان یک باکت Cloud Storage پیشفرض را دریافت کنید.
نمونه پیشفرض Cloud Firestore
توجه داشته باشید که اگر سابقهی کاری دارید*.appspot.com به عنوان باکت پیشفرض (که قبل از
در کنسول Firebase :
- مکان یک نمونه پیشفرض Cloud Firestore را در بخش Firestore کنسول Firebase تنظیم و پیدا کنید.
استفاده از API های REST:
هنگام فراخوانی
projects.databases.create، مکان نمونه پیشفرض Cloud Firestore را در حین آمادهسازی آن تنظیم کنید.با استفاده از
projects.databases.get، مکان یک نمونه پیشفرض Cloud Firestore را دریافت کنید.
توابع زمانبندیشده (نسل اول)
توجه داشته باشید که اگر سابقهی کاری دارید*.appspot.com به صورت پیشفرض ( قبل از
مکان یک تابع زمانبندیشده را در طول راهاندازی و استقرار آن تنظیم کنید.
مکان یک تابع زمانبندیشده را از نام موضوعِ وظیفه و تابع آن در کنسول Google Cloud دریافت کنید (
firebase-schedule- FUNCTION_NAME - REGION.