МенеджерВнешнихХранилищДвоичныхДанных.Удалить

Методы · Delete

Удаляет внешнее хранилище двоичных данных. Требуется режим монопольного доступа к информационной базе.

Синтаксис

Удалить(<ВнешнееХранилищеДвоичныхДанных>)

Примеры платформы

cp = Новый ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных();
cp.URL = "https://bucket.example.com";
cp.ТипURL = ТипURLВнешнегоХранилищаДвоичныхДанных.ВиртуальныйХостS3;
ap = Новый ПараметрыДоступаВнешнегоХранилищаДвоичныхДанных();
ap.ИдентификаторДоступа = "EXAMPLE";
ap.СекретныйКлюч = "SecretKey";
ap.Регион = "US";
Мнджр = ВнешниеХранилищаДвоичныхДанных.Добавить("manager", cp, ap);
Мнджр = ВнешниеХранилищаДвоичныхДанных["manager"];
ВнешниеХранилищаДвоичныхДанных.Удалить(Мнджр);
Полное описание, параметры и ограничения

МенеджерВнешнихХранилищДвоичныхДанных.Удалить (BinaryDataExternalStoragesManager.Delete)

МенеджерВнешнихХранилищДвоичныхДанных (BinaryDataExternalStoragesManager)

Удалить (Delete)

Доступен, начиная с версии 8.3.24.

Синтаксис:
Удалить(<ВнешнееХранилищеДвоичныхДанных>)
Параметры:

<ВнешнееХранилищеДвоичныхДанных> (обязательный)
Тип: МенеджерВнешнегоХранилищаДвоичныхДанных.
Менеджер внешнего хранилища двоичных данных.
Возвращаемое значение:
Нет
Описание:

Удаляет внешнее хранилище двоичных данных.
Требуется режим монопольного доступа к информационной базе.

Доступность:

Сервер.

Примечание:
При попытке повторного удаления будет сгенерировано исключение.

После удаления внешнего хранилища доступ к данным не восстанавливается, в том числе при повторном добавлении хранилища с теми же параметрами <Имя>, <ПараметрыПодключения> и <ПараметрыДоступа>.
Пример:

cp = Новый ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных();
cp.URL = "https://bucket.example.com";
cp.ТипURL = ТипURLВнешнегоХранилищаДвоичныхДанных.ВиртуальныйХостS3;

ap = Новый ПараметрыДоступаВнешнегоХранилищаДвоичныхДанных();
ap.ИдентификаторДоступа = "EXAMPLE";
ap.СекретныйКлюч = "SecretKey";
ap.Регион = "US";

Мнджр = ВнешниеХранилищаДвоичныхДанных.Добавить("manager", cp, ap);

Мнджр = ВнешниеХранилищаДвоичныхДанных["manager"];
ВнешниеХранилищаДвоичныхДанных.Удалить(Мнджр);

См. также:
МенеджерВнешнихХранилищДвоичныхДанных, метод Добавить

Использование в версии:

Доступен, начиная с версии 8.3.24.

Описание изменено в версии 8.3.27.

Методическая информация

Практические примеры

Добавить и удалить собственную регистрацию внешнего хранилища

Настройки доступа берём из своего действительного хранилища. Новый объект — отдельная учебная регистрация, не произвольная структура доступа.

Где и как запускать

Серверный обработчик своей учебной базы. Это пример синтаксиса: здесь 1С, файлы, базы и сеть не запускались.

Подготовка

  1. Только собственная учебная серверная ИБ в заранее установленном монопольном режиме и собственный отдельный S3-ресурс. Подготовьте регистрацию УчебноеИсходное с действительными доступом и параметрами.

  2. АдресУчебногоS3 — реальная строка адреса своего учебного ресурса. study-extra — отдельное согласованное учебное размещение; имя УчебноеДополнительное должно быть свободно. Не выводите ключи доступа.

Менеджер = ВнешниеХранилищаДвоичныхДанных;
Источник = Менеджер.Найти("УчебноеИсходное");
Доступ = Источник.ПараметрыДоступа;
Подключение = Новый ПараметрыПодключенияВнешнегоХранилищаДвоичныхДанных;
Подключение.URL = АдресУчебногоS3;
Подключение.Каталог = "study-extra";
Подключение.ТипURL = Источник.ПараметрыПодключения.ТипURL;
Новое = Менеджер.Добавить("УчебноеДополнительное", Подключение, Доступ);
Новое.ХранилищеПоУмолчанию = Ложь;
Новое.Записать();
Сообщить(Новое.Имя);
Менеджер.Удалить(Новое);

Разбор по шагам

  1. Используем действительные параметры доступа своего источника.

  2. Создаём и записываем отдельную регистрацию.

  3. Удаляем только удержанный новый объект регистрации.

Как проверить результат

  1. Прочитано собственное новое имя УчебноеДополнительное.

  2. Удаление относится к новому объекту, не к источнику.

Ожидаемый результат

Контрольный результат описывает будущую ручную проверку в подготовленном учебном окружении. Выполнение в 1С здесь не проверялось.

На что обратить внимание

  1. Добавить и Удалить требуют монопольного режима. Это будущие изменения своего стенда, не атомарный опыт: ошибка может оставить регистрацию; никаких обещаний удаления файлов S3 или отката.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.