Cluster · разработчикам
Asset
Временный ресурс изображения в выбранном генераторе. Это не файл Cluster.
Все методы SDK · Типы и ошибки
Получение объекта
asset = await app.images("image-generator-id").upload(image_bytes)asset получен через await drawing.upload(image_bytes).
__init__
Создаёт Asset. Обычный способ получения объекта показан выше; прямой конструктор не выполняет сетевые запросы.
def __init__(service: Drawing, id: str) -> None: ...Аргументы
service: Drawing, обязательный. Клиент генератора, которому принадлежит временный ресурс.id: str, обязательный. Идентификатор объекта, полученный при его создании. Не путь сервера.
Результат
None. Создаёт Asset. Обычный способ получения объекта показан выше; прямой конструктор не выполняет сетевые запросы.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.
Пример
# Обычный способ получения объекта:
asset = await app.images("image-generator-id").upload(image_bytes)delete
Освобождает временный ресурс один раз. release() выполняет очистку по возможности; отсутствие исключения не подтверждает удаление после сбоя связи. Освобождается идентификатор Asset; ограниченная копия исходных байтов может оставаться в кэше генератора до пяти минут.
async def delete() -> None: ...Аргументы
Нет.
Результат
None. Идентификатор освобождён по возможности; повторный upload получает новый идентификатор.
Права
Нужны modules.call.
Ошибки
- Ошибки ядра: AccessDenied при нехватке прав или выходе за ограничения, InvalidInput для неверных параметров, InvalidState для недоступного состояния, QuotaExceeded при превышении лимита, Unavailable при недоступной службе. Остальные коды представлены SDKError; см. TYPES.md. Ошибка канала связи вызывает RuntimeError. Действие с неизвестным результатом нельзя автоматически считать невыполненным.
Пример
result = await asset.delete()__aenter__
Вход в async with. Возвращает этот объект без дополнительной загрузки.
async def __aenter__() -> Self: ...Аргументы
Нет.
Результат
Self. Тот же объект после успешной операции. Вход в async with. Возвращает этот объект без дополнительной загрузки.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.
Пример
async with asset as active:
pass__aexit__
Выход из async with. Освобождает временный ресурс генератора. Исключения блока не подавляются.
async def __aexit__(*args: object) -> None: ...Аргументы
args: object, позиционные значения. Стандартные аргументы выхода: тип исключения, исключение и traceback. Передаются Python автоматически.
Результат
None. Выход из async with. Освобождает временный ресурс генератора. Исключения блока не подавляются.
Права
Нужны modules.call.
Ошибки
- Ошибки ядра: AccessDenied при нехватке прав или выходе за ограничения, InvalidInput для неверных параметров, InvalidState для недоступного состояния, QuotaExceeded при превышении лимита, Unavailable при недоступной службе. Остальные коды представлены SDKError; см. TYPES.md. Ошибка канала связи вызывает RuntimeError. Действие с неизвестным результатом нельзя автоматически считать невыполненным.
Пример
async with asset as active:
pass