Тип: Строка. Подкаталог внутри контейнера (корзины, bucket). Полный путь до объекта будет иметь вид: "<URL-адрес подключения к хранилищу>/<Каталог>".
Полное описание, параметры и ограничения
ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных.Каталог (BinaryDataExternalStorageConnectionParameters.Directory)
ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных (BinaryDataExternalStorageConnectionParameters)
Каталог (Directory)
Доступен, начиная с версии 8.3.27.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Подкаталог внутри контейнера (корзины, bucket). Полный путь до объекта будет иметь вид: "<URL-адрес подключения к хранилищу>/<Каталог>".
Доступность:
Сервер.
Использование в версии:
Доступен, начиная с версии 8.3.27.
Методическая информация
Практические примеры
Подготовить параметры S3 без сетевого подключения
Создаём отдельный объект параметров с учебным URL и подкаталогом. Домен example.invalid — фиктивный макет; он не является работающим сервисом или обходом доступа.
Где и как запускать
Полный серверный модуль собственной учебной конфигурации 8.5.1.1343. Нет применения настроек или удаления данных хранилища.
Подготовка
Создайте отдельную пустую учебную конфигурацию на платформе 8.5.1.1343 с режимом совместимости НеИспользовать. Не используйте производственную базу и не изменяйте предоставленные выгрузки КА2/УТ/УНФ.
Добавьте справочник УчебныеФайлы и три реквизита: Данные и Предпросмотр с типом ХранилищеЗначения, ИспользоватьВнешнееХранение с типом Булево. Обновите только свою учебную базу. Сами записи справочника создавать не нужно.
Создайте серверный общий модуль УчебныеЗадачи, вставьте полный модуль одного урока и вызовите ВыполнитьПример() из своей серверной команды.
Упражнения с Новый СоставХранимыхДанныхХранилищаДвоичныхДанных и параметрами подключения меняют только собственные объекты в памяти. Нет установки состава, записи менеджера, резервного копирования или физической очистки.
Для диагностики настоящего хранилища нужен отдельно подготовленный администратором учебный сервер. Код различает отсутствие поддержки платформой и ошибку чтения состояния, не включает сервис автоматически.
Процедура ВыполнитьПример() Экспорт
Параметры = Новый ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных;
Сообщить(ПустаяСтрока(Параметры.URL));
Сообщить(Параметры.ТипURL = ТипURLВнешнегоХранилищаДвоичныхДанных.ХостS3СБакетомВСоставеПути);
Параметры.URL = "https://storage.example.invalid/guide-bucket";
Параметры.Каталог = "syntax-guide-owned";
Сообщить(Параметры.URL = "https://storage.example.invalid/guide-bucket");
Сообщить(Параметры.Каталог = "syntax-guide-owned");
Сообщить("Проект адреса без обращения к сети: " + Параметры.URL + "/" + Параметры.Каталог);
КонецПроцедурыРазбор по шагам
Конструктор создаёт URL="" и ТипURL=ХостS3СБакетомВСоставеПути по справке. Объект параметров сам не регистрирует новое хранилище.
URL относится к подключению S3. Каталог — подкаталог внутри bucket, а не C:\папка и не путь файлового сервера.
Собственный префикс syntax-guide-owned отделяет учебное назначение. При реальном подключении адрес, тип URL и bucket необходимо согласовать с вашим провайдером S3.
Конкатенация показывает только проект адреса. Это не проверка подписи, наличия bucket, DNS, сертификата TLS или доступности S3.
Нет ВнешниеХранилищаДвоичныхДанных.Добавить, HTTPСоединение или Записать. Фиктивный домен не используется для сетевого запроса.
Как проверить результат
Четыре контрольных Истина и строка проекта адреса.
Внешнее хранилище в базе не зарегистрировано, запрос не отправлен.
Ожидаемый результат
Подготовлены понятные параметры будущего учебного подключения без секретов и внешних действий.
На что обратить внимание
Правильный формат URL выбирается по контракту конкретного S3; этот макет не доказывает сетевую совместимость.
Каталог не является отдельным bucket.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Проверить описание только своего внешнего хранилища без вывода ключей
Выбираем заранее подготовленное GUIDE_S3, читаем его параметры и проверяем заполненность доступа. Никакие ключи, URL и регионы не выводятся открытым текстом.
Где и как запускать
Полный серверный модуль собственной учебной конфигурации 8.5.1.1343. Нет применения настроек или удаления данных хранилища.
Подготовка
Только отдельная учебная база и серверный общий модуль. Если нужен непустой результат, администратор заранее вручную настраивает собственное тестовое S3-хранилище с уникальным именем GUIDE_S3 и выделенным учебным bucket.
Если такого собственного сервиса нет, запускайте только для понятного сообщения отсутствия. Этот пример его не создаёт и не просит вводить секреты в текст кода.
Не передавайте код чужому рабочему хранилищу и не добавляйте вывод объектов ПараметрыДоступа целиком. Код только читает описание собственной настройки.
Процедура ВыполнитьПример() Экспорт
Настройка = Новый Структура("Тип,Имя", ТипХранилищаДвоичныхДанных.Внешнее, "GUIDE_S3");
Если Настройка.Тип = ТипХранилищаДвоичныхДанных.Встроенное Тогда
Сообщить("Для встроенного типа нужна отдельная диагностика ХранилищеДвоичныхДанных");
Возврат;
КонецЕсли;
Если Настройка.Тип <> ТипХранилищаДвоичныхДанных.Внешнее Тогда
ВызватьИсключение "Неизвестный тип учебной настройки";
КонецЕсли;
Попытка
Сообщить("Внешних описаний в базе: " + Строка(ВнешниеХранилищаДвоичныхДанных.Количество()));
Хранилище = ВнешниеХранилищаДвоичныхДанных.Найти(Настройка.Имя);
Исключение
Сообщить("Чтение реестра недоступно; проверьте права и причину: " + ОписаниеОшибки());
Возврат;
КонецПопытки;
Если Хранилище = Неопределено Тогда
Сообщить("Собственное GUIDE_S3 не подготовлено; регистрация и сетевой запрос не выполняются");
Возврат;
КонецЕсли;
Сообщить(Хранилище.Имя = "GUIDE_S3");
Сообщить("Дата очистки задана: " + Строка(Хранилище.ДатаПоследнейОчистки <> Неопределено));
Сообщить("Минимальный размер в байтах: " + Строка(Хранилище.МинимальныйРазмерЗаписываемыхДанных));
Сообщить("Хранилище по умолчанию: " + Строка(Хранилище.ХранилищеПоУмолчанию));
Сообщить("Режим чтения/записи: " + Строка(Хранилище.РежимЧтенияЗаписи));
Сообщить("Правил состава: " + Строка(Хранилище.СоставХранимыхДанных.Количество()));
Подключение = Хранилище.ПараметрыПодключения;
Сообщить("URL заполнен: " + Строка(НЕ ПустаяСтрока(Подключение.URL)));
Сообщить("Подкаталог задан: " + Строка(НЕ ПустаяСтрока(Подключение.Каталог)));
Сообщить("Тип URL: " + Строка(Подключение.ТипURL));
Доступ = Хранилище.ПараметрыДоступа;
Сообщить("Идентификатор доступа заполнен: " + Строка(НЕ ПустаяСтрока(Доступ.ИдентификаторДоступа)));
Сообщить("Секретный ключ заполнен: " + Строка(НЕ ПустаяСтрока(Доступ.СекретныйКлюч)));
Сообщить("Регион задан: " + Строка(НЕ ПустаяСтрока(Доступ.Регион)));
Сообщить("Проверена заполненность описания, не успешная авторизация S3");
КонецПроцедурыРазбор по шагам
Тип учебной настройки — системное значение Внешнее. Для Встроенное выбран другой менеджер, а не поиск по имени в реестре S3.
Ищем только известное собственное имя GUIDE_S3. Отсутствие — нормальный понятный выход; код не регистрирует сервис по фиктивным реквизитам.
Менеджер хранит описание: минимальный размер, дату последней очистки, режим, признак по умолчанию и состав. Это не доказательство доступности bucket.
ПараметрыПодключения и ПараметрыДоступа — два разных объекта. URL, каталог, идентификатор, регион и секрет проверяются на заполненность без вывода самих строк.
ПараметрыДоступа получают от зарегистрированного менеджера; у этого типа нет документированного конструктора Новый. Не выдумываем его.
Нет Записать, Добавить, Удалить, очистки, установки монопольного режима или отправки S3-запроса. Проверка заполненности не равна успешной авторизации.
Как проверить результат
Если GUIDE_S3 нет — выход без регистрации. Если оно подготовлено — истинная проверка имени и фактические неперсональные признаки.
В сообщениях не появляются значения ключа, идентификатора доступа, URL или региона. Ни одно свойство менеджера не присваивается.
Ожидаемый результат
Собственное описание S3 исследовано с сохранением секретов и без изменения рабочей настройки.
На что обратить внимание
Не тестируйте пример на произвольных рабочих хранилищах только потому, что они есть в реестре.
Наличие ключа не проверяет правильность подписи, срок доступа или политики bucket.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.