2017-05-26 23:17:22 +00:00
|
|
|
---
|
|
|
|
|
layout: api
|
|
|
|
|
page_title: Regions - HTTP API
|
|
|
|
|
sidebar_current: api-regions
|
|
|
|
|
description: |-
|
|
|
|
|
The /regions endpoints list all known regions.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Regions HTTP API
|
|
|
|
|
|
|
|
|
|
The `/regions` endpoints list all known regions.
|
|
|
|
|
|
|
|
|
|
## List Regions
|
|
|
|
|
|
|
|
|
|
| Method | Path | Produces |
|
|
|
|
|
| ------ | ---------------------------- | -------------------------- |
|
|
|
|
|
| `GET` | `/status/regions` | `application/json` |
|
|
|
|
|
|
|
|
|
|
The table below shows this endpoint's support for
|
|
|
|
|
[blocking queries](/api/index.html#blocking-queries),
|
|
|
|
|
[consistency modes](/api/index.html#consistency-modes), and
|
|
|
|
|
[required ACLs](/api/index.html#acls).
|
|
|
|
|
|
2017-05-31 00:31:16 +00:00
|
|
|
| Blocking Queries | ACL Required |
|
|
|
|
|
| ---------------- | ------------ |
|
|
|
|
|
| `NO` | `none` |
|
2017-05-26 23:17:22 +00:00
|
|
|
|
|
|
|
|
### Sample Request
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
$ curl \
|
|
|
|
|
https://nomad.rocks/v1/status/regions
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Sample Response
|
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
[
|
|
|
|
|
"region1",
|
|
|
|
|
"region2"
|
|
|
|
|
]
|
|
|
|
|
```
|
