open-consul/website/content/commands/catalog/datacenters.mdx

---
layout: commands
page_title: 'Commands: Catalog List Datacenters'
---

# Consul Catalog List Datacenters

Command: `consul catalog datacenters`

Corresponding HTTP API Endpoint: [\[GET\] /v1/catalog/datacenters](https://www.consul.io/api-docs/catalog#list-datacenters)

The `catalog datacenters` command prints all known datacenters.

The table below shows this command's [required ACLs](/api#authentication). Configuration of
[blocking queries](/api/features/blocking) and [agent caching](/api/features/caching)
are not supported from commands, but may be from the corresponding HTTP endpoint.

| ACL Required |
| ------------ |
| `none`       |

## Examples

List all datacenters:

```shell-session
$ consul catalog datacenters
dc1
dc2
dc3
```

## Usage

Usage: `consul catalog datacenters [options]`

#### API Options

@include 'http_api_options_client.mdx'

@include 'http_api_options_server.mdx'
Add catalog CLI functions (#3204) 2017-07-14 19:45:08 +00:00			`---`
docs: update structure (#8506) - moved and renamed files/folders based on new structure - updated docs navigation based on new structure - moved CLI to top nav (created commands.jsx and commands-navigation.js) - updated and added redirects - updating to be consistent with standalone categories - changing "overview" link in top nav to lead to where intro was moved (docs/intro) - adding redirects for intro content - deleting old intro folders - format all data/navigation files - deleting old commands folder - reverting changes to glossary page - adjust intro navigation for removal of 'vs' paths - add helm page redirect - fix more redirects - add a missing redirect - fix broken anchor links and formatting mistakes - deleted duplicate section, added redirect, changed link - removed duplicate glossary page 2020-09-01 15:14:13 +00:00			`layout: commands`
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`page_title: 'Commands: Catalog List Datacenters'`
Add catalog CLI functions (#3204) 2017-07-14 19:45:08 +00:00			`---`

			`# Consul Catalog List Datacenters`

			Command: `consul catalog datacenters`

Added Corresponding HTTP API Endpoints for every CLI command 2022-01-10 17:40:11 +00:00			`Corresponding HTTP API Endpoint: [\[GET\] /v1/catalog/datacenters](https://www.consul.io/api-docs/catalog#list-datacenters)`

Add catalog CLI functions (#3204) 2017-07-14 19:45:08 +00:00			The `catalog datacenters` command prints all known datacenters.

Added ACL requirements for CLI commands 2022-01-10 21:44:56 +00:00			`The table below shows this command's [required ACLs](/api#authentication). Configuration of`
			`[blocking queries](/api/features/blocking) and [agent caching](/api/features/caching)`
			`are not supported from commands, but may be from the corresponding HTTP endpoint.`

			`\| ACL Required \|`
			`\| ------------ \|`
			\| `none` \|

Add catalog CLI functions (#3204) 2017-07-14 19:45:08 +00:00			`## Examples`

			`List all datacenters:`

update dependencies 2020-05-19 18:32:38 +00:00			```shell-session
Add catalog CLI functions (#3204) 2017-07-14 19:45:08 +00:00			`$ consul catalog datacenters`
			`dc1`
			`dc2`
			`dc3`
			```

			`## Usage`

			Usage: `consul catalog datacenters [options]`

			`#### API Options`

intro and api navigation converted 2020-04-07 18:55:19 +00:00			`@include 'http_api_options_client.mdx'`
docs rendering 2020-04-07 23:56:08 +00:00
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`@include 'http_api_options_server.mdx'`