b9996e6bbe
Also update the Docs and fixup the HTTP API to return proper errors when someone attempts to use Namespaces with an OSS agent. Add Namespace HTTP API docs Make all API endpoints disallow unknown fields
99 lines
1.9 KiB
Plaintext
99 lines
1.9 KiB
Plaintext
---
|
|
layout: "docs"
|
|
page_title: "Commands: Namespace List"
|
|
sidebar_current: "docs-commands-namespace-list"
|
|
---
|
|
|
|
<%= enterprise_alert :consul %>
|
|
|
|
# Consul Namespace List
|
|
|
|
Command: `consul namespace list`
|
|
|
|
This `namespace list` command lists all namespace configurations. This was added in Consul Enterprise 1.7.0. If
|
|
ACLs are enabled then this command will require a token with `operator:read` privileges or any `read` privileges
|
|
within the target namespaces. The results will be filtered based on the ACL token and therefore it is possible to
|
|
see a partial list.
|
|
|
|
## Usage
|
|
|
|
Usage: `consul namespace list`
|
|
|
|
#### API Options
|
|
|
|
<%= partial "docs/commands/http_api_options_client" %>
|
|
<%= partial "docs/commands/http_api_options_server" %>
|
|
|
|
#### Command Options
|
|
|
|
* `-format=<string>` - How to output the results. The choices are: pretty or json
|
|
|
|
* `-meta` - Indicates that namespace metadata such as the raft indices should be
|
|
shown for the namespace
|
|
|
|
## Examples
|
|
|
|
List Namespaces:
|
|
|
|
```sh
|
|
$ consul namespace list
|
|
default:
|
|
Description:
|
|
Builtin Default Namespace
|
|
foo:
|
|
Description:
|
|
Example Namespace
|
|
team-1:
|
|
Description:
|
|
|
|
```
|
|
|
|
Showing Raft Metadata:
|
|
|
|
```sh
|
|
$ consul namespace list -meta
|
|
default:
|
|
Description:
|
|
Builtin Default Namespace
|
|
Create Index: 4
|
|
Modify Index: 4
|
|
foo:
|
|
Description:
|
|
Example Namespace
|
|
Create Index: 352
|
|
Modify Index: 352
|
|
team-1:
|
|
Description:
|
|
Create Index: 339
|
|
Modify Index: 344
|
|
|
|
```
|
|
|
|
JSON Format:
|
|
|
|
```sh
|
|
$ consul namespace list -format=json
|
|
[
|
|
{
|
|
"Name": "default",
|
|
"Description": "Builtin Default Namespace",
|
|
"CreateIndex": 4,
|
|
"ModifyIndex": 4
|
|
},
|
|
{
|
|
"Name": "foo",
|
|
"Description": "Example Namespace",
|
|
"Meta": {
|
|
"team-id": "574407f3-8b26-4c84-8e51-028bb8cbdd37"
|
|
},
|
|
"CreateIndex": 352,
|
|
"ModifyIndex": 352
|
|
},
|
|
{
|
|
"Name": "team-1",
|
|
"CreateIndex": 339,
|
|
"ModifyIndex": 344
|
|
}
|
|
]
|
|
```
|