Order more snapshot storage

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.
• For the first invoice, credit on your account pays first. Otherwise you pay by card or PayPal on the page the order lands on (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 more storage at the top of the page.
• 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.

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.
2. Choose the billing cycle with the buttons beside the Size heading, such as Monthly. A longer term names what it saves, such as Annually · save 20%.
3. Check the summary under Your order. It lists the tier with its billing cycle, with Change beside it, and the Total with what is due today. The line under the total says how the first invoice is paid. On a phone the summary follows the tiers, and Review order at the bottom of the screen takes you to it.
4. Select the button under the summary. It reads Place order and pay when you pay after placing the order, and Place order when your credit pays for it or your account is billed in arrears.

If we refuse the order, Could not place the order appears above the button with the reason.

You can also buy a tier with a new Container Apps server: 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.

Once you place the order, its own page opens. When its title is Order placed, payment due, pay under Pay invoice with account credit, a saved card or PayPal account, or a new card (Pay and follow the order). We add the storage once the invoice is paid. To pay later, leave the page and pay the invoice under Invoices.

What you ordered on the order's page shows the service's number, such as #1042. Note it: you need it to change or cancel the storage later.

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 Snapshot storage card shows the larger allowance. When the account was over its allowance and now fits, the Over the allowance alert goes away and we cancel the cleanup date.

The service renews each billing cycle until you cancel it. The Services page lists it with Snapshot Storage in the Product column.

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.

Selecting a storage service on the Services page opens the Snapshots page, which has no billing controls. To reach the service's Billing tab, open https://www.coritan.com/dashboard/services/<service number>/billing in your browser, with the number from the order's page. There, Change plan… moves the service to another billing cycle, and Cancel service… cancels it (Cancel a service).

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

No Snapshot Storage plans yet

Snapshot storage is not in the catalogue for your account. Contact support if you expected it.

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.

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

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.

• How snapshot storage works
• Snapshots
• Order a service
• Pay an invoice
• Cancel a service

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.

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).