Uso de microsoft Graph API para exportar datos de facturación de asociados
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.