Files¶

Access files on the PLC. Requires feature flag Files enabled.

Not implemented. File access requires the ADS SystemService protocol (index groups 0x78xx), which the underlying ADS library does not provide. All three endpoints below return 501 Not Implemented with error code NOT_IMPLEMENTED for every request. The routes are kept in place for API stability and will be implemented once the library gains SystemService support.

Read File¶

Endpoint: Read File API_FILES_READ

status: open

component: Files

method: GET

route: /api/plcs/{plcId}/files/{path}

policy: ReadAccess

implements: FEAT_FILES

Returns the file content as base64-encoded bytes. Currently always returns 501.

Write File¶

Endpoint: Write File API_FILES_WRITE

status: open

component: Files

method: PUT

route: /api/plcs/{plcId}/files/{path}

policy: WriteAccess

implements: FEAT_FILES, REQ_SEC_WRITE_AUTH

Upload or overwrite a file on the PLC. Currently always returns 501.

List Directory¶

Endpoint: List Directory API_FILES_LIST

status: open

component: Files

method: GET

route: /api/plcs/{plcId}/files?dir={path}

policy: ReadAccess

implements: FEAT_FILES

Returns a list of entries in the specified directory. Currently always returns 501.