Espacio de nombres: microsoft.graph.partners.billing
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.
Exporte los datos de conciliación de facturas no facturados para un período de facturación específico y una moneda determinada.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global |
Gobierno de EE. UU. L4 |
Us Government L5 (DOD) |
China operada por 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso |
Permisos con privilegios mínimos |
Permisos con privilegios más altos |
| Delegado (cuenta profesional o educativa) |
PartnerBilling.Read.All |
No disponible. |
| Delegado (cuenta personal de Microsoft) |
No admitida. |
No admitida. |
| Aplicación |
PartnerBilling.Read.All |
No disponible. |
Solicitud HTTP
POST /reports/partners/billing/reconciliation/unbilled/export
| Nombre |
Descripción |
| Authorization |
{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Content-Type |
application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON de los parámetros.
En la tabla siguiente se muestran los parámetros que puede usar con esta acción.
| Parámetro |
Tipo |
Description |
| attributeSet |
microsoft.graph.partners.billing.attributeSet |
Atributos que se deben exportar. Los valores posibles son: full, basic, unknownFutureValue. El valor predeterminado es full. Elija full una respuesta completa o basic un subconjunto de atributos. Opcional. |
| billingPeriod |
microsoft.graph.partners.billing.billingPeriod |
Período de facturación de los datos de exportación. Los valores posibles son: current, last, unknownFutureValue. Elija current para el período de facturación actual y last para el último período de facturación. Obligatorio. |
| currencyCode |
Cadena |
Código de moneda para la facturación del asociado. Obligatorio. |
Respuesta
Si se ejecuta correctamente, este método 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 larga duración realizando una solicitud GET a esta dirección URL que devuelve uno de los siguientes objetos en el cuerpo de la respuesta: microsoft.graph.partners.billing.runningOperation, microsoft.graph.partners.billing.exportSuccessOperation o microsoft.graph.partners.billing.failedOperation.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
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);
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
// 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)
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
// 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);
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
const options = {
authProvider,
};
const client = Client.init(options);
const operation = {
attributeSet: 'full',
billingPeriod: 'current',
currencyCode: 'USD'
};
await client.api('/reports/partners/billing/reconciliation/unbilled/export')
.post(operation);
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
<?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();
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
# 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)
Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14