#Snapshots
#Get snapshots list
#Method
#Parameters
Name |
Type |
Description |
Required |
id |
string / number |
The identifier of the request. |
Yes |
jsonrpc |
string |
The protocol version. |
Yes |
method |
string |
The method name. |
Yes |
params |
object |
The parameters of the request. |
Yes |
#Result
Name |
Type |
Description |
Required |
id |
string / number |
The identifier of the request. |
Yes |
jsonrpc |
string |
The protocol version. |
Yes |
result |
array |
Result. |
Yes |
result.name |
string |
Snapshot name. |
Yes |
result.size |
string |
Snapshot size (KB). |
Yes |
#Request
{
"id": "unique-request-id",
"jsonrpc": "2.0",
"method": "snapshots.list",
"params": { }
}
#Response
{
"id": "unique-request-id",
"jsonrpc": "2.0",
"result": [
{
"name": "1-102",
"size": 69
},
{
"name": "1-51",
"size": 55
},
{
"name": "1-52",
"size": 38
}
]
}
#Create snapshot
#Method
#Parameters
Name |
Type |
Description |
Required |
id |
string / number |
The identifier of the request. |
Yes |
jsonrpc |
string |
The protocol version. |
Yes |
method |
string |
The method name. |
Yes |
params |
object |
The parameters of the request. |
Yes |
params.codec |
string |
Snapshot codec (default, json). |
No |
params.skipCompression |
boolean |
Skip data compression (false). |
No |
params.start |
boolean |
First block included in snapshot. |
No |
params.end |
boolean |
Last block included in snapshot. |
No |
Given start and end height may be changed to match nearest round start.
#Result
Name |
Type |
Description |
Required |
id |
string / number |
The identifier of the request. |
Yes |
jsonrpc |
string |
The protocol version. |
Yes |
result |
object |
Result. |
Yes |
An empty result means that snapshot creation process has started successfully. It does not guarantee that snapshot process will complete successfully.
#Request
{
"id": "unique-request-id",
"jsonrpc": "2.0",
"method": "snapshots.create",
"params": { "codec": "json", "skipCompression": true, "start": 1, "end": 200 }
}
#Response
{
"id": "unique-request-id",
"jsonrpc": "2.0",
"result": {}
}
#Restore snapshot
#Method
#Parameters
Name |
Type |
Description |
Required |
id |
string / number |
The identifier of the request. |
Yes |
jsonrpc |
string |
The protocol version. |
Yes |
method |
string |
The method name. |
Yes |
params |
object |
The parameters of the request. |
Yes |
params.name |
string |
Snapshot name. |
Yes |
params.truncate |
boolean |
Truncate database (false). |
No |
params.verify |
boolean |
Verify data on restore (false). |
No |
#Result
Name |
Type |
Description |
Required |
id |
string / number |
The identifier of the request. |
Yes |
jsonrpc |
string |
The protocol version. |
Yes |
result |
object |
Result. |
Yes |
Empty result means that snapshot restore process is started successfully. It does not guarantee that snapshot process will complete successfully.
#Request
{
"id": "unique-request-id",
"jsonrpc": "2.0",
"method": "snapshots.restore",
"params": { "blocks": "1-9793", "truncate": true, "verify": true }
}
#Response
{
"id": "unique-request-id",
"jsonrpc": "2.0",
"result": {}
}
#Delete snapshot
#Method
#Parameters
Name |
Type |
Description |
Required |
id |
string / number |
The identifier of the request. |
Yes |
jsonrpc |
string |
The protocol version. |
Yes |
method |
string |
The method name. |
Yes |
params |
object |
The parameters of the request. |
Yes |
params.name |
string |
Snapshot name. |
Yes |
#Result
Name |
Type |
Description |
Required |
id |
string / number |
The identifier of the request. |
Yes |
jsonrpc |
string |
The protocol version. |
Yes |
result |
object |
Result. |
Yes |
#Request
{
"id": "unique-request-id",
"jsonrpc": "2.0",
"method": "snapshots.delete",
"params": { "name": "1-9742" }
}
#Response
{
"id": "unique-request-id",
"jsonrpc": "2.0",
"result": {}
}