github.com/iqoqo/nomad@v0.11.3-0.20200911112621-d7021c74d101/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-sessioncurl \
    29      https://localhost:4646/v1/regions
    30  ```
    31  
    32  ### Sample Response
    33  
    34  ```json
    35  ["region1", "region2"]
    36  ```