Перейти к основному содержимому

Licence server: MonoPbx Cloud error codes (LIC-CLOUD-*)

Answered by the licence server's cloud routes (GET /v1/cloud/catalogue, /v1/portal/cloud/*, POST /v1/cloud/bootstrap) as application/problem+json (type, title, status, code). Design: cloud-offering.md; internal guides: cloud-provisioning.md, cloud-ops.md. The website's Cloud card shows each code's text in nine locales.

CodeStatusWhereMeaningWhat to do
LIC-CLOUD-OFF404every cloud routeMonoPbx Cloud is not offered by this licence server: [cloud] enabled = false (the default), no Stripe, no wizard parts set, or the price book has no [[cloud_plan]] named by cloud.plan.The website keeps the Cloud card hidden. Operators: see "Turning it on" in cloud-ops.md.
LIC-CLOUD-UNKNOWN404/v1/portal/cloud/instances/{id}*No such instance in the signed-in account (or it is deleted).Reload the account page.
LIC-CLOUD-USERS422create, usersThe number of users is outside the plan's min_users..max_users, or no size covers it.Choose a number in the range the card shows.
LIC-CLOUD-RESIZE422usersMore users than the instance's server size serves (cloud.sizes); a resize is a later row.Contact sales; the operator resizes by hand.
LIC-CLOUD-INTERVAL422createinterval: "year" in a currency whose cloud plan has no user_yearly_minor price (annual billing not offered there).Choose monthly billing, or another currency.
LIC-CLOUD-REGION422createThe region key is not in cloud.regions.Choose a listed region.
LIC-CLOUD-HANDLE-LENGTH422create (and available: false of the handle check)The handle has fewer than 3 or more than 40 characters.Choose another handle.
LIC-CLOUD-HANDLE-SYNTAX422create, handle checkA character outside [a-z0-9-], or a hyphen at an end or twice in a row.Choose another handle.
LIC-CLOUD-HANDLE-RESERVED422create, handle checkA reserved word (built in, or cloud.reserved_handles_extra).Choose another handle.
LIC-CLOUD-HANDLE-TAKEN409create, handle checkAnother living instance holds the handle. An unpaid request frees it after cloud.unpaid_request_hours (card) or 31 days (OXXO / SPEI).Choose another handle.
LIC-CLOUD-LIMIT409createThe account already has cloud.max_instances_per_account paid instances.Contact sales; the operator raises the limit.
LIC-CLOUD-STATE409users, cancelThe instance cannot change now: users only while the subscription is active and not cancelling; cancel not after it ended or was refunded.Reload the account page.
LIC-CLOUD-STALE412usersThe version sent is not the billing row's current one (another tab or a Stripe update changed it).Reload and try again.
LIC-CLOUD-RESIZE-NOT-OFFERED409POST /v1/portal/cloud/instances/{id}/resizeA larger server cannot be requested now: the size fits or is only getting close (watch), nothing larger is in the catalogue (on quote), the provider's resize does not give what is short (Google Cloud keeps the disk size), or the instance or its subscription is not active.The Cloud card shows the hint and the support link; support grows the server or the disk.
LIC-CLOUD-RESIZE-WAITING409POST /v1/portal/cloud/instances/{id}/resizeA resize of the instance is already planned (or failed and waits for the operator).Nothing to do: the card shows when it runs.
LIC-CLOUD-BOOTSTRAP-INVALID401POST /v1/cloud/bootstrapThe first-boot token is unknown, already used, expired (2 hours by default), the instance is not booting, or another server presented the token first.First boot retries a few times and gives up; the instance fails at the boot deadline (operator alert, refund, cleanup).
LIC-CLOUD-SETUP-URL400POST /v1/cloud/bootstrapThe first-administrator setup link is not https://<the instance's host name>/setup#token=...; the route mails only that server's own link.A first-boot script out of step with the licence server: update the pinned bundle.
LIC-CLOUD-LICENCE-BUSY409POST /v1/cloud/bootstrapThe licence billing made for this instance is attached to another server.Operator: detach it, then let first boot retry.
LIC-INSTALL-OTHER-ACCOUNT409POST /v1/cloud/bootstrapThe server's install is already linked to another licence account.Should not happen on a new server; rebuild the instance.
(job) final backups are not wired yet(job)cloud_jobs.last_error of stopAn ended instance is due to stop but the final backup hook refuses. The server stays up read-only; no notice goes out and nothing is deleted; the operator is alerted.Take the backup by hand or wire the backup hook, then requeue the stop job.

Shared codes the cloud routes also answer: LIC-PAYMENT-CURRENCY (a currency without a cloud price, or OXXO / SPEI in anything but pesos), LIC-PAYMENT-METHOD (a local method the operator did not turn on), LIC-EMAIL-UNVERIFIED, LIC-AUTH-INVALID (wrong password on cancel), LIC-STRIPE-UNAVAILABLE (Stripe did not answer; nothing was bought or changed), LIC-PORTAL-SESSION, LIC-CSRF, LIC-RATE-LIMITED.

The check-in of a cloud PBX whose subscription is unpaid past the grace, refunded or ended answers the signed LIC-LICENCE-SUSPENDED notice (state suspended, title "The MonoPbx Cloud subscription of this server is not paid ..."): the console is read-only until a payment arrives. | LIC-CLOUD-BACKUP-OFF | 503 | POST /v1/cloud/backup/sign, /list, /plan, GET /v1/cloud/backups/{id}/final | Cloud backups are not configured on this licence server ([cloud.backup] without bucket keys or at-rest key). | Operators: configure [cloud.backup] (cloud-reliability.md). The PBX retries its backup later. | | LIC-CLOUD-NOT-INSTANCE | 403 | POST /v1/cloud/backup/sign, /list, /plan | The calling install is not a MonoPbx Cloud server in service (never redeemed a first boot, or its instance was stopped or deleted). | Self-hosted installs use their own backup destination. | | LIC-CLOUD-BACKUP-REQUEST | 400 | POST /v1/cloud/backup/sign | method is not PUT, GET or DELETE, or name is not 1 to 128 characters of letters, digits, ., _ and - (no slash, no leading dot). | Fix the request. | | LIC-CLOUD-BACKUP-STORAGE | 503 | POST /v1/cloud/backup/sign, /list | The backup bucket could not be reached or listed. | Retry later; operators check the bucket key and the storage status. | | LIC-CLOUD-BACKUP-LINK | 404 | GET /v1/cloud/backups/{id}/final | The final backup link was altered, is for another instance or has expired (the backups were removed). | Ask support while the backups are still kept. |