From 7af3c2eac5501708e2f5ee1f14a482f1f1c79722 Mon Sep 17 00:00:00 2001 From: Aleksey Proshutinskiy Date: Tue, 17 Nov 2026 15:28:20 +0200 Subject: [PATCH 1/2] docs: GPU offer search also matches the country and the region label --- docs/build/api/gpu_cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/api/gpu_cloud.md b/docs/build/api/gpu_cloud.md index 947235e..af3fc1f 100644 --- a/docs/build/api/gpu_cloud.md +++ b/docs/build/api/gpu_cloud.md @@ -85,7 +85,7 @@ Choose the call that matches what you know: | `cpuArchitecture` | `x86_64`, `arm64`, or `unknown` | | `maxPricePerHour` | The highest price per instance-hour in USD, as a decimal string, for example `0.50` | | `available` | `false` also lists offers without capacity left. Without credentials, only offers on sale are listed. | -| `q` | Text in the GPU vendor or GPU model | +| `q` | Text in the GPU vendor or GPU model, a country code, a country name in English, or a region label | To sort, set `sort` to `price`, `vram`, `vcpu`, `memory`, `storage`, or `availability`, and `order` to `asc` or `desc`. Without `sort`, the cheapest offers come first. From 602c5b9537c00e6f3121e3eeaa2d5a1c090af4d8 Mon Sep 17 00:00:00 2001 From: Aleksey Proshutinskiy Date: Tue, 17 Nov 2026 18:43:38 +0200 Subject: [PATCH 2/2] docs: describe the form of GPU region labels --- docs/build/api/gpu_cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/api/gpu_cloud.md b/docs/build/api/gpu_cloud.md index af3fc1f..500ccf7 100644 --- a/docs/build/api/gpu_cloud.md +++ b/docs/build/api/gpu_cloud.md @@ -101,7 +101,7 @@ Besides the hardware and the price, an offer has these fields: - `offerKind`: `provider_sku` is an item of a provider catalog, and `host_offer` is one host. `market_profile` is an offer that fixes the hardware profile and the highest price, but not the host. The instance gets its host when you create it. - `hostTier`: `dedicated`, `shared`, or `unknown`. -- `region`: where the machine runs. `region.country` is a two-letter ISO code, or `null` if the country is not known. `region.label` identifies the place. Pass it in the `regionLabel` filter, or in `requirements.region.label`. +- `region`: where the machine runs. `region.country` is a two-letter ISO code, or `null` if the country is not known. `region.label` identifies the place. It is the country code and a number, for example `US-5`, or `LOC-4` when the country is not known. Pass it in the `regionLabel` filter, or in `requirements.region.label`. - `provider`, `dataCenter`, and `origin`: `provider` is `fluence` for every offer, `dataCenter` is `null`, and `origin` repeats the region. - `topology`: GPU links, such as NVLink. - `provisioning`: how long the instance usually takes to be ready, in `typicalSeconds`, `upperSeconds`, or both. It can be `null`.