Управление потреблением проектов

Существует несколько способов контролировать расходы на вычисления. В биллинге вы можете настроить уведомления о превышении установленного бюджета для сервиса DataSphere. Бюджет не влияет на потребление: DataSphere продолжит работу, даже если бюджет будет превышен.

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

Вы можете задать:

• Баланс проекта unit_balance — общее количество юнитов, доступных для проекта. Каждое исполнение ячейки будет уменьшать баланс проекта на то количество юнитов, которое необходимо для выполнения одной секунды вычислений выбранной конфигурации. Ячейки можно запустить до тех пор, пока баланс проекта положительный. Если во время вычислений в одной из ячеек баланс проекта станет меньше или равен нулю, все запущенные вычисления будут остановлены с предупреждением, что баланса проекта недостаточно.

• Ограничение на количество юнитов в час max_units_per_hour, которое может использовать проект. Если цена за час для выбранной конфигурации при запуске вычислений превышает max_units_per_hour, ячейка не запустится. Если в процессе вычислений в ячейке текущее потребление проекта за час превысит max_units_per_hour, все ячейки с вычислениями будут остановлены.

• Ограничение на количество юнитов max_units_per_execution, доступных для одного вычисления. Если в процессе вычислений ячейка превысит установленное ограничение max_units_per_execution, она будет остановлена.

Ограничения независимы и могут быть назначены проекту одновременно.

Чтобы посмотреть ограничения проекта, необходима роль datasphere.user. Для установки ограничений проекта понадобится роль datasphere.admin. Подробнее о ролях и управлении доступом в DataSphere читайте в разделе Управление доступом в DataSphere.

Установить баланс проекта

Для управления балансом проекта используйте методы API GetUniteBalance и SetUniteBalance.

Примеры запросов

Чтобы воспользоваться примерами, установите gRPCurl и получите данные вашего аккаунта для авторизации:

• Инструкция для аккаунта на Яндексе.
• Инструкция для сервисного аккаунта.
• Инструкция для федеративного аккаунта.

Полученный IAM-токен указывайте при обращении к ресурсам Yandex.Cloud через API. Передайте IAM-токен в заголовке Authorization в следующем формате:

Authorization: Bearer <IAM-TOKEN>

Получить баланс проекта:

grpcurl -rpc-header "Authorization: Bearer <IAM-token>" \
        -d '{"project_id": "<project_id>"}' \
        datasphere.api.cloud.yandex.net:443 \
        yandex.cloud.datasphere.v1.ProjectService/GetUnitBalance

Установить баланс проекта:

grpcurl -rpc-header "Authorization: Bearer <IAM-token>" \
        -d '{"project_id": "<project_id>", "unit_balance":60}' \
        datasphere.api.cloud.yandex.net:443 \
        yandex.cloud.datasphere.v1.ProjectService/SetUnitBalance

Установить ограничения на количество юнитов

Для настройки ограничений проекта используйте поле Limits методов API группы ProjectService.

Примеры запросов

Установить ограничение на размер вычислений в час:

grpcurl -rpc-header "Authorization: Bearer <IAM-token>" \
        -d '{"project_id": "<project_id>", "limits": {"max_units_per_hour": "210"}}' \
        datasphere.api.cloud.yandex.net:443 \
        yandex.cloud.datasphere.v1.ProjectService/Update 

Удалить установленные ограничения:

grpcurl -rpc-header Authorization: Bearer <IAM-token>" \
        -d '{"project_id": "<project_id>", "limits": {}}' \
        datasphere.api.cloud.yandex.net:443 \
        yandex.cloud.datasphere.v1.ProjectService/Update