tcb policy list
View the list of legacy gateway authentication policies.
PG environments and environments running the OPA authorization engine have no legacy gateway policy entries. Use tcb policy get instead.
Usage
tcb policy list [options]
Parameters
| Parameter | Description | Default |
|---|---|---|
-e, --env-id <envId> | Environment ID | — |
--resource-type <type> | Filter by resource type, available value: policy | All |
--json | Output JSON | — |
Output Fields
| Field | Description |
|---|---|
| PolicyId | Policy ID |
| ResourceType | Resource type |
| ResourceId | Resource ID |
| ResourceTitle | Resource title |
| ResourceName | Resource name |
| Effect | Effect (Allow/Deny) |
| IsAccess | Is accessible |
| RoleIdentity | Role identity |
| RoleName | Role name |
| SafeRule | Safe rule |
JSON Output
--json prints the cloud response as is; SkippedReason tells why no request was sent:
{
"data": {
"Data": { "PolicyList": [], "Total": "0" },
"RequestId": "",
"SkippedReason": "opa_authz_engine"
}
}
| Value | Description |
|---|---|
postgresql_env | PostgreSQL environment with no legacy gateway policies |
opa_authz_engine | OPA authorization engine enabled; legacy policies ignored |
When SkippedReason is present, PolicyList is empty and RequestId is an empty string. An empty list does not mean there are no policies.
Examples
# View all policies
tcb policy list -e my-env-id
# Filter by resource type
tcb policy list --resource-type policy -e my-env-id
# Output in JSON format
tcb policy list --json -e my-env-id