Доменное имя содержит указание бакета.
Полное описание, параметры и ограничения
ТипURLВнешнегоХранилищаДвоичныхДанных.ХостS3СБакетомВСоставеПути (BinaryDataExternalStorageURLType.S3HostWithBucketInPath)
ТипURLВнешнегоХранилищаДвоичныхДанных (BinaryDataExternalStorageURLType)
ХостS3СБакетомВСоставеПути (S3HostWithBucketInPath)
Доступен, начиная с версии 8.3.24.
Использование:
Только чтение.
Описание:
Доменное имя содержит указание бакета.
Доступность:
Сервер.
Примечание:
Доменное имя с бакетом указывается в свойстве URL.
Использование в версии:
Доступен, начиная с версии 8.3.24.
Методическая информация
Практические примеры
Подготовить параметры 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.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Сравнить два независимых проекта параметров подключения
Не изменяем один общий объект, переданный двум настройкам. Создаём два самостоятельных проекта и показываем оба варианта ТипURL без обещания рабочего S3.
Где и как запускать
Полный серверный модуль собственной учебной конфигурации 8.5.1.1343. Нет применения настроек или удаления данных хранилища.
Подготовка
Создайте отдельную пустую учебную конфигурацию на платформе 8.5.1.1343 с режимом совместимости НеИспользовать. Не используйте производственную базу и не изменяйте предоставленные выгрузки КА2/УТ/УНФ.
Добавьте справочник УчебныеФайлы и три реквизита: Данные и Предпросмотр с типом ХранилищеЗначения, ИспользоватьВнешнееХранение с типом Булево. Обновите только свою учебную базу. Сами записи справочника создавать не нужно.
Создайте серверный общий модуль УчебныеЗадачи, вставьте полный модуль одного урока и вызовите ВыполнитьПример() из своей серверной команды.
Упражнения с Новый СоставХранимыхДанныхХранилищаДвоичныхДанных и параметрами подключения меняют только собственные объекты в памяти. Нет установки состава, записи менеджера, резервного копирования или физической очистки.
Для диагностики настоящего хранилища нужен отдельно подготовленный администратором учебный сервер. Код различает отсутствие поддержки платформой и ошибку чтения состояния, не включает сервис автоматически.
Процедура ВыполнитьПример() Экспорт
Первый = Новый ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных;
Первый.URL = "https://storage.example.invalid/guide-bucket";
Первый.Каталог = "main";
Первый.ТипURL = ТипURLВнешнегоХранилищаДвоичныхДанных.ХостS3СБакетомВСоставеПути;
Второй = Новый ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных;
Второй.URL = "https://guide-bucket.storage.example.invalid";
Второй.Каталог = "preview";
Второй.ТипURL = ТипURLВнешнегоХранилищаДвоичныхДанных.ВиртуальныйХостS3;
Сообщить(Первый.Каталог = "main");
Сообщить(Второй.Каталог = "preview");
Сообщить(Первый.ТипURL <> Второй.ТипURL);
Второй.Каталог = "preview-v2";
Сообщить(Первый.Каталог = "main");
Сообщить(Второй.Каталог = "preview-v2");
Сообщить("Оба объекта только в памяти; подписи S3 и обращений к сервису нет");
КонецПроцедурыРазбор по шагам
Оба объекта созданы разными вызовами Новый. У каждого свои URL, Каталог и ТипURL.
Два системных значения ТипURL передаются как типизированные варианты, а не как строки ВиртуальныйХостS3 и ХостS3СБакетомВСоставеПути.
Учебные адреса не являются действующими настройками. В установленной справке краткие описания двух вариантов URL не согласованы с их названиями; реальную маршрутизацию S3 этим примером не утверждаем.
Меняем Каталог только второго проекта и проверяем, что первый остался main. Это демонстрация независимых объектов, не проверки сети.
Ни один объект не передан методу регистрации внешнего хранилища.
Как проверить результат
Пять контрольных Истина; изменение второго проекта не меняет первый.
Оба адреса имеют фиктивный домен, сетевых вызовов в коде нет.
Ожидаемый результат
Показано безопасное раздельное построение двух проектов параметров с разными системными вариантами URL.
На что обратить внимание
Не определяйте формат своего провайдера только по неоднозначной краткой фразе справки.
Присваивание Второй = Первый означало бы общий объект, а не независимую копию.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.