- Primeros pasos
- La definición de Swagger
- Ejemplos de uso de la API de Orchestrator
- Solicitudes de alertas
- Solicitudes de activos
- Solicitudes de calendario
- Solicitudes de entornos
- Solicitudes de carpetas
- Solicitudes de tareas genéricas
- Solicitudes de trabajos
- Solicitudes de bibliotecas
- Solicitudes de licencia
- Solicitudes de paquetes
- Solicitudes de permisos
- Solicitudes de espacios de trabajo personales
- Solicitudes de procesos
- Procesar solicitudes de política de retención de datos
- Solicitudes de elementos en cola
- Solicitudes de política de retención de cola
- Solicitudes de robots
- Solicitudes de roles
- Solicitudes de horarios
- Solicitudes de configuración
- Solicitudes de cubos de almacenamiento
- Solicitudes de tareas
- Solicitudes de catálogos de tareas
- Solicitudes de formularios de tareas
- Solicitudes de tenants
- Solicitudes de transacciones
- Solicitudes de usuario
- Solicitudes de Webhooks
Límites de tarifa
- Garantizan un sistema predecible: conocer el límite de llamadas a la API ayuda a diseñar y mantener mejor tus aplicaciones. Proporciona un entorno predecible, que minimiza las sorpresas debidas a infracciones inesperadas de los límites.
- Mejoran el rendimiento: al controlar el tráfico en nuestros servidores, garantizamos un rendimiento óptimo y respuestas más rápidas, lo que mejora significativamente tu experiencia del producto.
- Mejoran la seguridad: los límites que se describen a continuación actúan como una capa adicional de seguridad, protegiendo tu sistema de posibles ciberamenazas.
- Garantizan un uso justo: nuestros límites de tarifas aseguran una asignación de recursos equitativa a todos los usuarios y un funcionamiento fluido incluso durante los períodos de mayor uso.
Los límites que se indican a continuación requieren algunos ajustes por tu parte, pero estamos seguros de que aportarán beneficios a largo plazo.
Estos son los límites que aplicamos:
PuntoFinal |
Limits |
Efectivo desde |
---|---|---|
|
100 solicitudes de API/minuto/tenant |
Julio de 2024 |
| 100 solicitudes de API/minuto/tenant | Julio de 2024 |
Es importante tener en cuenta que estos límites no se aplican a la adición de elementos de cola y los trabajos de procesamiento. Como tal, no hay impacto en la adición de un elemento de cola, la eliminación de una cola, la configuración de su estado o el inicio y el procesamiento de cualquier número de trabajos.
Puedes comprobar tu uso de API por mes o día en la pestaña de auditoría de la API a nivel de tenant en la ventana de Supervisión.
Encabezado |
Descripción |
Ejemplo |
---|---|---|
|
Todas las solicitudes que superen los límites mencionados reciben una respuesta HTTP 429 que incluye este encabezado. Muestra el número de segundos que debes esperar hasta que el punto final vuelva a estar disponible. |
Retry-After: 10 significa que el límite de velocidad en el punto final caduca en 10 segundos. Cualquier reintento en estos 10 segundos da como resultado una respuesta 429.
|
|
El número de llamadas restantes |
X-RateLimit-Remaining: 30 significa que te quedan 30 llamadas en el intervalo de tiempo actual
|
Si el número de solicitudes por minuto es inferior a 10, se representa como 0.
Las siguientes actividades se ven afectadas por estos límites:
- Obtener trabajo
- Obtener elementos de la cola
- Solicitud Http de Orchestrator (cuando se utiliza para llamar a los puntos finales
GET /odata/Jobs
oGET /odata/QueueItems
)
Esto es lo que te recomendamos que hagas para asegurarte de que cumples nuestros límites y los aprovechas al máximo:
- Revisa tus patrones de uso de API y la información que recuperas de nuestros puntos finales de tipo
GetAll
mencionados anteriormente. - Ajusta la frecuencia de llamadas a la API y los procedimientos de extracción de datos para ajustarlos con estos límites cuando sea necesario.
- Consulta las secciones Exportar trabajos y Exportar elementos en cola para obtener ejemplos sobre cómo recuperar datos de trabajos y elementos en cola.
- Utiliza la opción Exportación de datos en tiempo real de Insights.
- Ponte en contacto con tu gestor de cuentas o con nuestro equipo de soporte si tienes alguna pregunta o necesitas más aclaraciones.
Los puntos finales de la API utilizados para recuperar listas de trabajos y elementos de cola pueden resultar problemáticos cuando se utilizan para la supervisión en tiempo real y la exportación de datos. Por ejemplo:
-
Al solicitar hasta 1000 elementos, con cada elemento que asciende a hasta 1 MB de datos grandes, la respuesta a una sola llamada a la API puede ser de 1 GB de tamaño. Dado que hay intermediarios que no permiten respuestas de este tamaño, las solicitudes fallan.
-
Al utilizar filtros complejos y luego paginar una cola con varios millones de elementos de cola, las solicitudes pueden comenzar a agotarse después de unas pocas docenas de páginas. Esto se debe a la cantidad de datos que deben recuperarse de la base de datos.
GetAll
. Estos son los campos afectados:
PuntoFinal |
Campos omitidos |
Qué puedes utilizar en su lugar |
Efectivo desde |
---|---|---|---|
|
|
Para las exportaciones, utiliza el punto final dedicado:
GET/odata/Jobs/UiPath.Server.Configuration.Data.Export Consulta Exportar trabajos para obtener más información. |
Tenants de comunidad y canarios: marzo de 2024 Tenants de Enterprise: julio de 2024 |
|
|
Para las exportaciones, utiliza el punto final dedicado:
/odata/QueueDefinitions
({key})/UiPathDataSvc.Export Consulta Exportar artículos en cola para obtener más información. |
Tenants de comunidad y canarios: marzo de 2024 Tenants de Enterprise: julio de 2024 |
GET /odata/Jobs
o GET
/odata/QueueItems
a través de la API o a través de las actividades Obtener trabajos, Obtener elementos de cola o Solicitud HTTP de Orchestrator, debes averiguar si utilizas alguno de los campos enumerados. Si lo haces, ten en cuenta que el contenido de estos campos se devolverá como nulo.
Te recomendamos que pruebes los procesos en tus tenants canarios para evaluar el impacto.
Puedes utilizar las siguientes alternativas para recuperar los campos:
- Consulta las secciones Exportar trabajos y Exportar elementos en cola para obtener ejemplos sobre cómo recuperar datos de trabajos y elementos en cola.
- Utiliza la opción Exportación de datos en tiempo real de Insights.
- Ponte en contacto con tu gestor de cuentas o nuestro equipo de soporte si los métodos anteriores no te funcionan.
Los límites de tarifa y los grandes cambios en los campos de datos no se implementarán en los entornos locales.
Si utilizas Orchestrator independiente y estás pensando en mudarte a la nube, puedes utilizar los registros de solicitudes de IIS para determinar la tasa de solicitudes para los puntos finales afectados. El análisis depende de cómo agregues los registros, para lo que puedes utilizar, por ejemplo, Microsoft Log Parser.
Para evaluar el impacto en grandes campos de datos, recomendamos probar tus procesos en los tenants canarios.