2020-02-06 23:45:31 +00:00
|
|
|
---
|
|
|
|
|
layout: api
|
|
|
|
|
page_title: Regions - HTTP API
|
|
|
|
|
description: The /regions endpoints list all known regions.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Regions HTTP API
|
|
|
|
|
|
|
|
|
|
The `/regions` endpoints list all known regions.
|
|
|
|
|
|
|
|
|
|
## List Regions
|
|
|
|
|
|
2021-07-21 10:14:19 +00:00
|
|
|
| Method | Path | Produces |
|
|
|
|
|
| ------ | ------------- | ------------------ |
|
|
|
|
|
| `GET` | `/v1/regions` | `application/json` |
|
2020-02-06 23:45:31 +00:00
|
|
|
|
|
|
|
|
The table below shows this endpoint's support for
|
2020-03-20 22:24:56 +00:00
|
|
|
[blocking queries](/api-docs#blocking-queries) and
|
|
|
|
|
[required ACLs](/api-docs#acls).
|
2020-02-06 23:45:31 +00:00
|
|
|
|
|
|
|
|
| Blocking Queries | ACL Required |
|
|
|
|
|
| ---------------- | ------------ |
|
|
|
|
|
| `NO` | `none` |
|
|
|
|
|
|
|
|
|
|
### Sample Request
|
|
|
|
|
|
2020-05-18 20:53:06 +00:00
|
|
|
```shell-session
|
|
|
|
|
$ curl \
|
2020-02-06 23:45:31 +00:00
|
|
|
https://localhost:4646/v1/regions
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Sample Response
|
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
["region1", "region2"]
|
|
|
|
|
```
|
