Пространство имен: microsoft.graph.partners.billing
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Примечание.
Этот API доступен партнерам по поставщику облачных решений (CSP) только для доступа к данным о выставлении счетов и неоплаченной выверки для клиента. Дополнительные сведения о программе CSP см. в статье Поставщик облачных решений Майкрософт.
Экспортируйте данные об использовании с выставлением счетов Azure.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба |
Правительство США L4 |
Правительство США L5 (DOD) |
Китай управляется 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
| Тип разрешения |
Разрешения с наименьшими привилегиями |
Более высокие привилегированные разрешения |
| Делегированные (рабочая или учебная учетная запись) |
PartnerBilling.Read.All |
Недоступно. |
| Делегированные (личная учетная запись Майкрософт) |
Не поддерживается. |
Не поддерживается. |
| Приложение |
PartnerBilling.Read.All |
Недоступно. |
HTTP-запрос
POST /reports/partners/billing/usage/billed/export
Текст запроса
В тексте запроса укажите представление параметров в формате JSON.
В следующей таблице показаны параметры, которые можно использовать с этим действием.
| Параметр |
Тип |
Описание |
| attributeSet |
microsoft.graph.partners.billing.attributeSet |
Атрибуты, которые необходимо экспортировать. Допустимые значения: full, basic, unknownFutureValue. Значение по умолчанию — full. Выберите full полный ответ или basic подмножество атрибутов. Необязательный параметр. |
| invoiceId |
String |
Идентификатор счета, для которого партнер запросил экспорт данных. Обязательно. |
Отклик
В случае успешного 202 Accepted выполнения этот метод возвращает код ответа и Location заголовок, содержащий URL-адрес длительной операции. Вы можете проверка состояние длительной операции, выполнив запрос GET на этот URL-адрес, который возвращает один из следующих объектов в тексте ответа: microsoft.graph.partners.billing.runningOperation, microsoft.graph.partners.billing.exportSuccessOperation или microsoft.graph.partners.billing.failedOperation.
Примеры
Запрос
Ниже показан пример запроса.
POST https://graph.microsoft.com/beta/reports/partners/billing/usage/billed/export
Content-Type: application/json
{
"invoiceId" : "G016907411",
"attributeSet" : "full"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Reports.Partners.Billing.Usage.Billed.MicrosoftGraphPartnersBillingExport;
using Microsoft.Graph.Beta.Models.Partners.Billing;
var requestBody = new ExportPostRequestBody
{
InvoiceId = "G016907411",
AttributeSet = AttributeSet.Full,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Reports.Partners.Billing.Usage.Billed.MicrosoftGraphPartnersBillingExport.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphreports "github.com/microsoftgraph/msgraph-beta-sdk-go/reports"
graphmodelspartnersbilling "github.com/microsoftgraph/msgraph-beta-sdk-go/models/partners/billing"
//other-imports
)
requestBody := graphreports.NewExportPostRequestBody()
invoiceId := "G016907411"
requestBody.SetInvoiceId(&invoiceId)
attributeSet := graphmodels.FULL_ATTRIBUTESET
requestBody.SetAttributeSet(&attributeSet)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
microsoftGraphPartnersBillingExport, err := graphClient.Reports().Partners().Billing().Usage().Billed().MicrosoftGraphPartnersBillingExport().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.reports.partners.billing.usage.billed.microsoftgraphpartnersbillingexport.ExportPostRequestBody exportPostRequestBody = new com.microsoft.graph.beta.reports.partners.billing.usage.billed.microsoftgraphpartnersbillingexport.ExportPostRequestBody();
exportPostRequestBody.setInvoiceId("G016907411");
exportPostRequestBody.setAttributeSet(com.microsoft.graph.beta.models.partners.billing.AttributeSet.Full);
var result = graphClient.reports().partners().billing().usage().billed().microsoftGraphPartnersBillingExport().post(exportPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const operation = {
invoiceId: 'G016907411',
attributeSet: 'full'
};
await client.api('/reports/partners/billing/usage/billed/export')
.version('beta')
.post(operation);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Reports\Partners\Billing\Usage\Billed\MicrosoftGraphPartnersBillingExport\ExportPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\Partners\Billing\AttributeSet;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ExportPostRequestBody();
$requestBody->setInvoiceId('G016907411');
$requestBody->setAttributeSet(new AttributeSet('full'));
$result = $graphServiceClient->reports()->partners()->billing()->usage()->billed()->microsoftGraphPartnersBillingExport()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Reports
$params = @{
invoiceId = "G016907411"
attributeSet = "full"
}
Export-MgBetaReportPartnerBillingUsageBilled -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.reports.partners.billing.usage.billed.microsoft_graph_partners_billing_export.export_post_request_body import ExportPostRequestBody
from msgraph_beta.generated.models.attribute_set import AttributeSet
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ExportPostRequestBody(
invoice_id = "G016907411",
attribute_set = AttributeSet.Full,
)
result = await graph_client.reports.partners.billing.usage.billed.microsoft_graph_partners_billing_export.post(request_body)
Отклик
Ниже приводится пример отклика.
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14