Use the ably apps rules list command to list all channel rules configured for an Ably application.
Synopsis
ably apps rules list [options]Options
--app
The app ID to list rules for. Uses the currently selected app if not specified.
--limit
The maximum number of results to return. Defaults to 100.
--json
Output results as compact JSON. Mutually exclusive with --pretty-json.
--pretty-json
Output results in formatted JSON. Mutually exclusive with --json.
--verbose | -v
Enable verbose logging. Can be combined with --json or --pretty-json.
Examples
List all channel rules for the current app:
ably apps rules listList channel rules for a specific app:
ably apps rules list --app aBcDe1List all channel rules in JSON format:
ably apps rules list --jsonList all channel rules in formatted JSON output:
ably apps rules list --pretty-jsonOutput
The ably apps channel-rules list command displays:
| Property | Description |
|---|---|
| Rule Count | Total number of channel rules found |
| Channel Rule ID | The unique identifier for each rule |
| Persisted | Whether messages are persisted for channels matching this rule |
| Push Enabled | Whether push notifications are enabled |
| Authenticated | Whether clients must be authenticated |
| Persist Last Message | Whether only the last message is persisted |
| Populate Channel Registry | Whether to populate the channel registry |
| Batching Enabled | Whether message batching is enabled |
| Conflation Enabled | Whether message conflation is enabled |
| TLS Only | Whether TLS is enforced |
| Created | When the rule was created |
| Updated | When the rule was last updated |
See also
- Apps — Explore all
ably appscommands. - CLI reference — Full list of available commands.