open-consul/website/pages/docs/commands/intention/get.mdx
R.B. Boyer 72a515f5ec
connect: various changes to make namespaces for intentions work more like for other subsystems (#8194)
Highlights:

- add new endpoint to query for intentions by exact match

- using this endpoint from the CLI instead of the dump+filter approach

- enforcing that OSS can only read/write intentions with a SourceNS or
  DestinationNS field of "default".

- preexisting OSS intentions with now-invalid namespace fields will
  delete those intentions on initial election or for wildcard namespaces
  an attempt will be made to downgrade them to "default" unless one
  exists.

- also allow the '-namespace' CLI arg on all of the intention subcommands

- update lots of docs
2020-06-26 16:59:15 -05:00

40 lines
737 B
Plaintext

---
layout: docs
page_title: 'Commands: Intention Get'
sidebar_title: get
---
# Consul Intention Get
Command: `consul intention get`
The `intention get` command shows a single intention.
## Usage
Usage:
- `consul intention get [options] SRC DST`
- `consul intention get [options] ID`
`SRC` and `DST` can both take [several forms](/docs/commands/intention#source-and-destination-naming).
#### API Options
@include 'http_api_options_client.mdx'
#### Enterprise Options
@include 'http_api_namespace_options.mdx'
## Examples
```shell-session
$ consul intention get web db
Source: web
Destination: db
Action: deny
ID: 20edfa56-9cd4-51db-8c22-db09fdec61ef
Created At: Thursday, 24-May-18 17:07:49 PDT
```