Skip to content
Coritan Docs

Order more snapshot storage

Add snapshot storage to your account when your servers' snapshots need more room than their plans include.

View as Markdown

Snapshot storage is a service of its own that adds room to your account's snapshot allowance. It belongs to the account, so it covers the snapshots of every server you have, and it stays when a server is gone. Order it when your snapshots need more room than your server plans include, or to keep your snapshots after you cancel your last server.

  • Each storage service adds a fixed size to the allowance, up to 2 TB. Services add up, so order more than one for more room.
  • You pay on the order page. Credit on your account pays first, and a saved payment method, a new card or a wallet pays the rest (How the first payment works).
  • How snapshot storage works explains what counts against the allowance.

Open the order page in one of these ways:

  • In the dashboard, go to Snapshots and select Order Snapshot Storage at the top of the page.
  • Under the Storage used tile, select Order storage. A strip that says your storage is nearly full or over the allowance has Order Snapshot Storage too.
  • On a server's Snapshots tab, select Order more storage on the Snapshot storage card.
  • When you take a snapshot that does not fit, select Order more storage in the Not enough snapshot storage alert.
  • On Order a service, select the Snapshot Storage card under Storage.

The Snapshot storage card at the top of the page shows how much of your allowance is Used and how much is left, so you can see how much room you are short of. The Storage used tile on the Snapshots page shows the same.

  1. Under Size, choose a tier. Each one says how much it adds to the allowance and what that costs per GB a month, such as Adds 100 GB to the snapshot allowance on this account. 2.5¢/GB a month. An account in another currency reads the rate in its currency, such as €0.0233/GB a month.
  2. Choose the billing cycle with the buttons beside the Size heading, such as Monthly. A longer term names what it saves, such as Yearly · save 20%.
  3. Check the summary under Your order. It lists the tier with its billing cycle, with Change beside it, and the Total. On a phone the summary follows the tiers, and the bar at the bottom of the screen shows what is due and has the same button.
  4. If you have a promo code, enter it in Promo code. We check it as you type, and the message under the field says whether it applies. A code that cannot be used on this order greys out the button until you change or clear it.
  5. Under Due today, read what you pay now. Under Pay with, choose Account credit when it covers the amount, a saved payment method, a new card, or a wallet such as Google Pay. We start with your default saved method.
  6. Select the button under the summary. It reads Place order when nothing is due. When you pay now it names the amount due, such as Pay $2.50 and order. One click places the order and pays for it, and you stay on the page until it is done.

If we refuse the order or the payment is declined, the reason appears under the button and your choices stay as they were. We never place an order twice.

You can also buy a tier with a new server on App Deployment: on the server's order page, turn on the Snapshot Storage card under Add-ons and choose its Size (Order a server). It goes on the server's first invoice and becomes a storage service of its own.

You pay on the order page, so there is nothing to pay afterwards. Once the order is placed, its receipt page opens, titled Order placed. If the payment could not be taken after we placed the order, the invoice waits there (Pay and follow the order), and you can pay it later under Invoices. We add the storage once the invoice is paid.

What you ordered on the order's page shows the service's number, such as #1042. The Storage plans card on the Snapshots page shows it too.

We add the storage as soon as the service is set up. The order's page then reads Your order is ready, and its button opens the Snapshots page, where the Storage used tile shows the larger allowance. When the account was over its allowance and now fits, the tile is no longer red, the strip no longer says "Over the allowance", and we cancel the cleanup date.

The service renews each billing cycle until you cancel it. The Subscriptions tab of Billing lists it with Snapshot Storage in the Product column, and the Storage plans card on the Snapshots page lists it with its price and renewal date.

Change or cancel snapshot storage

Section titled Change or cancel snapshot storage

Each size is a plan of its own, so you cannot resize a storage service. For more room, order another one. For less, cancel one.

The Storage plans card on the Snapshots page, under the list and the Where your storage comes from card, has one row for each storage service on your account, with its number, its Status, its Price and the date it Renews. The card appears once you have a storage service. Open the menu at the end of a service's row:

  • Change plan… moves the service to another billing cycle of the same size, such as from monthly to annually. Choose the cycle under New plan on the page that opens, read What it costs today, then select Apply change (Change a service's plan). The item is greyed out while the service is suspended, not yet set up, or ending.
  • Cancel service… opens the Cancel this service? dialog. Under When, choose At the end of the current term or Immediately, type cancel, and select Cancel service (Cancel a service). Once a cancellation is scheduled, the row shows Ending and the date it ends under Renews.

A storage service also has a page of its own on the Subscriptions tab of Billing. Its Current plan and Cancel service cards do the same as this menu (Read a service's page).

Warning

When a storage service ends, its room leaves the allowance. Ending the storage deletes no snapshot by itself. If your snapshots no longer fit, a grace period starts, and after it we delete the oldest snapshots until the rest fit (When the account is over).

If a renewal invoice goes unpaid and we suspend the service, the account keeps the room until the service ends.

No Snapshot Storage plans on sale
Coritan does not sell snapshot storage to your account right now. Select Contact support if you expected it, or See all products to choose another product.
Could not load the plans
The tiers did not load. Select Try again, or reload the page.
Could not load the snapshot allowance
The card at the top of the page could not read your allowance. Select Try again on it. You can still order a tier.
Could not load your storage plans
The Storage plans card could not read your storage services. Select Try again on it.
The Storage plans card is missing
You have no storage service, or every one has ended. The allowance your server plans include still shows on the Storage used tile.
The button under the summary is greyed out
The line under the button says why, such as This plan has no price yet. Select it to go to the Size section, and choose another tier.
The allowance has not grown
We add the storage once the service is set up, which waits for the first invoice to be paid. Pay it from Invoices.
Over the allowance still shows, or the Storage used tile is still red
The new storage does not cover everything your snapshots take. Delete snapshots you no longer need (Lock, download and delete snapshots), or order more storage.
You need more than 2 TB in one service
Contact support about a larger amount, or order several storage services.

Snapshot storage tiers are products whose module_name is storage in GET /products/. Order one with POST /services/order, as Order a service describes. The size comes from the tier, so config can be empty. If you send storage_gb, it must match the tier's size.

Shell
curl -X POST https://api.coritan.com/api/v1/services/order \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": 41,
    "pricing_id": 118,
    "idempotency_key": "8d2f6a14-3c7e-4b9a-a1d5-6e0c9f2b7a38",
    "config": {"storage_gb": 100}
  }'

A storage_gb that does not match the tier answers 422 with {"detail": {"errors": [...]}}, such as This plan is 50 GB of snapshot storage; to buy 100 GB choose the plan for that size. A storage_gb that is not a whole number answers storage_gb must be an integer.

To buy a tier with a new server, put it in the server order's addons, as {"product_id": 41}. We take its price on the server's billing cycle, else its monthly price. A server order takes one Snapshot Storage add-on, and a storage_gb that does not match answers the same 422, with the tier's name in front (Add-ons in the order).

GET /api/v1/services/ lists the storage service with its id. Cancel it with POST /api/v1/services/{service_ref}/cancel (Cancel a service). GET /api/v1/client/snapshots/allowance shows the allowance it adds (How snapshot storage works).

API operations on this page

MethodPathWhat it does
POST/api/v1/services/orderOrder a platform service, and any add-ons bought with it