プランの制限は、そのプランのすべてのアカウントで同じです。無料プランでは、有料プランにすればほとんどの制限がすぐに上がり(glac billing plan paid)、呼び出しの拒否もそう伝えます。一部の制限は、アカウントがプランを超える量を必要とする場合に、アカウントごとにも引き上げます。この方法で解除できる拒否は、メッセージにそう示され(「ask us to raise it for this account」)、その docs_url は該当するエラーを指します。アカウントは、下記の API 呼び出し 1 回で申請します。
引き上げるもの
| 項目 | 拒否のコード | 対応内容 |
|---|---|---|
| アカウントが同時に持てる量と作成の速さ:稼働中のサンドボックスとインスタンス、その vCPU とメモリ、スリープ中に保持するサンドボックス、1 つのリージョンでのアプリのインスタンス、1 分間のサンドボックスの作成数と、プロジェクトごとの 1 時間の作成数、1 時間のキューブとバージョンの作成数 | 403 plan_cap_reached。param が上限を示す |
どれについても、アカウント独自の数値を設定する |
| 有料プランで、プロジェクトが保持するドライブとボリュームの数 | 403 drive_limit_reached, volume_limit_reached |
アカウント独自の数値を設定する。有料プランではソフトリミット |
| どのプランの上限も超える、ドライブやボリュームのサイズ | 同上 | エンタープライズアカウントで、最大 16 TiB のドライブを使えるようにする |
| アカウントのカードに 1 か月に請求できる額:信頼レベル | 403 trust_limit_exceeded |
自動で上がるより早くレベルを引き上げる |
アカウントに設定した数値は、取り消されるまで、どのプランに移っても有効です。GET /v1/account(glac account)は、アカウントが同時に持てる量の各上限について、使用量と、誰の数値か(caps:source は plan か operator)を示し、キーのプロジェクトが保持するドライブとボリュームの状況(keeps:数、1 つの最大サイズ、全体の合計サイズの上限と、それぞれプロジェクトが持っている量、サイズを指定せずに作った場合のサイズ)も示します。数値がアカウント独自のものである場合、拒否のメッセージには「this account may」と示されます。
申請方法
コンソールでは、アカウントの Limits ページに、これらの各上限が、現在の数値、使用量、誰の数値かとともに一覧表示されます。上限の行の Ask for more で、必要な数値と用途を添えて申請でき、申請はその下に回答とともに一覧表示されます。
または、admin を許可したキーで API から申請します。
curl -X POST https://api.glac.ai/v1/limits/requests \
-H "Authorization: Bearer $GLAC_API_KEY" -H 'Content-Type: application/json' \
-d '{"limit": "vcpus", "wanted": 64, "why": "a build farm of eight sandboxes of 8 vCPUs"}'limit:上限。拒否のparamと、GET /v1/accountのcapsの下で示される名前で指定します:instances、vcpus、memory_bytes、sleeping、app_instances、creates_per_minute、creates_per_hour_per_project、app_creates_per_hour。またはプロジェクトが保持するもの:volumes(ドライブとボリュームの数)かvolume_bytes(1 つの最大サイズ。最大 16 TiB)です。wanted:アカウントに必要な数値で、現在の値より大きいもの。memory_bytesとvolume_bytesはバイト単位です。why:必要な理由。1〜2,000 文字です。
レスポンスは申請(limit_request。id は lrq-…)で、pending の状態で、申請時のアカウントの数値(from)を持ちます。申請しただけでは何も変わりません。1 つの上限について同時に出せる申請は 1 つで、同じ上限の別の申請は、待機中の申請を示す 409 limit_request_pending で拒否されます。GET /v1/limits/requests はアカウントの申請を新しい順に一覧表示し、GET /v1/limits/requests/{id} は 1 つを読み取ります。どのプロジェクトのキーでも同じものが見えます。
**回答。**承認すると、申請は granted になり、それ以降のアカウントの数値(granted。ドライブやボリュームのサイズは GiB の整数)を示します。却下すると refused になり、理由(answer)を示します。いずれの場合も、アカウントの各プロジェクトのイベント(limit_request.granted、limit_request.refused:GET /v1/events と、それを受け取る Webhook)と、アカウントのアドレスへのメールで伝えられます。承認された数値は、上の表のとおりアカウント独自のものです。
呼び出しで指定できないもの(たとえば、自動で上がるより早い信頼レベルの引き上げ)については、アカウントの ID(glac account、または GET /v1/account の id)、拒否された呼び出しの code と request_id、必要なものを添えて support@glac.ai にご連絡ください。