docs: add filtered by ACLs header curl example

This commit is contained in:
Jared Kirschner 2022-03-15 10:46:56 -07:00
parent 109ffcda26
commit 1f9ca248e1
1 changed files with 21 additions and 0 deletions

View File

@ -106,6 +106,27 @@ of results, because some have been filtered out by ACL policies.
In order to limit information leakage, this header is only present for requests
authenticated by a valid ACL token.
The following example uses `curl` to view the
`X-Consul-Results-Filtered-By-ACLs` response header.
```shell-session
$ curl \
--header "X-Consul-Token: <non-anonymous consul token>" \
--include \
http://127.0.0.1:8500/v1/catalog/services
HTTP/1.1 200 OK
Content-Type: application/json
...
X-Consul-Default-Acl-Policy: deny
X-Consul-Results-Filtered-By-Acls: true
{
"redis": [],
"postgresql": ["primary", "secondary"]
}
```
## UUID Format
UUID-format identifiers generated by the Consul API use the