github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/api-docs/regions.mdx (about)

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