Public Hosting Request Logs
A PublicHostingRequestLog is an audit log for monitoring requests we received to access your publicly served folders.
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.
List Public Hosting Request Logs
Command
files-cli public-hosting-request-logs list
Output
Outputs a list of PublicHostingRequestLog objects according to the output format.
Authorization Requirement
Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.
Additional Arguments
The PublicHostingRequestLog Object
Some of the commands above return a PublicHostingRequestLog object. The attributes of this object are listed below.
| Attribute | Description |
|---|---|
| timestamp date-time | Start Time of Action. Deprecrated: Use created_at. |
| remote_ip string | IP Address of Public Hosting Client. |
| server_ip string | IP Address of Public Hosting Server. |
| hostname string | HTTP Request Hostname. |
| path string | HTTP Request Path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters. |
| responseCode int64 | HTTP Response Code. |
| success boolean | Whether SFTP Action was successful. |
| duration_ms int64 | Duration (in milliseconds). |
| created_at date-time | Start Time of Action. |
| bytes_transferred int64 | The number of bytes transferred for file downloads. |
| http_method string | Method of the HTTP call. |