Apps rules list

Open in

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 list

List channel rules for a specific app:

ably apps rules list --app aBcDe1

List all channel rules in JSON format:

ably apps rules list --json

List all channel rules in formatted JSON output:

ably apps rules list --pretty-json

Output

The ably apps channel-rules list command displays:

PropertyDescription
Rule CountTotal number of channel rules found
Channel Rule IDThe unique identifier for each rule
PersistedWhether messages are persisted for channels matching this rule
Push EnabledWhether push notifications are enabled
AuthenticatedWhether clients must be authenticated
Persist Last MessageWhether only the last message is persisted
Populate Channel RegistryWhether to populate the channel registry
Batching EnabledWhether message batching is enabled
Conflation EnabledWhether message conflation is enabled
TLS OnlyWhether TLS is enforced
CreatedWhen the rule was created
UpdatedWhen the rule was last updated

See also

  • Apps — Explore all ably apps commands.
  • CLI reference — Full list of available commands.