در این صفحه، قراردادها و مقادیر Purge را بررسی می‌کنیم: شکل مسیر، سقف‌ها، گزینه‌های درخواست و نقش لازم. برای ثبت درخواست از API، پاکسازی کش دامنه (Purge) با API و برای مراحل پنل، پاکسازی کش دامنه (Purge) را دنبال می‌کنیم. برای آشنایی با رفتار غیرفعال Purge، پاکسازی کش (Purge) چگونه کار می‌کند؟ را مطالعه می‌کنیم.
مرجع OpenAPI را در CDN and DNS (v2.1) مطالعه می‌کنیم.
شکل مسیر
| شکل | مثال | معنی |
|---|---|---|
| مسیر مطلق فایل | /images/a.png | فقط همان کلید |
| پیشوند مسیر | /images/* | همه‌ی مسیرهایی که با آن پیشوند شروع می‌شوند |
- کاراکتر
*فقط باید آخرین کاراکتر مسیر باشد. - الگوی glob یا regex پشتیبانی نمی‌شود.
- در فرم پنل، در هر خط فقط یک مسیر وارد می‌شود.
سقف‌ها
به‌ازای هر hostname (همه‌ی درخواست‌های فعال)
| محدودیت | مقدار |
|---|---|
| درخواست Purge فعال هم‌زمان | حداکثر ۱۰۰ |
| مسیر مطلق در مجموع درخواست‌های فعال | حداکثر ۲۰ هزار |
مسیر پیشوندی (خاتمه‌یافته به *) در مجموع | حداکثر ۱ هزار |
ثبت درخواست به‌معنی انجام فوری Purge روی همه‌ی لبه‌ها نیست. منابع Purge پس از حدود ۲۴ ساعت به‌صورت خودکار حذف می‌شوند.
فرم پنل
| محدودیت | مقدار |
|---|---|
| مسیر در هر ارسال فرم | حداکثر ۳۰ |
برای تعداد بیشتر، ارسال را تکرار می‌کنیم یا از پاکسازی کش دامنه (Purge) با API استفاده می‌کنیم.
نقش لازم
درخواست API فقط با نقش cdn-purger مجاز است. تعریف نقش‌ها در شبکه توزیع محتوا (CDN) ستون چیست؟ آمده است.
درخواست از API نسخه ۲.۱
آدرس:
POST https://api.sotoon.ir/delivery/v2.1/global/workspaces/<workspaceUUID>/purges| گزینه | الزامی | توضیح |
|---|---|---|
| نام درخواست | بله | نام یکتا برای این درخواست Purge در فضای کاری |
| hostname | بله | hostname همان CDN؛ باید با دامنه‌ی پیکربندی‌شده یکی باشد |
| زیردامنه‌ها | خیر | زیردامنه‌هایی که همراه دامنه اصلی Purge می‌شوند؛ هر مورد به ابتدای hostname اضافه می‌شود. خود hostname را دوباره در این فهرست نمی‌آوریم |
| مسیرها | بله | حداقل یک مسیر؛ مطلق یا پیشوندی با * در انتها |
شناسه فضای کاری را از فضاهای کاری کپی می‌کنیم.
API قدیمی منسوخ است
آدرس
https://purge.edge.sotoon.irمنسوخ شده است. مراحل مهاجرت و نمونه درخواست در پاکسازی کش دامنه (Purge) با API است.