Introducción a las API y servicios medidos en Microsoft Graph
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:
- Propiedad de los datos del cliente: los datos del cliente pertenecen al cliente. Obtenga más información sobre cómo Microsoft clasifica los datos de los clientes.
- Acceso razonable: el servicio proporciona acceso al contenido del cliente, dentro de los límites definidos.
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 una API de Microsoft Graph 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).
- Las identidades administradas de Azure no se admiten para llamar a LAS API de uso medido. Para más información, consulte Servicios de Azure que admiten identidades administradas.