Связаться с экспертомПопробовать бесплатно

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

Статья создана
Открыть в Markdown

Примечание

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

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

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

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

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

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

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

  2. Убедитесь, что у пользователя или сервисного аккаунта, аутентифицированного в профиле CLI, есть роль для нужной операции:

  1. Установите утилиту cURL.

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

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

  4. Сохраните IAM-токен в переменной окружения:

    export IAM_TOKEN=<iam_токен>

  1. Установите утилиту gRPCurl.

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

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

  4. Сохраните IAM-токен в переменной окружения:

    export IAM_TOKEN=<iam_токен>

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

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

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

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

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

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

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

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
}

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

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

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

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

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

Чтобы изменить квоты, создайте запрос: укажите идентификатор и тип ресурса, идентификаторы квот и желаемые итоговые значения. Для увеличения квоты запрашиваемое значение должно быть больше текущего.

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

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

Изменение каждой квоты рассматривается отдельно. В примере изменение storage.buckets.count отклонено, поскольку запрошенное значение уже установлено.

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

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

curl \
  --request POST \
  --header "X-Request-Id: $(uuidgen -t)" \
  --header "Authorization: Bearer ${IAM_TOKEN?}" \
  --header "Content-Type: application/json" \
  --data '{"resource": {"id": "<идентификатор_облака>", "type": "resource-manager.cloud"}, "desiredQuotaLimits": [{"quotaId": "iam.accessKeys.count", "desiredLimit": "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.

Воспользуйтесь вызовом 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********"
  }
}

Чтобы узнать статус запроса на изменение квот, используйте его идентификатор из поля metadata.quotaRequestId. Поле id содержит идентификатор операции создания запроса.

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

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

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

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?pageSize=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********"
    }
  ]
}

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

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

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

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

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

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

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

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

Фильтр выбирает запросы, которые были отменены (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********"
    }
  ]
}

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

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

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

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. Передайте идентификатор запроса, а в поле quotaIds — идентификаторы квот, изменение которых хотите отменить.

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

curl \
  --request POST \
  --header "X-Request-Id: $(uuidgen -t)" \
  --header "Authorization: Bearer ${IAM_TOKEN?}" \
  --header "Content-Type: application/json" \
  --data '{"quotaIds": ["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. Передайте идентификатор запроса, а в поле quota_ids — идентификаторы квот, изменение которых хотите отменить.

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

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

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

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

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

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"
      }
    },
    {
      "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"
      }
    }
  ]
}
Предыдущая
Концепции
Следующая
Справочник квот