Skip to content

Commit ce33b96

Browse files
authored
docs: volumes are only supported in ord region (#3057)
The volumes page and tutorial incorrectly listed `ams` (Amsterdam) as a supported region for volumes and snapshots. Currently only `ord` (Chicago) supports volumes — the `ams` volume infrastructure is not yet provisioned. This caused a customer to hit unexplained 503 errors when trying to create volumes in `ams` following the docs. ### Changes - `sandbox/volumes.md`: Updated code comments and region field description to indicate only `ord` is supported - `examples/tutorials/volumes.md`: Same fix in the tutorial
1 parent 28870c9 commit ce33b96

2 files changed

Lines changed: 10 additions & 9 deletions

File tree

examples/tutorials/volumes.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,8 @@ const client = new Client();
4242

4343
## Provision storage for the cache
4444

45-
Pick a region (`ord` or `ams`) that matches the sandboxes you plan to run.
45+
Pick a region that matches the sandboxes you plan to run. Currently only `ord`
46+
(Chicago) supports volumes.
4647

4748
We're going to provide 2 GB of storage for our training cache volume:
4849

sandbox/volumes.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ const client = new Client();
3030

3131
const volume = await client.volumes.create({
3232
slug: "training-cache",
33-
region: "ord", // ord (Chicago) or ams (Amsterdam)
33+
region: "ord", // only "ord" (Chicago) is supported today
3434
capacity: "2GB", // accepts bytes or "1GB"/"512MB" style strings
3535
});
3636

@@ -54,7 +54,7 @@ sdk = DenoDeploy()
5454

5555
volume = sdk.volumes.create(
5656
slug="training-cache",
57-
region="ord", # ord (Chicago) or ams (Amsterdam)
57+
region="ord", # only "ord" (Chicago) is supported today
5858
capacity="2GB" # accepts bytes or "1GB"/"512MB" style strings
5959
)
6060

@@ -78,7 +78,7 @@ sdk = AsyncDenoDeploy()
7878

7979
volume = await sdk.volumes.create(
8080
slug="training-cache",
81-
region="ord", # ord (Chicago) or ams (Amsterdam)
81+
region="ord", # only "ord" (Chicago) is supported today
8282
capacity="2GB" # accepts bytes or "1GB"/"512MB" style strings
8383
)
8484

@@ -95,11 +95,11 @@ print(volume)
9595
</deno-tab>
9696
</deno-tabs>
9797

98-
| Field | Required | Details |
99-
| ---------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
100-
| `slug` || Unique per organization. Slugs become part of the mount metadata, so pick something descriptive. |
101-
| `region` || Must match an available sandbox region (`"ord"` or `"ams"` today). Only sandboxes in the same region can mount the volume. |
102-
| `capacity` || Between 300 MB and 20 GB. Pass a number of bytes or a string with `GB/MB/KB` (decimal) or `GiB/MiB/KiB` (binary) units. |
98+
| Field | Required | Details |
99+
| ---------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
100+
| `slug` || Unique per organization. Slugs become part of the mount metadata, so pick something descriptive. |
101+
| `region` || Currently only `"ord"` (Chicago) is supported. Only sandboxes in the same region can mount the volume. |
102+
| `capacity` || Between 300 MB and 20 GB. Pass a number of bytes or a string with `GB/MB/KB` (decimal) or `GiB/MiB/KiB` (binary) units. |
103103

104104
### Inspect and search volumes
105105

0 commit comments

Comments
 (0)