2020-03-16 13:42:39 +00:00
|
|
|
---
|
2020-04-07 18:55:19 +00:00
|
|
|
layout: docs
|
|
|
|
page_title: 'Commands: Namespace Create'
|
2020-04-13 18:40:26 +00:00
|
|
|
sidebar_title: create
|
2020-03-16 13:42:39 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
# Consul Namespace Create
|
|
|
|
|
|
|
|
Command: `consul namespace create`
|
|
|
|
|
2020-04-23 22:13:18 +00:00
|
|
|
<EnterpriseAlert />
|
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
This `namespace create` command creates a namespaces using the CLI parameters provided.
|
2020-03-16 13:42:39 +00:00
|
|
|
This was added in Consul Enterprise 1.7.2.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
Usage: `consul namespace create -name <namespace name> [options]`
|
|
|
|
|
|
|
|
Request a namespace to be created. Construction of the namespace definition is handled by this command
|
|
|
|
from the CLI arguments.
|
|
|
|
|
|
|
|
#### API Options
|
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
@include 'http_api_options_client.mdx'
|
2020-04-07 23:56:08 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
@include 'http_api_options_server.mdx'
|
2020-03-16 13:42:39 +00:00
|
|
|
|
|
|
|
#### Command Options
|
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-default-policy-id=<value>` - ID of a policy from the default namespace to inject for all tokens
|
|
|
|
in this namespace. May be specified multiple times.
|
2020-03-16 13:42:39 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-default-policy-name=<value>` - Name of a policy from the default namespace to inject for all
|
|
|
|
tokens in this namespace. May be specified multiple times.
|
2020-03-16 13:42:39 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-default-role-id=<value>` - ID of a role from the default namespace to inject for all tokens in
|
|
|
|
this namespace. May be specified multiple times.
|
2020-03-16 13:42:39 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-default-role-name=<value>` - Name of a role from the default namespace to inject for all tokens
|
|
|
|
in this namespace. May be specified multiple times.
|
2020-03-16 13:42:39 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-description=<string>` - A description of the namespace.
|
2020-03-16 13:42:39 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-format=<string>` - How to output the results. The choices are: pretty or json
|
2020-03-16 13:42:39 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-meta=<value>` - Metadata to set on the namespace, formatted as key=value. This flag
|
|
|
|
may be specified multiple times to set multiple meta fields
|
2020-03-16 13:42:39 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-name=<string>` - The namespace's name. This flag is required.
|
2020-03-16 13:42:39 +00:00
|
|
|
|
2020-04-07 18:55:19 +00:00
|
|
|
- `-show-meta` - Indicates that namespace metadata such as the raft indices should
|
|
|
|
be shown for the namespace
|
2020-03-16 13:42:39 +00:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
Create a new Namespace:
|
|
|
|
|
2020-04-07 23:56:08 +00:00
|
|
|
```shell
|
2020-03-16 13:42:39 +00:00
|
|
|
$ consul namespace create -name "team-1"
|
|
|
|
Name: team-1
|
|
|
|
```
|
|
|
|
|
|
|
|
Showing Raft Metadata:
|
|
|
|
|
2020-04-07 23:56:08 +00:00
|
|
|
```shell
|
2020-03-16 13:42:39 +00:00
|
|
|
$ consul namespace create -name team-1 -show-meta
|
|
|
|
Name: team-1
|
|
|
|
Create Index: 339
|
|
|
|
Modify Index: 344
|
|
|
|
```
|
|
|
|
|
|
|
|
JSON Format:
|
|
|
|
|
2020-04-07 23:56:08 +00:00
|
|
|
```shell
|
2020-03-16 13:42:39 +00:00
|
|
|
$ consul namespace create -name team2 -description "Example Namespace" -meta "team-id=574407f3-8b26-4c84-8e51-028bb8cbdd37" -format=json
|
|
|
|
{
|
|
|
|
"Name": "team2",
|
|
|
|
"Description": "Example Namespace",
|
|
|
|
"Meta": {
|
|
|
|
"team-id": "574407f3-8b26-4c84-8e51-028bb8cbdd37"
|
|
|
|
},
|
|
|
|
"CreateIndex": 352,
|
|
|
|
"ModifyIndex": 352
|
|
|
|
}
|
|
|
|
```
|