WebDAV Action Logs

A WebDAVActionLog is an audit log for monitoring and troubleshooting operations made to your site through WebDAV protocol.

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 WebDAV Action Logs

SDK Method

webdavactionlog.List()

Return Object

[]*WebDavActionLog

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.

Additional Arguments

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    web_dav_action_log "github.com/Files-com/files-sdk-go/v3/webdavactionlog"
)

webDavActionLogIterator, err := web_dav_action_log.List(files_sdk.WebDavActionLogListParams{})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

for webDavActionLogIterator.Next() {
    webDavActionLog := webDavActionLogIterator.webDavActionLog()
}
err = webDavActionLogIterator.Err()
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

The WebDavActionLog Object

Some of the methods above return a WebDavActionLog object. The attributes of this object are listed below.

AttributeDescription
Timestamp
date-time		Start Time of Action. Deprecrated: Use created_at.
RemoteIp
string		IP Address of WebDAV Client
ServerIp
string		IP Address of WebDAV Server
Username
string		Username
AuthCiphers
string		Authentication Ciphers
ActionType
string		Action Type
Path
string		Path as sent by the Client (may not match Files.com path due to user root folders for WebDAV). This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
TruePath
string		Path on Files.com
Name
string		Name of File
HttpMethod
string		Method of the HTTP call.
HttpPath
string		Path of the HTTP call.
HttpResponseCode
int64		HTTP Response Code returned to the WebDAV Client.
Size
int64		Size of File That was Uploaded or Downloaded.
EntriesReturned
int64		Number of entries returned when listing files and folders
Success
boolean		Whether WebDAV Action was successful.
Status
string		WebDAV Action status.
Possible values: SUCCESS, FAILURE, PARTIAL_TRANSFER
DurationMs
int64		Duration (in milliseconds)
CreatedAt
date-time		Start Time of Action