API del servicio cuota de Azure

  • Artículo

La API REST del servicio cuota de Azure está diseñada para ver y administrar cuotas para proveedores de recursos de Azure.

Importante

Azure Quota Service API es una versión preliminar pública

Una nueva versión de La API de cuota de Azure es una versión preliminar pública. Esta API usa el proveedor de recursos Microsoft.Quota, admite máquinas virtuales de Azure (núcleos/vCPU), Azure Machine Learning (dedicados/vCPU), redes, azure HPC Cache, almacenamiento y servicios de Azure Purview.

Una cuota es el límite de servicio o la concesión establecidos en un recurso de la suscripción de Azure. Cada servicio de Azure define sus cuotas y determina sus valores predeterminados. Para más información sobre las cuotas más comunes de Microsoft Azure, consulte Límites, cuotas y restricciones de suscripción y servicio de Azure.

Uso de las API de cuota

Con la API de cuota, puede:

  1. Obtenga las cuotas y usos actuales de un recurso.
  2. Obtenga una lista de cuotas y usos actuales de todos los recursos.
  3. Cree o actualice cuotas de un recurso.
  4. Obtenga el estado de las solicitudes de cuota de un recurso.
  5. Obtener la lista de todas las solicitudes de cuota de un recurso durante un año

Llamada PUT de API de cuota y ámbito

La solicitud PUT de la API de cuota incluye un parámetro de "ámbito" que se puede personalizar para alinearse con los requisitos de los proveedores de recursos que buscan un aumento de cuota, lo que garantiza que la llamada API sigue siendo uniforme.

https://management.azure.com/<scope>/Microsoft.Quota/quotas/<resourceName>?api-version=2021-03-15-preview
Proveedor de recursos Ámbito
Microsoft.Compute subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{azure location}
Microsoft.HDInsight subscriptions/{subscriptionId}/providers/Microsoft.HDInsight/locations/{azure location}
Microsoft.MachineLearningService subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningService/locations/{azure location}
Microsoft.Network subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{azure location}
Microsoft.Purview subscriptions/{subscriptionId}/providers/Microsoft.Purview/locations/{azure location}

Nota: Aquí puede encontrar un ejemplo de llamada PUT para el proceso.

Requisitos previos

Importante

Para poder usar Quota API, debe hacer lo siguiente:

Registro del proveedor de recursos cuota de Microsoft

Para registrar el proveedor de recursos cuota de Microsoft, use el siguiente comando de PowerShell:

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Devuelve resultados similares a los de la salida siguiente:

ProviderNamespace : Microsoft.Quota
RegistrationState : Registering
ResourceTypes     : {usages, quotas, quotaRequests, operationsStatus...}
Locations         : {West Europe, East US, South Central US...}

Una vez registrado el proveedor de recursos Microsoft.Quota, RegistrationState se establecerá en Registered. Para más información sobre cómo administrar proveedores de recursos de Azure, consulte Proveedores de recursos de Azure.

Limitación de peticiones

Todas las llamadas API de nivel de suscripción y de nivel 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.

Rol de operador de solicitud de cuota

El 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 operador de solicitud de cuota es 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

El rol Operador de solicitud de cuota se extiende para incluir permisos del proveedor de recursos de cuota.

Procedimientos recomendados de las API de cuota

  1. Supervisión de la utilización de cuota: Use la API de cuota de Azure para realizar un seguimiento eficaz del uso de la cuota. Esta API proporciona información en tiempo real sobre el uso actual y la cuota disponible para una combinación específica de suscripción, familia de máquinas virtuales y región. Es fundamental comprobar periódicamente el uso de la cuota antes de considerar cualquier aumento de cuota.

  2. Solicitud de aumento de cuota: Si el uso de la cuota supera el destino predefinido, inicie una solicitud de aumento de cuota mediante la API de cuota de Azure para volver a poner el uso en línea con los objetivos. El proceso es sencillo: simplemente envíe una solicitud de API que describa el aumento de cuota deseado. Por ejemplo, si el uso de destino para la cuota de familia de máquinas virtuales Dv2 en el Norte de Europa, en "subscription1", se establece en el 80 %, y la supervisión de la API de cuota de Azure indica un uso real del 85 %, envíe un aumento de cuota del 10 % al 20 %.

Sugerencia

Es aconsejable solicitar un aumento de cuota del 10 % al 20 % de la utlización de recursos, ya que proporciona un búfer actualizable para picos inesperados en el uso de recursos, lo que garantiza que no alcanzará inmediatamente el nuevo límite de cuota después de un aumento . Este enfoque minimiza la necesidad de llamadas API frecuentes para solicitar cuota adicional, lo que mejora las posibilidades de aprobación.

  1. Respuesta del aumento de cuota: Al enviar una solicitud de aumento de cuota, recibirá una respuesta que indica si la solicitud se ha aprobado o rechazado. En caso de rechazo, puede iniciar un seguimiento registrando una solicitud de soporte técnico mediante la API rest de soporte técnico de Azure o mediante una nueva solicitud de soporte técnico en la Azure Portal, incluidos los detalles de la solicitud de aumento de cuota denegada y el motivo de la consulta.

Solución de errores de la API de cuota

Use las tablas siguientes para solucionar errores que podría 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.Quota 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. 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).
Se requiere MFA Las solicitudes de cuota necesitan Multi-Factor Authentication. Habilite Multi-Factor Authentication para su inquilino o cuenta siguiendo las instrucciones de habilitación de MFA e inténtelo de nuevo.
RequestPartiallyFulfilled La solicitud de cuota se cumple parcialmente. Para cualquier pregunta, 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: