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