شروع با ابر ساروی

رایگان شروع کنید

Starter یک فضای اشتراکی با داده، کاربران، فایل‌ها، تابع‌ها و یک وب‌سایت مستقل است. برای شروع بستهٔ پولی یا کارت پرداخت لازم نیست. هر حساب یک ابر Starter دارد و آن ابر به پروژهٔ API انتخاب‌شده متصل است. کلید پروژهٔ دیگر به آن دسترسی ندارد.

ظرفیت Starter

ثبت‌نام و ورود چند عملیات داخلی مصرف می‌کنند. درخواست فایل‌های سایت نیز در همین سقف ماهانه حساب می‌شود. سقف‌ها جلوی عملیات جدید را می‌گیرند و باعث خرید یا برداشت خودکار نمی‌شوند. Starter برای نمونهٔ اولیه و کاربران اولیه است؛ SLA، پشتیبان‌گیری مدیریت‌شده و منابع اختصاصی ندارد. از داده‌های مهم نسخهٔ خروجی نگه دارید. ظرفیت اولیهٔ سرویس ۲۰ ابر است؛ در صورت تکمیل ظرفیت STARTER_CAPACITY برمی‌گردد.

ساخت و اتصال

با کلید Sarovi دارای cloud:read و cloud:write، POST /v1/cloud را بفرستید:

import json, os, urllib.request, urllib.error

payload = {
    "plan": "starter",
    "name": "محصول من"
}

request = urllib.request.Request(
    "https://api.sarovi.ir/v1/cloud",
    data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["SAROVI_API_KEY"],
        "Content-Type": "application/json"
    },
    method="POST"
)
try:
    with urllib.request.urlopen(request, timeout=300) as response:
        result = json.load(response)
        print(result)
except urllib.error.HTTPError as error:
    detail = json.load(error)
    raise RuntimeError(f"{error.code}: {detail['error'].get('code', detail['error'].get('type', 'HTTP_ERROR'))}") from error

پاسخ 201 شامل id و status=ready است. سپس GET /v1/cloud/{id}/connection را بخوانید. url آدرس اجرای برنامه و public_key کلید عمومی همان ابر است. کلید srv_ فقط برای مدیریت از سرور شماست؛ کلید scpub_ برای برنامه و توکن sct_ برای نشست کاربر استفاده می‌شود. کلید عمومی به‌تنهایی اجازهٔ دیدن دادهٔ خصوصی را نمی‌دهد.

حساب و اعتبار

همان حساب ساروی مدیریت را انجام می‌دهد. تولید AI همچنان از کیف اعتبار مشترک مصرف می‌کند. Starter هزینهٔ زیرساخت مشتری ندارد. بسته‌های micro/small/medium مربوط به زیرساخت اختصاصی هستند و ساخت آن‌ها فقط هنگام dedicated_available:true فعال است؛ نبودن آن را با خرید بسته حل نکنید. ارتقا یا انتقال داده خودکار نیست و بعداً باید جداگانه انجام شود.

انتخاب مسیر

ورود و کاربران · داده · فایل · تابع · انتشار سایت

حذف و خطاها

DELETE /v1/cloud/{id} با confirm_delete:true سایت و دادهٔ ابر را حذف می‌کند. پیش از حذف، داده و فایل‌ها را صادر کنید. خطاهای STARTER_*_LIMIT سقف بخش مربوط را نشان می‌دهند؛ RATE_LIMITED را با Retry-After دوباره امتحان کنید. تکرار درخواست ایجاد، نشست یا انتشار ممکن است اثر تکراری داشته باشد؛ نتیجهٔ قبلی و شناسهٔ منبع را بررسی کنید.