Page History

Создание хранилища

{
    "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
      "added": [ {
          "uid": "hosts/

SERVER",
          "units": [ {
              "type": "MultimediaStorage",
              "properties": [
                { "id": "display_name", "properties": [], "value_string": "ArchiveStorage" },
                { "id": "color", "properties": [], "value_string": "Gray" },
                { "id": "storage_type", "value_string": "object" }
      ] } ] } ]

    }
}

где

• uid −
Сервер
• сервер, на котором создаем архив
;
• ,
• units − свойства
;
• ,
• storage_type − тип архива (если параметр явно не задан, то создается старый тип архива): 
  • block − старый тип архива
;
• • ,
  • object − новый тип архива (объектный).
Если параметр явно не задан, то создается старый тип архива.
• •  

Создание тома архива

Возможные параметры ArchiveVolume в разделе properties:

На уровне ArchiveVolume также должно добавляться свойство connection_params со следующими параметрами:

Пример создания тома архива в виде файлов на локальном диске

...

Expand

Code Block language cpp { "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig", "data": { "added": [ { "uid": "hosts/SERVER/MultimediaStorage.Gray", "units": [ { "type": "ArchiveVolume", "properties": [ { "id": "volume_type", "value_string": "object", "properties": [ { "id": "connection_params", "value_properties": { "properties": [ {"id": "schema","value_string": "file"}, {"id": "path","value_string": "D:/archives"} ]}}]}, {"id": "label","value_string": "test"}, {"id": "volume_size","value_uint64": "26843545600"}, {"id": "format","value_bool": true}, { "id": "auto_mount", "value_bool": true } ]}]} ] } }

Пример создания тома архива на удаленном ресурсе

...

Expand

Code Block language cpp { "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig", "data": { "added": [ { "uid": "hosts/SERVER/MultimediaStorage.Gray", "units": [ { "type": "ArchiveVolume", "properties": [ { "id": "volume_type", "value_string": "object", "properties": [ { "id": "connection_params", "value_properties": { "properties": [ { "id": "schema", "value_string": "smb" }, { "id": "host", "value_string": "computer" }, { "id": "smb_domain", "value_string": "domain" }, { "id": "smb_share", "value_string": "Share" }, { "id": "path", "value_string": "video" }, { "id": "user", "value_string": "Tester" }, { "id": "password", "value_string": "Testing321" } ]}}]}, {"id": "label","value_string": "test"}, {"id": "volume_size","value_uint64": "12073741824"}, {"id": "format","value_bool": true} ]} ] } ] } }

Пример создания тома облачного архива в Microsoft Azure

...

Expand

Code Block language cpp { "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig", "data": { "added": [ { "uid": "hosts/SERVER/MultimediaStorage.Gray", "units": [ { "type": "ArchiveVolume", "properties": [ { "id": "volume_type", "value_string": "object", "properties": [ { "id": "connection_params", "value_properties": { "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": "youraccesskey==" }, { "id": "container", "value_string": "container" }, { "id": "user", "value_string": "axxonsoft" }, { "id": "path", "value_string": "" } ]}}]}, {"id": "label","value_string": "test"}, {"id": "volume_size","value_uint64": "12073741824"}, {"id": "format","value_bool": true} ]} ] } ] } }

Пример создания тома облачного архива в Amazon

...

Expand

Code Block language cpp { "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig", "data": { "added": [ { "uid": "hosts/SERVER/MultimediaStorage.Gray", "units": [ { "type": "ArchiveVolume", "properties": [ { "id": "volume_type", "value_string": "object", "properties": [ { "id": "connection_params", "value_properties": { "properties": [ { "id": "schema", "value_string": "s3_amazon" }, { "id": "bucket", "value_string": "axxonsoft-test" }, { "id": "region", "value_string": "us-west-1" }, { "id": "access_key_id", "value_string": "youraccesskeyid" }, { "id": "secret_access_key", "value_string": "yoursecretaccesskey" }, { "id": "path", "value_string": "path" }, { "id": "protocol", "value_string": "https" }, { "id": "host", "value_string": "amazonaws.com" } ]}}]}, {"id": "label","value_string": "test"}, {"id": "volume_size","value_uint64": "12073741824"}, {"id": "format","value_bool": true} ]} ] } ] } }

Пример создания тома облачного архива в Wasabi

...

Expand

Code Block language cpp { "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig", "data": { "added": [ { "uid": "hosts/SERVER/MultimediaStorage.Gray", "units": [ { "type": "ArchiveVolume", "properties": [ { "id": "volume_type", "value_string": "object", "properties": [ { "id": "connection_params", "value_properties": { "properties": [ { "id": "schema", "value_string": "s3_wasabi" }, { "id": "bucket", "value_string": "axxontest-1" }, { "id": "region", "value_string": "us-central-1" }, { "id": "access_key_id", "value_string": "youraccesskeyid" }, { "id": "secret_access_key", "value_string": "yoursecretaccesskey" }, { "id": "path", "value_string": "path" }, { "id": "protocol", "value_string": "http" }, { "id": "host", "value_string": "wasabisys.com" } ]}} ]}, {"id": "label","value_string": "test"}, {"id": "volume_size","value_uint64": "209715200"}, {"id": "format","value_bool": true} ] } ] } ] } }

Пример создания тома облачного архива в Huawei Cloud

...

Expand

Code Block language cpp { "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig", "data": { "added": [ { "uid": "hosts/SERVER/MultimediaStorage.Gray", "units": [ { "type": "ArchiveVolume", "properties": [ { "id": "volume_type", "value_string": "object", "properties": [ { "id": "connection_params", "value_properties": { "properties": [ { "id": "schema", "value_string": "s3_huawei" }, { "id": "bucket", "value_string": "axxon-test-1" }, { "id": "region", "value_string": "ap-southeast-1" }, { "id": "access_key_id", "value_string": "youraccesskeyid" }, { "id": "secret_access_key", "value_string": "yoursecretaccesskey" }, { "id": "path", "value_string": "path" }, { "id": "protocol", "value_string": "https" }, { "id": "host", "value_string": "myhuaweicloud.com" } ]}}]}, {"id": "label","value_string": "test"}, {"id": "volume_size","value_uint64": "10073741824"}, {"id": "format","value_bool": true} ] } ] } ] } }

Пример создания тома облачного архива в Seagate Lyve Cloud

...

Expand

Code Block language cpp { "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig", "data": { "added": [ { "uid": "hosts/SERVER/MultimediaStorage.Gray", "units": [ { "type": "ArchiveVolume", "properties": [ { "id": "volume_type", "value_string": "object", "properties": [ { "id": "connection_params", "value_properties": { "properties": [ { "id": "schema", "value_string": "s3_seagate" }, { "id": "bucket", "value_string": "axxonsoft-test" }, { "id": "region", "value_string": "us-west-1" }, { "id": "access_key_id", "value_string": "youraccesskeyid" }, { "id": "secret_access_key", "value_string": "yoursecretaccesskey" }, { "id": "path", "value_string": "path" }, { "id": "protocol", "value_string": "https" }, { "id": "host", "value_string": "lyvecloud.seagate.com" } ]}}]}, {"id": "label","value_string": "test"}, {"id": "volume_size","value_uint64": "1073741824"}, {"id": "format","value_bool": true} ]}]} ] } }

Пример создания тома облачного архива в MinIO S3

...

Expand

Code Block language cpp { "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig", "data": { "added": [ { "uid": "hosts/ServerNameSERVER/MultimediaStorage.Gray", "units": [ { "type": "ArchiveVolume", "properties": [ { "id": "volume_type", "value_string": "object", "properties": [ { "id": "connection_params", "value_properties": { "properties": [ { "id": "schema", "value_string": "s3" }, { "id": "bucket", "value_string": "bucket" }, { "id": "region", "value_string": "us-east-1" }, { "id": "access_key_id", "value_string": "MINIOROOT" }, { "id": "secret_access_key", "value_string": "MINIOPASS" }, { "id": "path", "value_string": "path" }, { "id": "protocol", "value_string": "http" }, { "id": "host", "value_string": "192.168.56.102" }, { "id": "port", "value_string": "9000" } ]}}]}, {"id": "label","value_string": "test"}, {"id": "volume_size","value_uint64": 1207374182}, {"id": "format","value_bool": true} ]} ] } ] } }

Пример создания тома облачного архива в MinIO S3 с использованием имени домена

...

{
    "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
        "added": [
            {
                "uid": "hosts/ServerSERVER/MultimediaStorage.Gray",
                "units": [
                    {
                        "type": "ArchiveVolume",
                        "properties": [
                            {
                                "id": "volume_type",
                                "value_string": "object",
                                "properties": [
                                    {
                                        "id": "connection_params",
                                        "value_properties": {
                                            "properties": [
                                                { "id": "schema", "value_string": "s3" },
                                                { "id": "bucket", "value_string": "bucket" },
                                                { "id": "region", "value_string": "us-east-1" },
                                                { "id": "access_key_id", "value_string": "MINIOROOT" },
                                                { "id": "secret_access_key", "value_string": "MINIOPASS" },
                                                { "id": "path", "value_string": "" },
                                                { "id": "protocol", "value_string": "http" },
                                                { "id": "host", "value_string": "" },
                                                { "id": "bucket_endpoint", "value_string": "http://miniopoc1.agis.xh.ar:9000" }
                                            ]}}]},
                            {"id": "label","value_string": "test"},
                            {"id": "volume_size","value_uint64": 1207374182},
                            {"id": "format","value_bool": true}
                        ]}
                        ]
            }
        ]
    }
}

Изменение тома

...

архива

Для изменения тома архива используются те же параметры, что и при его создании.

{
    "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig",
    "data": {
        "changed": [
            {
                "uid": "hosts/

SERVER/MultimediaStorage.Gray/ArchiveVolume.4508f459-5eeb-4ee3-881b-4a4e149c7802",
                "properties": [
                    {
                        "id": "label",
                        "value_string": "NewLabel"
                    },
                    {
                        "id": "readonly",
                        "value_bool": false
                    },
                    {
                        "id": "connection_params",
                        "value_properties": {
                            "properties": [
                                {
                                }
                            ]
                        }
                    }
                ]
            }
        ]
    }
}

Проверка наличия зашифрованных данных в томе архива

Проверка наличия зашифрованных данных выполняется с помощью метода ProbeVolume (ArchiveVolumeService). Для проверки нужно:

1. Предварительно создать объектное хранилище (см. Создание хранилища).
2. Добавить том архива с указанием ключа шифрования aes_key_hex:
   

   Code Block
   language cpp
   { "method": "axxonsoft.bl.config.ConfigurationService.ChangeConfig", "data": { "added": [ { "uid": "hosts/SERVER/MultimediaStorage.Blue", "units": [ { "properties": [ { "id": "volume_type", "properties": [ { "id": "connection_params", "value_properties": { "properties": [ { "id": "schema", "value_string": "file" }, { "id": "path", "value_string": "E:/Blue" } ] } } ], "value_string": "object" }, { "id": "label", "value_string": "Object volume" }, { "id": "volume_size", "value_uint64": "10374182400" }, { "id": "format", "value_bool": true }, { "id": "aes_key_hex", "value_string": "642b6c71556a6f66726c30526c6640535735732465506c7752232b4f4b553d52" }, { "id": "auto_mount", "value_bool": true } ], "type": "ArchiveVolume" } ] } ] } }

3. Привязать камеру к архиву (см. Привязка видеокамеры к архиву через gRPC API).
4. Выполнить запрос ProbeVolume к тому архива без указания ключа шифрования:
   

   Code Block
   language cpp
   { "method":"axxonsoft.bl.archive.ArchiveVolumeService.ProbeVolume", "data": { "volume_type": "object", "connection_params": { "schema": "file", "path": "E:\\Blue" }, "aes_key_hex": "" } }

5. Если в ответе в поле status_code указано значение OK, нужно дождаться появления первого блока данных в архиве и повторно выполнить запрос ProbeVolume. В результате должен прийти ответ:
   

   Code Block
   language cpp
   { "status_code": "ENCRYPTED", "error_details": "", "label": "C:/ArchiveAliceBlue", "capacity_bytes": "1073741824", "used_bytes": "13280428", "details": { "TotalBytesWritten": "13280428", "FormatVersion": "1", "max_block_size_mb": "64", "optimal_read_size_mb": "4", "AvailableSizeBytes": "1060461396" }, "create_time": "2024-09-10T08:46:42Z" }

   где значение ENCRYPTED возвращается, если в томе архива присутствуют зашифрованные данные, и их расшифровка невозможна с использованием указанного ключа шифрования. Если том архива создан, но запись данных в него не выполнялась, статус ENCRYPTED не возвращается, поскольку зашифрованные данные отсутствуют.

Проверка зашифрованных данных завершена.