Экспорт данных о выставлении счетов партнеров с помощью API Graph Майкрософт
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Примечание.
Этот API доступен партнерам по поставщику облачных решений (CSP) только для доступа к данным о выставлении счетов и неоплаченной выверки для клиента. Дополнительные сведения о программе CSP см. в статье Поставщик облачных решений Майкрософт.
В рамках экосистемы Центра партнеров Майкрософт прямые партнеры Майкрософт в программах для поставщиков облачных решений могут запрашивать экспорт своих оплачиваемых и неоплаченных данных в Хранилище BLOB-объектов Azure асинхронно. Это избавляет от необходимости поддерживать открытое подключение в течение нескольких часов и циклически выполнять миллионы транзакций. Асинхронный API позволяет быстро получить доступ к данным выставления счетов и выверки в управляемых блоках.
API выставления счетов для партнеров определяется в подпространстве microsoft.graph.partners.billingимен OData .
Примечание.
Ежедневное использование обычно занимает 24 часа, чтобы отображаться в Центре партнеров Майкрософт или быть доступным через API.
Авторизация
Чтобы экспортировать данные выверки, вызывающий субъект должен находиться в клиенте партнера и иметь соответствующие разрешения на выставление счетов партнера. API выставления счетов для партнеров поддерживает следующие разрешения партнера.
| Тип разрешения | Разрешение с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | PartnerBilling.Read.All | Не поддерживается. |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Приложение | PartnerBilling.Read.All | Не поддерживается. |
"Никому не доверяй"
Эта функция помогает организациям согласовать свои удостоверения с тремя руководящими принципами архитектуры "Никому не доверяй":
- Выполняйте проверку явным образом.
- Использование минимальных привилегий
- Предполагайте наличие бреши в системе безопасности
Дополнительные сведения о принципах "Никому не доверяй" и других способах согласования организации с руководящими принципами см. в центре руководства по принципу "Никому не доверяй".
Основные варианты использования
API выставления счетов для партнеров предоставляет методы и действия, которые позволяют прямым партнерам Майкрософт экспортировать свои большие объемы выверочных данных, а также данные об использовании Azure с выставлением счетов и без выставления счетов.
Данные об использовании с выставлением счетов
| Вариант использования | API |
|---|---|
| Создание новой операции экспорта для экспорта данных об использовании с выставлением счетов | billedUsage: export |
| Опрос на наличие обновления состояния операции | Операция получения |
Необясленные данные об использовании
| Вариант использования | API |
|---|---|
| Создание новой операции экспорта для экспорта данных об использовании без ограничения | unbilledUsage: export |
| Опрос на наличие обновления состояния операции | Операция получения |
Данные выверки выставленного счета
| Вариант использования | API |
|---|---|
| Создание новой операции экспорта для экспорта данных выверки счетов | billedReconciliation: export |
| Опрос на наличие обновления состояния операции | Операция получения |
Асинхронное извлечение данных
Скачивание данных об использовании или выверки — это длительная операция, которая состоит из следующих операций.
Конечная точка элемента строки использования
Используйте API billedUsage: export или unbilledUsage: export для доступа к оплачиваемым или неописуемым элементам строк потребления. API возвращает 202 Accepted код ответа и Location заголовок, содержащий URL-адрес длительной операции. Вы можете проверка состояние длительной операции, выполняя запрос GET через регулярные интервалы, пока не получите состояние успешного выполнения с URL-адресом манифеста.
Конечная точка элемента строки без использования
Используйте API выставления счетовReconciliation: export для доступа к элементам строки выверки выставленного счета. API возвращает 202 Accepted код ответа и Location заголовок, содержащий URL-адрес длительной операции. Вы можете проверка состояние длительной операции, выполняя запрос GET через регулярные интервалы, пока не получите состояние успешного выполнения с URL-адресом манифеста.
Конечная точка состояния операции
Пока вы не получите состояние успешного выполнения, регулярно опрашиваете API операции получения . Если запрошенные данные недоступны, ответ API содержит заголовок, указывающий Retry-After , сколько времени следует ждать перед отправкой другого запроса. После успешного завершения операции ответ также предоставляет манифест с подробными сведениями о созданных файлах. Манифест предоставляет папку хранилища, из которой можно скачать фактические данные выставления счетов. Ответ разделяет или секционирует файлы для оптимизации пропускной способности и параллелизма ввода-вывода.