Cloud Backup API, REST: Backup.listFiles
ListFiles of the backup.
HTTP request
GET https://backup.api.cloud.yandex.net/backup/v1/backups/{backupId}/files
Path parameters
Parameter | Description |
---|---|
backupId | Required. Backup ID. |
Query parameters
Parameter | Description |
---|---|
folderId | Required. Folder ID. |
sourceId | Empty source will list disks of the backup. |
Response
HTTP Code: 200 - OK
{
"files": [
{
"id": "string",
"parentId": "string",
"type": "string",
"fullPath": "string",
"name": "string",
"size": "string",
"actions": {
"restoreToDisk": true,
"goToLocation": true
},
"modifiedAt": "string"
}
]
}
Field | Description |
---|---|
files[] | object BackupFile represents a single unit of file or directory system inside the backup. |
files[]. id |
string Required. ID of the item. Should be used as source ID in case of listing. |
files[]. parentId |
string Might be empty if this is root directory. |
files[]. type |
string Required. Type of the item. Type of the file. |
files[]. fullPath |
string Required. Absolute path of the item. |
files[]. name |
string Required. Name of the directory / file. |
files[]. size |
string (int64) Size in bytes of the item. |
files[]. actions |
object Required. Actions that might be done on the object. |
files[]. actions. restoreToDisk |
boolean (boolean) Allows to send request to restore item to disk |
files[]. actions. goToLocation |
boolean (boolean) Allows to move to location by id. |
files[]. modifiedAt |
string (date-time) Required. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). |