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

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

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

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

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

2. Создайте сервисный аккаунт и назначьте ему одну из ролей, указанных выше.

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

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

   export IAM_TOKEN=<iam_токен>
   

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

2. Создайте сервисный аккаунт и назначьте ему одну из ролей, указанных выше.

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

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

   export IAM_TOKEN=<iam_токен>
   

1. Посмотрите список сервисов с квотами на уровне облака:

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

   Параметр --resource-type (тип ресурса) определяет уровень просмотра квот. Для уровня организации укажите organization-manager.organization.

2. Посмотрите значение и потребление квоты iam.accessKeys.count:

   yc quota-manager quota-limit get \
     --quota-id iam.accessKeys.count \
     --resource-id <идентификатор_облака> \
     --resource-type resource-manager.cloud
   

   Где:

   • --resource-id — идентификатор облака или организации.
   • --quota-id — идентификатор квоты из справочника. В примере iam.accessKeys.count — количество статических ключей доступа в облаке.
   • --resource-type — тип ресурса, определяющий уровень просмотра квот. Для уровня организации укажите organization-manager.organization.

   В ответе limit — значение квоты, usage — потребление квоты. Сравните эти значения, чтобы оценить запас квоты.

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

1. Получите список сервисов с квотами на уровне облака методом listServices:

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

   Параметр resourceType (тип ресурса) определяет уровень просмотра квот. Для уровня организации укажите organization-manager.organization.

   Если в ответе есть непустое поле nextPageToken, передайте его значение в параметре pageToken следующего запроса. Повторяйте запросы, пока не получите все сервисы.

2. Получите значение и потребление квоты iam.accessKeys.count методом get для ресурса QuotaLimit:

   curl \
     --request GET \
     --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'
   

   Где:

   • resource.id — идентификатор облака или организации.
   • iam.accessKeys.count — идентификатор квоты на количество статических ключей доступа в облаке. Для другой квоты возьмите идентификатор из справочника.
   • resource.type — тип ресурса, определяющий уровень просмотра квот. Для уровня организации укажите organization-manager.organization.

   В ответе limit — значение квоты, usage — потребление квоты. Сравните эти значения, чтобы оценить запас квоты.

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

1. Получите список сервисов с квотами на уровне облака с помощью вызова QuotaLimitService/ListServices:

   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
   

   Поле resource_type (тип ресурса) определяет уровень просмотра квот. Для уровня организации укажите organization-manager.organization.

   Если в ответе есть непустое поле nextPageToken, передайте его значение в поле page_token следующего запроса. Повторяйте запросы, пока не получите все сервисы.

2. Получите значение и потребление квоты iam.accessKeys.count с помощью вызова QuotaLimitService/Get:

   grpcurl \
     -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
   

   Где:

   • resource.id — идентификатор облака или организации.
   • quota_id — идентификатор квоты из справочника. В примере iam.accessKeys.count — количество статических ключей доступа в облаке.
   • resource.type — тип ресурса, определяющий уровень просмотра квот. Для уровня организации укажите organization-manager.organization.

   В ответе limit — значение квоты, usage — потребление квоты. Сравните эти значения, чтобы оценить запас квоты.

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

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

   yc quota-manager quota-request create \
     --resource-id <идентификатор_облака> \
     --resource-type resource-manager.cloud \
     --desired-limit quota-id=iam.accessKeys.count,value=1001
   

   В примере запрашивается новое значение квоты 1001, вы можете заменить его на другое.

   Сохраните значение поля id из ответа — идентификатор запроса.

2. Проверьте статус запроса:

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

   В ответе поле status показывает состояние запроса, а результат изменения каждой квоты указан в списке quota_limits.

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

Если нужно найти ранее созданный запрос, посмотрите список запросов. Подробные примеры приведены в разделе Примеры запросов для работы с квотами.

1. Создайте запрос методом create для ресурса QuotaRequest:

   curl \
     --request POST \
     --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'
   

   В примере запрашивается итоговое значение квоты 1001. Замените его на нужное значение.

   Сохраните значение metadata.quotaRequestId из ответа — идентификатор запроса. Поля id и done относятся к операции создания запроса, а не к его рассмотрению.

2. Проверьте статус запроса методом get:

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

   В ответе поле status показывает состояние запроса, а результат изменения каждой квоты указан в списке quotaLimits.

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

Если нужно найти ранее созданный запрос, посмотрите список запросов. Подробные примеры приведены в разделе Примеры запросов для работы с квотами.

1. Создайте запрос с помощью вызова QuotaRequestService/Create:

   grpcurl \
     -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
   

   В примере запрашивается итоговое значение квоты 1001. Замените его на нужное значение.

   Сохраните значение metadata.quotaRequestId из ответа — идентификатор запроса. Поля id и done относятся к операции создания запроса, а не к его рассмотрению.

2. Проверьте статус запроса с помощью вызова QuotaRequestService/Get:

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

   В ответе поле status показывает состояние запроса, а результат изменения каждой квоты указан в списке quotaLimits.

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

Если нужно найти ранее созданный запрос, посмотрите список запросов. Подробные примеры приведены в разделе Примеры запросов для работы с квотами.