Create archive using gRPC API methods

On this page:

Creating an archive entity

{
    "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
        "added": [
            {
                "uid": "hosts/Server1",
                "units": [
                    {
                        "type": "MultimediaStorage",
                        "properties": [
                            {
                                "id": "display_name",
                                "properties": [],
                                "value_string": "Object storage"
                            },
                            {
                                "id": "color",
                                "properties": [],
                                "value_string": "AliceBlue"
                            },
                            {
                                "id": "storage_type",
                                "value_int32": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "changed": [],
        "removed": []
    }
}

where

uid - Server on which the archive is created;
units - properties;
storage_type - archive type: 0 - old archive type; 1 - new archive type (object archive). If the parameter is not explicitly specified, then an archive of old type is created.

Creating an archive volume

Possible ArchiveVolume parameters in the properties section:

Parameter	Description
format	true if it is necessary to format the created volume. The default is false.
volume_size_gb	Volume size in GB. Applicable if format = true.
auto_mount	true if it is necessary to mount the created volume. The default is false.
label	Volume label
Parameters for object archives only (storage_type = 1):
max_block_size_mb	Maximum block size in MB. The default is 64, the range of valid values is [16; 512].
optimal_read_size_mb	Optimal size of blocks reading in MB. The default is 4, the range of valid values is [1; max_block_size_mb / 2].
incoming_buffer_size_mb	The incoming buffer size in MB. The default is 3 * max_block_size_mb. The minimum value should be greater than 2 * max_block_size_mb.
block_flush_period_seconds	Block recording period in seconds. The default is 60, the range of valid values is [30; 300].
index_snapshot_max_block_distance	The maximum number of blocks between indexing operations. The default is 256, the minimum is 16.
sequence_flush_period_seconds	Sequences recording period in seconds. The default is 60, the minimum is 32.

At the ArchiveVolume level, the connection_params property is also added, with the following parameters:

Parameter	Required	Description
schema	Yes	Volume type. Possible values: file - local archive on the Server; smb - network archive with an SMB protocol connection; azure - archive in Microsoft Azure cloud storage.
Parameters for the file type:
path	Yes	The path to the file/disk with the archive.
Parameters for the smb type:
host	Yes	Name of the server with network repository.
smb_share	Yes	Network repository.
path	Yes	Folder in network repository, where the archive will be stored.
smb_domain	No	Network repository domain.
user	No	User name.
password	No	Password.
Parameters for the azure type:
protocol	Yes	Connection protocol: HTTP or HTTPS.
host	Yes	Azure server address.
access_key	Yes	Access key in base64.
container	Yes	Azure container.
user	Yes	User name.
path	No	Location of the volume folder in Azure.
port	No	Azure server port.

Example of creating an object archive as files on a local disk:

{
	"method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
	"data": {
		"added": [
			{
				"uid": "hosts/Server1/MultimediaStorage.AliceBlue",
				"units": [
					{
						"type": "ArchiveVolume",
						"properties": [
							{
								"id": "connection_params",
								"properties": [
									{
										"id": "schema",
										"value_string": "file"
									},
									{
										"id": "path",
										"value_string": "D:/archiveCrimson1"
									}
								]
							},
							{
								"id": "label",
								"value_string": "Test archive"
							},
							{
								"id": "volume_size_gb",
								"value_uint64": 4
							}
						]
					}
				]
			}
		],
		"changed": [],
		"removed": []
	}
}

Example of creating an object archive on a network resource:

{
	"method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
	"data": {
		"added": [
			{
				"uid": "hosts/Server1/MultimediaStorage.AliceBlue",
				"units": [
					{
						"type": "ArchiveVolume",
						"properties": [

                            {
                                "id": "connection_params",
                                "properties": [
                                    {
                                        "id": "schema",
                                        "value_string": "smb"
                                    },
                                    {
                                        "id": "host",
                                        "value_string": "qa-t39"
							        },
                                    {
                                        "id": "smb_share",
                                        "value_string": "incoming"
							        },
                                    {
                                        "id": "path",
                                        "value_string": "video"
							        },
                                    {
                                        "id": "user",
                                        "value_string": "QA"
							        },
                                    {
                                        "id": "password",
                                        "value_string": "QA_TEST"
							        }
                                ]
                            },

                            {
								"id": "label",
							    "value_string": "Test archive"
							},
                            {
								"id": "volume_size_gb",
								"value_uint64": 4
							},
                            {
								"id": "format",
								"value_bool": true
							}
						]
					}
				]
			}
		],
		"changed": [],
		"removed": []
	}
}

Example of creating an object archive in Microsoft Azure:

{
	"method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
	"data": {
		"added": [
			{
				"uid": "hosts/Server1/MultimediaStorage.AliceBlue",
				"units": [
					{
						"type": "ArchiveVolume",
						"properties": [

                            {
                                "id": "connection_params",
                                "properties": [
                                    {
                                        "id": "schema",
                                        "value_string": "azure"
                                    },
                                    {
                                        "id": "protocol",
                                        "value_string": "https"
                                    },
                                    {
                                        "id": "host",
                                        "value_string": "axxonsoft.blob.core.windows.net"
                                    },
                                    {
                                        "id": "access_key",
                                        "value_string": "bik2582k7wBdpXHtm5WZ7LXvrRM/QGLyuMrzqyNPIRDD+E21yppcBMtiR+FwFFWfYp91aBC6gf1us6Jn3KAhnA=="
                                    },
                                    {
                                        "id": "container",
                                        "value_string": "container"
                                    },
                                    {
                                        "id": "user",
                                        "value_string": "axxonsoft"
                                    },
                                    {
                                        "id": "path",
                                        "value_string": ""
                                    }
                                ]
                            },

                            {
								"id": "label",
							    "value_string": "Test archive"
							},
                            {
								"id": "volume_size_gb",
								"value_uint64": 10000
							},
                            {
								"id": "format",
								"value_bool": true
							}
						]
					}
				]
			}
		],
		"changed": [],
		"removed": []
	}
}

Changing an archive volume

To change the archive volume, the same parameters are used as when creating it.

{
	"method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
	"data": {
		"added": [],
		"changed": [
			{
				"uid": "hosts/Node1/MultimediaStorage.AliceBlue/ArchiveVolume.d0305f4a-1a20-4b10-a132-605eff3269d7",
				"properties": [
					{
						"id": "connection_params",
						"properties": [
							{
								"id": "schema",
								"value_string": "file"
							},
							{
								"id": "path",
								"value_string": "D:/archiveCrimson11"
							}
						]
					}
				]
			}
		],
		"removed": []
	}
}

Page tree

Create archive using gRPC API methods

Creating an archive entity

Creating an archive volume

Changing an archive volume