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
76 lines
1.6 KiB
Plaintext
76 lines
1.6 KiB
Plaintext
---
|
|
layout: "docs"
|
|
page_title: "Commands: Namespace Write"
|
|
sidebar_current: "docs-commands-namespace-write"
|
|
---
|
|
|
|
<%= enterprise_alert :consul %>
|
|
|
|
# Consul Namespace Write
|
|
|
|
Command: `consul namespace write`
|
|
|
|
This `namespace write` command creates or updates a namespaces configuration. This was added in Consul Enterprise 1.7.0.
|
|
|
|
## Usage
|
|
|
|
Usage: `consul namespace write <namespace definition>`
|
|
|
|
The `<namespace definition>` must either be a file path or `-` to indicate that
|
|
the definition should be read from stdin. The definition can be in either JSON
|
|
or HCL format. See [here](/docs/enterprise/namespaces/index.html#namespace-definition) for a description of the namespace definition.
|
|
|
|
#### 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
|
|
|
|
Create a new Namespace:
|
|
|
|
```sh
|
|
$ consul namespace write - <<< 'Name = "team-1"'
|
|
Name: team-1
|
|
Description:
|
|
```
|
|
|
|
Showing Raft Metadata:
|
|
|
|
```sh
|
|
$ consul namespace write -meta - <<< 'Name = "team-1"'
|
|
Name: team-1
|
|
Description:
|
|
Create Index: 339
|
|
Modify Index: 344
|
|
```
|
|
|
|
JSON Format:
|
|
|
|
```sh
|
|
$ cat ns.hcl
|
|
Name = "foo"
|
|
Description = "Example Namespace"
|
|
Meta {
|
|
team-id = "574407f3-8b26-4c84-8e51-028bb8cbdd37"
|
|
}
|
|
$ consul namespace write -format=json ns.hcl
|
|
{
|
|
"Name": "foo",
|
|
"Description": "Example Namespace",
|
|
"Meta": {
|
|
"team-id": "574407f3-8b26-4c84-8e51-028bb8cbdd37"
|
|
},
|
|
"CreateIndex": 352,
|
|
"ModifyIndex": 352
|
|
}
|
|
```
|