Backups

Show #

URL Parameters

This endpoint does not accept any parameters
                            GET
                            /v1/backups/{backup_id}
                        
                           
curl https://api.snapshooter.com/v1/backups/{backup_id} \
-X GET \
--header 'Authorization: Bearer API_TOKEN_HERE'
HTTP/2 200
{
"data": {
"id": "596c5046-1bd8-4664-9a3f-6208526c3b87",
"job_id": "6f7c5f07-bd49-49a5-8416-27b8de037ddc",
"status": "completed",
"tags": {
"manual": true,
"hourly": false,
"daily": false,
"weekly": false,
"monthly": false
},
"s3_directory": "snapshooter/5d32e6da-docker-mysql-ssh/2023/07/06/21-01",
"created_at": "2023-07-06T21:01:58.000000Z",
"started_at": "2023-07-06T21:02:18.000000Z",
"completed_at": "2023-07-06T21:02:49.000000Z",
"monitoring_available": true,
"encryption_key": "LS0tLS1CRU...URSBLRVktLS0tLQ==",
"files": [
{
"id": "045c31f2-234c-4c12-ae69-b6188b37412d",
"name": "snapshooter\/5d32e6da-docker-mysql-ssh\/2023\/07\/06\/21-01\/test.sql.gz",
"size": "744 bytes",
"url": "..."
}
]
}
}

Errors


Download Backup Files #

Parameters

This endpoint does not accept any parameters
                            POST
                            /v1/backups/{backup_id}/download
                        
                           
curl https://api.snapshooter.com/v1/backups/{backup_id}/download \
-X POST \
--header 'Authorization: Bearer API_TOKEN_HERE'
HTTP/2 200
{
"data": {
"run.sh": "https://snapshooter-test.s3.eu-west-1.scw.cloud/aut?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=key%2F20220614%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20220614T133438Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=11a077e91564dc8997a4c868419b75f51a7967b7c9b010404c200ec7f6191096",
"app.js": "https://snapshooter-test.s3.eu-west-1.amazonaws.com/qui?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=key%2F20220614%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20220614T133438Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=8dfadf49bfe58d45c452b2796460254ad6ec08ab0ac4a76704eb5110672685bc",
"app.css": "https://snapshooter-test.s3.filebase.com/libero?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=key%2F20220614%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20220614T133438Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=42e833c15a49cd75c88b13fcb869887c062dcf0a1873e8b6d0dca770f1959f28",
"dashboard.js": "https://s3.amazonaws.com/snapshooter-test/id?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=key%2F20220614%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20220614T133438Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=bd079f2e8fa51f7de5c76dfadd3291c3144916565d20c66d25282e9724d82a08",
"admin.js": "https://snapshooter.eu-west-1.upcloudobjects.com/test/rerum?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=key%2F20220614%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20220614T133438Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=88623b03fb58ee192ac03990dc44a24badbb721248a5f1c7f8843821eaf75d23",
"admin.css": "https://s3.eu-west-1.backblazeb2.com/snapshooter-test/commodi?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=key%2F20220614%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20220614T133438Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=60f1401609c20c293d6ed30622bd9ec767dc94963a46a54170947f37a1fe9176",
"guest.js": "https://snapshooter-test.s3.filebase.com/asperiores?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=key%2F20220614%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20220614T133438Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=7b601b7f2c6f46228dced2c3fec4c63f9a33ccae4c276b54a427b985da638516"
}
}

Errors


Restore

Restore #

Parameters


array files (optional)

Array of file ids to restore. If parameter is ommitted, all available files will be restored.


object compute (optional)

Allows to change the resource in which the Backup Restore will be processed. This option is not available when using Serverless Compute to perform the Backup. The object must contain the "type" and "server_id" parameters.

                            POST
                            /v1/backups/{backup_id}/restore
                        
                           
curl https://api.snapshooter.com/v1/backups/{backup_id}/restore \
-X POST \
--header 'Authorization: Bearer API_TOKEN_HERE' \
HTTP/2 201
{
"data": {
"id": "ed6ca4f1-6047-4deb-a69d-8c42ba7e745f",
"job_id": "5d32e6da-7d64-40c7-9e7f-6f16080a13c4",
"backup_id": "70bf81d5-bf19-4a09-b0e0-c10b140d712e",
"compute": {
"id": 3,
"type": "server",
"server": {
"id": 3,
"host": "...",
"user": "root",
"port": 22,
"name": "WordPress Blog",
"created_at": "2023-04-25T14:16:59.000000Z",
"last_used": "2023-07-06T21:02:49.000000Z",
"status": "success"
}
},
"status": "pending",
"created_at": "2023-07-21T15:36:39.000000Z",
"started_at": null,
"completed_at": null,
"files": [
{
"id": "045c31f2-234c-4c12-ae69-b6188b37412d",
"name": "snapshooter\/5d32e6da-docker-mysql-ssh\/2023\/07\/06\/21-01\/test.sql.gz",
"size": "744 bytes",
"url": "..."
}
]
}
}

Examples

curl -X POST https://api.snapshooter.com/v1/backups/{backup_id}/restore \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data-binary @- <<DATA
{}
DATA
curl -X POST https://api.snapshooter.com/v1/backups/{backup_id}/restore \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data-binary @- <<DATA
{
"files": ["f7a4b142-5aa8-4b42-8896-62455f696e5a"]
}
DATA
curl -X POST https://api.snapshooter.com/v1/backups/{backup_id}/restore \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data-binary @- <<DATA
{
"compute": {
"type": "ss_agent",
"server_id": 9362
}
}
DATA

Errors


Was this page helpful?

Thank you for helping us improve!