Uso de microsoft Graph API para exportar datos de facturación de asociados

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Nota:

Esta API está disponible para que los asociados del proveedor de soluciones en la nube (CSP) solo accedan a sus datos de conciliación facturados y no facturados de un inquilino. Para más información sobre el programa CSP, consulte Proveedor de soluciones en la nube de Microsoft.

Como parte del ecosistema del Centro de partners de Microsoft, los asociados directos de Microsoft en los programas proveedores de soluciones en la nube pueden solicitar exportar sus datos facturados y no facturados a Azure Blob Storage de forma asincrónica. Esto elimina la necesidad de mantener una conexión abierta durante horas y recorrer millones de transacciones de forma iterativa. La API asincrónica proporciona una manera de acceder rápidamente a los datos de facturación y conciliación en fragmentos administrables.

La API de facturación del asociado se define en el subnombre de OData.microsoft.graph.partners.billing

Nota:

El uso con clasificación diaria normalmente tarda 24 horas en aparecer en el Centro de partners de Microsoft o estar disponible a través de la API.

Autorización

Para exportar datos de conciliación, la entidad de seguridad que realiza la llamada debe estar en el inquilino del asociado y tener los permisos de privilegios de facturación de asociado adecuados. La API de facturación de asociados admite los siguientes permisos de asociado.

Tipo de permiso	Permiso con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	PartnerBilling.Read.All	No admitida.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	PartnerBilling.Read.All	No admitida.

Confianza cero

Esta característica ayuda a las organizaciones a alinear sus identidades con los tres principios rectores de una arquitectura de Confianza cero:

• Comprobar de forma explícita.
• Uso de privilegios mínimos
• Asumir la vulneración.

Para obtener más información sobre Confianza cero y otras formas de alinear su organización con los principios rectores, consulte el Centro de orientación de Confianza cero.

Casos de uso comunes

La API de facturación de asociados proporciona métodos y acciones que permiten a los asociados directos de Microsoft exportar sus datos de conciliación facturados de gran volumen y los datos de uso de Azure facturados y no facturados.

Datos de uso facturados

Caso de uso	API
Creación de una nueva operación de exportación para exportar datos de uso facturados	billedUsage: export
Sondeo de la actualización del estado de la operación	Obtener operación

Datos de uso no facturados

Caso de uso	API
Creación de una nueva operación de exportación para exportar datos de uso no facturados	unbilledUsage: export
Sondeo de la actualización del estado de la operación	Obtener operación

Datos de conciliación de facturas facturadas

Caso de uso	API
Creación de una nueva operación de exportación para exportar datos de conciliación de facturas facturadas	billedReconciliation: export
Sondeo de la actualización del estado de la operación	Obtener operación

Recuperación asincrónica de datos

La descarga de datos de uso o conciliación es una operación de larga duración que consta de las siguientes operaciones.

Punto de conexión de línea de uso

Use billedUsage: export o unbilledUsage: export API para acceder a los elementos de línea de consumo facturados o no facturados. La API devuelve un 202 Accepted código de respuesta y un Location encabezado que contiene la dirección URL de la operación de ejecución prolongada. Puede comprobar el estado de la operación de ejecución prolongada realizando una solicitud GET a intervalos regulares hasta que reciba un estado correcto con una dirección URL de manifiesto .

Punto de conexión de elemento de línea que no es de uso

Use la API billedReconciliation: export para acceder a los artículos de línea de conciliación de facturas facturadas. La API devuelve un 202 Accepted código de respuesta y un Location encabezado que contiene la dirección URL de la operación de ejecución prolongada. Puede comprobar el estado de la operación de ejecución prolongada realizando una solicitud GET a intervalos regulares hasta que reciba un estado correcto con una dirección URL de manifiesto .

Punto de conexión de estado de la operación

Hasta que reciba el estado correcto, siga sondeando la API Get operation a intervalos regulares. Si los datos solicitados no están disponibles, la respuesta de la API incluye un Retry-After encabezado que indica cuánto tiempo debe esperar antes de enviar otra solicitud. Cuando la operación se ha completado correctamente, la respuesta también proporciona un manifiesto con detalles de los archivos generados. El manifiesto proporciona una carpeta de almacenamiento desde la que se pueden descargar datos de facturación reales. La respuesta divide o divide los archivos para optimizar el rendimiento y el paralelismo de E/S.