Python SDK: StoredFile: свойства сохранённого файла
storage.put() и storage.put_from_url() возвращают объект SDK StoredFile. Читайте открытые свойства через точку, а не как ключи словаря. Это результат уже выполненного вызова, новый запрос не нужен.
| Свойство | Тип | Значение |
|---|---|---|
key |
str |
Итоговый ключ объекта, который выбрало хранилище. Может отличаться от предложенного. |
url |
str | None |
Доступный URL объекта; приватный объект не становится публичным автоматически. |
size |
int |
Размер содержимого в байтах. |
mime |
str | None |
Тип содержимого по результату операции. |
etag |
str | None |
Идентификатор/контрольная сумма хранилища; формат зависит от провайдера. |
dry_run |
bool |
Пробная операция была имитирована без записи внешнему получателю. |
stored = ctx.storage('media').put('reports/summary.txt', 'Ready', 'text/plain')
ctx.log('Результат хранилища', {'key': stored.key, 'size': stored.size, 'dry_run': stored.dry_run})
Не передавайте StoredFile целиком в emit. Выберите поля своей схемы. Новую временную ссылку на приватный файл получите через ctx.storage('media').url(stored.key, 3600). Не записывайте в журнал подписанную ссылку, если она открывает приватный файл.
Ошибки и контекст выполнения
Все вызовы синхронны. Неверный аргумент или формат данных может вызвать ValueError/TypeError; отказ платформы или недоступность сервиса вызывает RuntimeError. Отсутствие элемента/значения даёт None либо пустой список только там, где это явно описано. Не превращайте любое исключение в пустой успешный результат. Методы внешних сервисов недоступны в преобразовании выгрузки; см. ограничения преобразований и среду.