github.com/smintz/nomad@v0.8.3/website/source/api/regions.html.md (about)

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