Introducción a las API y servicios medidos en Microsoft Graph

  • Artículo

Microsoft Graph incluye API que están disponibles sin costo adicional con licencias de suscripción de usuario y API y servicios medidos. Las API y servicios medidos de Microsoft Graph incurren en costos en función del uso. Los costos pueden incurrirse por llamada API realizada, por objeto devuelto en una llamada API o a través de otras medidas.

Tanto si se mide como si no, las API de Microsoft Graph siguen estos dos principios:

La medición de algunas API ayuda a garantizar el estado del ecosistema actual y futuro de Microsoft Graph mediante el equilibrio entre el acceso y el costo de la plataforma. En caso de que se mida un Graph API de Microsoft que se incluye con licencias de suscripción de usuario, sería un cambio compatible con versiones anteriores y se aplicarían las directivas de control de versiones, compatibilidad y cambio importante para Microsoft Graph.

Para obtener la lista de API y servicios medidos, consulte API y servicios medidos.

Categorías de API y medición

Las API de Microsoft Graph se dividen en tres categorías y la medición puede aplicarse en función de la categoría de la API.

API estándar

La mayoría de las API de Microsoft Graph son API estándar. Estas API realizan operaciones estándar (crear, leer, actualizar, eliminar) en el contenido del cliente y los puntos de conexión administrativos. Los límites de acceso razonables para estas API se definen en función de los umbrales de uso documentados. Esto ayuda a garantizar una experiencia positiva del cliente y fomenta patrones de uso de API eficaces. El acceso a las API estándar dentro de los umbrales de uso definidos está disponible como parte de la licencia de usuario sin costos adicionales.

API de alta capacidad

Las API de alta capacidad garantizan que los clientes y desarrolladores tengan acceso a los datos a escala. Esta categoría incluye puntos de conexión de importación o exportación masiva creados específicamente y servicios de Microsoft Graph. Estas API pueden medirse e incurrir en costos adicionales más allá de las licencias de suscripción de usuario.

API avanzadas

Las API avanzadas proporcionan acceso a datos enriquecidos o agregados, o funciones avanzadas que se extienden desde Microsoft 365. La API assignSensitivityLabel es un ejemplo de una API avanzada. Estas API pueden medirse e incurrir en costos adicionales más allá de las licencias de suscripción de usuario.

Acceso a LAS API de uso medido

Para acceder a api y servicios medidos en Microsoft Graph, una aplicación debe estar asociada a una suscripción activa de Microsoft Azure. Para obtener más información sobre cómo asociar una aplicación a una suscripción, consulte Habilitación de API y servicios medidos en Microsoft Graph.

Consideraciones sobre el uso de API de uso medido

Tenga en cuenta las siguientes consideraciones cuando use API y servicios medidos en Microsoft Graph:

  • Las API de uso medido pueden devolver errores relacionados con el estado de la suscripción, además de otros errores comunes. Para obtener más información sobre los errores de Microsoft Graph, consulte Errores y tipos de recursos de Microsoft Graph.
  • Las API de uso medido se facturan según el uso de la API. Asegúrese de comprender la unidad de medición para poder calcular los costos asociados a una API determinada.

Limitaciones conocidas

Las siguientes limitaciones se aplican a las API de uso medido:

  • Actualmente, las API y servicios medidos de Microsoft Graph solo están disponibles en el entorno global de Microsoft y no en implementaciones en la nube nacionales, incluidas las implementaciones de Microsoft 365 GCC a las que se accede a través del punto de conexión de Microsoft Graph en todo el mundo. Para más información sobre las nubes nacionales, consulte Implementaciones de nubes nacionales.
  • La aplicación de destino debe ser una aplicación cliente confidencial (por ejemplo, aplicación web, API web o demonio/servicio). No se admiten aplicaciones cliente públicas (aplicaciones de escritorio y móviles).

Contenido relacionado