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

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

Yandex Cloud

Улучшена

Обновлена 2 октября 2025 г.

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

Примечание

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

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

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

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

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

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

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

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

Для работы с квотами доступны интерфейсы: консоль управления, API и CLI.

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

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

Чтобы начать работать в Yandex Cloud:

Войдите в консоль управления. Если вы еще не зарегистрированы, перейдите в консоль управления и следуйте инструкциям.
В сервисе Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его.
Если у вас еще нет каталога, создайте его.
В зависимости от интерфейса, который вы будете использовать, выполните дополнительные действия:
Консоль управления

CLI

REST API

gRPC API
Убедитесь, что у пользователя есть следующие роли:
- для получения информации о квотах: quota-manager.viewer или выше;
- для создания запросов на изменение квот:
  - на уровне организации — quota-manager.requestOperator или выше и organization-manager.viewer или выше;
  - на уровне облака — resource-manager.viewer или выше.
1. Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
  
  По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.
2. Убедитесь, что у пользователя или сервисного аккаунта, аутентифицированного в профиле CLI, есть следующие роли:
  - для получения информации о квотах: quota-manager.viewer или выше;
  - для создания запросов на изменение квот:
    
    на уровне организации — quota-manager.requestOperator или выше и organization-manager.viewer или выше;
    
    на уровне облака — resource-manager.viewer или выше.
1. Установите утилиту cURL.
2. Создайте сервисный аккаунт и назначьте ему роли:
  - для получения информации о квотах: quota-manager.viewer или выше;
  - для создания запросов на изменение квот:
    
    на уровне организации — quota-manager.requestOperator или выше и organization-manager.viewer или выше;
    
    на уровне облака — resource-manager.viewer или выше.
3. Получите IAM-токен для созданного сервисного аккаунта.
1. Установите утилиту gRPCurl.
2. Создайте сервисный аккаунт и назначьте ему роли:
  - для получения информации о квотах: quota-manager.viewer или выше;
  - для создания запросов на изменение квот:
    
    на уровне организации — quota-manager.requestOperator или выше и organization-manager.viewer или выше;
    
    на уровне облака — resource-manager.viewer или выше.
3. Получите IAM-токен для созданного сервисного аккаунта.

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

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

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

CLI

REST API

gRPC API

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

На странице отобразится список сервисов, которые используются в вашем облаке.
Раскройте раздел сервиса и посмотрите значения в столбце Использование:
- Два числа — потребление квоты / значение квоты. Например, 2 / 20 или 1.203 / 5120 ГБ.
- Одно число — лимит, изменить его нельзя.
Чтобы оценить потребление ресурсов, вверху справа в списке выберите:
- Активно используются — ресурсы, которые потребляют более половины установленной квоты.
- Почти израсходованы — ресурсы, которые почти израсходованы.

Посмотрите список сервисов с квотами.
```
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
}
```

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

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

CLI

REST API

gRPC API

Запросите изменение квоты одним из способов:

На странице квот выберите ресурсы и нажмите Повысить.
Обратитесь в техническую поддержку и опишите, какие потребляемые квоты нужно увеличить и на сколько.

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

Посмотрите идентификатор квоты и создайте запрос на ее изменение:
```
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"
}

Статус операции false означает, что запрос находится на рассмотрении.

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

Воспользуйтесь методом 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

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

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

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

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

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

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

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