Добавляет новое внешнее хранилище двоичных данных. Требуется режим монопольного доступа к информационной базе.
Синтаксис
Добавить(<Имя>, <ПараметрыПодключения>, <ПараметрыДоступа>)Примеры платформы
СтрПодключения = Новый
ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных();
СтрПодключения.URL = "https://bucket.example.com";
СтрПодключения.ТипURL =
ТипURLВнешнегоХранилищаДвоичныхДанных.ВиртуальныйХостS3;
Доступ = Новый ПараметрыДоступаВнешнегоХранилищаДвоичныхДанных();
Доступ.ИдентификаторДоступа = "EXAMPLE";
Доступ.СекретныйКлюч = "SecretKey";
Доступ.Регион = "US";
Мнджр = ВнешниеХранилищаДвоичныхДанных
.Добавить("manager", СтрПодключения, Доступ);Полное описание, параметры и ограничения
МенеджерВнешнихХранилищДвоичныхДанных.Добавить (BinaryDataExternalStoragesManager.Add)
МенеджерВнешнихХранилищДвоичныхДанных (BinaryDataExternalStoragesManager)
Добавить (Add)
Доступен, начиная с версии 8.3.24.
Синтаксис:
Добавить(<Имя>, <ПараметрыПодключения>, <ПараметрыДоступа>)
Параметры:
<Имя> (обязательный)
Тип: Строка.
Имя внешнего хранилища двоичных данных.
<ПараметрыПодключения> (обязательный)
Тип: ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных.
Параметры подключения внешнего хранилища двоичных данных.
<ПараметрыДоступа> (обязательный)
Тип: ПараметрыДоступаВнешнегоХранилищаДвоичныхДанных.
Параметры доступа внешнего хранилища двоичных данных.
Возвращаемое значение:
Тип: МенеджерВнешнегоХранилищаДвоичныхДанных.
Описание:
Добавляет новое внешнее хранилище двоичных данных.
Требуется режим монопольного доступа к информационной базе.
Доступность:
Сервер.
Примечание:
Если хранилище с данным именем уже существует, в имени содержатся пробелы, либо оно пустое, то будет сгенерировано исключение, а операция отклонена.
Если в параметре ПараметрыПодключения поле URL или ТипURL имеют значение Неопределено, то будет сгенерировано исключение, а операция отклонена.
Параметры метода будут записаны в поля <Имя> и <ПараметрыПодключения> соответственно. Изменить их можно будет только пересозданием менеджера.
Пример:
СтрПодключения = Новый
ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных();
СтрПодключения.URL = "https://bucket.example.com";
СтрПодключения.ТипURL =
ТипURLВнешнегоХранилищаДвоичныхДанных.ВиртуальныйХостS3;
Доступ = Новый ПараметрыДоступаВнешнегоХранилищаДвоичныхДанных();
Доступ.ИдентификаторДоступа = "EXAMPLE";
Доступ.СекретныйКлюч = "SecretKey";
Доступ.Регион = "US";
Мнджр = ВнешниеХранилищаДвоичныхДанных
.Добавить("manager", СтрПодключения, Доступ);
См. также:
МенеджерВнешнегоХранилищаДвоичныхДанных
МенеджерВнешнегоХранилищаДвоичныхДанных, свойство Имя
МенеджерВнешнегоХранилищаДвоичныхДанных, свойство ПараметрыПодключения
Использование в версии:
Доступен, начиная с версии 8.3.24.
Методическая информация
Практические примеры
Добавить и удалить собственную регистрацию внешнего хранилища
Настройки доступа берём из своего действительного хранилища. Новый объект — отдельная учебная регистрация, не произвольная структура доступа.
Где и как запускать
Серверный обработчик своей учебной базы. Это пример синтаксиса: здесь 1С, файлы, базы и сеть не запускались.
Подготовка
Только собственная учебная серверная ИБ в заранее установленном монопольном режиме и собственный отдельный S3-ресурс. Подготовьте регистрацию УчебноеИсходное с действительными доступом и параметрами.
АдресУчебногоS3 — реальная строка адреса своего учебного ресурса. study-extra — отдельное согласованное учебное размещение; имя УчебноеДополнительное должно быть свободно. Не выводите ключи доступа.
Менеджер = ВнешниеХранилищаДвоичныхДанных;
Источник = Менеджер.Найти("УчебноеИсходное");
Доступ = Источник.ПараметрыДоступа;
Подключение = Новый ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных;
Подключение.URL = АдресУчебногоS3;
Подключение.Каталог = "study-extra";
Подключение.ТипURL = Источник.ПараметрыПодключения.ТипURL;
Новое = Менеджер.Добавить("УчебноеДополнительное", Подключение, Доступ);
Новое.ХранилищеПоУмолчанию = Ложь;
Новое.Записать();
Сообщить(Новое.Имя);
Менеджер.Удалить(Новое);Разбор по шагам
Используем действительные параметры доступа своего источника.
Создаём и записываем отдельную регистрацию.
Удаляем только удержанный новый объект регистрации.
Как проверить результат
Прочитано собственное новое имя УчебноеДополнительное.
Удаление относится к новому объекту, не к источнику.
Ожидаемый результат
Контрольный результат описывает будущую ручную проверку в подготовленном учебном окружении. Выполнение в 1С здесь не проверялось.
На что обратить внимание
Добавить и Удалить требуют монопольного режима. Это будущие изменения своего стенда, не атомарный опыт: ошибка может оставить регистрацию; никаких обещаний удаления файлов S3 или отката.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.