Примеры запросов для работы с квотами

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

Yandex Cloud

Улучшена

mmerihsesh

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

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

Примечание

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

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

Чтобы гарантировать наличие критически важных для вашего сервиса ресурсов, проверяйте потребление квот и запрашивайте их увеличение в автоматическом режиме. Для этого можно использовать CLI или API Yandex Cloud Quota Manager.

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

Чтобы воспользоваться примерами:

CLI

REST API

gRPC API

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

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

Установите утилиту cURL.
Создайте сервисный аккаунт и назначьте ему роли:
- для получения информации о квотах: quota-manager.viewer или выше;
- для создания запросов на изменение квот:
  - на уровне организации — quota-manager.requestOperator или выше и organization-manager.viewer или выше;
  - на уровне облака — resource-manager.viewer или выше.
Получите IAM-токен для созданного сервисного аккаунта.

Установите утилиту gRPCurl.
Создайте сервисный аккаунт и назначьте ему роли:
- для получения информации о квотах: quota-manager.viewer или выше;
- для создания запросов на изменение квот:
  - на уровне организации — quota-manager.requestOperator или выше и organization-manager.viewer или выше;
  - на уровне облака — resource-manager.viewer или выше.
Получите IAM-токен для созданного сервисного аккаунта.

Ниже приведены примеры запросов и ответов CLI и API для работы с квотами. В примерах используются следующие параметры:

CLI

API

--quota-id — идентификатор квоты. В примерах используется идентификатор iam.accessKeys.count — количество статических ключей доступа в одном облаке, квота в сервисе Identity and Access Management.
--resource-id — идентификатор ресурса. В примерах используется идентификатор облака. Для выполнения запросов из примеров укажите идентификатор вашего облака.
--resource-type — тип ресурса. В примере используется resource-manager.cloud — облако.
--filter — фильтрующее выражение. Отфильтровать запросы можно только по их статусу.
<идентификатор_запроса> — идентификатор вашего запроса на изменение квоты.

<IAM-токен> или ${IAM_TOKEN?} — IAM-токен для сервисного аккаунта или переменная окружения, в которой находится IAM-токен.
uuidgen -t — команда для генерации уникального идентификатора запроса (UUID), который передается в заголовке X-Request-Id. Передавать UUID необязательно, но он помогает отслеживать конкретный запрос в системе.
quotaId — идентификатор квоты. В примерах используется идентификатор iam.accessKeys.count — количество статических ключей доступа в одном облаке, квота в сервисе Identity and Access Management.
resourceId — идентификатор ресурса. В примерах используется идентификатор облака. Для выполнения запросов из примеров укажите идентификатор вашего облака.
resourceType — тип ресурса. В примере используется resource-manager.cloud — облако.
<идентификатор_запроса> — идентификатор вашего запроса на изменение квоты.

Посмотреть идентификатор квоты

Узнать идентификатор определенной квоты можно в разделе Квоты для сервисов Yandex Cloud.

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

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

CLI

REST API

gRPC API

Выполните команду:

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 Get для ресурса QuotaLimit.

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

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/Get.

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

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-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
  ...

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

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

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
    },
    ...
  ]
}

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

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

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
    },
    ...
  ]
}

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

Чтобы запросить изменение квоты, создайте запрос и укажите идентификаторы квот ресурсов и новое значение.

CLI

REST API

gRPC API

Выполните команду:

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********

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

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

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 означает, что запрос находится на рассмотрении.

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

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

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********"
  }
}

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

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

CLI

REST API

gRPC API

Выполните команду:

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********

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

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

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********"
    },
    ...
  ]
}

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

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

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********"
    },
    ...
  ]
}

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

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

CLI

REST API

gRPC API

Выполните команду:

yc quota-manager quota-request get \
  --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 Get для ресурса QuotaRequest. В запросе передайте идентификатор запроса на изменение квоты, информацию о котором вы хотите посмотреть.

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

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********"
}

Пример ответа (запрос отменен)

{
  "resource": {
    "id": "b1gia87mbaom********",
    "type": "resource-manager.cloud"
  },
  "quotaLimits": [
    {
      "quotaId": "iam.accessKeys.count",
      "desiredLimit": 1001,
      "status": "CANCELED",
      "modifiedBy": "ajeol2afu1js********"
    }
  ],
  "id": "atd67f3m9k92********",
  "createdAt": "2025-09-01T11:48:31.847524Z",
  "status": "CANCELED",
  "createdBy": "ajeol2afu1js********"
}

Воспользуйтесь вызовом gRPC API QuotaRequestService/Get. В запросе передайте идентификатор запроса на изменение квоты, информацию о котором вы хотите посмотреть.

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

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********"
}

Пример ответа (запрос отменен)

{
  "id": "atd67f3m9k92********",
  "resource": {
    "id": "b1gia87mbaom********",
    "type": "resource-manager.cloud"
  },
  "createdAt": "2025-09-01T11:48:31.847524Z",
  "status": "CANCELED",
  "quotaLimits": [
    {
      "quotaId": "iam.accessKeys.count",
      "desiredLimit": 1001,
      "status": "CANCELED",
      "modifiedBy": "ajeol2afu1js********"
    }
  ],
  "createdBy": "ajeol2afu1js********"
}

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

CLI

REST API

gRPC API

Выполните команду:

yc quota-manager quota-request list \
  --resource-type resource-manager.cloud \
  --resource-id <идентификатор_облака> \
  --filter "status in ('CANCELED','PENDING')"

В примере фильтр выбирает запросы, которые были отменены (CANCELED) или находятся в ожидании (PENDING).

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

quota_requests:
  - id: atdusk8qi57o********
    resource:
      id: b1gia87mbaom********
      type: resource-manager.cloud
    created_at: "2025-09-15T15:13:46.928383Z"
    status: PENDING
    quota_limits:
      - quota_id: iam.accessKeys.count
        desired_limit: 1015
        status: PROCESSING
    created_by: ajeol2afu1js********
  - id: atdb761kojdb********
    resource:
      id: b1gia87mbaom********
      type: resource-manager.cloud
    created_at: "2025-09-01T19:40:03.838651Z"
    status: CANCELED
    quota_limits:
      - quota_id: iam.accessKeys.count
        desired_limit: 1040
        status: CANCELED
        modified_by: ajegtlf2q28a********
    created_by: ajegtlf2q28a********
  - id: atd2od8goloa********
    resource:
      id: b1gia87mbaom********
      type: resource-manager.cloud
    created_at: "2025-09-01T19:26:47.312728Z"
    status: CANCELED
    quota_limits:
      - quota_id: iam.accessKeys.count
        desired_limit: 1030
        status: CANCELED
        modified_by: ajegtlf2q28a********
    created_by: ajegtlf2q28a********
  ...

Воспользуйтесь методом REST API List для ресурса QuotaRequest с параметром filter. Отфильтровать запросы можно только по их статусу.

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

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=1&resource.id=<идентификатор_облака>&resource.type=resource-manager.cloud&filter=status%20in%20(%27CANCELED%27%2C%20%27PENDING%27)&page_size=100'

Фильтр выбирает запросы, которые были отменены (CANCELED) или находятся в ожидании (PENDING).

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

{
  "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********"
    },
    {
      "resource": {
        "id": "b1gia87mbaom********",
        "type": "resource-manager.cloud"
      },
      "quotaLimits": [
        {
          "quotaId": "iam.accessKeys.count",
          "desiredLimit": 10000,
          "status": "CANCELED",
          "modifiedBy": "ajegtlf2q28a********"
        }
      ],
      "id": "atdg5kdelhfr********",
      "createdAt": "2025-08-25T15:30:03.773669Z",
      "status": "CANCELED",
      "createdBy": "ajegtlf2q28a********"
    },
    ...
  ]
}

Воспользуйтесь вызовом gRPC API QuotaRequestService/List с параметром filter. Отфильтровать запросы можно только по их статусу.

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

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

Фильтр выбирает запросы, которые были отменены (CANCELED) или находятся в ожидании (PENDING).

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

{
  "quotaRequests": [
    {
      "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********"
    },
    {
      "id": "atd9im7tcr89********",
      "resource": {
        "id": "b1gia87mbaom********",
        "type": "resource-manager.cloud"
      },
      "createdAt": "2025-09-01T17:24:01.580902Z",
      "status": "CANCELED",
      "quotaLimits": [
        {
          "quotaId": "iam.accessKeys.count",
          "desiredLimit": 10000,
          "status": "CANCELED",
          "modifiedBy": "ajegtlf2q28a********"
        }
      ],
      "createdBy": "ajegtlf2q28a********"
    },
    ...
  ]
}

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

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

CLI

REST API

gRPC API

Выполните команду:

yc quota-manager quota-request cancel \
  --id <идентификатор_запроса> \
  --quota-id iam.accessKeys.count

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

id: atdusk8qi57o********
resource:
  id: b1gia87mbaom********
  type: resource-manager.cloud
created_at: "2025-09-15T15:13:46.928383Z"
status: CANCELED
quota_limits:
  - quota_id: iam.accessKeys.count
    desired_limit: 1015
    status: CANCELED
    modified_by: ajeol2afu1js********
created_by: ajeol2afu1js********

Воспользуйтесь методом REST API Cancel для ресурса QuotaRequest. В запросе передайте идентификатор запроса на изменение квоты, который вы хотите отменить.

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

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

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

{
  "done": false,
  "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.quotamanager.v1.CancelQuotaRequestMetadata",
    "quotaRequestId": "atdandtanku3********"
  },
  "id": "atdu5jt4dtve********",
  "description": "Cancel quota request",
  "createdAt": "2025-09-01T12:28:43.805955898Z",
  "createdBy": "ajeol2afu1js********",
  "modifiedAt": "2025-09-01T12:28:43.805955898Z"
}

Воспользуйтесь вызовом gRPC API QuotaRequestService/Cancel. В запросе передайте идентификатор запроса на изменение квоты, который вы хотите отменить.

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

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

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

{
  "id": "atd6ervtiljj********",
  "description": "Cancel quota request",
  "createdAt": "2025-09-01T11:50:32.151491373Z",
  "createdBy": "ajeol2afu1js********",
  "modifiedAt": "2025-09-01T11:50:32.151491373Z",
  "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.quotamanager.v1.CancelQuotaRequestMetadata",
    "quotaRequestId": "atd67f3m9k92********"
  }
}

Посмотреть список операций с запросом на изменение квоты

Чтобы посмотреть список операций с запросом на изменение квоты:

CLI

REST API

gRPC API

Выполните команду:

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

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

+----------------------+---------------------+----------------------+---------------------+--------+----------------------+
|          ID          |     CREATED AT      |      CREATED BY      |     MODIFIED AT     | STATUS |     DESCRIPTION      |
+----------------------+---------------------+----------------------+---------------------+--------+----------------------+
| atds4r7oishc******** | 2025-09-15 15:23:07 | ajeol2afu1js******** | 2025-09-15 15:23:14 | DONE   | Cancel quota request |
| atdg006longe******** | 2025-09-15 15:13:46 | ajeol2afu1js******** | 2025-09-15 15:14:01 | DONE   | Create quota request |
+----------------------+---------------------+----------------------+---------------------+--------+----------------------+

Воспользуйтесь методом REST API ListOperations для ресурса QuotaRequest. В запросе передайте идентификатор запроса на изменение квоты, список операций с которым вы хотите посмотреть.

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

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/<идентификатор_запроса>/operations'

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

{
  "operations": [
    {
      "done": true,
      "metadata": {
        "@type": "type.googleapis.com/yandex.cloud.quotamanager.v1.CancelQuotaRequestMetadata",
        "quotaRequestId": "atd67f3m9k92********"
      },
      "response": {
        "@type": "type.googleapis.com/google.protobuf.Empty"
      },
      "id": "atd6ervtiljj********",
      "description": "Cancel quota request",
      "createdAt": "2025-09-01T11:50:32.151Z",
      "createdBy": "ajeol2afu1js********",
      "modifiedAt": "2025-09-01T11:50:41.792964295Z"
    },
    {
      "done": true,
      "metadata": {
        "@type": "type.googleapis.com/yandex.cloud.quotamanager.v1.CreateQuotaRequestMetadata",
        "quotaRequestId": "atd67f3m9k92********"
      },
      "response": {
        "@type": "type.googleapis.com/google.protobuf.Empty"
      },
      "id": "atdb3g33v9a9********",
      "description": "Create quota request",
      "createdAt": "2025-09-01T11:48:31.880Z",
      "createdBy": "ajeol2afu1js********",
      "modifiedAt": "2025-09-01T11:48:47.971065163Z"
    }
  ]
}

Воспользуйтесь вызовом gRPC API QuotaRequestService/ListOperations. В запросе передайте идентификатор запроса на изменение квоты, список операций с которым вы хотите посмотреть.

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

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/ListOperations

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

{
  "operations": [
    {
      "id": "atd6ervtiljj********",
      "description": "Cancel quota request",
      "createdAt": "2025-09-01T11:50:32.151Z",
      "createdBy": "ajeol2afu1js********",
      "modifiedAt": "2025-09-01T11:50:41.792964295Z",
      "done": true,
      "metadata": {
        "@type": "type.googleapis.com/yandex.cloud.quotamanager.v1.CancelQuotaRequestMetadata",
        "quotaRequestId": "atd67f3m9k92********"
      },
      "response": {
        "@type": "type.googleapis.com/google.protobuf.Empty",
        "value": {}
      }
    },
    {
      "id": "atdb3g33v9a9********",
      "description": "Create quota request",
      "createdAt": "2025-09-01T11:48:31.880Z",
      "createdBy": "ajeol2afu1js********",
      "modifiedAt": "2025-09-01T11:48:47.971065163Z",
      "done": true,
      "metadata": {
        "@type": "type.googleapis.com/yandex.cloud.quotamanager.v1.CreateQuotaRequestMetadata",
        "quotaRequestId": "atd67f3m9k92********"
      },
      "response": {
        "@type": "type.googleapis.com/google.protobuf.Empty",
        "value": {}
      }
    }
  ]
}

Примеры запросов для работы с квотами

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

Посмотреть идентификатор квотыПосмотреть идентификатор квоты

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

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

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

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

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

Посмотреть список запросов с фильтром по статусуПосмотреть список запросов с фильтром по статусу

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

Посмотреть список операций с запросом на изменение квотыПосмотреть список операций с запросом на изменение квоты

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

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

Посмотреть идентификатор квоты

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

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

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

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

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

Посмотреть список запросов с фильтром по статусу

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

Посмотреть список операций с запросом на изменение квоты