YouTrack Standalone 2020.3 Help

Operations with Specific BackupFile

This resource lets you access the database backup files. The user account that performs the operation must have Low-level Read Administration permissions.

Resource

/api/admin/databaseBackup/backups/{fileID}

Returned entity

BackupFile. For the description of the entity attributes, see Supported Fields section.

Supported methods

BackupFile attributes

Represents the backup file.

This table describes attributes of the BackupFile entity.

  • To receive an attribute in the response from server, specify it explicitly in the request parameter fields.

  • To update an attribute, provide it in the body of a POST request.

Field

Type

Description

name

String

Name of the backup file. Read-only.

size

Long

Size of the file. Read-only.

creationDate

Long

The timestamp when the backup file was created. Read-only.

link

String

The link to the backup file. Read-only.

Read a Specific BackupFile

Get data on the specific backup file.

Required permissions

Requires Low-level Admin Read permission.

Request syntax

GET /api/admin/databaseBackup/backups/{fileID}?{fields}

{fileID}

Name of the file.

Request parameters

Parameter

Type

Description

fields

String

A list of BackupFile attributes that should be returned in the response. If no field is specified,only the entityID is returned

Sample

Sample request URI

https://example.myjetbrains.com/youtrack/api/admin/databaseBackup/backups/2019-02-09-19-03-45.tar.gz?fields=creationDate,file,error,link,name,size,id

Sample response body

{ "name": "2019-02-09-19-03-45.tar.gz", "size": 26696777, "creationDate": 1549728231000, "link": "backupFile/2019-02-09-19-03-45.tar.gz", "error": null, "id": "2019-02-09-19-03-45.tar.gz", "$type": "BackupFile" }
Last modified: 28 October 2020