Use the listener-policies command to list or retrieve listener policies for a specific Event Gateway Listener.
Related Documentation
Incompatible with
on-prem
Related Resources
Command usage
Usage:
kongctl get event-gateway listener-policies [flags]
Aliases:
listener-policies, listener-policy, lp, lps
Examples:
# List listener policies for a listener by ID
kongctl get event-gateway listener-policies --gateway-id <gateway-id> --listener-id <listener-id>
# List listener policies for a listener by name
kongctl get event-gateway listener-policies --gateway-name my-gateway --listener-name my-listener
# Get a specific listener policy by ID (positional argument)
kongctl get event-gateway listener-policies --gateway-id <gateway-id> --listener-id <listener-id> <policy-id>
# Get a specific listener policy by name (positional argument)
kongctl get event-gateway listener-policies --gateway-id <gateway-id> --listener-id <listener-id> my-policy
# Get a specific listener policy by ID (flag)
kongctl get event-gateway listener-policies --gateway-id <gateway-id> --listener-id <listener-id> --policy-id <policy-id>
# Get a specific listener policy by name (flag)
kongctl get event-gateway listener-policies --gateway-name my-gateway --listener-name my-listener --policy-name my-policy
Flags:
--base-url string Base URL for Konnect API requests.
- Config path: [ konnect.base-url ]
- Default : [ https://us.api.konghq.com ]
--color-theme string Configures the CLI UI/theme (prompt, tables, TUI elements).
- Config path: [ color-theme ]
- Examples : [ 3024_day, 3024_night, aardvark_blue, abernathy, adventure ]
- Reference : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "kong-light")
--config-file string Path to the configuration file to load.
- Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
--gateway-id string The ID of the event gateway that owns the resource.
- Config path: [ konnect.event-gateway.id ]
--gateway-name string The name of the event gateway that owns the resource.
- Config path: [ konnect.event-gateway.name ]
-h, --help help for listener-policies
--jq string Filter JSON responses using jq expressions (powered by gojq for full jq compatibility)
--jq-color string Controls colorized output for jq filter results.
- Config path: [ jq.color.enabled ]
- Allowed : [ auto|always|never ] (default "auto")
--jq-color-theme string Select the color theme used for jq filter results.
- Config path: [ jq.color.theme ]
- Examples : [ friendly, github-dark, dracula ]
- Reference : [ https://xyproto.github.io/splash/docs/ ] (default "friendly")
-r, --jq-raw-output Output string jq results without JSON quotes (like jq -r).
- Config path: [ jq.raw-output ]
--listener-id string The ID of the listener to retrieve.
- Config path: [ konnect.event-gateway.listener.id ]
--listener-name string The name of the listener to retrieve.
- Config path: [ konnect.event-gateway.listener.name ]
--log-file string Write execution logs to the specified file instead of STDERR.
- Config path: [ log-file ]
--log-level string Configures the logging level. Execution logs are written to STDERR.
- Config path: [ log-level ]
- Allowed : [ trace|debug|info|warn|error ] (default "error")
-o, --output string Configures the format of data written to STDOUT.
- Config path: [ output ]
- Allowed : [ json|yaml|text ] (default "text")
--page-size int Max number of results to include per response page for get and list operations.
- Config path: [ konnect.page-size ] (default 10)
--pat string Konnect Personal Access Token (PAT) used to authenticate the CLI.
Setting this value overrides tokens obtained from the login command.
- Config path: [ konnect.pat ]
--policy-id string The ID of the listener policy to retrieve.
- Config path: [ konnect.event-gateway.listener-policy.id ]
--policy-name string The name of the listener policy to retrieve.
- Config path: [ konnect.event-gateway.listener-policy.name ]
-p, --profile string Specify the profile to use for this command. (default "default")
--region string Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
- Config path: [ konnect.region ]
Copied!