Получить ссылку скачивания объекта
Получает прямую ссылку для скачивания объекта без дополнительной авторизации
- Параметры
- Расширенный вызов ?
Функция ПолучитьСсылкуСкачиванияОбъекта(Знач Наименование, Знач Бакет, Знач ОсновныеДанные, Знач ВремяЖизни = 3600, Знач Заголовки = Неопределено, Знач Каталог = Ложь) Экспорт
| Параметр | CLI опция | Тип | Обяз. | Назначение |
|---|---|---|---|---|
| Наименование | --name | Строка | ✔ | Наименование объекта в бакете |
| Бакет | --bucket | Строка | ✔ | Имя бакета для загрузки объекта |
| ОсновныеДанные | --basic | Структура Из КлючИЗначение | ✔ | Основные данные запроса. См. ПолучитьСтруктуруДанных |
| ВремяЖизни | --expires | Строка, Число | ✖ | Время жизни ссылки в секундах. 604800 максимум |
| Заголовки | --headers | Соответствие Из КлючИЗначение | ✖ | Дополнительные заголовки запроса, если необходимо |
| Каталог | --dir | Булево | ✖ | Истина > Path style URL, Ложь > Virtual hosted style URL |
Возвращаемое значение
Строка - URL для получения объекта
| Параметр | Описание |
|---|---|
| dontwait | Создает фоновое задание и возвращает его данные (только для 1С и OneScript) |
подсказка
В Заголовки необходимо добавить все x-amz заголовки, которые будут использоваться при обращении к полученному URL
О механизме в документации AWS: Download and upload objects with presigned URLs
Пример использования для 1С:Предприятие/OneScript
URL = "s3.openintegrations.dev";
AccessKey = "bayselo...";
SecretKey = "12we34...";
Region = "BTC";
ОсновныеДанные = OPI_S3.ПолучитьСтруктуруДанных(URL, AccessKey, SecretKey, Region);
Наименование = "picture.jpg";
Каталог = Истина; // Формирование URL в path-style
Бакет = "w567hjy1";
Результат = OPI_S3.ПолучитьСсылкуСкачиванияОбъекта(Наименование, Бакет, ОсновныеДанные, 7200, , Каталог);
- Bash
- CMD/Bat
# JSON данные также могут быть переданы как путь к файлу .json
oint s3 ПолучитьСсылкуСкачиванияОбъекта \
--name "picture.jpg" \
--bucket "9089140c" \
--basic "{'URL':'s3.openintegrations.dev','AccessKey':'***','SecretKey':'***','Region':'BTC','Service':'s3'}" \
--expires 7200 \
--dir true
:: JSON данные также могут быть переданы как путь к файлу .json
oint s3 ПолучитьСсылкуСкачиванияОбъекта ^
--name "picture.jpg" ^
--bucket "9089140c" ^
--basic "{'URL':'s3.openintegrations.dev','AccessKey':'***','SecretKey':'***','Region':'BTC','Service':'s3'}" ^
--expires 7200 ^
--dir true
Результат
"s3.openintegrations.dev/9089140c/picture.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=bayselonarrend%2F20260526%2FBTC%2Fs3%2Faws4_request&X-Amz-Date=20260526T181838Z&X-Amz-Expires=7200&X-Amz-SignedHeaders=host&X-Amz-Signature=3b874a854e867c359a82ad4c7881df6586921f41b84161d6bb740126b19bfa83"