Compartir a través de

API de cuota de Azure

  • Artículo

La API de cuota es una API REST que puede usar para ver y administrar cuotas para los servicios de Azure.

Importante

Disponibilidad general de la API de cuota

Azure Quota API ya está disponible con carácter general. Actualmente admite máquinas virtuales de Azure (núcleos/vCPU) y servicios de Azure Machine Learning (dedicados o vCPU).

Nota: Una nueva versión de la API REST de cuota está en versión preliminar pública, en la API rest del servicio cuota de Azure. Usa el proveedor de recursos Microsoft.Quota y admite máquinas virtuales de Azure (núcleos/vCPU), Azure Machine Learning, redes de Azure, azure HPC Cache y servicios de Azure Purview.

Las cuotas son los valores máximos de recursos, acciones y elementos de la suscripción de Azure. Cada servicio de Azure define sus cuotas y determina sus valores predeterminados. En función de sus necesidades empresariales, es posible que tenga que aumentar los valores de cuota.

Para más información sobre los límites más comunes de Microsoft Azure, consulte Límites, cuotas y restricciones de suscripción y servicios de Azure.

Uso de la API de cuota

Con la API de cuota, puede:

  • Obtenga las cuotas y los usos actuales de un recurso.
  • Obtenga una lista de cuotas y usos actuales de todos los recursos.
  • Crear o actualizar cuotas de un recurso.
  • Obtenga el estado de las solicitudes de cuota de un recurso.
  • Obtenga la lista de todas las solicitudes de cuota de un recurso durante un año.

Operaciones REST

La API de cuota de Azure facilita la búsqueda de las cuotas y los aumentos de solicitudes mediante estas operaciones REST:

Requisitos previos

Importante

Para poder usar Quota API, debe hacer lo siguiente:

Registro del proveedor de recursos de capacidad de Microsoft

Para registrar el proveedor de recursos De capacidad de Microsoft, use este comando de PowerShell:

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Devuelve resultados similares a este resultado:

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

Una vez registrado el proveedor de recursos Microsoft.Capacity, RegistrationState se establecerá Registereden . Para más información sobre la administración de proveedores de recursos de Azure, consulte Proveedores de recursos de Azure.

Rol operador de solicitud de cuota

El rol Operador de solicitud de cuota es un rol integrado de Azure personalizado para las operaciones de cuota. Concede permisos para leer y crear solicitudes de cuota, obtener el estado de la solicitud de cuota y crear incidencias de soporte técnico. Asigne este rol a usuarios, grupos, entidades de servicio, identidades administradas y aplicaciones que realizan operaciones de cuota. Como referencia, el identificador de rol del operador de solicitud de cuota es 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

Cuotas de vCPU

Puede usar Quota API para administrar las cuotas de estos dos tipos de cuotas de vCPU:

  • Cuota de vCPU estándar para máquinas virtuales de pago por uso y instancias reservadas de máquina virtual.
  • Cuota de vCPU de spot para máquinas virtuales de spot .

Para más información sobre los límites y cuotas de Azure, consulte Límites , cuotas y restricciones de suscripción y servicio de Azure.

Cuotas de Azure Machine Learning

Puede usar Quota API para administrar cuotas para áreas de trabajo y proceso de Azure Machine Learning. Lea el artículo Administración y aumento de cuotas de recursos con Azure Machine Learning para más información sobre:

  • Límites predeterminados de los recursos de Azure relacionados con Azure Machine Learning.
  • Creación de cuotas de nivel de área de trabajo.
  • Visualización de las cuotas y los límites.
  • Solicitud de aumentos de cuota.
  • Puntos de conexión privados y cuotas de DNS.

Regions

La mayoría de las cuotas son específicas para una carga de trabajo en cualquier región. Solicite cuotas independientes para cada región en la que quiera implementar un servicio. Para enumerar todas las regiones de Azure en las que existe el servicio, use la operación Enumerar por regiones de servicio .

Limitación de peticiones

Todas las llamadas API de nivel de suscripción y de inquilino se pueden limitar si envía demasiadas solicitudes de API. Si la llamada API está limitada, recibirá un mensaje de error que indica que el servidor rechazó la solicitud de API. Puede volver a intentar la llamada API después de que haya transcurrido algún tiempo.

Para más información sobre la limitación de API, cómo solucionar problemas de limitación y cómo evitar la limitación, consulte Solución de problemas de limitación en Azure.

Solución de problemas de errores de la API de cuota

Use las tablas siguientes para solucionar errores que puede obtener al usar quota API.

Código de error Cómo resolverlo
ContactSupport Abra una nueva solicitud de soporte técnico en el Azure Portal. En Seleccionar un tipo de problema, elija Límites de servicio y suscripción (cuotas). También puede abrirlo mediante programación mediante la API REST de soporte técnico de Azure.
InternalServerError Error interno del servidor Vuelva a intentar la llamada API más adelante.
MissingRegistration Registre el proveedor de recursos Microsoft.Capacity para cada una de las suscripciones. Para obtener instrucciones de solución de problemas, consulte Resolución de errores para el registro del proveedor de recursos.
QuotaNotAvailableForResource La cuota no está disponible actualmente en la ubicación del recurso solicitado. Abra una nueva solicitud de soporte técnico en el Azure Portal. En Seleccionar un tipo de problema, elija Límites de servicio y suscripción (cuotas). También puede abrirlo mediante programación mediante la API REST de soporte técnico de Azure.
QuotaReductionNotSupported El límite de cuota actual es mayor que la cuota solicitada o el uso actual es mayor que la cuota solicitada. No se admite la reducción de cuotas. No se puede reducir la cuota.
RequestThrottled Todas las solicitudes de API de nivel de suscripción y de nivel de inquilino se pueden limitar para ayudar con el rendimiento general del servicio. El número de solicitudes superó la tasa máxima de solicitudes de API permitida. Vuelva a intentarlo más tarde.
ResourceNotAvailableForOffer El recurso no está disponible actualmente en la ubicación del tipo de oferta. Para obtener la lista de ofertas actuales y retiradas, consulte la página Detalles de la oferta de Microsoft Azure . Para cambiar el tipo de oferta, consulte la página Cambio de la suscripción de Azure a otra oferta . También puede abrir una nueva solicitud de soporte técnico en el Azure Portal. En Seleccionar un tipo de problema, elija Límites de servicio y suscripción (cuotas). También puede abrirlo mediante programación mediante la API REST de soporte técnico de Azure.
ResourceNotAvailableForSubscription El recurso no está disponible actualmente en la ubicación de la suscripción solicitada. Abra una nueva solicitud de soporte técnico en el Azure Portal. En Seleccionar un tipo de problema, elija Límites de servicio y suscripción (cuotas). También puede abrirlo mediante programación mediante la API REST de soporte técnico de Azure.
UnableToIncreaseQuota No se pueden aumentar las cuotas de las suscripciones solicitadas. Abra una nueva solicitud de soporte técnico en el Azure Portal. En Seleccionar un tipo de problema, elija Límites de servicio y suscripción (cuotas).

Compatibilidad con otros lenguajes e interfaces

La API REST de cuota está disponible en los siguientes SDK de Microsoft Azure específicos del lenguaje:

Uso de Azure Portal y la API de soporte técnico para administrar cuotas

Azure le permite crear y administrar solicitudes de soporte técnico, también conocidas como incidencias de soporte técnico. Puede: