61 lines
1.7 KiB
Plaintext
61 lines
1.7 KiB
Plaintext
---
|
|
layout: commands
|
|
page_title: 'Commands: Config List'
|
|
---
|
|
|
|
# Consul Config List
|
|
|
|
Command: `consul config list`
|
|
|
|
Corresponding HTTP API Endpoint: [\[GET\] /v1/config/:kind](/api-docs/config#list-configurations)
|
|
|
|
The `config list` command lists all given config entries of the given kind.
|
|
See the [configuration entries docs](/docs/agent/config-entries) for more
|
|
details about configuration entries.
|
|
|
|
The table below shows this command's [required ACLs](/api-docs/api-structure#authentication). Configuration of
|
|
[blocking queries](/api-docs/features/blocking) and [agent caching](/api-docs/features/caching)
|
|
are not supported from commands, but may be from the corresponding HTTP endpoint.
|
|
|
|
| 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` |
|
|
|
|
## Usage
|
|
|
|
Usage: `consul config list [options]`
|
|
|
|
#### Command Options
|
|
|
|
- `-kind` - Specifies the kind of the config entry to list.
|
|
|
|
#### Enterprise Options
|
|
|
|
@include 'http_api_partition_options.mdx'
|
|
|
|
@include 'http_api_namespace_options.mdx'
|
|
|
|
#### API Options
|
|
|
|
@include 'http_api_options_client.mdx'
|
|
|
|
## Examples
|
|
|
|
$ consul config list -kind service-defaults
|
|
billing
|
|
db
|
|
web
|