#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": {}
}