billedUsage: export

Статья
02/01/2024

Пространство имен: 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

Заголовки запросов

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type	application/json. Обязательно.

Текст запроса

В тексте запроса укажите представление параметров в формате 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);

Важно!

Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta reports partners billing usage billed microsoft-graph-partners-billing-export post --body '{\
  "invoiceId" : "G016907411",\
  "attributeSet" : "full"\
}\
'

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.



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
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphreports.NewExportPostRequestBody()
invoiceId := "G016907411"
requestBody.SetInvoiceId(&invoiceId) 
attributeSet := graphmodels.FULL_ATTRIBUTESET 
requestBody.SetAttributeSet(&attributeSet) 

microsoftGraphPartnersBillingExport, err := graphClient.Reports().Partners().Billing().Usage().Billed().MicrosoftGraphPartnersBillingExport().Post(context.Background(), requestBody, nil)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


// 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);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


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);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\ExportPostRequestBody;


$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();

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


Import-Module Microsoft.Graph.Beta.Reports

$params = @{
	invoiceId = "G016907411"
	attributeSet = "full"
}

Export-MgBetaReportPartnerBillingUsageBilled -BodyParameter $params

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


from msgraph import GraphServiceClient
from msgraph.generated.reports.partners.billing.usage.billed.microsoft_graph_partners_billing_export.export_post_request_body import ExportPostRequestBody

graph_client = GraphServiceClient(credentials, scopes)

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)

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

Ниже приводится пример отклика.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14

billedUsage: export

Разрешения

HTTP-запрос

Заголовки запросов

Текст запроса

Отклик

Примеры

Запрос

Отклик

Обратная связь

Обратная связь

Дополнительные ресурсы