Namespace: microsoft.graph.partners.billing
Hinweis
Diese API ist nur für CSP-Partner (Cloud Solution Provider) verfügbar, um auf ihre abgerechneten und nicht abgerechneten Abstimmungsdaten für einen Mandanten zuzugreifen. Weitere Informationen zum CSP-Programm finden Sie unter Microsoft Cloud Solution Provider.
Exportieren Sie die abgerechneten Rechnungsabstimmungsdaten für einen bestimmten Abrechnungszeitraum und eine bestimmte Währung.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service |
US Government L4 |
US Government L5 (DOD) |
China, betrieben von 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp |
Berechtigungen mit den geringsten Berechtigungen |
Berechtigungen mit höheren Berechtigungen |
| Delegiert (Geschäfts-, Schul- oder Unikonto) |
PartnerBilling.Read.All |
Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) |
Nicht unterstützt |
Nicht unterstützt |
| Application |
PartnerBilling.Read.All |
Nicht verfügbar. |
HTTP-Anforderung
POST /reports/partners/billing/reconciliation/unbilled/export
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.
Die folgende Tabelle zeigt die Parameter, die Sie mit dieser Aktion verwenden können.
| Parameter |
Typ |
Beschreibung |
| attributeSet |
microsoft.graph.partners.billing.attributeSet |
Attribute, die exportiert werden sollen. Die möglichen Werte sind: full, basic, unknownFutureValue. Der Standardwert ist full. Wählen Sie full eine vollständige Antwort oder basic eine Teilmenge der Attribute aus. Optional. |
| billingPeriod |
microsoft.graph.partners.billing.billingPeriod |
Der Abrechnungszeitraum für die Exportdaten. Die möglichen Werte sind: current, last, unknownFutureValue. Wählen Sie current für den aktuellen Abrechnungszeitraum und last für den letzten Abrechnungszeitraum aus. Erforderlich. |
| currencyCode |
Zeichenfolge |
Der Währungscode für die Partnerabrechnung. Erforderlich. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der 202 Accepted Antwortcode und ein Location Header zurückgegeben, der die URL für den zeitintensiven Vorgang enthält. Sie können die status des zeitintensiven Vorgangs überprüfen, indem Sie eine GET-Anforderung an diese URL senden, die eines der folgenden Objekte im Antworttext zurückgibt: microsoft.graph.partners.billing.runningOperation, microsoft.graph.partners.billing.exportSuccessOperation oder microsoft.graph.partners.billing.failedOperation.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/v1.0/reports/partners/billing/reconciliation/unbilled/export
Content-Type: application/json
{
"attributeSet": "full",
"billingPeriod": "current",
"currencyCode": "USD"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Reports.Partners.Billing.Reconciliation.Unbilled.MicrosoftGraphPartnersBillingExport;
using Microsoft.Graph.Models.Partners.Billing;
var requestBody = new ExportPostRequestBody
{
AttributeSet = AttributeSet.Full,
BillingPeriod = BillingPeriod.Current,
CurrencyCode = "USD",
};
// 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.Reconciliation.Unbilled.MicrosoftGraphPartnersBillingExport.PostAsync(requestBody);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphreports "github.com/microsoftgraph/msgraph-sdk-go/reports"
graphmodelspartnersbilling "github.com/microsoftgraph/msgraph-sdk-go/models/partners/billing"
//other-imports
)
requestBody := graphreports.NewExportPostRequestBody()
attributeSet := graphmodels.FULL_ATTRIBUTESET
requestBody.SetAttributeSet(&attributeSet)
billingPeriod := graphmodels.CURRENT_BILLINGPERIOD
requestBody.SetBillingPeriod(&billingPeriod)
currencyCode := "USD"
requestBody.SetCurrencyCode(¤cyCode)
// 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().Reconciliation().Unbilled().MicrosoftGraphPartnersBillingExport().Post(context.Background(), requestBody, nil)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.reports.partners.billing.reconciliation.unbilled.microsoftgraphpartnersbillingexport.ExportPostRequestBody exportPostRequestBody = new com.microsoft.graph.reports.partners.billing.reconciliation.unbilled.microsoftgraphpartnersbillingexport.ExportPostRequestBody();
exportPostRequestBody.setAttributeSet(com.microsoft.graph.models.partners.billing.AttributeSet.Full);
exportPostRequestBody.setBillingPeriod(com.microsoft.graph.models.partners.billing.BillingPeriod.Current);
exportPostRequestBody.setCurrencyCode("USD");
var result = graphClient.reports().partners().billing().reconciliation().unbilled().microsoftGraphPartnersBillingExport().post(exportPostRequestBody);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Reports\Partners\Billing\Reconciliation\Unbilled\MicrosoftGraphPartnersBillingExport\ExportPostRequestBody;
use Microsoft\Graph\Generated\Models\Partners\Billing\AttributeSet;
use Microsoft\Graph\Generated\Models\Partners\Billing\BillingPeriod;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ExportPostRequestBody();
$requestBody->setAttributeSet(new AttributeSet('full'));
$requestBody->setBillingPeriod(new BillingPeriod('current'));
$requestBody->setCurrencyCode('USD');
$result = $graphServiceClient->reports()->partners()->billing()->reconciliation()->unbilled()->microsoftGraphPartnersBillingExport()->post($requestBody)->wait();
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.reports.partners.billing.reconciliation.unbilled.microsoft_graph_partners_billing_export.export_post_request_body import ExportPostRequestBody
from msgraph.generated.models.attribute_set import AttributeSet
from msgraph.generated.models.billing_period import BillingPeriod
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ExportPostRequestBody(
attribute_set = AttributeSet.Full,
billing_period = BillingPeriod.Current,
currency_code = "USD",
)
result = await graph_client.reports.partners.billing.reconciliation.unbilled.microsoft_graph_partners_billing_export.post(request_body)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14