filescom-inbound-s3-logs

An InboundS3Log is an audit log for monitoring and troubleshooting S3-compatible API requests to your Files.com site.

Logs available through this endpoint are retained for 6 months, after which they are automatically discarded. For longer retention, use Files.com SIEM integrations to stream logs in real time to your preferred SIEM, or configure SIEM streaming to a file.

All subcommands also accept the flags documented in CONTEXT.md (--api-key, --format, --workspace-id, --debug, and the pagination flags --cursor / --per-page / --max-pages on list). Those are not repeated below.

Commands

files-cli inbound-s3-logs list

List Inbound S3 Logs.

Flag	Type	Description
--filter	object	If set, return records where the specified field is equal to the supplied value. Valid fields are operation, status, path, client_ip or created_at. Valid field combinations are [ operation ], [ status ], [ path ], [ client_ip ], [ created_at ], [ operation, status ], [ operation, path ], [ operation, client_ip ], [ operation, created_at ], [ status, path ], [ status, client_ip ], [ status, created_at ], [ path, client_ip ], [ path, created_at ], [ client_ip, created_at ], [ operation, status, path ], [ operation, status, client_ip ], [ operation, status, created_at ], [ operation, path, client_ip ], [ operation, path, created_at ], [ operation, client_ip, created_at ], [ status, path, client_ip ], [ status, path, created_at ], [ status, client_ip, created_at ], [ path, client_ip, created_at ], [ operation, status, path, client_ip ], [ operation, status, path, created_at ], [ operation, status, client_ip, created_at ], [ operation, path, client_ip, created_at ] or [ status, path, client_ip, created_at ].
--filter-gt	object	If set, return records where the specified field is greater than the supplied value. Valid fields are created_at. Valid field combinations are [ operation ], [ status ], [ path ], [ client_ip ], [ created_at ], [ operation, status ], [ operation, path ], [ operation, client_ip ], [ operation, created_at ], [ status, path ], [ status, client_ip ], [ status, created_at ], [ path, client_ip ], [ path, created_at ], [ client_ip, created_at ], [ operation, status, path ], [ operation, status, client_ip ], [ operation, status, created_at ], [ operation, path, client_ip ], [ operation, path, created_at ], [ operation, client_ip, created_at ], [ status, path, client_ip ], [ status, path, created_at ], [ status, client_ip, created_at ], [ path, client_ip, created_at ], [ operation, status, path, client_ip ], [ operation, status, path, created_at ], [ operation, status, client_ip, created_at ], [ operation, path, client_ip, created_at ] or [ status, path, client_ip, created_at ].
--filter-gteq	object	If set, return records where the specified field is greater than or equal the supplied value. Valid fields are created_at. Valid field combinations are [ operation ], [ status ], [ path ], [ client_ip ], [ created_at ], [ operation, status ], [ operation, path ], [ operation, client_ip ], [ operation, created_at ], [ status, path ], [ status, client_ip ], [ status, created_at ], [ path, client_ip ], [ path, created_at ], [ client_ip, created_at ], [ operation, status, path ], [ operation, status, client_ip ], [ operation, status, created_at ], [ operation, path, client_ip ], [ operation, path, created_at ], [ operation, client_ip, created_at ], [ status, path, client_ip ], [ status, path, created_at ], [ status, client_ip, created_at ], [ path, client_ip, created_at ], [ operation, status, path, client_ip ], [ operation, status, path, created_at ], [ operation, status, client_ip, created_at ], [ operation, path, client_ip, created_at ] or [ status, path, client_ip, created_at ].
--filter-prefix	object	If set, return records where the specified field is prefixed by the supplied value. Valid fields are operation, status, path or client_ip. Valid field combinations are [ operation ], [ status ], [ path ], [ client_ip ], [ created_at ], [ operation, status ], [ operation, path ], [ operation, client_ip ], [ operation, created_at ], [ status, path ], [ status, client_ip ], [ status, created_at ], [ path, client_ip ], [ path, created_at ], [ client_ip, created_at ], [ operation, status, path ], [ operation, status, client_ip ], [ operation, status, created_at ], [ operation, path, client_ip ], [ operation, path, created_at ], [ operation, client_ip, created_at ], [ status, path, client_ip ], [ status, path, created_at ], [ status, client_ip, created_at ], [ path, client_ip, created_at ], [ operation, status, path, client_ip ], [ operation, status, path, created_at ], [ operation, status, client_ip, created_at ], [ operation, path, client_ip, created_at ] or [ status, path, client_ip, created_at ].
--filter-lt	object	If set, return records where the specified field is less than the supplied value. Valid fields are created_at. Valid field combinations are [ operation ], [ status ], [ path ], [ client_ip ], [ created_at ], [ operation, status ], [ operation, path ], [ operation, client_ip ], [ operation, created_at ], [ status, path ], [ status, client_ip ], [ status, created_at ], [ path, client_ip ], [ path, created_at ], [ client_ip, created_at ], [ operation, status, path ], [ operation, status, client_ip ], [ operation, status, created_at ], [ operation, path, client_ip ], [ operation, path, created_at ], [ operation, client_ip, created_at ], [ status, path, client_ip ], [ status, path, created_at ], [ status, client_ip, created_at ], [ path, client_ip, created_at ], [ operation, status, path, client_ip ], [ operation, status, path, created_at ], [ operation, status, client_ip, created_at ], [ operation, path, client_ip, created_at ] or [ status, path, client_ip, created_at ].
--filter-lteq	object	If set, return records where the specified field is less than or equal the supplied value. Valid fields are created_at. Valid field combinations are [ operation ], [ status ], [ path ], [ client_ip ], [ created_at ], [ operation, status ], [ operation, path ], [ operation, client_ip ], [ operation, created_at ], [ status, path ], [ status, client_ip ], [ status, created_at ], [ path, client_ip ], [ path, created_at ], [ client_ip, created_at ], [ operation, status, path ], [ operation, status, client_ip ], [ operation, status, created_at ], [ operation, path, client_ip ], [ operation, path, created_at ], [ operation, client_ip, created_at ], [ status, path, client_ip ], [ status, path, created_at ], [ status, client_ip, created_at ], [ path, client_ip, created_at ], [ operation, status, path, client_ip ], [ operation, status, path, created_at ], [ operation, status, client_ip, created_at ], [ operation, path, client_ip, created_at ] or [ status, path, client_ip, created_at ].