Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Cloud Quota Manager
  • Начало работы
  • Концепции
    • Все инструкции
    • Посмотреть список сервисов и квот
    • Посмотреть значение квоты
    • Изменить квоты
  • Управление доступом
  • Правила тарификации
    • Аутентификация в API
  • История изменений

В этой статье:

  • Получить информацию о квотах
  • Запросить увеличение квот

Как начать работать с Yandex Cloud Quota Manager

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 21 апреля 2025 г.
  • Получить информацию о квотах
  • Запросить увеличение квот

Примечание

Сервис находится на стадии Preview.

При проектировании инфраструктуры в облаке важно учитывать квоты и лимиты. Сервис Cloud Quota Manager позволяет управлять квотами ваших сервисов Yandex Cloud с помощью различных интерфейсов. Некоторые сервисы, например SpeechKit, в Cloud Quota Manager недоступны.

Квоты — ограничения на количество ресурсов, которые можно использовать в вашем облаке. Это организационные ограничения, которые можно изменять по мере необходимости. Квоты помогают избежать перерасхода и избыточного использования ресурсов, позволяя грамотно планировать бюджет и контролировать потребление.

В описании работы с квотами используются два термина:

  • Значение квоты (quota limit) — текущее ограничение на ресурс для облака или организации.

  • Потребление квоты (quota usage) — объем или величина фактически используемого ресурса.

Потенциально квоты можно увеличить до лимитов.

Лимиты — технические ограничения, обусловленные особенностями архитектуры Yandex Cloud, физическими характеристиками оборудования или внешними ограничениями.

Взаимосвязь квот и лимитов показана на схеме ниже.

В настоящий момент для работы с квотами доступны интерфейсы:

  • Консоль — получение информации и запрос на изменение квот.
  • CLI — получение информации о квотах.
  • API — получение информации о квотах.

Позднее появится возможность создавать запрос на изменение квот через CLI и API.

Получить информацию о квотахПолучить информацию о квотах

Консоль управления
CLI
API
  1. В консоли управления выберите облако, в котором хотите посмотреть квоты.

  2. Выберите вкладку Квоты.

    На странице отобразится список сервисов, которые используются в вашем облаке.

  3. Раскройте раздел сервиса и посмотрите значения в столбце Использование:

    • Два числа — потребление квоты / значение квоты. Например, 2 / 20 или 1.203 / 5120 ГБ.

    • Одно число — лимит, изменить его нельзя.

  4. Чтобы оценить потребление ресурсов, вверху справа в списке выберите:

    • Активно используются — ресурсы, которые потребляют более половины установленной квоты.
    • Почти израсходованы — ресурсы, которые почти израсходованы.

Настройте работу с CLI

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Для просмотра квот аккаунт должен иметь роль quota-manager.viewer.

Посмотрите квоты

  1. Посмотрите список сервисов, для которых есть квоты.

    yc quota-manager quota-limit list-services --resource-type=<тип_ресурса>
    

    Где --resource-type — тип ресурса:

    • resource-manager.cloud — облако;
    • organization-manager.organization — организация;
    • billing.account — платежный аккаунт.

    Пример:

    yc quota-manager quota-limit list-services --resource-type=resource-manager.cloud
    

    Будет выведен список сервисов, которые находятся на уровне облака и для которых есть квоты.

  2. Посмотрите список квот для определенного сервиса, а также значение и потребление всех квот.

    yc quota-manager quota-limit list \
       --service=<название_сервиса> \
       --resource-type=<тип_ресурса> \
       --resource-id=<идентификатор_ресурса>
    

    Где:

    • --service — название сервиса, полученное на предыдущем шаге. Также название сервиса можно посмотреть в справочнике YC CLI.
    • --resource-id — идентификатор ресурса: идентификатор облака, организации или платежного аккаунта.
    • --resource-type — тип ресурса: resource-manager.cloud, organization-manager.organization, billing.account.

    Пример:

    yc quota-manager quota-limit list --service=iam --resource-type=resource-manager.cloud --resource-id=b1gflhy********
    

    Будут выведены идентификаторы квот, которые есть в сервисе IAM в облаке b1gflhy********. А также значение и потребление этих квот.

  3. Посмотрите значение и потребление определенной квоты.

    yc quota-manager quota-limit get \
       --quota-id=<идентификатор_квоты> \
       --resource-id <идентификатор_ресурса> \
       --resource-type <тип_ресурса>
    

    Где:

    • --quota-id — идентификатор квоты, полученный на предыдущем шаге.
    • --resource-id — идентификатор ресурса (облака, организации или платежного аккаунта).
    • --resource-type — тип ресурса: resource-manager.cloud, organization-manager.organization, billing.account.

    Пример:

    yc quota-manager quota-limit get --quota-id=iam.apiKeys.count --resource-id=b1gflhy********  --resource-type=resource-manager.cloud
    

    Будут выведены значение и потребление квоты для количества API-ключей в облаке b1gflhy********:

    quota_id: iam.apiKeys.count
    limit: 1000
    usage: 27
    

    Где:

    • limit — значение квоты;
    • usage — потребление квоты.

Настройте работу с API

  1. Чтобы проверить работу с квотами через API, установите утилиты:

    • cURL при использовании REST API.
    • gRPCurl при использовании gRPC API.
  2. Создайте сервисный аккаунт с ролью quota-manager.viewer.

  3. Получите IAM-токен для созданного сервисного аккаунта.

Посмотрите квоты

  1. Посмотрите список сервисов, для которых есть квоты.

    Для этого воспользуйтесь методом REST API listServices для ресурса QuotaLimit или вызовом gRPC API QuotaLimitService/ListServices.

    Чтобы проверить работу метода REST API, выполните запрос:

    curl -X GET \
    --header "Authorization: Bearer <IAM-токен>" \
    "https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits/services?resourceType=<resourceType>"
    

    Где:

    • <resourceType> — тип ресурса: resource-manager.cloud, organization-manager.organization, billing.account.
    • <IAM-токен> — IAM-токен для сервисного аккаунта или переменная окружения, в которой находится IAM-токен.

    Пример запроса:

    curl -X GET \
    --header "Authorization: Bearer $IAM_TOKEN" \
    'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits/services?resourceType=resource-manager.cloud'
    
    
  2. Посмотрите список квот для определенного сервиса, а также значение и потребление всех квот.

    Для этого воспользуйтесь методом REST API list для ресурса QuotaLimit или вызовом gRPC API QuotaLimitService/List.

    Чтобы проверить работу метода REST API, выполните запрос:

    curl -X GET \
    --header "Authorization: Bearer <IAM-токен>" \
    "https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits?service=<serviceName>&resource.id=<resourceId>&resource.type=<resourceType>"
    

    Где:

    • <resourceId> — идентификатор ресурса: облака, организации или платежного аккаунта.
    • <resourceType> — тип ресурса: resource-manager.cloud, organization-manager.organization, billing.account.
    • <serviceName> — имя сервиса.
    • <IAM-токен> — IAM-токен для сервисного аккаунта или переменная окружения, в которой находится IAM-токен.

    Пример запроса:

    curl -X GET \
    --header "Authorization: Bearer $IAM_TOKEN" \
    'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits?service=iam&resource.id=b1gflhy********&resource.type=resource-manager.cloud'
    
  3. Посмотрите значение и потребление определенной квоты.

    Для этого воспользуйтесь методом REST API get для ресурса QuotaLimit или вызовом gRPC API QuotaLimitService/Get.

    Чтобы проверить работу метода REST API, выполните запрос:

    curl -X GET \
    --header "Authorization: Bearer <IAM-токен>" \
    "https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits/<quotaId>?resource.id=<resourceId>&resource.type=<resourceType>"
    

    Где:

    • <quotaId> — идентификатор квоты, полученный на предыдущем шаге.
    • <resourceId> — идентификатор ресурса (облака, организации или платежного аккаунта).
    • <resourceType> — тип ресурса: resource-manager.cloud, organization-manager.organization, billing.account.
    • <IAM-токен> — IAM-токен для сервисного аккаунта или переменная окружения, в которой находится IAM-токен.

    Пример запроса:

    curl -X GET \
    --header "Authorization: Bearer $IAM_TOKEN" \
    'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits/iam.accessKeys.count?resource.id=b1gflhy********&resource.type=resource-manager.cloud'
    

Запросить увеличение квотЗапросить увеличение квот

Сейчас запросить изменение квот можно через консоль управления. Позднее появится возможность изменить квоты через CLI и API.

Консоль управления
  1. Убедитесь, что ваша учетная запись имеет роль quota-manager.requestOperator или выше (editor или admin).
  2. Запросите изменение квоты одним из способов:
    • На странице квот выберите ресурсы и нажмите Повысить.
    • Обратитесь в техническую поддержку и опишите, какие потребляемые квоты нужно увеличить и на сколько.

Была ли статья полезна?

Следующая
Концепции
Проект Яндекса
© 2025 ООО «Яндекс.Облако»