github.com/adityamillind98/nomad@v0.11.8/website/pages/api-docs/regions.mdx (about)

     1  ---
     2  layout: api
     3  page_title: Regions - HTTP API
     4  sidebar_title: Regions
     5  description: The /regions endpoints list all known regions.
     6  ---
     7  
     8  # Regions HTTP API
     9  
    10  The `/regions` endpoints list all known regions.
    11  
    12  ## List Regions
    13  
    14  | Method | Path       | Produces           |
    15  | ------ | ---------- | ------------------ |
    16  | `GET`  | `/regions` | `application/json` |
    17  
    18  The table below shows this endpoint's support for
    19  [blocking queries](/api-docs#blocking-queries) and
    20  [required ACLs](/api-docs#acls).
    21  
    22  | Blocking Queries | ACL Required |
    23  | ---------------- | ------------ |
    24  | `NO`             | `none`       |
    25  
    26  ### Sample Request
    27  
    28  ```shell-session
    29  $ curl \
    30      https://localhost:4646/v1/regions
    31  ```
    32  
    33  ### Sample Response
    34  
    35  ```json
    36  ["region1", "region2"]
    37  ```