LogoLogo
What's New?Connect Agent ReleasesBook a DemoPricing
  • Documentation
  • Developers
  • Administration
  • API Reference
    • Connect API Reference
      • Devices
      • Deployments
      • Device Files
      • Port Tunneling
      • API Reference v1 (Legacy)
        • Device state
        • Bulk devices state
        • Get devices details
        • Change devices details
        • Deploy Update
        • Update Trigger
        • Tags
        • Apps
    • Create Access Token
  • GitHub Action
    • Deploy Device Update
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. API Reference
  2. Connect API Reference

Device Files

JFrog Connect API request to retrieve files and folders (such as logs) from devices.

PreviousDeploymentsNextPort Tunneling

Was this helpful?

Fetch Files

post

Triggers Connect to fetch files from the device you specify. For example, you can use this command to fetch logs from a device. The files are fetched from the device path you specify in the request body using the files_path attribute. You can specify a folder or a specific file.

The request returns a URL. You can use the Artifactory UI, API, or CLI to download the files from this URL. The files are not available immediately at the URL. They become available when the device uploads them and if the upload is successful.

Authorizations
Path parameters
project_keystringRequired

The project key of the relevant project in the account. An account can have multiple projects. If you don't know the project key, you can find it in the Settings of the web UI in the Projects tab.

device_uuidstringRequired

The UUID of the device you are acting on. This is the unique identifier of the device in Connect, for example, d-4cfe-4e51. You can find the UUID in the ID column of the Devices table in the Devices page of the web UI.

Body
files_pathstringOptional

The path where the requested files are on the device.

Responses
200
OK
application/json
401
UNAUTHORIZED
application/json
404
NOT FOUND
application/json
post
POST /api/v2/{project_key}/devices/{device_uuid}/logs HTTP/1.1
Host: api.connect.jfrog.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "files_path": "/home/path/to/file"
}
{
  "download_url": "https://example.jfrog.io/artifactory/connect-default-generic/upswift-general/devices/d-672a-f5e4/files/user_requested/logs_application/33835"
}