luxolus
/
open-consul
2
0
Fork 0
Code Issues 1 Pull Requests Packages Releases Wiki Activity
open-consul/website/pages/commands/acl/token/read.mdx

79 lines
1.9 KiB
Plaintext
Raw Normal View History

docs: add documentation for all secure acl introduction work (#5640)
2019-05-01 21:11:23 +00:00
---
docs: update structure (#8506) - moved and renamed files/folders based on new structure - updated docs navigation based on new structure - moved CLI to top nav (created commands.jsx and commands-navigation.js) - updated and added redirects - updating to be consistent with standalone categories - changing "overview" link in top nav to lead to where intro was moved (docs/intro) - adding redirects for intro content - deleting old intro folders - format all data/navigation files - deleting old commands folder - reverting changes to glossary page - adjust intro navigation for removal of 'vs' paths - add helm page redirect - fix more redirects - add a missing redirect - fix broken anchor links and formatting mistakes - deleted duplicate section, added redirect, changed link - removed duplicate glossary page
2020-09-01 15:14:13 +00:00
layout: commands
intro and api navigation converted
2020-04-07 18:55:19 +00:00
page_title: 'Commands: ACL Token Read'
remove 'sidebar_current' from frontmatter
2020-04-13 18:40:26 +00:00
sidebar_title: read
docs: add documentation for all secure acl introduction work (#5640)
2019-05-01 21:11:23 +00:00
---
# Consul ACL Token Read
Command: `consul acl token read`
The `acl token read` command reads and displays a token details.
## Usage
Usage: `consul acl token read [options] [args]`
#### API Options
intro and api navigation converted
2020-04-07 18:55:19 +00:00
@include 'http_api_options_client.mdx'
docs rendering
2020-04-07 23:56:08 +00:00
intro and api navigation converted
2020-04-07 18:55:19 +00:00
@include 'http_api_options_server.mdx'
docs: add documentation for all secure acl introduction work (#5640)
2019-05-01 21:11:23 +00:00
#### Command Options
intro and api navigation converted
2020-04-07 18:55:19 +00:00
- `-id=<string>` - The ID of the policy to read. It may be specified as a unique ID
prefix but will error if the prefix matches multiple policy IDs.
docs: add documentation for all secure acl introduction work (#5640)
2019-05-01 21:11:23 +00:00
intro and api navigation converted
2020-04-07 18:55:19 +00:00
- `-meta` - Indicates that policy metadata such as the content hash and raft
docs: add documentation for all secure acl introduction work (#5640)
2019-05-01 21:11:23 +00:00
indices should be shown for each entry.
intro and api navigation converted
2020-04-07 18:55:19 +00:00
- `-self` - Indicates that the current HTTP token should be read by secret ID
instead of expecting a -id option.
docs: add documentation for all secure acl introduction work (#5640)
2019-05-01 21:11:23 +00:00
intro and api navigation converted
2020-04-07 18:55:19 +00:00
- `-format={pretty|json}` - Command output format. The default value is `pretty`.
Add acl commands -format option to doc.
2020-03-26 16:03:22 +00:00
Add Namespace support to the API module and the CLI commands (#6874) 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
2019-12-06 16:14:56 +00:00
#### Enterprise Options
intro and api navigation converted
2020-04-07 18:55:19 +00:00
@include 'http_api_namespace_options.mdx'
Add Namespace support to the API module and the CLI commands (#6874) 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
2019-12-06 16:14:56 +00:00
docs: add documentation for all secure acl introduction work (#5640)
2019-05-01 21:11:23 +00:00
## Examples
Get token details:
update dependencies
2020-05-19 18:32:38 +00:00
```shell-session
docs: add documentation for all secure acl introduction work (#5640)
2019-05-01 21:11:23 +00:00
$ consul acl token read -id 986
AccessorID: 986193b5-e2b5-eb26-6264-b524ea60cc6d
SecretID: ec15675e-2999-d789-832e-8c4794daa8d7
Description: Read Nodes and Services
Local: false
Create Time: 2018-10-22 15:33:39.01789 -0400 EDT
Policies:
06acc965-df4b-5a99-58cb-3250930c6324 - node-services-read
```
Get token details using the token secret ID:
docs rendering
2020-04-07 23:56:08 +00:00
```shell
docs: add documentation for all secure acl introduction work (#5640)
2019-05-01 21:11:23 +00:00
$consul acl token read -self
AccessorID: 4d123dff-f460-73c3-02c4-8dd64d136e01
SecretID: 86cddfb9-2760-d947-358d-a2811156bf31
Description: Bootstrap Token (Global Management)
Local: false
Create Time: 2018-10-22 11:27:04.479026 -0400 EDT
Policies:
00000000-0000-0000-0000-000000000001 - global-management
```
Get token details (Builtin Tokens)
update dependencies
2020-05-19 18:32:38 +00:00
```shell-session
docs: add documentation for all secure acl introduction work (#5640)
2019-05-01 21:11:23 +00:00
$ consul acl token read -id anonymous
AccessorID: 00000000-0000-0000-0000-000000000002
SecretID: anonymous
Description: Anonymous Token
Local: false
Create Time: 0001-01-01 00:00:00 +0000 UTC
Policies:
```