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

Статья создана

Yandex Cloud

Улучшена

Обновлена 15 октября 2026 г.

Открыть в Markdown

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

Примечание

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

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

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

У квот есть два показателя:

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

Квоты можно увеличить по запросу в пределах лимитов.

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

В большинстве сервисов квоты действуют на уровне облака. В Resource Manager, Cloud Video и некоторых других сервисах квоты действуют на уровне организации. В IAM есть квоты обоих уровней.

Интерфейсы управления квотами:

Cloud Center — уровень организации;
консоль управления — уровень облака;
CLI и API — уровень организации и облака.

Для управления квотами ресурсов через CLI и API используйте их идентификаторы из раздела Квоты для сервисов Yandex Cloud.

Перед началом работы

Предполагается, что у вас уже есть ресурсы Yandex Cloud в облаке или организации.

Убедитесь, что у пользователя или сервисного аккаунта есть роли:

quota-manager.viewer — для просмотра квот.
quota-manager.requestOperator — для просмотра квот и создания запросов на их изменение.

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

Консоль управления

Интерфейс Cloud Center

CLI

REST API

gRPC API

Войдите в консоль управления и выберите облако.

Войдите в Cloud Center и выберите организацию.

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

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

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

Установите утилиту cURL.
Создайте сервисный аккаунт и назначьте ему одну из ролей, указанных выше.
Получите IAM-токен для созданного сервисного аккаунта.

Установите утилиту gRPCurl.
Создайте сервисный аккаунт и назначьте ему одну из ролей, указанных выше.
Получите IAM-токен для созданного сервисного аккаунта.

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

Консоль управления

Интерфейс Cloud Center

CLI

REST API

gRPC API

Чтобы получить информацию о квотах в облаке:

В консоли управления выберите облако и на панели слева откройте Квоты.
На вкладке Список квот:
- Введите в строку поиска название сервиса, название или идентификатор квоты.
- В группе Сервисы с потреблением или Сервисы без потребления раскройте раздел нужного сервиса.
В строке квоты посмотрите значение в столбце Использование:
- Два числа — потребление квоты / значение квоты. Например, 2 / 20.
- Одно число — лимит, изменить его нельзя.
Чтобы показать только сервисы, в которых квоты близки к исчерпанию, вверху нажмите Почти закончились.

Чтобы получить информацию о квотах в организации:

В Cloud Center выберите организацию и на панели слева откройте Квоты.
На вкладке Список квот:
- Введите в строку поиска название сервиса, название или идентификатор квоты.
- В группе Сервисы с потреблением или Сервисы без потребления раскройте раздел нужного сервиса.
Посмотрите значение в столбце Использование:
- Два числа — потребление квоты / значение квоты. Например, 2 / 20.
- Одно число — лимит, изменить его нельзя.
Чтобы показать только сервисы, в которых квоты близки к исчерпанию, вверху нажмите Почти закончились.

Посмотрите список сервисов с квотами.
```
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
```
Будет выведен список сервисов с квотами на уровне облака.
Посмотрите значения и потребление всех квот для сервиса.
```
yc quota-manager quota-limit list \
  --service <имя_сервиса> \
  --resource-type <тип_ресурса> \
  --resource-id <идентификатор_ресурса>
```
Где:
- --service — идентификатор сервиса, полученный на предыдущем шаге.
- --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 <идентификатор_облака>
```
Будут выведены идентификаторы квот, которые есть в сервисе IAM в облаке, а также значения и потребление этих квот:
```
resource:
  id: b1gia87mbaom********
  type: resource-manager.cloud
quota_limits:
  - quota_id: iam.accessKeys.count
    limit: 1001
    usage: 33
  - quota_id: iam.apiKeys.count
    limit: 1000
    usage: 14
  - quota_id: iam.authorizedKeys.count
    limit: 1000
    usage: 44
  ...
```
Посмотрите значение и потребление определенной квоты.
```
yc quota-manager quota-limit get \
  --quota-id <идентификатор_квоты> \
  --resource-id <идентификатор_ресурса> \
  --resource-type <тип_ресурса>
```
Где:
- --quota-id — идентификатор квоты. Узнать идентификатор можно в разделе Квоты для сервисов Yandex Cloud.
- --resource-id — идентификатор ресурса (облака, организации или платежного аккаунта).
- --resource-type — тип ресурса: resource-manager.cloud, organization-manager.organization, billing.account.
Пример команды:
```
yc quota-manager quota-limit get \
  --quota-id iam.accessKeys.count \
  --resource-id <идентификатор_облака> \
  --resource-type resource-manager.cloud
```
Будут выведены значение и потребление квоты для количества статических ключей доступа в облаке:
```
quota_id: iam.accessKeys.count
limit: 1000
usage: 27
```
Где:
- limit — значение квоты;
- usage — потребление квоты.

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

Воспользуйтесь методом REST API listServices для ресурса QuotaLimit:

curl \
  --request GET \
  --header "Authorization: Bearer <IAM-токен>" \
  "https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits/services?resourceType=<тип_ресурса>"

Где:

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

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

curl \
  --request GET \
  --header "Authorization: Bearer ${IAM_TOKEN?}" \
  'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits/services?resourceType=resource-manager.cloud'

Пример ответа:

{
  "services": [
    {
      "id": "alb",
      "name": "Application Load Balancer"
    },
    {
      "id": "audit-trails",
      "name": "Audit Trails"
    },
    ...
    {
      "id": "ylb",
      "name": "Network Load Balancer"
    },
    {
      "id": "yq",
      "name": "Yandex Query"
    }
  ]
}

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

Воспользуйтесь методом REST API list для ресурса QuotaLimit:

curl \
  --request GET \
  --header "Authorization: Bearer <IAM-токен>" \
  "https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits?service=<идентификатор_сервиса>&resource.id=<идентификатор_ресурса>&resource.type=<тип_ресурса>"

Где:

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

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

curl \
  --request GET \
  --header "X-Request-Id: $(uuidgen -t)" \
  --header "Authorization: Bearer ${IAM_TOKEN?}" \
  'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits?service=iam&resource.id=<идентификатор_облака>&resource.type=resource-manager.cloud'

Пример ответа:

{
  "resource": {
    "id": "b1gia87mbaom********",
    "type": "resource-manager.cloud"
  },
  "quotaLimits": [
    {
      "quotaId": "iam.accessKeys.count",
      "limit": 1000,
      "usage": 34
    },
    {
      "quotaId": "iam.apiKeys.count",
      "limit": 1000,
      "usage": 13
    },
    {
      "quotaId": "iam.authorizedKeys.count",
      "limit": 1000,
      "usage": 43
    },
    ...
  ]
}

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

Воспользуйтесь методом REST API get для ресурса QuotaLimit:
```
curl \
  --request GET \
  --header "Authorization: Bearer <IAM-токен>" \
  "https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits/<идентификатор_квоты>?resource.id=<идентификатор_ресурса>&resource.type=<тип_ресурса>"
```
Где:
- <IAM-токен> — IAM-токен для сервисного аккаунта или переменная окружения, в которой находится IAM-токен.
- <идентификатор_квоты> — идентификатор квоты. Узнать идентификатор можно в разделе Квоты для сервисов Yandex Cloud.
- <идентификатор_ресурса> — идентификатор ресурса (облака, организации или платежного аккаунта).
- <тип_ресурса> — тип ресурса: resource-manager.cloud, organization-manager.organization, billing.account.
Пример запроса:
```
curl \
  --request GET \
  --header "X-Request-Id: $(uuidgen -t)" \
  --header "Authorization: Bearer ${IAM_TOKEN?}" \
  'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaLimits/iam.accessKeys.count?resource.id=<идентификатор_облака>&resource.type=resource-manager.cloud'
```
Пример ответа:
```
{
  "quotaId": "iam.accessKeys.count",
  "limit": 1000,
  "usage": 34
}
```

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

Воспользуйтесь вызовом gRPC API QuotaLimitService/ListServices:

grpcurl \
  -H "Authorization: Bearer <IAM-токен>" \
  -d "{\"resource_type\": \"<тип_ресурса>\"}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaLimitService/ListServices

Где:

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

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

grpcurl \
  -H "Authorization: Bearer ${IAM_TOKEN?}" \
  -d "{\"resource_type\": \"resource-manager.cloud\"}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaLimitService/ListServices

Пример ответа:

{
  "services": [
    {
      "id": "alb",
      "name": "Application Load Balancer"
    },
    {
      "id": "audit-trails",
      "name": "Audit Trails"
    },
    ...
    {
      "id": "ylb",
      "name": "Network Load Balancer"
    },
    {
      "id": "yq",
      "name": "Yandex Query"
    }
  ]
}

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

Воспользуйтесь вызовом gRPC API QuotaLimitService/List:

grpcurl \
  -H "Authorization: Bearer <IAM-токен>" \
  -d "{ \"resource\": { \"id\": \"<идентификатор_ресурса>\", \"type\": \"<тип_ресурса>\" }, \"service\": \"<идентификатор_сервиса>\"}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaLimitService/List

Где:

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

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

grpcurl \
  -H "X-Request-Id: $(uuidgen -t)" \
  -H "Authorization: Bearer ${IAM_TOKEN?}" \
  -d "{ \"resource\": { \"id\": \"<идентификатор_облака>\", \"type\": \"resource-manager.cloud\" }, \"service\": \"iam\"}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaLimitService/List

Пример ответа:

{
  "resource": {
    "id": "b1gia87mbaom********",
    "type": "resource-manager.cloud"
  },
  "quotaLimits": [
    {
      "quotaId": "iam.accessKeys.count",
      "limit": 1000,
      "usage": 34
    },
    {
      "quotaId": "iam.apiKeys.count",
      "limit": 1000,
      "usage": 13
    },
    {
      "quotaId": "iam.authorizedKeys.count",
      "limit": 1000,
      "usage": 43
    },
    ...
  ]
}

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

Воспользуйтесь вызовом gRPC API QuotaLimitService/Get:
```
grpcurl \
  -H "Authorization: Bearer <IAM-токен>" \
  -d "{ \"resource\": { \"id\": \"<идентификатор_ресурса>\", \"type\": \"<тип_ресурса>\" }, \"quota_id\": \"<идентификатор_квоты>\"}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaLimitService/Get
```
Где:
- <IAM-токен> — IAM-токен для сервисного аккаунта или переменная окружения, в которой находится IAM-токен.
- <идентификатор_ресурса> — идентификатор ресурса (облака, организации или платежного аккаунта).
- <тип_ресурса> — тип ресурса: resource-manager.cloud, organization-manager.organization, billing.account.
- <идентификатор_квоты> — идентификатор квоты. Узнать идентификатор можно в разделе Квоты для сервисов Yandex Cloud.
Пример запроса:
```
grpcurl \
  -H "X-Request-Id: $(uuidgen -t)" \
  -H "Authorization: Bearer ${IAM_TOKEN?}" \
  -d "{ \"resource\": { \"id\": \"<идентификатор_облака>\", \"type\": \"resource-manager.cloud\" }, \"quota_id\": \"iam.accessKeys.count\"}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaLimitService/Get
```
Пример ответа:
```
{
  "quotaId": "iam.accessKeys.count",
  "limit": 1000,
  "usage": 34
}
```

Запросить изменение квот

Консоль управления

Интерфейс Cloud Center

CLI

REST API

gRPC API

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

В консоли управления выберите облако и на панели слева откройте Квоты.
На вкладке Список квот:
- Введите в строку поиска название сервиса, название или идентификатор квоты.
- В группе Сервисы с потреблением или Сервисы без потребления раскройте раздел нужного сервиса.
Отметьте квоты, которые хотите увеличить, и нажмите Изменить.
Укажите новые значения квот и нажмите Отправить.

Чтобы запросить увеличение квот организации:

В Cloud Center выберите организацию и на панели слева откройте Квоты.
На вкладке Список квот:
- Введите в строку поиска название сервиса, название или идентификатор квоты.
- В группе Сервисы с потреблением или Сервисы без потребления раскройте раздел нужного сервиса.
Отметьте квоты, которые хотите увеличить, и нажмите Запросить изменение.
Укажите новые значения квот и нажмите Отправить.

Создайте запрос на изменение квоты.

Посмотрите идентификатор квоты и создайте запрос на ее изменение:
```
yc quota-manager quota-request create \
  --resource-type <тип_ресурса> \
  --resource-id <идентификатор_ресурса> \
  --desired-limit quota-id=<идентификатор_квоты>,value=<новое_значение_квоты>
```
Где:
- --resource-type — тип ресурса: resource-manager.cloud, organization-manager.organization, billing.account.
- --resource-id — идентификатор ресурса (облака, организации или платежного аккаунта).
- --desired-limit — данные для изменения квоты:
  - quota-id — идентификатор квоты.
  - value — новое значение, которое нужно присвоить квоте.
В одном запросе можно указать несколько квот. Для этого добавьте несколько параметров --desired-limit.

Пример команды:
```
yc quota-manager quota-request create \
  --resource-id <идентификатор_облака> \
  --resource-type resource-manager.cloud \
  --desired-limit quota-id=compute.placementGroups.count,value=5 \
  --desired-limit quota-id=storage.buckets.count,value=30
```
Будет создан запрос на увеличение квот:
- В сервисе Compute Cloud — количество групп размещения ВМ (compute.placementGroups.count), новое значение — 5.
- В сервисе Object Storage — количество бакетов (storage.buckets.count), новое значение — 30.
Пример ответа:
```
id: atdogfioseaq********
resource:
  id: b1gia87mbaom********
  type: resource-manager.cloud
created_at: "2025-09-11T08:24:24.142277Z"
status: PENDING
quota_limits:
  - quota_id: compute.placementGroups.count
    desired_limit: 5
    status: PROCESSING
  - quota_id: storage.buckets.count
    desired_limit: 30
    status: REJECTED
    message: значение квоты, которое вы запрашиваете, равно тому значению, которое уже используется
created_by: ajegtlf2q28a********
```

Посмотрите список запросов на изменение квот.

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

Где:

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

Пример команды:

yc quota-manager quota-request list \
  --resource-id <идентификатор_облака> \
  --resource-type resource-manager.cloud \
  --limit 1

Пример ответа:

quota_requests:
  - id: atdogfioseaq********
    resource:
      id: b1gia87mbaom********
      type: resource-manager.cloud
    created_at: "2025-09-11T08:24:24.142277Z"
    status: PENDING
    quota_limits:
      - quota_id: storage.buckets.count
        desired_limit: 30
        status: REJECTED
        message: значение квоты, которое вы запрашиваете, равно тому значению, которое уже используется
      - quota_id: compute.placementGroups.count
        desired_limit: 5
        status: PROCESSING
    created_by: ajegtlf2q28a********

Посмотрите статус запроса на изменение квоты.

yc quota-manager quota-request get \
  --id <идентификатор_запроса>

Где --id — идентификатор запроса на изменение квоты.

Пример ответа:

id: atdogfioseaq********
resource:
  id: b1gia87mbaom********
  type: resource-manager.cloud
created_at: "2025-09-11T08:24:24.142277Z"
status: PENDING
quota_limits:
  - quota_id: compute.placementGroups.count
    desired_limit: 5
    status: PROCESSING
  - quota_id: storage.buckets.count
    desired_limit: 30
    status: REJECTED
    message: значение квоты, которое вы запрашиваете, равно тому значению, которое уже используется
created_by: ajegtlf2q28a********

Создайте запрос на изменение квоты.

Посмотрите идентификатор квоты и воспользуйтесь методом REST API create для ресурса QuotaRequest:
```
curl \
  --request POST \
  --header "Authorization: Bearer <IAM-токен>" \
  --data '{"resource": {"id": "<идентификатор_ресурса>", "type": "<тип_ресурса>"}, "desired_quota_limits": [{"quota_id": "<идентификатор_квоты>", "desired_limit": "<новое_значение_квоты>"}]}' \
    'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaRequests'
```
Где:
- <IAM-токен> — IAM-токен для сервисного аккаунта или переменная окружения, в которой находится IAM-токен.
- <идентификатор_ресурса> — идентификатор ресурса (облака, организации или платежного аккаунта).
- <тип_ресурса> — тип ресурса: resource-manager.cloud, organization-manager.organization, billing.account.
- <идентификатор_квоты> — идентификатор квоты, которую нужно изменить.
- <новое_значение_квоты> — новое значение, которое нужно присвоить выбранной квоте.
Пример запроса:
```
curl \
  --request POST \
  --header "X-Request-Id: $(uuidgen -t)" \
  --header "Authorization: Bearer ${IAM_TOKEN?}" \
  --data '{"resource": {"id": "<идентификатор_облака>", "type": "resource-manager.cloud"}, "desired_quota_limits": [{"quota_id": "iam.accessKeys.count", "desired_limit": "1001"}]}' \
  'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaRequests'
```
Пример ответа:
```
{
  "done": false,
  "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.quotamanager.v1.CreateQuotaRequestMetadata",
    "quotaRequestId": "atdogfioseaq********"
  },
  "id": "atdlsk0hjt6r********",
  "description": "Create quota request",
  "createdAt": "2025-09-01T08:39:37.195600077Z",
  "createdBy": "ajegtlf2q28a********",
  "modifiedAt": "2025-09-01T08:39:37.195600077Z"
}
```
Значение done: false означает, что операция создания запроса еще не завершена. Чтобы узнать статус самого запроса, используйте его идентификатор из поля metadata.quotaRequestId.

Посмотрите список запросов на изменение квот.

Воспользуйтесь методом REST API list для ресурса QuotaRequest:

curl \
  --request GET \
  --header "Authorization: Bearer <IAM-токен>" \
  'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaRequests?page_size=<размер_страницы>&resource.id=<идентификатор_ресурса>&resource.type=<тип_ресурса>'

Где:

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

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

curl \
  --request GET \
  --header "X-Request-Id: $(uuidgen -t)" \
  --header "Authorization: Bearer ${IAM_TOKEN?}" \
  'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaRequests?page_size=100&resource.id=<идентификатор_облака>&resource.type=resource-manager.cloud'

Пример ответа:

{
  "quotaRequests": [
    {
      "resource": {
        "id": "b1gia87mbaom********",
        "type": "resource-manager.cloud"
      },
      "quotaLimits": [
        {
          "quotaId": "iam.accessKeys.count",
          "desiredLimit": 1001,
          "status": "PROCESSING"
        }
      ],
      "id": "atdp0kd3799e********",
      "createdAt": "2025-09-01T08:46:28.091109Z",
      "status": "PROCESSING",
      "createdBy": "ajegtlf2q28a********"
    },
    ...
  ]
}

Посмотрите статус запроса на изменение квоты.

Воспользуйтесь методом REST API get для ресурса QuotaRequest:

curl \
  --request GET \
  --header "Authorization: Bearer <IAM-токен>" \
  'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaRequests/<идентификатор_запроса>'

Где:

<IAM-токен> — IAM-токен для сервисного аккаунта или переменная окружения, в которой находится IAM-токен.
<идентификатор_запроса> — идентификатор запроса на изменение квоты, полученный на предыдущем шаге.

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

curl \
  --request GET \
  --header "X-Request-Id: $(uuidgen -t)" \
  --header "Authorization: Bearer ${IAM_TOKEN?}" \
  'https://quota-manager.api.cloud.yandex.net/quota-manager/v1/quotaRequests/<идентификатор_запроса>'

Пример ответа:

{
  "resource": {
    "id": "b1gia87mbaom********",
    "type": "resource-manager.cloud"
  },
  "quotaLimits": [
    {
      "quotaId": "iam.accessKeys.count",
      "desiredLimit": 1001,
      "status": "PROCESSING"
    }
  ],
  "id": "atdp0kd3799e********",
  "createdAt": "2025-09-01T08:46:28.091109Z",
  "status": "PENDING",
  "createdBy": "ajegtlf2q28a********"
}

Создайте запрос на изменение квоты.

Посмотрите идентификатор квоты и создайте запрос с помощью вызова gRPC API QuotaRequestService/Create:

grpcurl \
  -H "Authorization: Bearer <IAM-токен>" \
  -d "{\"resource\": {\"id\": \"<идентификатор_ресурса>\", \"type\": \"<тип_ресурса>\"}, \"desired_quota_limits\": [{\"quota_id\": \"<идентификатор_квоты>\", \"desired_limit\": \"<новое_значение_квоты>\"}]}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaRequestService/Create

Где:

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

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

grpcurl \
  -H "X-Request-Id: $(uuidgen -t)" \
  -H "Authorization: Bearer ${IAM_TOKEN?}" \
  -d "{\"resource\": {\"id\": \"<идентификатор_облака>\", \"type\": \"resource-manager.cloud\"}, \"desired_quota_limits\": [{\"quota_id\": \"iam.accessKeys.count\", \"desired_limit\": \"1001\"}]}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaRequestService/Create

Пример ответа:

{
  "id": "atdhrm4k26ar********",
  "description": "Create quota request",
  "createdAt": "2025-09-01T08:46:28.116514197Z",
  "createdBy": "ajegtlf2q28a********",
  "modifiedAt": "2025-09-01T08:46:28.116514197Z",
  "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.quotamanager.v1.CreateQuotaRequestMetadata",
    "quotaRequestId": "atdp0kd3799e********"
  }
}

Посмотрите список запросов на изменение квот.

Воспользуйтесь вызовом gRPC API QuotaRequestService/List:

grpcurl \
  -H "Authorization: Bearer <IAM-токен>" \
  -d "{\"resource\": {\"id\": \"<идентификатор_ресурса>\", \"type\": \"<тип_ресурса>\"}}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaRequestService/List

Где:

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

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

grpcurl \
  -H "X-Request-Id: $(uuidgen -t)" \
  -H "Authorization: Bearer ${IAM_TOKEN?}" \
  -d "{\"resource\": {\"id\": \"<идентификатор_облака>\", \"type\": \"resource-manager.cloud\"}}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaRequestService/List

Пример ответа:

{
  "quotaRequests": [
    {
      "id": "atdp0kd3799e********",
      "resource": {
        "id": "b1gia87mbaom********",
        "type": "resource-manager.cloud"
      },
      "createdAt": "2025-09-01T08:46:28.091109Z",
      "status": "PROCESSING",
      "quotaLimits": [
        {
          "quotaId": "iam.accessKeys.count",
          "desiredLimit": 1001,
          "status": "PROCESSING"
        }
      ],
      "createdBy": "ajegtlf2q28a********"
    },
    ...
  ]
}

Посмотрите статус запроса на изменение квоты.

Воспользуйтесь вызовом gRPC API QuotaRequestService/Get:

grpcurl \
  -H "Authorization: Bearer <IAM-токен>" \
  -d "{\"quota_request_id\": \"<идентификатор_запроса>\"}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaRequestService/Get

Где:

<IAM-токен> — IAM-токен для сервисного аккаунта или переменная окружения, в которой находится IAM-токен.
<идентификатор_запроса> — идентификатор запроса на изменение квоты, полученный на предыдущем шаге.

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

grpcurl \
  -H "X-Request-Id: $(uuidgen -t)" \
  -H "Authorization: Bearer ${IAM_TOKEN?}" \
  -d "{\"quota_request_id\": \"<идентификатор_запроса>\"}" \
  quota-manager.api.cloud.yandex.net:443 yandex.cloud.quotamanager.v1.QuotaRequestService/Get

Пример ответа:

{
  "id": "atdp0kd3799e********",
  "resource": {
    "id": "b1gia87mbaom********",
    "type": "resource-manager.cloud"
  },
  "createdAt": "2025-09-01T08:46:28.091109Z",
  "status": "PENDING",
  "quotaLimits": [
    {
      "quotaId": "iam.accessKeys.count",
      "desiredLimit": 1001,
      "status": "PROCESSING"
    }
  ],
  "createdBy": "ajegtlf2q28a********"
}

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

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

Перед началом работыПеред началом работы

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

Запросить изменение квотЗапросить изменение квот

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

Перед началом работы

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

Запросить изменение квот