API квоты Azure

API квот — это REST API, который можно использовать для просмотра квот для служб Azure и управления ими.

Важно!

Общая доступность API квоты

API квоты Azure теперь является общедоступным. В настоящее время она поддерживает виртуальные машины Azure (ядра и виртуальные ЦП) и службы машинного обучения Azure (выделенные или виртуальные ЦП).

Примечание: Новая версия REST API квоты доступна в общедоступной предварительной версии в Rest API службы квот Azure. Он использует поставщик ресурсов Microsoft.Quota и поддерживает виртуальные машины Azure (ядра и виртуальные ЦП), Машинное обучение Azure, сеть Azure, azure HPC Cache и службы Azure Purview.

Квоты — это максимальные значения для ресурсов, действий и элементов в подписке Azure. Каждая служба Azure определяет свои квоты и значения по умолчанию. В зависимости от бизнес-потребностей может потребоваться увеличить значения квоты.

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

Использование API квоты

С помощью API квоты вы можете:

  • Получение текущих квот и использования ресурса.
  • Получение списка текущих квот и использования всех ресурсов.
  • Создание или обновление квот ресурса.
  • Получение состояния запросов квоты для ресурса.
  • Получение списка всех запросов на квоту ресурса за один год.

Операции REST

API квот Azure позволяет легко искать квоты и запрашивать увеличение с помощью следующих операций REST:

Предварительные требования

Важно!

Перед использованием API квоты необходимо:

Регистрация поставщика ресурсов емкости Майкрософт

Чтобы зарегистрировать поставщик ресурсов Емкости Майкрософт, используйте следующую команду PowerShell:

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Он возвращает результаты, аналогичные следующим выходным данным:

ProviderNamespace : Microsoft.Capacity
RegistrationState : Registering
ResourceTypes     : {resources, reservationOrders, reservationOrders/reservations, listbenefits...}
Locations         : {West Europe, East US, South Central US...}

После регистрации RegistrationState поставщика ресурсов Microsoft.Capacity для будет задано значение Registered. Дополнительные сведения об управлении поставщиками ресурсов Azure см. в статье Поставщики ресурсов Azure.

Роль оператора запроса квоты

Роль оператора запроса квоты — это встроенная роль Azure, настроенная для операций с квотами. Он предоставляет разрешения на чтение и создание запросов квоты, получение состояния запроса на квоту и создание запросов в службу поддержки. Назначьте эту роль пользователям, группам, субъектам-службам, управляемым удостоверениям и приложениям, которые выполняют операции квоты. Для справки идентификатором роли оператора запроса квоты является 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

Квоты на виртуальные ЦП

Api квот можно использовать для управления квотами для следующих двух типов квот виртуальных ЦП:

  • Стандартная квота виртуальных ЦП для виртуальных машин с оплатой по мере использования и зарезервированных экземпляров виртуальных машин.
  • Квота точечных виртуальных ЦП для точечных виртуальных машин.

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

Квоты Машинного обучения Azure

Api квот можно использовать для управления квотами для рабочих областей и вычислений Машинного обучения Azure. Дополнительные сведения см. в статье Управление квотами для ресурсов с помощью Машинного обучения Azure и их увеличение .

  • Ограничения по умолчанию для ресурсов Azure, связанных с Машинным обучением Azure.
  • Создание квот уровня рабочей области.
  • Просмотр квот и ограничений.
  • Запрос на увеличение квоты.
  • Квоты частных конечных точек и DNS.

Регионы

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

Регулирование

При отправке слишком большого количества запросов API можно регулировать все вызовы API уровня подписки и клиента. Если вызов API регулируется, вы получите сообщение об ошибке о том, что сервер отклонил запрос API. Вы можете повторить вызов API по истечении некоторого времени.

Дополнительные сведения о регулировании API, устранении неполадок с регулированием и о том, как избежать регулирования, см. в статье Устранение ошибок регулирования в Azure.

Устранение ошибок API квоты

Используйте следующие таблицы для устранения ошибок, которые могут возникнуть при использовании API квоты.

Код ошибки Как решить эту проблему
ContactSupport Откройте новый запрос в службу поддержки в портал Azure. В разделе Выберите тип проблемы выберите Ограничения службы и подписки (квоты). Вы также можете открыть его программным способом с помощью REST API службы поддержки Azure.
InternalServerError Внутренняя ошибка сервера. Повторите вызов API позже.
Отсутствуетрегистрация Зарегистрируйте поставщик ресурсов Microsoft.Capacity для каждой подписки. Инструкции по устранению неполадок см. в статье Устранение ошибок при регистрации поставщика ресурсов.
QuotaNotAvailableForResource Квота сейчас недоступна в расположении для запрошенного ресурса. Откройте новый запрос в службу поддержки в портал Azure. В разделе Выберите тип проблемы выберите Ограничения службы и подписки (квоты). Вы также можете открыть его программным способом с помощью REST API службы поддержки Azure.
QuotaReductionNotSupported Текущее ограничение квоты превышает запрошенную квоту или текущее использование превышает запрошенную квоту. Сокращение квот не поддерживается. Квота не может быть уменьшена.
RequestThrottled Для повышения общей производительности службы можно регулировать все запросы API уровня подписки и клиента. Количество запросов превысило максимально допустимую частоту запросов API. Повторите попытку позже.
ResourceNotAvailableForOffer Ресурс в настоящее время недоступен в расположении для типа предложения. Список текущих и устаревших предложений см. на странице Сведений о предложении Microsoft Azure . Сведения об изменении типа предложения см. на странице Изменение подписки Azure на другое предложение . Вы также можете открыть новый запрос в службу поддержки в портал Azure. В разделе Выберите тип проблемы выберите Ограничения службы и подписки (квоты). Вы также можете открыть его программным способом с помощью REST API службы поддержки Azure.
ResourceNotAvailableForSubscription Ресурс сейчас недоступен в расположении для запрошенной подписки. Откройте новый запрос в службу поддержки в портал Azure. В разделе Выберите тип проблемы выберите Ограничения службы и подписки (квоты). Вы также можете открыть его программным способом с помощью REST API службы поддержки Azure.
UnableToIncreaseQuota Невозможно увеличить квоты для запрошенных подписок. Откройте новый запрос в службу поддержки в портал Azure. В разделе Выберите тип проблемы выберите Ограничения службы и подписки (квоты).

Поддержка другими языками и интерфейсами

REST API квоты доступен в следующих пакетах SDK Microsoft Azure для конкретных языков:

Использование API портал Azure и поддержки для управления квотами

Azure позволяет создавать запросы на поддержку и управлять ими. Вы можете: