open-nomad/website/content/docs/commands/namespace/inspect.mdx
Luiz Aoqui d5aa72190f
node pools: namespace integration (#17562)
Add structs and fields to support the Nomad Pools Governance Enterprise
feature of controlling node pool access via namespaces.

Nomad Enterprise allows users to specify a default node pool to be used
by jobs that don't specify one. In order to accomplish this, it's
necessary to distinguish between a job that explicitly uses the
`default` node pool and one that did not specify any.

If the `default` node pool is set during job canonicalization it's
impossible to do this, so this commit allows a job to have an empty node
pool value during registration but sets to `default` at the admission
controller mutator.

In order to guarantee state consistency the state store validates that
the job node pool is set and exists before inserting it.
2023-06-16 16:30:22 -04:00

51 lines
1 KiB
Plaintext

---
layout: docs
page_title: 'Commands: namespace inspect'
description: >
The namespace inspect command is used to view raw information about a
particular namespace.
---
# Command: namespace inspect
The `namespace inspect` command is used to view raw information about a particular
namespace.
<Tip>
Visit the <a href="https://developer.hashicorp.com/nomad/tutorials/manage-clusters/namespaces">
Nomad Namespaces tutorial
</a> for more information.
</Tip>
## Usage
```plaintext
nomad namespace inspect [options] <namespace_name>
```
If ACLs are enabled, this command requires a management ACL token or a token
that has a capability associated with the namespace.
## General Options
@include 'general_options_no_namespace.mdx'
## Inspect Options
- `-t` : Format and display the namespace using a Go template.
## Examples
Inspect a namespace:
```shell-session
$ nomad namespace inspect default
{
"CreateIndex": 5,
"Description": "Default shared namespace",
"ModifyIndex": 38,
"Name": "default",
"Quota": "shared-default-quota"
}
```