2019-05-01 18:21:11 +00:00
|
|
|
---
|
2020-09-01 15:14:13 +00:00
|
|
|
layout: commands
|
2020-04-07 18:55:19 +00:00
|
|
|
page_title: 'Commands: Config List'
|
2019-05-01 18:21:11 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
# Consul Config List
|
|
|
|
|
|
|
|
Command: `consul config list`
|
|
|
|
|
2022-01-11 13:26:58 +00:00
|
|
|
Corresponding HTTP API Endpoint: [\[GET\] /v1/config/:kind](/api-docs/config#list-configurations)
|
2022-01-10 17:40:11 +00:00
|
|
|
|
2019-05-01 18:21:11 +00:00
|
|
|
The `config list` command lists all given config entries of the given kind.
|
2020-10-14 15:23:05 +00:00
|
|
|
See the [configuration entries docs](/docs/agent/config-entries) for more
|
2019-05-08 20:19:37 +00:00
|
|
|
details about configuration entries.
|
2019-05-01 18:21:11 +00:00
|
|
|
|
2022-01-10 21:44:56 +00:00
|
|
|
The table below shows this command's [required ACLs](/api#authentication). Configuration of
|
2022-03-30 21:16:26 +00:00
|
|
|
[blocking queries](/api-docs/features/blocking) and [agent caching](/api-docs/features/caching)
|
2022-01-10 21:44:56 +00:00
|
|
|
are not supported from commands, but may be from the corresponding HTTP endpoint.
|
|
|
|
|
2022-01-11 14:41:54 +00:00
|
|
|
| ACL Required<sup>1</sup> |
|
|
|
|
| ------------------------------------- |
|
|
|
|
| `service:read`<br />`intentions:read` |
|
|
|
|
|
|
|
|
<sup>1</sup> The ACL required depends on the config entry kind being read:
|
|
|
|
|
|
|
|
| Config Entry Kind | Required ACL |
|
|
|
|
| ------------------- | ----------------- |
|
|
|
|
| ingress-gateway | `service:read` |
|
|
|
|
| proxy-defaults | `<none>` |
|
|
|
|
| service-defaults | `service:read` |
|
|
|
|
| service-intentions | `intentions:read` |
|
|
|
|
| service-resolver | `service:read` |
|
|
|
|
| service-router | `service:read` |
|
|
|
|
| service-splitter | `service:read` |
|
|
|
|
| terminating-gateway | `service:read` |
|
2022-01-10 21:44:56 +00:00
|
|
|
|
2019-05-01 18:21:11 +00:00
|
|
|
## Usage
|
|
|
|
|
|
|
|
Usage: `consul config list [options]`
|
|
|
|
|
|
|
|
#### API Options
|
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
@include 'http_api_options_client.mdx'
|
2019-05-01 18:21:11 +00:00
|
|
|
|
2020-02-07 20:01:04 +00:00
|
|
|
#### Enterprise Options
|
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
@include 'http_api_namespace_options.mdx'
|
2020-02-07 20:01:04 +00:00
|
|
|
|
2021-12-15 01:55:21 +00:00
|
|
|
@include 'http_api_partition_options.mdx'
|
|
|
|
|
2019-05-01 18:21:11 +00:00
|
|
|
#### Config List Options
|
|
|
|
|
2021-05-04 21:32:07 +00:00
|
|
|
- `-kind` - Specifies the kind of the config entry to list.
|
2019-05-01 18:21:11 +00:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
$ consul config list -kind service-defaults
|
|
|
|
billing
|
|
|
|
db
|
|
|
|
web
|