From e8c6d9d46d73bc410267e1804ae14b1e96f10b1a Mon Sep 17 00:00:00 2001 From: Abhishek Singh Date: Wed, 17 Jan 2024 00:44:43 -0800 Subject: [PATCH 01/35] added doc for v1.0 release --- .../partners-billing-billedusage-export.md | 94 +++++++++ .../v1.0/api/partners-billing-manifest-get.md | 105 ++++++++++ .../api/partners-billing-operation-get.md | 186 ++++++++++++++++++ .../partners-billing-unbilledusage-export.md | 97 +++++++++ .../permissions/operation-get-permissions.md | 6 + .../permissions/partners-permissions.md | 6 + .../partners-billing-api-overview.md | 75 +++++++ .../partners-billing-attributeset.md | 94 +++++++++ .../resources/partners-billing-azureusage.md | 49 +++++ .../resources/partners-billing-billedusage.md | 48 +++++ .../resources/partners-billing-billing.md | 50 +++++ .../v1.0/resources/partners-billing-blob.md | 43 ++++ ...partners-billing-exportsuccessoperation.md | 55 ++++++ .../partners-billing-failedoperation.md | 55 ++++++ .../resources/partners-billing-manifest.md | 72 +++++++ .../resources/partners-billing-operation.md | 61 ++++++ .../partners-billing-runningoperation.md | 53 +++++ .../partners-billing-unbilledusage.md | 56 ++++++ api-reference/v1.0/resources/partners.md | 49 +++++ api-reference/v1.0/resources/reportroot.md | 1 + api-reference/v1.0/toc.yml | 28 +++ 21 files changed, 1283 insertions(+) create mode 100644 api-reference/v1.0/api/partners-billing-billedusage-export.md create mode 100644 api-reference/v1.0/api/partners-billing-manifest-get.md create mode 100644 api-reference/v1.0/api/partners-billing-operation-get.md create mode 100644 api-reference/v1.0/api/partners-billing-unbilledusage-export.md create mode 100644 api-reference/v1.0/includes/permissions/operation-get-permissions.md create mode 100644 api-reference/v1.0/includes/permissions/partners-permissions.md create mode 100644 api-reference/v1.0/resources/partners-billing-api-overview.md create mode 100644 api-reference/v1.0/resources/partners-billing-attributeset.md create mode 100644 api-reference/v1.0/resources/partners-billing-azureusage.md create mode 100644 api-reference/v1.0/resources/partners-billing-billedusage.md create mode 100644 api-reference/v1.0/resources/partners-billing-billing.md create mode 100644 api-reference/v1.0/resources/partners-billing-blob.md create mode 100644 api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md create mode 100644 api-reference/v1.0/resources/partners-billing-failedoperation.md create mode 100644 api-reference/v1.0/resources/partners-billing-manifest.md create mode 100644 api-reference/v1.0/resources/partners-billing-operation.md create mode 100644 api-reference/v1.0/resources/partners-billing-runningoperation.md create mode 100644 api-reference/v1.0/resources/partners-billing-unbilledusage.md create mode 100644 api-reference/v1.0/resources/partners.md diff --git a/api-reference/v1.0/api/partners-billing-billedusage-export.md b/api-reference/v1.0/api/partners-billing-billedusage-export.md new file mode 100644 index 00000000000..1accca76f88 --- /dev/null +++ b/api-reference/v1.0/api/partners-billing-billedusage-export.md @@ -0,0 +1,94 @@ +--- +title: "billedUsage: export" +description: "Export the billed Azure usage data." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: apiPageType +--- + +# billedUsage: export + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Export the billed Azure usage data. + +## Permissions + +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/partners-permissions.md)] + +## HTTP request + + +``` http +POST /reports/partners/billing/usage/billed/export +``` + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| + +## Request body + +In the request body, supply a JSON representation of the parameters. + +The following table shows the parameters that you can use with this action. + +|Parameter|Type|Description| +|:---|:---|:---| +|attributeSet|[microsoft.graph.partners.billing.attributeSet](../resources/partners-billing-attributeset.md)|Attributes that should be exported. Possible values are: `full`, `basic`, `unknownFutureValue`. The default value is `full`. Choose `full` for a complete response or `basic` for a subset of attributes. Optional.| +|invoiceId|String|The invoice ID for which the partner requested to export data. Required.| + +## Response + +If successful, this method returns a `202 Accepted` response code and a `Location` header that contains the URL to the long-running operation. You can check the status of the long-running operation by making a GET request to this URL that returns one of the following objects in the response body: [microsoft.graph.partners.billing.runningOperation](../resources/partners-billing-runningoperation.md), [microsoft.graph.partners.billing.exportSuccessOperation](../resources/partners-billing-exportsuccessoperation.md), or [microsoft.graph.partners.billing.failedOperation](../resources/partners-billing-failedoperation.md). + +## Examples + +### Request + +The following example shows a request. + + +``` http +POST https://graph.microsoft.com/beta/reports/partners/billing/usage/billed/export +Content-Type: application/json + +{ + "invoiceId" : "G016907411", + "attributeSet" : "full" +} +``` + +### Response + +The following example shows the response. + + +``` http +HTTP/1.1 202 OK +Location: https://graph.microsoft.com/beta/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14 +``` diff --git a/api-reference/v1.0/api/partners-billing-manifest-get.md b/api-reference/v1.0/api/partners-billing-manifest-get.md new file mode 100644 index 00000000000..a5e494f9d94 --- /dev/null +++ b/api-reference/v1.0/api/partners-billing-manifest-get.md @@ -0,0 +1,105 @@ +--- +title: "Get manifest" +description: "Read the properties and relationships of a manifest object." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: apiPageType +--- + +# Get manifest + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Read the properties and relationships of a [manifest](../resources/partners-billing-manifest.md) object. + +## Permissions + +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/partners-permissions.md)] + +## HTTP request + + +``` http +GET /reports/partners/billing/manifests/{id} +``` + +## Optional query parameters + +This method doesn't support any OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and a [microsoft.graph.partners.billing.manifest](../resources/partners-billing-manifest.md) object in the response body. + +## Examples + +### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/beta/reports/partners/billing/manifests/6fe687d7-1e0f-4bd6-9091-4672691f64bc +``` + +### Response + +The following example shows the response. + +>**Note:** The response object shown here might be shortened for readability. + + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "id": "6fe687d7-1e0f-4bd6-9091-4672691f64bc", + "schemaVersion": "1", + "dataFormat": "compressedJSON", + "createdDateTime": "2023-03-09T06:34:34.87Z", + "eTag": "WYjLro78HdMg6vUWR", + "partnerTenantId": "0e195b37-4574-4539-bc42-0e539b9684c0", + "rootDirectory": "https://adlsreconbuprodeastus201.blob.core.windows.net/billedusagefastpath/v1/PartnerTenantId=0e195b37-4574-4539-bc42-0e539b9684c0/BillingMonth=202310/InvoiceId=G031809528/InvoiceVersion=202311/Fragment=basic/PartitionType=default", + "sasToken": "skoid=0c414a25-fd23-4785-815f-1258467f9ab7&sktid=975f013f-7f24-47e8-a7d3-abc4752bf346&skt=2023-12-13T00%3A37%3A17Z&ske=2023-12-14T00%3A37%3A17Z&sks=b&skv=2021-08-06&sv=2021-08-06&se=2023-12-13T12%3A37%3A17Z&sr=d&sp=rl&sdd=7&sig=RpVY0WBGUHJ2APB3N76jtMak8loAWY4oiA0%2FaoJX1bM%3D", + "partitionType": "Default", + "blobCount": 1, + "blobs": [ + { + "name": "part-00049-b016029b-a7a7-4c46-9b5e-c925ac317ac6.c000.json.gz", + "partitionValue": "default" + } + ] +} +``` diff --git a/api-reference/v1.0/api/partners-billing-operation-get.md b/api-reference/v1.0/api/partners-billing-operation-get.md new file mode 100644 index 00000000000..44c94d67b46 --- /dev/null +++ b/api-reference/v1.0/api/partners-billing-operation-get.md @@ -0,0 +1,186 @@ +--- +title: "Get operation" +description: "Read the properties and relationships of an operation object." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: apiPageType +--- + +# Get operation + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Read the properties and relationships of an [operation](../resources/partners-billing-operation.md) object. + +## Permissions + +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/partners-permissions.md)] + +## HTTP request + + +``` http +GET /reports/partners/billing/operations/{id} +``` + +## Optional query parameters + +This method doesn't support any OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| + +## Request body + +Don't supply a request body for this method. + +## Response + +If an operation completes successfully, this method returns a `200 OK` response code and a [microsoft.graph.partners.billing.exportSuccessOperation](../resources/partners-billing-exportsuccessoperation.md) object in the response body. The **resourceLocation** navigation property in the response body represents the [microsoft.graph.partners.billing.manifest](../resources/partners-billing-manifest.md) resource for the operation. + +If an operation fails, this method returns a `200 OK` response code and a [microsoft.graph.partners.billing.failedOperation](../resources/partners-billing-failedoperation.md) object in the response body. + +If an operation is still running, this method returns a `200 OK` response code and a [microsoft.graph.partners.billing.runningOperation](../resources/partners-billing-runningoperation.md) object in the response body. + +## Examples + +### Example 1: Get operation succeeded + +#### Request + +The following example shows a request that returns a [microsoft.graph.partners.billing.exportSuccessOperation](../resources/partners-billing-exportsuccessoperation.md) object. + + +``` http +GET https://graph.microsoft.com/beta/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc +``` + +#### Response + +The following example shows the response for an operation that completed successfully. + +>**Note:** The response object shown here might be shortened for readability. + + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.partners.billing.exportSuccessOperation", + "id": "6fe687d7-1e0f-4bd6-9091-4672691f64bc", + "status": "succeeded", + "createdDateTime": "2023-03-09T08:12:53", + "lastActionDateTime": "2023-03-09T08:37:48.5046691Z", + "resourceLocation@odata.navigationLink": "https://graph.microsoft.com/beta/reports/partners/billing/manifests/8fe347d7-1e0f-4bd6-9091-4672691f32db" +} +``` + +### Example 2: Get operation failed + +#### Request + +The following example shows a request that returns a [microsoft.graph.partners.billing.failedOperation](../resources/partners-billing-failedoperation.md) object. + + +``` http +GET https://graph.microsoft.com/beta/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc +``` + +#### Response + +The following example shows the response for an operation that failed. + +>**Note:** The response object shown here might be shortened for readability. + + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.partners.billing.failedOperation", + "id": "6fe687d7-1e0f-4bd6-9091-4672691f64bc", + "status": "failed", + "createdDateTime": "2023-03-09T08:12:53", + "lastActionDateTime": "2023-03-09T08:37:48.5046691Z", + "error": { + "message": "No data available", + "code": "5000" + } +} +``` + +### Example 3: Get operation is still running + +#### Request + +The following example shows a request that returns a [microsoft.graph.partners.billing.runningOperation](../resources/partners-billing-runningoperation.md) object. + + +``` http +GET https://graph.microsoft.com/beta/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc +``` + +#### Response + +The following example shows the response for an operation that is still running. + +>**Note:** The response object shown here might be shortened for readability. + + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "@odata.type": "#microsoft.graph.partners.billing.runningOperation", + "id": "6fe687d7-1e0f-4bd6-9091-4672691f64bc", + "status": "running", + "createdDateTime": "2023-03-09T08:12:53", + "lastActionDateTime": "2023-03-09T08:37:48.5046691Z" +} +``` diff --git a/api-reference/v1.0/api/partners-billing-unbilledusage-export.md b/api-reference/v1.0/api/partners-billing-unbilledusage-export.md new file mode 100644 index 00000000000..94e452c521a --- /dev/null +++ b/api-reference/v1.0/api/partners-billing-unbilledusage-export.md @@ -0,0 +1,97 @@ +--- +title: "unbilledUsage: export" +description: "Export the unbilled Azure usage data for a specific billing period and a given currency." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: apiPageType +--- + +# unbilledUsage: export + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Export the unbilled Azure usage data for a specific billing period and a given currency. + +## Permissions + +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/partners-permissions.md)] + +## HTTP request + + +``` http +POST /reports/partners/billing/usage/unbilled/export +``` + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required.| +|Content-Type|application/json. Required.| + +## Request body + +In the request body, supply a JSON representation of the parameters. + +The following table shows the parameters that you can use with this action. + +|Parameter|Type|Description| +|:---|:---|:---| +|attributeSet|[microsoft.graph.partners.billing.attributeSet](../resources/partners-billing-attributeset.md)|Attributes that should be exported. Possible values are: `full`, `basic`, `unknownFutureValue`. The default value is `full`. Choose `full` for a complete response or `basic` for a subset of attributes. Optional.| +|billingPeriod|[microsoft.graph.partners.billing.billingPeriod](../resources/partners-billing-unbilledusage.md#billingperiod-values)|The billing period for the export data. Possible values are: `current`, `last`, `unknownFutureValue`. Choose `current` for the current billing period and `last` for the last billing period. Required.| +|currencyCode|String|The currency code for the partner billing. Required.| + +## Response + +If successful, this method returns a `202 Accepted` response code and a `Location` header that contains the URL to the long-running operation. You can check the status of the long-running operation by making a GET request to this URL that returns one of the following objects in the response body: [microsoft.graph.partners.billing.runningOperation](../resources/partners-billing-runningoperation.md), [microsoft.graph.partners.billing.exportSuccessOperation](../resources/partners-billing-exportsuccessoperation.md), or [microsoft.graph.partners.billing.failedOperation](../resources/partners-billing-failedoperation.md). + +## Examples + +### Request + +The following example shows a request. + + +``` http +POST https://graph.microsoft.com/beta/reports/partners/billing/usage/unbilled/export +Content-Type: application/json + +{ + "currencyCode": "USD", + "attributeSet": "full", + "billingPeriod": "current" +} +``` + +### Response + +The following example shows the response. + + +``` http +HTTP/1.1 202 Accepted +Content-Type: application/json +Location: https://graph.microsoft.com/beta/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14 +``` diff --git a/api-reference/v1.0/includes/permissions/operation-get-permissions.md b/api-reference/v1.0/includes/permissions/operation-get-permissions.md new file mode 100644 index 00000000000..0b40e599af1 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/operation-get-permissions.md @@ -0,0 +1,6 @@ +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|PartnerBilling.Read.All|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|PartnerBilling.Read.All|Not supported.| + diff --git a/api-reference/v1.0/includes/permissions/partners-permissions.md b/api-reference/v1.0/includes/permissions/partners-permissions.md new file mode 100644 index 00000000000..0b40e599af1 --- /dev/null +++ b/api-reference/v1.0/includes/permissions/partners-permissions.md @@ -0,0 +1,6 @@ +|Permission type|Least privileged permission|Higher privileged permissions| +|:---|:---|:---| +|Delegated (work or school account)|PartnerBilling.Read.All|Not supported.| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|PartnerBilling.Read.All|Not supported.| + diff --git a/api-reference/v1.0/resources/partners-billing-api-overview.md b/api-reference/v1.0/resources/partners-billing-api-overview.md new file mode 100644 index 00000000000..6a3ca84e9d7 --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-api-overview.md @@ -0,0 +1,75 @@ +--- +title: "Use the Microsoft Graph API to export partner billing data (preview)" +description: "The partner billing API in Microsoft Graph offers Microsoft direct partners a faster, more efficient way to export their high-volume billed and unbilled Azure usage data." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +ms.custom: zt-include +--- + +# Use the Microsoft Graph API to export partner billing data (preview) + +As part of the Microsoft Partner Center ecosystem, Microsoft direct partners in the Cloud Solution Provider programs can request to export their billed and unbilled data to Azure Blob Storage asynchronously. this removes the need to maintain an open connection for hours and loop through millions of transactions iteratively. The asynchronous API provides a way to quickly access billing and reconciliation data in manageable chunks. + +The partner billing API is defined in the OData subnamespace `microsoft.graph.partners.billing`. + +> [!NOTE] +> Daily-rated usage normally takes 24 hours to appear in the Microsoft Partner Center or to be available through the API. + +## Authorization + +To export reconciliation data, the calling principal must be in the partner tenant and be granted the appropriate partner billing privilege permissions. The partner billing API supports the following partner permissions. + +[!INCLUDE [permissions-table](../includes/permissions/partners-permissions.md)] + + + +[!INCLUDE [zero-trust](~/../azure_docs/includes/active-directory-zero-trust.md)] + + + + +## Common use cases + +The partner billing API provides methods and actions that allow Microsoft direct partners to export their high-volume billed and unbilled Azure usage data. + +### Billed reconciliation data + +| Use case | API | +|--|--| +| Create a new export operation to export billed reconciliation data | [billedUsage: export](../api/partners-billing-billedusage-export.md) | +| Poll for operation status update | [Get operation](../api/partners-billing-operation-get.md) | + +### Unbilled reconciliation data + +| Use case | API | +|--|--| +| Create a new export operation to export unbilled reconciliation data | [unbilledUsage: export](../api/partners-billing-unbilledusage-export.md) | +| Poll for operation status update | [Get operation](../api/partners-billing-operation-get.md) | + +## Asynchronous data retrieval + +The download of reconciliation data is a long-running operation that consists of the following operations. + +### Usage line-item endpoint + +Use the [billedUsage: export](../api/partners-billing-billedusage-export.md) or [unbilledUsage: export](../api/partners-billing-unbilledusage-export.md) API to access billed or unbilled consumption line items. The API returns a `202 Accepted` response code and a `Location` header that contains the URL to the long-running operation. You can check the status of the long-running operation by making a GET request at regular intervals until you receive a success status with a [manifest](../resources/partners-billing-manifest.md) URL. + +### Operation status endpoint + +Until you receive the success status, keep polling the [Get operation](../api/partners-billing-operation-get.md) API at regular intervals. If the requested data is unavailable, the API response includes a `Retry-After` header that indicates how long you should wait before sending another request. When the operation has completed successfully, the response also provides a [manifest](../resources/partners-billing-manifest.md) with details of the generated files. The manifest provides a storage folder from which actual billing data can be downloaded. The response splits or partitions the files to optimize throughput and I/O parallelism. + + + diff --git a/api-reference/v1.0/resources/partners-billing-attributeset.md b/api-reference/v1.0/resources/partners-billing-attributeset.md new file mode 100644 index 00000000000..fabd508c014 --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-attributeset.md @@ -0,0 +1,94 @@ +--- +title: "attributeSet enum type" +description: "Represents attributes for exported data sets in the Microsoft Graph partner billing API." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: enumPageTypes +--- + +# attributeSet enum type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents attributes for exported data sets in the Microsoft Graph partner billing API. The default value is `full`. Choose `full` for a complete response or `basic` for a subset of attributes. + +## Members + +| Member | Value | Description | +|:-------------------|:------|:-------------------------------------------------| +| full | 1 | All attributes in the exported data. | +| basic | 2 | Only basic attributes in the exported data. | +| unknownFutureValue | 3 | Evolvable enumeration sentinel value. Don't use. | + +### Attributes + +The [billedUsage: export](../api/partners-billing-billedusage-export.md) or [unbilledUsage: export](../api/partners-billing-unbilledusage-export.md) API response with the `full` or `basic` request parameter returns the following attributes. + +| Attribute | Full | Basic | +|:------------------------------|:-----|:------| +| AdditionalInfo | Yes | Yes | +| AvailabilityId | Yes | No | +| BenefitID | Yes | No | +| BenefitOrderID | Yes | Yes | +| BenefitType | Yes | Yes | +| BillingCurrency | Yes | Yes | +| BillingPreTaxTotal | Yes | Yes | +| ChargeEndDate | Yes | Yes | +| ChargeStartDate | Yes | Yes | +| ChargeType | Yes | Yes | +| ConsumedService | Yes | No | +| CreditPercentage | Yes | Yes | +| CreditType | Yes | Yes | +| CustomerCountry | Yes | No | +| CustomerDomainName | Yes | No | +| CustomerId | Yes | Yes | +| CustomerName | Yes | Yes | +| EffectiveUnitPrice | Yes | Yes | +| EntitlementDescription | Yes | No | +| EntitlementId | Yes | Yes | +| InvoiceNumber | Yes | Yes | +| MeterCategory | Yes | No | +| MeterId | Yes | No | +| MeterName | Yes | No | +| MeterRegion | Yes | No | +| MeterSubCategory | Yes | No | +| MeterType | Yes | No | +| MpnId | Yes | No | +| PartnerEarnedCreditPercentage | Yes | No | +| PartnerId | Yes | Yes | +| PartnerName | Yes | Yes | +| PCToBCExchangeRate | Yes | Yes | +| PricingCurrency | Yes | Yes | +| PricingPreTaxTotal | Yes | Yes | +| ProductId | Yes | Yes | +| ProductName | Yes | No | +| PublisherId | Yes | No | +| PublisherName | Yes | Yes | +| Quantity | Yes | Yes | +| ResourceGroup | Yes | No | +| ResourceLocation | Yes | No | +| ResourceURI | Yes | Yes | +| ServiceInfo1 | Yes | No | +| ServiceInfo2 | Yes | No | +| SkuId | Yes | Yes | +| SkuName | Yes | Yes | +| SubscriptionDescription | Yes | No | +| SubscriptionId | Yes | Yes | +| Tags | Yes | No | +| Tier2MpnId | Yes | No | +| Unit | Yes | No | +| UnitPrice | Yes | Yes | +| UnitType | Yes | Yes | +| UsageDate | Yes | Yes | + + diff --git a/api-reference/v1.0/resources/partners-billing-azureusage.md b/api-reference/v1.0/resources/partners-billing-azureusage.md new file mode 100644 index 00000000000..f07f6807953 --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-azureusage.md @@ -0,0 +1,49 @@ +--- +title: "azureUsage resource type" +description: "Represents details for billed and unbilled Azure usage data." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# azureUsage resource type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents details for billed and unbilled Azure usage data. + +## Methods + +None. + +## Properties + +None. + +## Relationships + +|Relationship|Type|Description| +|:---|:---|:---| +|billed|[microsoft.graph.partners.billing.billedUsage](partners-billing-billedusage.md)|Represents details for billed Azure usage data.| +|unbilled|[microsoft.graph.partners.billing.unbilledUsage](partners-billing-unbilledusage.md)|Represents details for unbilled Azure usage data.| + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "@odata.type": "#microsoft.graph.partners.billing.azureUsage" +} +``` diff --git a/api-reference/v1.0/resources/partners-billing-billedusage.md b/api-reference/v1.0/resources/partners-billing-billedusage.md new file mode 100644 index 00000000000..58ccc694c29 --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-billedusage.md @@ -0,0 +1,48 @@ +--- +title: "billedUsage resource type" +description: "Represents details for billed Azure usage data." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# billedUsage resource type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents details for billed Azure usage data. + +## Methods + +|Method|Return type|Description| +|:---|:---|:---| +|[export](../api/partners-billing-billedusage-export.md)|[microsoft.graph.partners.billing.operation](partners-billing-operation.md)|Export the billed Azure usage data.| + +## Properties + +None. + +## Relationships + +None. + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "@odata.type": "#microsoft.graph.partners.billing.billedUsage" +} +``` diff --git a/api-reference/v1.0/resources/partners-billing-billing.md b/api-reference/v1.0/resources/partners-billing-billing.md new file mode 100644 index 00000000000..5f53b92a55f --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-billing.md @@ -0,0 +1,50 @@ +--- +title: "billing resource type" +description: "Represents billing details for billed and unbilled data." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# billing resource type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents billing details for billed and unbilled data. + +## Methods + +None. + +## Properties + +None. + +## Relationships + +|Relationship|Type|Description| +|:---|:---|:---| +|manifests|[microsoft.graph.partners.billing.manifest](partners-billing-manifest.md) collection|Represents metadata for the exported data.| +|operations|[microsoft.graph.partners.billing.operation](partners-billing-operation.md) collection|Represents an operation to export the billing data of a partner.| +|usage|[microsoft.graph.partners.billing.azureUsage](partners-billing-azureusage.md)|Represents details for billed and unbilled Azure usage data.| + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "@odata.type": "#microsoft.graph.partners.billing.billing" +} +``` diff --git a/api-reference/v1.0/resources/partners-billing-blob.md b/api-reference/v1.0/resources/partners-billing-blob.md new file mode 100644 index 00000000000..2fd3313dfd3 --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-blob.md @@ -0,0 +1,43 @@ +--- +title: "blob resource type" +description: "Represents a billing blob that contains exported data." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# blob resource type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents a billing blob that contains exported data. + +## Properties + +|Property|Type|Description| +|:---|:---|:---| +|name|String|The blob name.| +|partitionValue|String|The partition that contains the file. A large partition is split into multiple files, each with the same **partitionValue**.| + +## Relationships + +None. + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "name": "String", + "partitionValue": "String" +} +``` diff --git a/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md b/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md new file mode 100644 index 00000000000..583c3c46f03 --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md @@ -0,0 +1,55 @@ +--- +title: "exportSuccessOperation resource type" +description: "Represents an export operation that is completed successfully." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# exportSuccessOperation resource type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents an export operation that is completed successfully. + +Inherits from [operation](../resources/partners-billing-operation.md). + +## Properties + +|Property|Type|Description| +|:---|:---|:---| +|createdDateTime|DateTimeOffset|The start time of the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [operation](../resources/partners-billing-operation.md).| +|id|String|The unique identifier for the **exportSuccessOperation**. Inherited from [operation](../resources/partners-billing-operation.md).| +|lastActionDateTime|DateTimeOffset|The time of the last action of the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [operation](../resources/partners-billing-operation.md).| +|status|microsoft.graph.longRunningOperationStatus|The status of the operation. Supports a subset of the values for **longRunningOperationStatus**. Possible value is: `completed`. Inherited from [operation](../resources/partners-billing-operation.md).| + +## Relationships + +|Relationship|Type|Description| +|:---|:---|:---| +|resourceLocation|[microsoft.graph.partners.billing.manifest](../resources/partners-billing-manifest.md)|Metadata for the exported files.| + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "@odata.type": "#microsoft.graph.partners.billing.exportSuccessOperation", + "createdDateTime": "String (timestamp)", + "id": "String (identifier)", + "lastActionDateTime": "String (timestamp)", + "status": "String" +} +``` diff --git a/api-reference/v1.0/resources/partners-billing-failedoperation.md b/api-reference/v1.0/resources/partners-billing-failedoperation.md new file mode 100644 index 00000000000..526db2fef3b --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-failedoperation.md @@ -0,0 +1,55 @@ +--- +title: "failedOperation resource type" +description: "Represents an export operation that failed to complete." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# failedOperation resource type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents an export operation that failed to complete. + +Inherits from [operation](../resources/partners-billing-operation.md). + +## Properties + +|Property|Type|Description| +|:---|:---|:---| +|createdDateTime|DateTimeOffset|The start time of the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [operation](../resources/partners-billing-operation.md).| +|id|String|The unique identifier for the **failedOperation**. Inherited from [operation](../resources/partners-billing-operation.md).| +|lastActionDateTime|DateTimeOffset|The time of the last action of the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [operation](../resources/partners-billing-operation.md).| +|status|microsoft.graph.longRunningOperationStatus|The status of the operation. Supports a subset of the values for **longRunningOperationStatus**. Possible value is: `failed`. Inherited from [operation](../resources/partners-billing-operation.md).| + +## Relationships + +|Relationship|Type|Description| +|:---|:---|:---| +|error|[microsoft.graph.publicError](../resources/publicerror.md)|Information about the error that caused the failure.| + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "@odata.type": "#microsoft.graph.partners.billing.failedOperation", + "createdDateTime": "String (timestamp)", + "id": "String (identifier)", + "lastActionDateTime": "String (timestamp)", + "status": "String" +} +``` diff --git a/api-reference/v1.0/resources/partners-billing-manifest.md b/api-reference/v1.0/resources/partners-billing-manifest.md new file mode 100644 index 00000000000..9c3e803eaba --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-manifest.md @@ -0,0 +1,72 @@ +--- +title: "manifest resource type" +description: "Represents metadata for the exported data." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# manifest resource type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents metadata for the exported data. Use the metadata to get details of the file you want to download from an Azure Blob Storage. + +Inherits from [entity](../resources/entity.md). + +## Methods + +|Method|Return type|Description| +|:---|:---|:---| +|[Get manifest](../api/partners-billing-manifest-get.md)|[microsoft.graph.partners.billing.manifest](../resources/partners-billing-manifest.md)|Read the properties and relationships of a [manifest](../resources/partners-billing-manifest.md) object.| + +## Properties + +|Property|Type|Description| +|:---|:---|:---| +|blobCount|Int32|The total file count for this partner tenant ID.| +|blobs|[microsoft.graph.partners.billing.blob](../resources/partners-billing-blob.md) collection|A collection of blob objects that contain details of all the files for the partner tenant ID.| +|createdDateTime|DateTimeOffset|The date and time when a manifest resource was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|dataFormat|String|The billing data file format. The possible value is: `compressedJSONLines`. Each blob is a compressed file and data in the file is in [JSON lines](https://jsonlines.org/) format. Decompress the file to access the data.| +|eTag|String|Version of data represented by the manifest. Any change in **eTag** indicates a new data version.| +|id|String|The unique identifier for the **manifest**. Inherited from [entity](../resources/entity.md).| +|partitionType|String|Indicates the division of data. If a given partition has more than the supported number, the data is split into multiple files, each file representing a specific **partitionValue**. By default, the data in the file is partitioned by the number of line items.| +|partnerTenantId|String|The Microsoft Entra tenant ID of the partner.| +|rootDirectory|String|The root directory that contains all the files.| +|sasToken|String|The SAS token for accessing the directory or an individual file in the directory.| +|schemaVersion|String|The version of the manifest schema.| + +## Relationships + +None. + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "blobCount": "Int32", + "blobs": [{"@odata.type": "microsoft.graph.partners.billing.blob"}], + "createdDateTime": "String (timestamp)", + "dataFormat": "String", + "eTag": "String", + "id": "String (identifier)", + "partitionType": "String", + "partnerTenantId": "String", + "rootDirectory": "String", + "sasToken": "String", + "schemaVersion": "String" +} +``` diff --git a/api-reference/v1.0/resources/partners-billing-operation.md b/api-reference/v1.0/resources/partners-billing-operation.md new file mode 100644 index 00000000000..b70bdeb89c3 --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-operation.md @@ -0,0 +1,61 @@ +--- +title: "operation resource type" +description: "Represents an operation to export the billing data of a partner." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# operation resource type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents an operation to export the billing data of a partner. + +Base type of [exportSuccessOperation](../resources/partners-billing-exportsuccessoperation.md), [failedOperation](../resources/partners-billing-failedoperation.md), and [runningOperation](../resources/partners-billing-runningoperation.md). + +Inherits from [entity](../resources/entity.md). + +## Methods + +|Method|Return type|Description| +|:---|:---|:---| +|[Get operation](../api/partners-billing-operation-get.md)|[microsoft.graph.partners.billing.operation](../resources/partners-billing-operation.md)|Read the properties and relationships of an [operation](../resources/partners-billing-operation.md) object.| + +## Properties + +|Property|Type|Description| +|:---|:---|:---| +|createdDateTime|DateTimeOffset|The start time of the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|id|String|The unique identifier for the **operation**. Inherited from [entity](../resources/partners-billing-operation.md).| +|lastActionDateTime|DateTimeOffset|The time of the last action of the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +|status|microsoft.graph.longRunningOperationStatus|The status of the operation. Possible values are: `notStarted`, `running`, `completed`, `failed`, `unknownFutureValue`.| + +## Relationships + +None. + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "@odata.type": "#microsoft.graph.partners.billing.operation", + "createdDateTime": "String (timestamp)", + "id": "String (identifier)", + "lastActionDateTime": "String (timestamp)", + "status": "String" +} +``` diff --git a/api-reference/v1.0/resources/partners-billing-runningoperation.md b/api-reference/v1.0/resources/partners-billing-runningoperation.md new file mode 100644 index 00000000000..eaab0c3d9d1 --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-runningoperation.md @@ -0,0 +1,53 @@ +--- +title: "runningOperation resource type" +description: "Represents an export operation that is still running, which indicates that the files aren't ready yet." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# runningOperation resource type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents an export operation that is still running, which indicates that the files aren't ready yet. + +Inherits from [operation](../resources/partners-billing-operation.md). + +## Properties + +|Property|Type|Description| +|:---|:---|:---| +|createdDateTime|DateTimeOffset|The start time of the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [operation](../resources/partners-billing-operation.md).| +|id|String|The unique identifier for the **runningOperation**. Inherited from [operation](../resources/partners-billing-operation.md).| +|lastActionDateTime|DateTimeOffset|The time of the last action of the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [operation](../resources/partners-billing-operation.md).| +|status|microsoft.graph.longRunningOperationStatus|The status of the operation. Supports a subset of the values for **longRunningOperationStatus**. Possible values are: `notStarted`, `running`. Inherited from [operation](../resources/partners-billing-operation.md).| + +## Relationships + +None. + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "@odata.type": "#microsoft.graph.partners.billing.runningOperation", + "createdDateTime": "String (timestamp)", + "id": "String (identifier)", + "lastActionDateTime": "String (timestamp)", + "status": "String" +} +``` diff --git a/api-reference/v1.0/resources/partners-billing-unbilledusage.md b/api-reference/v1.0/resources/partners-billing-unbilledusage.md new file mode 100644 index 00000000000..e76760437e8 --- /dev/null +++ b/api-reference/v1.0/resources/partners-billing-unbilledusage.md @@ -0,0 +1,56 @@ +--- +title: "unbilledUsage resource type" +description: "Represents details for unbilled Azure usage data." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# unbilledUsage resource type + +Namespace: microsoft.graph.partners.billing + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents details for unbilled Azure usage data. + +## Methods + +|Method|Return type|Description| +|:---|:---|:---| +|[export](../api/partners-billing-unbilledusage-export.md)|[microsoft.graph.partners.billing.operation](partners-billing-operation.md)|Export the unbilled Azure usage data for a specific billing period and a given currency.| + +## Properties + +None. + +### billingPeriod values + +| Member | Description | +|:-------------------|:-------------------------------------------------| +| current | The current billing period. | +| last | The billing period for the last month. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | + +## Relationships + +None. + +## JSON representation + +The following JSON representation shows the resource type. + + +``` json +{ + "@odata.type": "#microsoft.graph.partners.billing.unbilledUsage" +} +``` diff --git a/api-reference/v1.0/resources/partners.md b/api-reference/v1.0/resources/partners.md new file mode 100644 index 00000000000..f106d8819ea --- /dev/null +++ b/api-reference/v1.0/resources/partners.md @@ -0,0 +1,49 @@ +--- +title: "partners resource type" +description: "Represents billing details for a Microsoft direct partner." +author: "abhishek-singh-ms" +ms.localizationpriority: medium +ms.prod: "reports" +doc_type: resourcePageType +--- + +# partners resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents billing details for a Microsoft direct partner. + +## Methods + +None. + +## Properties + +None. + +## Relationships + +|Relationship|Type|Description| +|:---|:---|:---| +|billing|[microsoft.graph.partners.billing.billing](partners-billing-billing.md)|Represents billing details for billed and unbilled data.| + +## JSON representation + +The following JSON representation shows the resource type. + + + +``` json +{ + "@odata.type": "#microsoft.graph.partners" +} +``` diff --git a/api-reference/v1.0/resources/reportroot.md b/api-reference/v1.0/resources/reportroot.md index 5c3215c743b..db3a6657358 100644 --- a/api-reference/v1.0/resources/reportroot.md +++ b/api-reference/v1.0/resources/reportroot.md @@ -34,6 +34,7 @@ None. | monthlyPrintUsageByPrinter | [printUsageByPrinter](../resources/printusagebyprinter.md) collection | Retrieve a list of monthly print usage summaries, grouped by printer. | | monthlyPrintUsageByUser | [printUsageByUser](../resources/printusagebyuser.md) collection | Retrieve a list of monthly print usage summaries, grouped by user. | | security | [securityReportsRoot](../resources/securityreportsroot.md) | Represents an abstract type that contains resources for attack simulation and training reports. | +| partners | [partners](../resources/partners.md) | Represents billing details for a Microsoft direct partner. | ## JSON representation diff --git a/api-reference/v1.0/toc.yml b/api-reference/v1.0/toc.yml index e0322738fac..85145c38eff 100644 --- a/api-reference/v1.0/toc.yml +++ b/api-reference/v1.0/toc.yml @@ -7543,6 +7543,34 @@ items: href: resources/attacksimulationtrainingusercoverage.md - name: Get training coverage for users href: api/securityreportsroot-getattacksimulationtrainingusercoverage.md + - name: Partner billing reports + items: + - name: Overview + href: resources/partners-billing-api-overview.md + - name: Billed usage + items: + - name: Billed usage + href: resources/partners-billing-billedusage.md + - name: Export + href: api/partners-billing-billedusage-export.md + - name: Manifest + items: + - name: Manifest + href: resources/partners-billing-manifest.md + - name: Get + href: api/partners-billing-manifest-get.md + - name: Operation + items: + - name: Operation + href: resources/partners-billing-operation.md + - name: Get + href: api/partners-billing-operation-get.md + - name: Unbilled usage + items: + - name: Unbilled usage + href: resources/partners-billing-unbilledusage.md + - name: Export + href: api/partners-billing-unbilledusage-export.md - name: Search items: - name: Query From c1e1805b0c949c5607bd88ed3cc9fc292eb025ff Mon Sep 17 00:00:00 2001 From: Abhishek Singh Date: Wed, 17 Jan 2024 11:32:33 -0800 Subject: [PATCH 02/35] removed beta references --- .../v1.0/api/partners-billing-billedusage-export.md | 6 ++---- api-reference/v1.0/api/partners-billing-manifest-get.md | 3 +-- api-reference/v1.0/api/partners-billing-operation-get.md | 9 ++++----- .../v1.0/api/partners-billing-unbilledusage-export.md | 6 ++---- .../v1.0/resources/partners-billing-api-overview.md | 4 ++-- .../v1.0/resources/partners-billing-attributeset.md | 1 - .../v1.0/resources/partners-billing-azureusage.md | 1 - .../v1.0/resources/partners-billing-billedusage.md | 1 - api-reference/v1.0/resources/partners-billing-billing.md | 2 -- api-reference/v1.0/resources/partners-billing-blob.md | 1 - .../resources/partners-billing-exportsuccessoperation.md | 1 - .../v1.0/resources/partners-billing-failedoperation.md | 1 - .../v1.0/resources/partners-billing-manifest.md | 1 - .../v1.0/resources/partners-billing-operation.md | 1 - .../v1.0/resources/partners-billing-runningoperation.md | 1 - .../v1.0/resources/partners-billing-unbilledusage.md | 1 - api-reference/v1.0/resources/partners.md | 1 - 17 files changed, 11 insertions(+), 30 deletions(-) diff --git a/api-reference/v1.0/api/partners-billing-billedusage-export.md b/api-reference/v1.0/api/partners-billing-billedusage-export.md index 1accca76f88..ac58d9a1e1c 100644 --- a/api-reference/v1.0/api/partners-billing-billedusage-export.md +++ b/api-reference/v1.0/api/partners-billing-billedusage-export.md @@ -11,8 +11,6 @@ doc_type: apiPageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - Export the billed Azure usage data. ## Permissions @@ -70,7 +68,7 @@ The following example shows a request. } --> ``` http -POST https://graph.microsoft.com/beta/reports/partners/billing/usage/billed/export +POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export Content-Type: application/json { @@ -90,5 +88,5 @@ The following example shows the response. --> ``` http HTTP/1.1 202 OK -Location: https://graph.microsoft.com/beta/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14 +Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14 ``` diff --git a/api-reference/v1.0/api/partners-billing-manifest-get.md b/api-reference/v1.0/api/partners-billing-manifest-get.md index a5e494f9d94..54b9815ea87 100644 --- a/api-reference/v1.0/api/partners-billing-manifest-get.md +++ b/api-reference/v1.0/api/partners-billing-manifest-get.md @@ -11,7 +11,6 @@ doc_type: apiPageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Read the properties and relationships of a [manifest](../resources/partners-billing-manifest.md) object. @@ -65,7 +64,7 @@ The following example shows a request. } --> ``` http -GET https://graph.microsoft.com/beta/reports/partners/billing/manifests/6fe687d7-1e0f-4bd6-9091-4672691f64bc +GET https://graph.microsoft.com/v1.0/reports/partners/billing/manifests/6fe687d7-1e0f-4bd6-9091-4672691f64bc ``` ### Response diff --git a/api-reference/v1.0/api/partners-billing-operation-get.md b/api-reference/v1.0/api/partners-billing-operation-get.md index 44c94d67b46..afe6c6bd5e2 100644 --- a/api-reference/v1.0/api/partners-billing-operation-get.md +++ b/api-reference/v1.0/api/partners-billing-operation-get.md @@ -11,7 +11,6 @@ doc_type: apiPageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Read the properties and relationships of an [operation](../resources/partners-billing-operation.md) object. @@ -72,7 +71,7 @@ The following example shows a request that returns a [microsoft.graph.partners.b } --> ``` http -GET https://graph.microsoft.com/beta/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc +GET https://graph.microsoft.com/v1.0/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc ``` #### Response @@ -97,7 +96,7 @@ Content-Type: application/json "status": "succeeded", "createdDateTime": "2023-03-09T08:12:53", "lastActionDateTime": "2023-03-09T08:37:48.5046691Z", - "resourceLocation@odata.navigationLink": "https://graph.microsoft.com/beta/reports/partners/billing/manifests/8fe347d7-1e0f-4bd6-9091-4672691f32db" + "resourceLocation@odata.navigationLink": "https://graph.microsoft.com/v1.0/reports/partners/billing/manifests/8fe347d7-1e0f-4bd6-9091-4672691f32db" } ``` @@ -113,7 +112,7 @@ The following example shows a request that returns a [microsoft.graph.partners.b } --> ``` http -GET https://graph.microsoft.com/beta/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc +GET https://graph.microsoft.com/v1.0/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc ``` #### Response @@ -157,7 +156,7 @@ The following example shows a request that returns a [microsoft.graph.partners.b } --> ``` http -GET https://graph.microsoft.com/beta/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc +GET https://graph.microsoft.com/v1.0/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc ``` #### Response diff --git a/api-reference/v1.0/api/partners-billing-unbilledusage-export.md b/api-reference/v1.0/api/partners-billing-unbilledusage-export.md index 94e452c521a..f933f389b9f 100644 --- a/api-reference/v1.0/api/partners-billing-unbilledusage-export.md +++ b/api-reference/v1.0/api/partners-billing-unbilledusage-export.md @@ -11,8 +11,6 @@ doc_type: apiPageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - Export the unbilled Azure usage data for a specific billing period and a given currency. ## Permissions @@ -71,7 +69,7 @@ The following example shows a request. } --> ``` http -POST https://graph.microsoft.com/beta/reports/partners/billing/usage/unbilled/export +POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export Content-Type: application/json { @@ -93,5 +91,5 @@ The following example shows the response. ``` http HTTP/1.1 202 Accepted Content-Type: application/json -Location: https://graph.microsoft.com/beta/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14 +Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14 ``` diff --git a/api-reference/v1.0/resources/partners-billing-api-overview.md b/api-reference/v1.0/resources/partners-billing-api-overview.md index 6a3ca84e9d7..9a118e35f49 100644 --- a/api-reference/v1.0/resources/partners-billing-api-overview.md +++ b/api-reference/v1.0/resources/partners-billing-api-overview.md @@ -1,5 +1,5 @@ --- -title: "Use the Microsoft Graph API to export partner billing data (preview)" +title: "Use the Microsoft Graph API to export partner billing data" description: "The partner billing API in Microsoft Graph offers Microsoft direct partners a faster, more efficient way to export their high-volume billed and unbilled Azure usage data." author: "abhishek-singh-ms" ms.localizationpriority: medium @@ -8,7 +8,7 @@ doc_type: resourcePageType ms.custom: zt-include --- -# Use the Microsoft Graph API to export partner billing data (preview) +# Use the Microsoft Graph API to export partner billing data As part of the Microsoft Partner Center ecosystem, Microsoft direct partners in the Cloud Solution Provider programs can request to export their billed and unbilled data to Azure Blob Storage asynchronously. this removes the need to maintain an open connection for hours and loop through millions of transactions iteratively. The asynchronous API provides a way to quickly access billing and reconciliation data in manageable chunks. diff --git a/api-reference/v1.0/resources/partners-billing-attributeset.md b/api-reference/v1.0/resources/partners-billing-attributeset.md index fabd508c014..d009de74689 100644 --- a/api-reference/v1.0/resources/partners-billing-attributeset.md +++ b/api-reference/v1.0/resources/partners-billing-attributeset.md @@ -11,7 +11,6 @@ doc_type: enumPageTypes Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents attributes for exported data sets in the Microsoft Graph partner billing API. The default value is `full`. Choose `full` for a complete response or `basic` for a subset of attributes. diff --git a/api-reference/v1.0/resources/partners-billing-azureusage.md b/api-reference/v1.0/resources/partners-billing-azureusage.md index f07f6807953..aa2a5fad3e6 100644 --- a/api-reference/v1.0/resources/partners-billing-azureusage.md +++ b/api-reference/v1.0/resources/partners-billing-azureusage.md @@ -11,7 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents details for billed and unbilled Azure usage data. diff --git a/api-reference/v1.0/resources/partners-billing-billedusage.md b/api-reference/v1.0/resources/partners-billing-billedusage.md index 58ccc694c29..228c417a9ce 100644 --- a/api-reference/v1.0/resources/partners-billing-billedusage.md +++ b/api-reference/v1.0/resources/partners-billing-billedusage.md @@ -11,7 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents details for billed Azure usage data. diff --git a/api-reference/v1.0/resources/partners-billing-billing.md b/api-reference/v1.0/resources/partners-billing-billing.md index 5f53b92a55f..0ff9d2b85c7 100644 --- a/api-reference/v1.0/resources/partners-billing-billing.md +++ b/api-reference/v1.0/resources/partners-billing-billing.md @@ -11,8 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - Represents billing details for billed and unbilled data. ## Methods diff --git a/api-reference/v1.0/resources/partners-billing-blob.md b/api-reference/v1.0/resources/partners-billing-blob.md index 2fd3313dfd3..b6f9bd8bcc6 100644 --- a/api-reference/v1.0/resources/partners-billing-blob.md +++ b/api-reference/v1.0/resources/partners-billing-blob.md @@ -11,7 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents a billing blob that contains exported data. diff --git a/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md b/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md index 583c3c46f03..d12a4068bd6 100644 --- a/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md +++ b/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md @@ -11,7 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents an export operation that is completed successfully. diff --git a/api-reference/v1.0/resources/partners-billing-failedoperation.md b/api-reference/v1.0/resources/partners-billing-failedoperation.md index 526db2fef3b..dda029503cd 100644 --- a/api-reference/v1.0/resources/partners-billing-failedoperation.md +++ b/api-reference/v1.0/resources/partners-billing-failedoperation.md @@ -11,7 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents an export operation that failed to complete. diff --git a/api-reference/v1.0/resources/partners-billing-manifest.md b/api-reference/v1.0/resources/partners-billing-manifest.md index 9c3e803eaba..8998777080c 100644 --- a/api-reference/v1.0/resources/partners-billing-manifest.md +++ b/api-reference/v1.0/resources/partners-billing-manifest.md @@ -11,7 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents metadata for the exported data. Use the metadata to get details of the file you want to download from an Azure Blob Storage. diff --git a/api-reference/v1.0/resources/partners-billing-operation.md b/api-reference/v1.0/resources/partners-billing-operation.md index b70bdeb89c3..e0c741ae3e4 100644 --- a/api-reference/v1.0/resources/partners-billing-operation.md +++ b/api-reference/v1.0/resources/partners-billing-operation.md @@ -11,7 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents an operation to export the billing data of a partner. diff --git a/api-reference/v1.0/resources/partners-billing-runningoperation.md b/api-reference/v1.0/resources/partners-billing-runningoperation.md index eaab0c3d9d1..7834e28c41c 100644 --- a/api-reference/v1.0/resources/partners-billing-runningoperation.md +++ b/api-reference/v1.0/resources/partners-billing-runningoperation.md @@ -11,7 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents an export operation that is still running, which indicates that the files aren't ready yet. diff --git a/api-reference/v1.0/resources/partners-billing-unbilledusage.md b/api-reference/v1.0/resources/partners-billing-unbilledusage.md index e76760437e8..fa6cfbc94aa 100644 --- a/api-reference/v1.0/resources/partners-billing-unbilledusage.md +++ b/api-reference/v1.0/resources/partners-billing-unbilledusage.md @@ -11,7 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents details for unbilled Azure usage data. diff --git a/api-reference/v1.0/resources/partners.md b/api-reference/v1.0/resources/partners.md index f106d8819ea..60070589f7b 100644 --- a/api-reference/v1.0/resources/partners.md +++ b/api-reference/v1.0/resources/partners.md @@ -11,7 +11,6 @@ doc_type: resourcePageType Namespace: microsoft.graph -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Represents billing details for a Microsoft direct partner. From 7e6fa68153246759b0aa609574a0c97d2766364f Mon Sep 17 00:00:00 2001 From: Abhishek Singh Date: Thu, 18 Jan 2024 11:59:07 -0800 Subject: [PATCH 03/35] updated author --- api-reference/v1.0/api/partners-billing-billedusage-export.md | 2 +- api-reference/v1.0/api/partners-billing-manifest-get.md | 2 +- api-reference/v1.0/api/partners-billing-operation-get.md | 2 +- api-reference/v1.0/api/partners-billing-unbilledusage-export.md | 2 +- api-reference/v1.0/resources/partners-billing-api-overview.md | 2 +- api-reference/v1.0/resources/partners-billing-attributeset.md | 2 +- api-reference/v1.0/resources/partners-billing-azureusage.md | 2 +- api-reference/v1.0/resources/partners-billing-billedusage.md | 2 +- api-reference/v1.0/resources/partners-billing-billing.md | 2 +- api-reference/v1.0/resources/partners-billing-blob.md | 2 +- .../v1.0/resources/partners-billing-exportsuccessoperation.md | 2 +- .../v1.0/resources/partners-billing-failedoperation.md | 2 +- api-reference/v1.0/resources/partners-billing-manifest.md | 2 +- api-reference/v1.0/resources/partners-billing-operation.md | 2 +- .../v1.0/resources/partners-billing-runningoperation.md | 2 +- api-reference/v1.0/resources/partners-billing-unbilledusage.md | 2 +- api-reference/v1.0/resources/partners.md | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/api-reference/v1.0/api/partners-billing-billedusage-export.md b/api-reference/v1.0/api/partners-billing-billedusage-export.md index ac58d9a1e1c..bd4a9cc9e40 100644 --- a/api-reference/v1.0/api/partners-billing-billedusage-export.md +++ b/api-reference/v1.0/api/partners-billing-billedusage-export.md @@ -1,7 +1,7 @@ --- title: "billedUsage: export" description: "Export the billed Azure usage data." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: apiPageType diff --git a/api-reference/v1.0/api/partners-billing-manifest-get.md b/api-reference/v1.0/api/partners-billing-manifest-get.md index 54b9815ea87..cfea610c607 100644 --- a/api-reference/v1.0/api/partners-billing-manifest-get.md +++ b/api-reference/v1.0/api/partners-billing-manifest-get.md @@ -1,7 +1,7 @@ --- title: "Get manifest" description: "Read the properties and relationships of a manifest object." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: apiPageType diff --git a/api-reference/v1.0/api/partners-billing-operation-get.md b/api-reference/v1.0/api/partners-billing-operation-get.md index afe6c6bd5e2..1c0da34031d 100644 --- a/api-reference/v1.0/api/partners-billing-operation-get.md +++ b/api-reference/v1.0/api/partners-billing-operation-get.md @@ -1,7 +1,7 @@ --- title: "Get operation" description: "Read the properties and relationships of an operation object." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: apiPageType diff --git a/api-reference/v1.0/api/partners-billing-unbilledusage-export.md b/api-reference/v1.0/api/partners-billing-unbilledusage-export.md index f933f389b9f..32fb187ee49 100644 --- a/api-reference/v1.0/api/partners-billing-unbilledusage-export.md +++ b/api-reference/v1.0/api/partners-billing-unbilledusage-export.md @@ -1,7 +1,7 @@ --- title: "unbilledUsage: export" description: "Export the unbilled Azure usage data for a specific billing period and a given currency." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: apiPageType diff --git a/api-reference/v1.0/resources/partners-billing-api-overview.md b/api-reference/v1.0/resources/partners-billing-api-overview.md index 9a118e35f49..8b03a45a1eb 100644 --- a/api-reference/v1.0/resources/partners-billing-api-overview.md +++ b/api-reference/v1.0/resources/partners-billing-api-overview.md @@ -1,7 +1,7 @@ --- title: "Use the Microsoft Graph API to export partner billing data" description: "The partner billing API in Microsoft Graph offers Microsoft direct partners a faster, more efficient way to export their high-volume billed and unbilled Azure usage data." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners-billing-attributeset.md b/api-reference/v1.0/resources/partners-billing-attributeset.md index d009de74689..e48ba9b7e50 100644 --- a/api-reference/v1.0/resources/partners-billing-attributeset.md +++ b/api-reference/v1.0/resources/partners-billing-attributeset.md @@ -1,7 +1,7 @@ --- title: "attributeSet enum type" description: "Represents attributes for exported data sets in the Microsoft Graph partner billing API." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: enumPageTypes diff --git a/api-reference/v1.0/resources/partners-billing-azureusage.md b/api-reference/v1.0/resources/partners-billing-azureusage.md index aa2a5fad3e6..b6765cd7f04 100644 --- a/api-reference/v1.0/resources/partners-billing-azureusage.md +++ b/api-reference/v1.0/resources/partners-billing-azureusage.md @@ -1,7 +1,7 @@ --- title: "azureUsage resource type" description: "Represents details for billed and unbilled Azure usage data." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners-billing-billedusage.md b/api-reference/v1.0/resources/partners-billing-billedusage.md index 228c417a9ce..ce376fec301 100644 --- a/api-reference/v1.0/resources/partners-billing-billedusage.md +++ b/api-reference/v1.0/resources/partners-billing-billedusage.md @@ -1,7 +1,7 @@ --- title: "billedUsage resource type" description: "Represents details for billed Azure usage data." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners-billing-billing.md b/api-reference/v1.0/resources/partners-billing-billing.md index 0ff9d2b85c7..f06d5b8d5f6 100644 --- a/api-reference/v1.0/resources/partners-billing-billing.md +++ b/api-reference/v1.0/resources/partners-billing-billing.md @@ -1,7 +1,7 @@ --- title: "billing resource type" description: "Represents billing details for billed and unbilled data." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners-billing-blob.md b/api-reference/v1.0/resources/partners-billing-blob.md index b6f9bd8bcc6..f60f611ca84 100644 --- a/api-reference/v1.0/resources/partners-billing-blob.md +++ b/api-reference/v1.0/resources/partners-billing-blob.md @@ -1,7 +1,7 @@ --- title: "blob resource type" description: "Represents a billing blob that contains exported data." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md b/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md index d12a4068bd6..c5a9a74598a 100644 --- a/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md +++ b/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md @@ -1,7 +1,7 @@ --- title: "exportSuccessOperation resource type" description: "Represents an export operation that is completed successfully." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners-billing-failedoperation.md b/api-reference/v1.0/resources/partners-billing-failedoperation.md index dda029503cd..5fb9d66d62a 100644 --- a/api-reference/v1.0/resources/partners-billing-failedoperation.md +++ b/api-reference/v1.0/resources/partners-billing-failedoperation.md @@ -1,7 +1,7 @@ --- title: "failedOperation resource type" description: "Represents an export operation that failed to complete." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners-billing-manifest.md b/api-reference/v1.0/resources/partners-billing-manifest.md index 8998777080c..9310d0bc8ef 100644 --- a/api-reference/v1.0/resources/partners-billing-manifest.md +++ b/api-reference/v1.0/resources/partners-billing-manifest.md @@ -1,7 +1,7 @@ --- title: "manifest resource type" description: "Represents metadata for the exported data." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners-billing-operation.md b/api-reference/v1.0/resources/partners-billing-operation.md index e0c741ae3e4..48a6fe248d4 100644 --- a/api-reference/v1.0/resources/partners-billing-operation.md +++ b/api-reference/v1.0/resources/partners-billing-operation.md @@ -1,7 +1,7 @@ --- title: "operation resource type" description: "Represents an operation to export the billing data of a partner." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners-billing-runningoperation.md b/api-reference/v1.0/resources/partners-billing-runningoperation.md index 7834e28c41c..0950f524114 100644 --- a/api-reference/v1.0/resources/partners-billing-runningoperation.md +++ b/api-reference/v1.0/resources/partners-billing-runningoperation.md @@ -1,7 +1,7 @@ --- title: "runningOperation resource type" description: "Represents an export operation that is still running, which indicates that the files aren't ready yet." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners-billing-unbilledusage.md b/api-reference/v1.0/resources/partners-billing-unbilledusage.md index fa6cfbc94aa..26bdf9ceb3c 100644 --- a/api-reference/v1.0/resources/partners-billing-unbilledusage.md +++ b/api-reference/v1.0/resources/partners-billing-unbilledusage.md @@ -1,7 +1,7 @@ --- title: "unbilledUsage resource type" description: "Represents details for unbilled Azure usage data." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/partners.md b/api-reference/v1.0/resources/partners.md index 60070589f7b..686f142f841 100644 --- a/api-reference/v1.0/resources/partners.md +++ b/api-reference/v1.0/resources/partners.md @@ -1,7 +1,7 @@ --- title: "partners resource type" description: "Represents billing details for a Microsoft direct partner." -author: "abhishek-singh-ms" +author: "sourishdeb" ms.localizationpriority: medium ms.prod: "reports" doc_type: resourcePageType From cc297fbec8748e8a4559cfd142e4cdeda26e22ac Mon Sep 17 00:00:00 2001 From: Abhishek Singh Date: Thu, 18 Jan 2024 12:44:30 -0800 Subject: [PATCH 04/35] added csp partner call out --- .../v1.0/includes/alerts-callout-csp-partner-only.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 api-reference/v1.0/includes/alerts-callout-csp-partner-only.md diff --git a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md new file mode 100644 index 00000000000..4adab143f6e --- /dev/null +++ b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md @@ -0,0 +1,11 @@ +--- +author: "sourishdeb" +ms.localizationpriority: medium +ms.prod: "reports" +ms.topic: include +--- + + +>[!NOTE] +>This API is only for CSP partners who want to access their billed and unbilled data for a tenant. + From 2184753b40d23d4a122d40527ccc18bd68afa467 Mon Sep 17 00:00:00 2001 From: Abhishek Singh Date: Thu, 18 Jan 2024 16:20:03 -0800 Subject: [PATCH 05/35] updated partner disclaimer --- api-reference/v1.0/api/partners-billing-billedusage-export.md | 2 ++ api-reference/v1.0/api/partners-billing-manifest-get.md | 2 ++ api-reference/v1.0/api/partners-billing-operation-get.md | 2 ++ .../v1.0/api/partners-billing-unbilledusage-export.md | 2 ++ .../v1.0/includes/alerts-callout-csp-partner-only.md | 4 ++-- 5 files changed, 10 insertions(+), 2 deletions(-) diff --git a/api-reference/v1.0/api/partners-billing-billedusage-export.md b/api-reference/v1.0/api/partners-billing-billedusage-export.md index bd4a9cc9e40..49ecdc16df8 100644 --- a/api-reference/v1.0/api/partners-billing-billedusage-export.md +++ b/api-reference/v1.0/api/partners-billing-billedusage-export.md @@ -11,6 +11,8 @@ doc_type: apiPageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] + Export the billed Azure usage data. ## Permissions diff --git a/api-reference/v1.0/api/partners-billing-manifest-get.md b/api-reference/v1.0/api/partners-billing-manifest-get.md index cfea610c607..17a34524997 100644 --- a/api-reference/v1.0/api/partners-billing-manifest-get.md +++ b/api-reference/v1.0/api/partners-billing-manifest-get.md @@ -11,6 +11,8 @@ doc_type: apiPageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] + Read the properties and relationships of a [manifest](../resources/partners-billing-manifest.md) object. diff --git a/api-reference/v1.0/api/partners-billing-operation-get.md b/api-reference/v1.0/api/partners-billing-operation-get.md index 1c0da34031d..0dd84658696 100644 --- a/api-reference/v1.0/api/partners-billing-operation-get.md +++ b/api-reference/v1.0/api/partners-billing-operation-get.md @@ -11,6 +11,8 @@ doc_type: apiPageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] + Read the properties and relationships of an [operation](../resources/partners-billing-operation.md) object. diff --git a/api-reference/v1.0/api/partners-billing-unbilledusage-export.md b/api-reference/v1.0/api/partners-billing-unbilledusage-export.md index 32fb187ee49..ff3f862fa26 100644 --- a/api-reference/v1.0/api/partners-billing-unbilledusage-export.md +++ b/api-reference/v1.0/api/partners-billing-unbilledusage-export.md @@ -11,6 +11,8 @@ doc_type: apiPageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] + Export the unbilled Azure usage data for a specific billing period and a given currency. ## Permissions diff --git a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md index 4adab143f6e..f90fa35a088 100644 --- a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md +++ b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md @@ -6,6 +6,6 @@ ms.topic: include --- ->[!NOTE] ->This API is only for CSP partners who want to access their billed and unbilled data for a tenant. +> [!NOTE] +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled data for a tenant. For information about the CSP program, see the [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview) page. From c167ac2716b07b98fef9114ae6fa7015c69953a7 Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Thu, 18 Jan 2024 16:39:21 -0800 Subject: [PATCH 06/35] Update alerts-callout-csp-partner-only.md --- api-reference/v1.0/includes/alerts-callout-csp-partner-only.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md index f90fa35a088..827db4817a4 100644 --- a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md +++ b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md @@ -7,5 +7,5 @@ ms.topic: include > [!NOTE] -> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled data for a tenant. For information about the CSP program, see the [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview) page. +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled data for a tenant. For information about the CSP program, see the [Microsoft Cloud Solution Provider](/partner-center/csp-overview) page. From 93802daa216bd6dd0b44871910002ba28617b0ce Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Thu, 18 Jan 2024 16:40:35 -0800 Subject: [PATCH 07/35] Update alerts-callout-csp-partner-only.md --- api-reference/v1.0/includes/alerts-callout-csp-partner-only.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md index 827db4817a4..c4212ce9331 100644 --- a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md +++ b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md @@ -7,5 +7,5 @@ ms.topic: include > [!NOTE] -> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled data for a tenant. For information about the CSP program, see the [Microsoft Cloud Solution Provider](/partner-center/csp-overview) page. +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled data for a tenant. For information about the CSP program, see the [Microsoft Cloud Solution Provider](https://partner.microsoft.com/partnership/cloud-solution-provider) page. From 9ae6bfb3c81564866878e0809a5318c98ac216c8 Mon Sep 17 00:00:00 2001 From: Abhishek Singh Date: Thu, 18 Jan 2024 16:58:38 -0800 Subject: [PATCH 08/35] added partner disclaimer for resource files --- api-reference/v1.0/includes/alerts-callout-csp-partner-only.md | 2 +- api-reference/v1.0/resources/partners-billing-api-overview.md | 2 ++ api-reference/v1.0/resources/partners-billing-attributeset.md | 1 + api-reference/v1.0/resources/partners-billing-azureusage.md | 1 + api-reference/v1.0/resources/partners-billing-billedusage.md | 1 + api-reference/v1.0/resources/partners-billing-billing.md | 2 ++ .../v1.0/resources/partners-billing-exportsuccessoperation.md | 1 + .../v1.0/resources/partners-billing-failedoperation.md | 1 + api-reference/v1.0/resources/partners-billing-manifest.md | 1 + api-reference/v1.0/resources/partners-billing-operation.md | 1 + .../v1.0/resources/partners-billing-runningoperation.md | 1 + api-reference/v1.0/resources/partners-billing-unbilledusage.md | 1 + api-reference/v1.0/resources/partners.md | 1 + 13 files changed, 15 insertions(+), 1 deletion(-) diff --git a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md index c4212ce9331..f90fa35a088 100644 --- a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md +++ b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md @@ -7,5 +7,5 @@ ms.topic: include > [!NOTE] -> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled data for a tenant. For information about the CSP program, see the [Microsoft Cloud Solution Provider](https://partner.microsoft.com/partnership/cloud-solution-provider) page. +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled data for a tenant. For information about the CSP program, see the [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview) page. diff --git a/api-reference/v1.0/resources/partners-billing-api-overview.md b/api-reference/v1.0/resources/partners-billing-api-overview.md index 8b03a45a1eb..876e20cc51b 100644 --- a/api-reference/v1.0/resources/partners-billing-api-overview.md +++ b/api-reference/v1.0/resources/partners-billing-api-overview.md @@ -8,6 +8,8 @@ doc_type: resourcePageType ms.custom: zt-include --- +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] + # Use the Microsoft Graph API to export partner billing data As part of the Microsoft Partner Center ecosystem, Microsoft direct partners in the Cloud Solution Provider programs can request to export their billed and unbilled data to Azure Blob Storage asynchronously. this removes the need to maintain an open connection for hours and loop through millions of transactions iteratively. The asynchronous API provides a way to quickly access billing and reconciliation data in manageable chunks. diff --git a/api-reference/v1.0/resources/partners-billing-attributeset.md b/api-reference/v1.0/resources/partners-billing-attributeset.md index e48ba9b7e50..ed82050855e 100644 --- a/api-reference/v1.0/resources/partners-billing-attributeset.md +++ b/api-reference/v1.0/resources/partners-billing-attributeset.md @@ -11,6 +11,7 @@ doc_type: enumPageTypes Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents attributes for exported data sets in the Microsoft Graph partner billing API. The default value is `full`. Choose `full` for a complete response or `basic` for a subset of attributes. diff --git a/api-reference/v1.0/resources/partners-billing-azureusage.md b/api-reference/v1.0/resources/partners-billing-azureusage.md index b6765cd7f04..a82de3a6421 100644 --- a/api-reference/v1.0/resources/partners-billing-azureusage.md +++ b/api-reference/v1.0/resources/partners-billing-azureusage.md @@ -11,6 +11,7 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents details for billed and unbilled Azure usage data. diff --git a/api-reference/v1.0/resources/partners-billing-billedusage.md b/api-reference/v1.0/resources/partners-billing-billedusage.md index ce376fec301..c609d55165d 100644 --- a/api-reference/v1.0/resources/partners-billing-billedusage.md +++ b/api-reference/v1.0/resources/partners-billing-billedusage.md @@ -11,6 +11,7 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents details for billed Azure usage data. diff --git a/api-reference/v1.0/resources/partners-billing-billing.md b/api-reference/v1.0/resources/partners-billing-billing.md index f06d5b8d5f6..6fba268b799 100644 --- a/api-reference/v1.0/resources/partners-billing-billing.md +++ b/api-reference/v1.0/resources/partners-billing-billing.md @@ -11,6 +11,8 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] + Represents billing details for billed and unbilled data. ## Methods diff --git a/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md b/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md index c5a9a74598a..abe2249af93 100644 --- a/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md +++ b/api-reference/v1.0/resources/partners-billing-exportsuccessoperation.md @@ -11,6 +11,7 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents an export operation that is completed successfully. diff --git a/api-reference/v1.0/resources/partners-billing-failedoperation.md b/api-reference/v1.0/resources/partners-billing-failedoperation.md index 5fb9d66d62a..ad4b61ea260 100644 --- a/api-reference/v1.0/resources/partners-billing-failedoperation.md +++ b/api-reference/v1.0/resources/partners-billing-failedoperation.md @@ -11,6 +11,7 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents an export operation that failed to complete. diff --git a/api-reference/v1.0/resources/partners-billing-manifest.md b/api-reference/v1.0/resources/partners-billing-manifest.md index 9310d0bc8ef..e1ee6a37070 100644 --- a/api-reference/v1.0/resources/partners-billing-manifest.md +++ b/api-reference/v1.0/resources/partners-billing-manifest.md @@ -11,6 +11,7 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents metadata for the exported data. Use the metadata to get details of the file you want to download from an Azure Blob Storage. diff --git a/api-reference/v1.0/resources/partners-billing-operation.md b/api-reference/v1.0/resources/partners-billing-operation.md index 48a6fe248d4..ebc97136b1f 100644 --- a/api-reference/v1.0/resources/partners-billing-operation.md +++ b/api-reference/v1.0/resources/partners-billing-operation.md @@ -11,6 +11,7 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents an operation to export the billing data of a partner. diff --git a/api-reference/v1.0/resources/partners-billing-runningoperation.md b/api-reference/v1.0/resources/partners-billing-runningoperation.md index 0950f524114..099bee2cc92 100644 --- a/api-reference/v1.0/resources/partners-billing-runningoperation.md +++ b/api-reference/v1.0/resources/partners-billing-runningoperation.md @@ -11,6 +11,7 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents an export operation that is still running, which indicates that the files aren't ready yet. diff --git a/api-reference/v1.0/resources/partners-billing-unbilledusage.md b/api-reference/v1.0/resources/partners-billing-unbilledusage.md index 26bdf9ceb3c..ae73a908257 100644 --- a/api-reference/v1.0/resources/partners-billing-unbilledusage.md +++ b/api-reference/v1.0/resources/partners-billing-unbilledusage.md @@ -11,6 +11,7 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents details for unbilled Azure usage data. diff --git a/api-reference/v1.0/resources/partners.md b/api-reference/v1.0/resources/partners.md index 686f142f841..293a34a1326 100644 --- a/api-reference/v1.0/resources/partners.md +++ b/api-reference/v1.0/resources/partners.md @@ -11,6 +11,7 @@ doc_type: resourcePageType Namespace: microsoft.graph +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents billing details for a Microsoft direct partner. From f4478ca802c99c2737dd976241c851913c67ab32 Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Thu, 18 Jan 2024 17:46:18 -0800 Subject: [PATCH 09/35] Update toc.yml --- api-reference/v1.0/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/toc.yml b/api-reference/v1.0/toc.yml index 85145c38eff..df0800448f5 100644 --- a/api-reference/v1.0/toc.yml +++ b/api-reference/v1.0/toc.yml @@ -7544,7 +7544,7 @@ items: - name: Get training coverage for users href: api/securityreportsroot-getattacksimulationtrainingusercoverage.md - name: Partner billing reports - items: + items: - name: Overview href: resources/partners-billing-api-overview.md - name: Billed usage From 7a2c2e16522cf9f49f4be54b3c43d0d038267790 Mon Sep 17 00:00:00 2001 From: Abhishek Singh Date: Mon, 22 Jan 2024 01:13:25 -0800 Subject: [PATCH 10/35] change log --- changelog/Microsoft.Partner.Billing.json | 168 +++++++++++++++-------- 1 file changed, 108 insertions(+), 60 deletions(-) diff --git a/changelog/Microsoft.Partner.Billing.json b/changelog/Microsoft.Partner.Billing.json index b96ed41217e..226f9084d5a 100644 --- a/changelog/Microsoft.Partner.Billing.json +++ b/changelog/Microsoft.Partner.Billing.json @@ -1,126 +1,174 @@ { "changelog": [ { - "ChangeList": [ + "ChangeList": [ { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", - "ApiChange": "Enum type", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Enumeration", + "ChangedApiName": "longRunningOperationStatus", + "ChangeType": "Addition", + "Description": "Added the **longRunningOperationStatus** enumeration type.", + "Target": "longRunningOperationStatus" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Resource", + "ChangedApiName": "publicError", + "ChangeType": "Addition", + "Description": "Added the [publicError](https://learn.microsoft.com/en-us/graph/api/resources/publicError?view=graph-rest-1.0) resource.", + "Target": "publicError" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Resource", + "ChangedApiName": "publicErrorDetail", + "ChangeType": "Addition", + "Description": "Added the [publicErrorDetail](https://learn.microsoft.com/en-us/graph/api/resources/publicErrorDetail?view=graph-rest-1.0) resource.", + "Target": "publicErrorDetail" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Resource", + "ChangedApiName": "publicInnerError", + "ChangeType": "Addition", + "Description": "Added the [publicInnerError](https://learn.microsoft.com/en-us/graph/api/resources/publicInnerError?view=graph-rest-1.0) resource.", + "Target": "publicInnerError" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Resource", + "ChangedApiName": "partners", + "ChangeType": "Addition", + "Description": "Added the [partners](https://learn.microsoft.com/en-us/graph/api/resources/partners?view=graph-rest-1.0) resource.", + "Target": "partners" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Resource", + "ChangedApiName": "reportRoot", + "ChangeType": "Addition", + "Description": "Added the [reportRoot](https://learn.microsoft.com/en-us/graph/api/resources/reportRoot?view=graph-rest-1.0) resource.", + "Target": "reportRoot" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Enumeration", "ChangedApiName": "attributeSet", "ChangeType": "Addition", "Description": "Added the **attributeSet** enumeration type.", "Target": "attributeSet" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", - "ApiChange": "Enum type", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Enumeration", "ChangedApiName": "billingPeriod", "ChangeType": "Addition", "Description": "Added the **billingPeriod** enumeration type.", "Target": "billingPeriod" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", "ChangedApiName": "blob", "ChangeType": "Addition", - "Description": "Added the [blob](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-blob?view=graph-rest-beta) resource type.", + "Description": "Added the [blob](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-blob?view=graph-rest-1.0) resource.", "Target": "blob" - }, - { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", - "ApiChange": "Resource", - "ChangedApiName": "exportSuccessOperation", - "ChangeType": "Addition", - "Description": "Added the [exportSuccessOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-exportSuccessOperation?view=graph-rest-beta) resource type.", - "Target": "exportSuccessOperation" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", - "ChangedApiName": "failedOperation", + "ChangedApiName": "azureUsage", "ChangeType": "Addition", - "Description": "Added the [failedOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-failedOperation?view=graph-rest-beta) resource type.", - "Target": "failedOperation" + "Description": "Added the [azureUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-azureUsage?view=graph-rest-1.0) resource.", + "Target": "azureUsage" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", - "ChangedApiName": "manifest", + "ChangedApiName": "billedUsage", "ChangeType": "Addition", - "Description": "Added the [manifest](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-manifest?view=graph-rest-beta) resource and a supported method.", - "Target": "manifest" + "Description": "Added the [billedUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-billedUsage?view=graph-rest-1.0) resource.", + "Target": "billedUsage" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", - "ChangedApiName": "operation", + "ChangedApiName": "billing", "ChangeType": "Addition", - "Description": "Added the [operation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-operation?view=graph-rest-beta) resource and a supported method.", - "Target": "operation" + "Description": "Added the [billing](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-billing?view=graph-rest-1.0) resource.", + "Target": "billing" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", - "ChangedApiName": "runningOperation", + "ChangedApiName": "exportSuccessOperation", "ChangeType": "Addition", - "Description": "Added the [runningOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-runningOperation?view=graph-rest-beta) resource type.", - "Target": "runningOperation" + "Description": "Added the [exportSuccessOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-exportSuccessOperation?view=graph-rest-1.0) resource.", + "Target": "exportSuccessOperation" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", - "ChangedApiName": "partners", + "ChangedApiName": "failedOperation", "ChangeType": "Addition", - "Description": "Added the [partners](https://learn.microsoft.com/en-us/graph/api/resources/partners?view=graph-rest-beta) resource type.", - "Target": "partners" + "Description": "Added the [failedOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-failedOperation?view=graph-rest-1.0) resource.", + "Target": "failedOperation" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", - "ChangedApiName": "billing", + "ChangedApiName": "manifest", "ChangeType": "Addition", - "Description": "Added the [billing](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-billing?view=graph-rest-beta) resource type.", - "Target": "billing" + "Description": "Added the [manifest](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-manifest?view=graph-rest-1.0) resource.", + "Target": "manifest" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", - "ChangedApiName": "azureUsage", + "ChangedApiName": "operation", "ChangeType": "Addition", - "Description": "Added the [azureUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-azureUsage?view=graph-rest-beta) resource type.", - "Target": "azureUsage" + "Description": "Added the [operation](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-operation?view=graph-rest-1.0) resource.", + "Target": "operation" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", - "ChangedApiName": "billedUsage", + "ChangedApiName": "runningOperation", "ChangeType": "Addition", - "Description": "Added the [billedUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-billedUsage?view=graph-rest-beta) resource and a supported method.", - "Target": "billedUsage" + "Description": "Added the [runningOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-runningOperation?view=graph-rest-1.0) resource.", + "Target": "runningOperation" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", "ChangedApiName": "unbilledUsage", "ChangeType": "Addition", - "Description": "Added the [unbilledUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-unbilledUsage?view=graph-rest-beta) resource and a supported method.", + "Description": "Added the [unbilledUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-unbilledUsage?view=graph-rest-1.0) resource.", "Target": "unbilledUsage" }, { - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", - "ApiChange": "Relationship", - "ChangedApiName": "partners", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Method", + "ChangedApiName": "export", "ChangeType": "Addition", - "Description": "Added the **partners** relationship to the [reportRoot](https://learn.microsoft.com/en-us/graph/api/resources/reportRoot?view=graph-rest-beta) resource.", - "Target": "reportRoot" + "Description": "Added the [export](https://learn.microsoft.com/en-us/graph/api/partners.billing-billedUsage-export?view=graph-rest-1.0) method to the [billedUsage](https://learn.microsoft.com/en-us/graph/api/partners.billing-billedUsage?view=graph-rest-1.0) resource.", + "Target": "billedUsage" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Method", + "ChangedApiName": "export", + "ChangeType": "Addition", + "Description": "Added the [export](https://learn.microsoft.com/en-us/graph/api/partners.billing-unbilledUsage-export?view=graph-rest-1.0) method to the [unbilledUsage](https://learn.microsoft.com/en-us/graph/api/partners.billing-unbilledUsage?view=graph-rest-1.0) resource.", + "Target": "unbilledUsage" } ], - "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "Cloud": "Prod", - "Version": "beta", - "CreatedDateTime": "2024-01-16T08:51:46.3920632Z", - "WorkloadArea": "Reports", - "SubArea": "Partner billing reports" + "Version": "v1.0", + "CreatedDateTime": "2024-01-22T08:46:33.6864129Z", + "WorkloadArea": "Microsoft.Partner.Billing", + "SubArea": "" } ] -} +} \ No newline at end of file From 066fd55016df3e314804fa92838d3709d2f1e6ac Mon Sep 17 00:00:00 2001 From: Abhishek Singh Date: Mon, 22 Jan 2024 15:51:46 -0800 Subject: [PATCH 11/35] disclaimer text update --- api-reference/v1.0/includes/alerts-callout-csp-partner-only.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md index f90fa35a088..ecbd8a799be 100644 --- a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md +++ b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md @@ -7,5 +7,5 @@ ms.topic: include > [!NOTE] -> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled data for a tenant. For information about the CSP program, see the [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview) page. +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about about the CSP program, see [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview). From 83885c99bba979a385a5249a7ef931891ca341cd Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 06:18:09 +0100 Subject: [PATCH 12/35] Update whats-new-overview.md Edit. --- concepts/whats-new-overview.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md index 912d2e94bbf..5901fa629a5 100644 --- a/concepts/whats-new-overview.md +++ b/concepts/whats-new-overview.md @@ -22,6 +22,15 @@ For details about previous updates to Microsoft Graph, see [Microsoft Graph what The [virtualEndpoint](/graph/api/resources/virtualendpoint) resource is generally available, laying the foundation for future Cloud PC updates to the `v1.0` path. +### Reports | Partner billing reports + +The new partner billing API in Microsoft Graph offers Microsoft direct partners a faster, more efficient way to export their high-volume billed and unbilled Azure usage data. Partners can quickly create export operations, monitor their status, and retrieve manifests using the following APIs: + +- [billedUsage: export](/graph/api/partners-billing-billedusage-export) +- [unbilledUsage: export](/graph/api/partners-billing-unbilledusage-export) +- [Get operation](/graph/api/partners-billing-operation-get) +- [Get manifest](/graph/api/partners-billing-manifest-get) + ### Teamwork and communications | Calls and online meetings Communications servers can publish [deltaParticipants](/graph/api/resources/deltaParticipants) notifications for the creation, update, or deletion of a [participant](/graph/api/resources/participant) in a [call](/graph/api/resources/call). For more information, see [JSON payload examples](/graph/api/application-post-calls#notification---roster) of notifications with delta roster disabled or enabled. From 3fe85598c6274863682e14aae44c30d4f9b81692 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 06:22:01 +0100 Subject: [PATCH 13/35] Update reportroot-concept-overview.md Edit. --- concepts/reportroot-concept-overview.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/concepts/reportroot-concept-overview.md b/concepts/reportroot-concept-overview.md index 16596174e27..fcff78ac451 100644 --- a/concepts/reportroot-concept-overview.md +++ b/concepts/reportroot-concept-overview.md @@ -52,7 +52,7 @@ You can use the reports API to access the data sets listed in the following tabl | Microsoft 365 (general) | [Activations](/graph/api/resources/office-365-activations-reports)
[Active users](/graph/api/resources/office-365-active-users-reports)
[Apps usage](/graph/api/resources/microsoft-365-apps-usage-report)
[Browser usage (preview)](/graph/api/resources/microsoft-365-browser-usage-report)
[Groups activity](/graph/api/resources/office-365-groups-activity-reports) | | OneDrive | [Activity](/graph/api/resources/onedrive-activity-reports)
[Usage](/graph/api/resources/onedrive-usage-reports) | | Outlook | [Activity](/graph/api/resources/email-activity-reports)
[App usage](/graph/api/resources/email-app-usage-reports)
[Mailbox usage](/graph/api/resources/mailbox-usage-reports) | -| Partner billing | [Billed usage (preview)](/graph/api/resources/partners-billing-billedusage)
[Unbilled usage (preview)](/graph/api/resources/partners-billing-unbilledusage) | +| Partner billing | [Billed usage](/graph/api/resources/partners-billing-billedusage)
[Unbilled usage](/graph/api/resources/partners-billing-unbilledusage) | | SharePoint | [Activity](/graph/api/resources/sharepoint-activity-reports)
[Site usage](/graph/api/resources/sharepoint-site-usage-reports) | | Skype for Business | [Activity](/graph/api/resources/skype-for-business-activity-reports)
[Device usage](/graph/api/resources/skype-for-business-device-usage-reports)
[Organizer activity](/graph/api/resources/skype-for-business-organizer-activity-reports)
[Participant activity](/graph/api/resources/skype-for-business-participant-activity-reports)
[Peer to peer activity](/graph/api/resources/skype-for-business-peer-to-peer-activity) | | Yammer | [Activity](/graph/api/resources/yammer-activity-reports)
[Device usage](/graph/api/resources/yammer-device-usage-reports)
[Groups activity](/graph/api/resources/yammer-groups-activity-reports) | @@ -64,6 +64,8 @@ Looking for the API reference for this service? - [Identity and access reports API in Microsoft Graph beta](/graph/api/resources/report-identity-access?view=graph-rest-beta&preserve-view=true) - [Microsoft 365 usage reports API in Microsoft Graph v1.0](/graph/api/resources/report?view=graph-rest-1.0&preserve-view=true) - [Microsoft 365 usage reports API in Microsoft Graph beta](/graph/api/resources/report?view=graph-rest-beta&preserve-view=true) +- [Partner billing reports API in Microsoft Graph v1.0](/graph/api/resources/partners-billing-api-overview?view=graph-rest-1.0&preserve-view=true) +- [Partner billing reports API in Microsoft Graph beta](/graph/api/resources/partners-billing-api-overview?view=graph-rest-beta&preserve-view=true) ## Next steps From 235b71c9be7f3d859c01d008df0ac1103143b003 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 06:22:47 +0100 Subject: [PATCH 14/35] Update toc.yml Edit. --- concepts/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/concepts/toc.yml b/concepts/toc.yml index c108e00fc75..7dffcd0a3a8 100644 --- a/concepts/toc.yml +++ b/concepts/toc.yml @@ -788,7 +788,7 @@ items: displayName: report, reports - name: Authorization for Microsoft 365 usage reports href: reportroot-authorization.md - - name: Partner billing (preview) + - name: Partner billing href: partners-billing-concept-overview.md - name: Search items: From e61d8f562fd80ecccd9f6df345ddd7b95502d4e9 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 06:25:57 +0100 Subject: [PATCH 15/35] Update partners-billing-concept-overview.md Edit. --- concepts/partners-billing-concept-overview.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/concepts/partners-billing-concept-overview.md b/concepts/partners-billing-concept-overview.md index 5c8ddea2e71..394e67c563d 100644 --- a/concepts/partners-billing-concept-overview.md +++ b/concepts/partners-billing-concept-overview.md @@ -1,12 +1,12 @@ --- -title: "Use the partner billing API in Microsoft Graph to access billing data (preview)" +title: "Use the partner billing API in Microsoft Graph to access billing data" description: "Learn how to use the partner billing API in Microsoft Graph to facilitate the export of billing data." author: "abhishek-singh-ms" ms.localizationpriority: medium ms.prod: "reports" --- -# Use the partner billing API in Microsoft Graph to access billing data (preview) +# Use the partner billing API in Microsoft Graph to access billing data The partner billing API in Microsoft Graph allow Microsoft direct partners in the Cloud Solution Provider programs to export their high-volume billed and unbilled data asynchronously. This removes the need to maintain an open connection for hours and loop through millions of transactions iteratively. Asynchronous APIs enable fast, efficient retrieval of billing and reconciliation data in manageable chunks for quicker reconciliation. @@ -47,5 +47,6 @@ Looking for the API reference for this service? ## Next steps -- To learn more about the partner billing API, see [Use the Microsoft Graph API to export partner billing data (preview)](/graph/api/resources/partners-billing-api-overview?view=graph-rest-beta&preserve-view=true). +- To learn more about the partner billing reports API in Microsoft Graph v1.0, see [Use the Microsoft Graph API to export partner billing data](/graph/api/resources/partners-billing-api-overview?view=graph-rest-1.0&preserve-view=true). +- To learn more about the partner billing reports API in Microsoft Graph beta, see [Use the Microsoft Graph API to export partner billing data](/graph/api/resources/partners-billing-api-overview?view=graph-rest-beta&preserve-view=true). - Try the partner billing API in [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). From 030cf62850254a6c745b5a7e8eff55cbe321d8f8 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 06:28:14 +0100 Subject: [PATCH 16/35] Update partners-billing-concept-overview.md Edit. --- concepts/partners-billing-concept-overview.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/concepts/partners-billing-concept-overview.md b/concepts/partners-billing-concept-overview.md index 394e67c563d..b66478706dc 100644 --- a/concepts/partners-billing-concept-overview.md +++ b/concepts/partners-billing-concept-overview.md @@ -43,10 +43,10 @@ Use the [Get operation](/graph/api/partners-billing-operation-get) endpoint to p Looking for the API reference for this service? -[Partner billing API in Microsoft Graph beta](/graph/api/resources/partners-billing-api-overview?view=graph-rest-beta&preserve-view=true) +- [Partner billing reports API in Microsoft Graph v1.0](/graph/api/resources/partners-billing-api-overview?view=graph-rest-1.0&preserve-view=true) +- [Partner billing reports API in Microsoft Graph beta](/graph/api/resources/partners-billing-api-overview?view=graph-rest-beta&preserve-view=true) ## Next steps -- To learn more about the partner billing reports API in Microsoft Graph v1.0, see [Use the Microsoft Graph API to export partner billing data](/graph/api/resources/partners-billing-api-overview?view=graph-rest-1.0&preserve-view=true). -- To learn more about the partner billing reports API in Microsoft Graph beta, see [Use the Microsoft Graph API to export partner billing data](/graph/api/resources/partners-billing-api-overview?view=graph-rest-beta&preserve-view=true). +- To learn more about the partner billing reports API, see [Use the Microsoft Graph API to export partner billing data](/graph/api/resources/partners-billing-api-overview). - Try the partner billing API in [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). From 6e4c9b9dc5942ef9f5c2fdd9f00be79923eba4db Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 06:38:04 +0100 Subject: [PATCH 17/35] Update Microsoft.Partner.Billing.json Edit. --- changelog/Microsoft.Partner.Billing.json | 208 +++++++++++++++-------- 1 file changed, 141 insertions(+), 67 deletions(-) diff --git a/changelog/Microsoft.Partner.Billing.json b/changelog/Microsoft.Partner.Billing.json index 226f9084d5a..c514d39719e 100644 --- a/changelog/Microsoft.Partner.Billing.json +++ b/changelog/Microsoft.Partner.Billing.json @@ -1,109 +1,159 @@ { "changelog": [ { - "ChangeList": [ + "ChangeList": [ { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", - "ApiChange": "Enumeration", - "ChangedApiName": "longRunningOperationStatus", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "ApiChange": "Enum type", + "ChangedApiName": "attributeSet", "ChangeType": "Addition", - "Description": "Added the **longRunningOperationStatus** enumeration type.", - "Target": "longRunningOperationStatus" + "Description": "Added the **attributeSet** enumeration type.", + "Target": "attributeSet" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", - "ApiChange": "Resource", - "ChangedApiName": "publicError", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "ApiChange": "Enum type", + "ChangedApiName": "billingPeriod", "ChangeType": "Addition", - "Description": "Added the [publicError](https://learn.microsoft.com/en-us/graph/api/resources/publicError?view=graph-rest-1.0) resource.", - "Target": "publicError" + "Description": "Added the **billingPeriod** enumeration type.", + "Target": "billingPeriod" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "ApiChange": "Resource", + "ChangedApiName": "blob", + "ChangeType": "Addition", + "Description": "Added the [blob](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-blob?view=graph-rest-beta) resource type.", + "Target": "blob" + }, + { + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", "ApiChange": "Resource", - "ChangedApiName": "publicErrorDetail", + "ChangedApiName": "exportSuccessOperation", "ChangeType": "Addition", - "Description": "Added the [publicErrorDetail](https://learn.microsoft.com/en-us/graph/api/resources/publicErrorDetail?view=graph-rest-1.0) resource.", - "Target": "publicErrorDetail" + "Description": "Added the [exportSuccessOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-exportSuccessOperation?view=graph-rest-beta) resource type.", + "Target": "exportSuccessOperation" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", "ApiChange": "Resource", - "ChangedApiName": "publicInnerError", + "ChangedApiName": "failedOperation", "ChangeType": "Addition", - "Description": "Added the [publicInnerError](https://learn.microsoft.com/en-us/graph/api/resources/publicInnerError?view=graph-rest-1.0) resource.", - "Target": "publicInnerError" + "Description": "Added the [failedOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-failedOperation?view=graph-rest-beta) resource type.", + "Target": "failedOperation" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", "ApiChange": "Resource", - "ChangedApiName": "partners", + "ChangedApiName": "manifest", "ChangeType": "Addition", - "Description": "Added the [partners](https://learn.microsoft.com/en-us/graph/api/resources/partners?view=graph-rest-1.0) resource.", - "Target": "partners" + "Description": "Added the [manifest](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-manifest?view=graph-rest-beta) resource and a supported method.", + "Target": "manifest" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", "ApiChange": "Resource", - "ChangedApiName": "reportRoot", + "ChangedApiName": "operation", "ChangeType": "Addition", - "Description": "Added the [reportRoot](https://learn.microsoft.com/en-us/graph/api/resources/reportRoot?view=graph-rest-1.0) resource.", - "Target": "reportRoot" + "Description": "Added the [operation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-operation?view=graph-rest-beta) resource and a supported method.", + "Target": "operation" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", - "ApiChange": "Enumeration", - "ChangedApiName": "attributeSet", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "ApiChange": "Resource", + "ChangedApiName": "runningOperation", "ChangeType": "Addition", - "Description": "Added the **attributeSet** enumeration type.", - "Target": "attributeSet" + "Description": "Added the [runningOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-runningOperation?view=graph-rest-beta) resource type.", + "Target": "runningOperation" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", - "ApiChange": "Enumeration", - "ChangedApiName": "billingPeriod", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "ApiChange": "Resource", + "ChangedApiName": "partners", "ChangeType": "Addition", - "Description": "Added the **billingPeriod** enumeration type.", - "Target": "billingPeriod" + "Description": "Added the [partners](https://learn.microsoft.com/en-us/graph/api/resources/partners?view=graph-rest-beta) resource type.", + "Target": "partners" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", "ApiChange": "Resource", - "ChangedApiName": "blob", + "ChangedApiName": "billing", "ChangeType": "Addition", - "Description": "Added the [blob](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-blob?view=graph-rest-1.0) resource.", - "Target": "blob" + "Description": "Added the [billing](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-billing?view=graph-rest-beta) resource type.", + "Target": "billing" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", "ApiChange": "Resource", "ChangedApiName": "azureUsage", "ChangeType": "Addition", - "Description": "Added the [azureUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-azureUsage?view=graph-rest-1.0) resource.", + "Description": "Added the [azureUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-azureUsage?view=graph-rest-beta) resource type.", "Target": "azureUsage" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", "ApiChange": "Resource", "ChangedApiName": "billedUsage", "ChangeType": "Addition", - "Description": "Added the [billedUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-billedUsage?view=graph-rest-1.0) resource.", + "Description": "Added the [billedUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-billedUsage?view=graph-rest-beta) resource and a supported method.", "Target": "billedUsage" }, { - "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", "ApiChange": "Resource", - "ChangedApiName": "billing", + "ChangedApiName": "unbilledUsage", "ChangeType": "Addition", - "Description": "Added the [billing](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-billing?view=graph-rest-1.0) resource.", - "Target": "billing" + "Description": "Added the [unbilledUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-unbilledUsage?view=graph-rest-beta) resource and a supported method.", + "Target": "unbilledUsage" + }, + { + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "ApiChange": "Relationship", + "ChangedApiName": "partners", + "ChangeType": "Addition", + "Description": "Added the **partners** relationship to the [reportRoot](https://learn.microsoft.com/en-us/graph/api/resources/reportRoot?view=graph-rest-beta) resource.", + "Target": "reportRoot" + } + ], + "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2024-01-16T08:51:46.3920632Z", + "WorkloadArea": "Reports", + "SubArea": "Partner billing reports" + }, + { + "ChangeList": [ + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Enum type", + "ChangedApiName": "attributeSet", + "ChangeType": "Addition", + "Description": "Added the **attributeSet** enumeration type.", + "Target": "attributeSet" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Enum type", + "ChangedApiName": "billingPeriod", + "ChangeType": "Addition", + "Description": "Added the **billingPeriod** enumeration type.", + "Target": "billingPeriod" }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Resource", + "ChangedApiName": "blob", + "ChangeType": "Addition", + "Description": "Added the [blob](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-blob?view=graph-rest-1.0) resource type.", + "Target": "blob" + }, { "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", "ChangedApiName": "exportSuccessOperation", "ChangeType": "Addition", - "Description": "Added the [exportSuccessOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-exportSuccessOperation?view=graph-rest-1.0) resource.", + "Description": "Added the [exportSuccessOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-exportSuccessOperation?view=graph-rest-1.0) resource type.", "Target": "exportSuccessOperation" }, { @@ -111,7 +161,7 @@ "ApiChange": "Resource", "ChangedApiName": "failedOperation", "ChangeType": "Addition", - "Description": "Added the [failedOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-failedOperation?view=graph-rest-1.0) resource.", + "Description": "Added the [failedOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-failedOperation?view=graph-rest-1.0) resource type.", "Target": "failedOperation" }, { @@ -119,7 +169,7 @@ "ApiChange": "Resource", "ChangedApiName": "manifest", "ChangeType": "Addition", - "Description": "Added the [manifest](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-manifest?view=graph-rest-1.0) resource.", + "Description": "Added the [manifest](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-manifest?view=graph-rest-1.0) resource and a supported method.", "Target": "manifest" }, { @@ -127,7 +177,7 @@ "ApiChange": "Resource", "ChangedApiName": "operation", "ChangeType": "Addition", - "Description": "Added the [operation](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-operation?view=graph-rest-1.0) resource.", + "Description": "Added the [operation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-operation?view=graph-rest-1.0) resource and a supported method.", "Target": "operation" }, { @@ -135,40 +185,64 @@ "ApiChange": "Resource", "ChangedApiName": "runningOperation", "ChangeType": "Addition", - "Description": "Added the [runningOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-runningOperation?view=graph-rest-1.0) resource.", + "Description": "Added the [runningOperation](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-runningOperation?view=graph-rest-1.0) resource type.", "Target": "runningOperation" }, { "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", - "ChangedApiName": "unbilledUsage", + "ChangedApiName": "partners", "ChangeType": "Addition", - "Description": "Added the [unbilledUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners.billing-unbilledUsage?view=graph-rest-1.0) resource.", - "Target": "unbilledUsage" + "Description": "Added the [partners](https://learn.microsoft.com/en-us/graph/api/resources/partners?view=graph-rest-1.0) resource type.", + "Target": "partners" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Resource", + "ChangedApiName": "billing", + "ChangeType": "Addition", + "Description": "Added the [billing](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-billing?view=graph-rest-1.0) resource type.", + "Target": "billing" }, { "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", - "ApiChange": "Method", - "ChangedApiName": "export", + "ApiChange": "Resource", + "ChangedApiName": "azureUsage", "ChangeType": "Addition", - "Description": "Added the [export](https://learn.microsoft.com/en-us/graph/api/partners.billing-billedUsage-export?view=graph-rest-1.0) method to the [billedUsage](https://learn.microsoft.com/en-us/graph/api/partners.billing-billedUsage?view=graph-rest-1.0) resource.", + "Description": "Added the [azureUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-azureUsage?view=graph-rest-1.0) resource type.", + "Target": "azureUsage" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Resource", + "ChangedApiName": "billedUsage", + "ChangeType": "Addition", + "Description": "Added the [billedUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-billedUsage?view=graph-rest-1.0) resource and a supported method.", "Target": "billedUsage" }, { "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", - "ApiChange": "Method", - "ChangedApiName": "export", + "ApiChange": "Resource", + "ChangedApiName": "unbilledUsage", "ChangeType": "Addition", - "Description": "Added the [export](https://learn.microsoft.com/en-us/graph/api/partners.billing-unbilledUsage-export?view=graph-rest-1.0) method to the [unbilledUsage](https://learn.microsoft.com/en-us/graph/api/partners.billing-unbilledUsage?view=graph-rest-1.0) resource.", + "Description": "Added the [unbilledUsage](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-unbilledUsage?view=graph-rest-1.0) resource and a supported method.", "Target": "unbilledUsage" + }, + { + "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", + "ApiChange": "Relationship", + "ChangedApiName": "partners", + "ChangeType": "Addition", + "Description": "Added the **partners** relationship to the [reportRoot](https://learn.microsoft.com/en-us/graph/api/resources/reportRoot?view=graph-rest-1.0) resource.", + "Target": "reportRoot" } ], "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "Cloud": "Prod", "Version": "v1.0", - "CreatedDateTime": "2024-01-22T08:46:33.6864129Z", - "WorkloadArea": "Microsoft.Partner.Billing", - "SubArea": "" + "CreatedDateTime": "2024-01-16T08:51:46.3920632Z", + "WorkloadArea": "Reports", + "SubArea": "Partner billing reports" } ] -} \ No newline at end of file +} From 4fe37fe6e95472c9531be2632d9d88bd58718d36 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 06:46:48 +0100 Subject: [PATCH 18/35] Update Microsoft.Partner.Billing.json Edit. --- changelog/Microsoft.Partner.Billing.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/changelog/Microsoft.Partner.Billing.json b/changelog/Microsoft.Partner.Billing.json index c514d39719e..5cd68442a42 100644 --- a/changelog/Microsoft.Partner.Billing.json +++ b/changelog/Microsoft.Partner.Billing.json @@ -1,7 +1,7 @@ -{ +{ "changelog": [ { - "ChangeList": [ + "ChangeList": [ { "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", "ApiChange": "Enum type", @@ -25,7 +25,7 @@ "ChangeType": "Addition", "Description": "Added the [blob](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-blob?view=graph-rest-beta) resource type.", "Target": "blob" - }, + }, { "Id": "7c2c17ad-d53f-4573-bc55-3f5738450f30", "ApiChange": "Resource", @@ -122,8 +122,8 @@ "WorkloadArea": "Reports", "SubArea": "Partner billing reports" }, - { - "ChangeList": [ + { + "ChangeList": [ { "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Enum type", @@ -147,7 +147,7 @@ "ChangeType": "Addition", "Description": "Added the [blob](https://learn.microsoft.com/en-us/graph/api/resources/partners-billing-blob?view=graph-rest-1.0) resource type.", "Target": "blob" - }, + }, { "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "ApiChange": "Resource", From d0a877cd4941a559d890d6824946c410e9127931 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 06:48:42 +0100 Subject: [PATCH 19/35] Update partners-billing-api-overview.md Edit. --- api-reference/v1.0/resources/partners-billing-api-overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/v1.0/resources/partners-billing-api-overview.md b/api-reference/v1.0/resources/partners-billing-api-overview.md index 876e20cc51b..d9b86d81925 100644 --- a/api-reference/v1.0/resources/partners-billing-api-overview.md +++ b/api-reference/v1.0/resources/partners-billing-api-overview.md @@ -8,10 +8,10 @@ doc_type: resourcePageType ms.custom: zt-include --- -[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] - # Use the Microsoft Graph API to export partner billing data +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] + As part of the Microsoft Partner Center ecosystem, Microsoft direct partners in the Cloud Solution Provider programs can request to export their billed and unbilled data to Azure Blob Storage asynchronously. this removes the need to maintain an open connection for hours and loop through millions of transactions iteratively. The asynchronous API provides a way to quickly access billing and reconciliation data in manageable chunks. The partner billing API is defined in the OData subnamespace `microsoft.graph.partners.billing`. From 874d2bbcf99e2365787fd053463f247c68ec6f0f Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 06:52:33 +0100 Subject: [PATCH 20/35] Update partners-billing-concept-overview.md Edit. --- concepts/partners-billing-concept-overview.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/concepts/partners-billing-concept-overview.md b/concepts/partners-billing-concept-overview.md index b66478706dc..c5d89d09d57 100644 --- a/concepts/partners-billing-concept-overview.md +++ b/concepts/partners-billing-concept-overview.md @@ -43,10 +43,10 @@ Use the [Get operation](/graph/api/partners-billing-operation-get) endpoint to p Looking for the API reference for this service? -- [Partner billing reports API in Microsoft Graph v1.0](/graph/api/resources/partners-billing-api-overview?view=graph-rest-1.0&preserve-view=true) -- [Partner billing reports API in Microsoft Graph beta](/graph/api/resources/partners-billing-api-overview?view=graph-rest-beta&preserve-view=true) +- [Partner billing API in Microsoft Graph v1.0](/graph/api/resources/partners-billing-api-overview?view=graph-rest-1.0&preserve-view=true) +- [Partner billing API in Microsoft Graph beta](/graph/api/resources/partners-billing-api-overview?view=graph-rest-beta&preserve-view=true) ## Next steps -- To learn more about the partner billing reports API, see [Use the Microsoft Graph API to export partner billing data](/graph/api/resources/partners-billing-api-overview). +- To learn more about the partner billing API, see [Use the Microsoft Graph API to export partner billing data](/graph/api/resources/partners-billing-api-overview). - Try the partner billing API in [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). From 2b3f1ebc107692c18d5c3f3b42196ff5d72f275a Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 06:58:08 +0100 Subject: [PATCH 21/35] Update toc.yml Edit. --- api-reference/v1.0/toc.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/v1.0/toc.yml b/api-reference/v1.0/toc.yml index df0800448f5..eabade0c3f3 100644 --- a/api-reference/v1.0/toc.yml +++ b/api-reference/v1.0/toc.yml @@ -7543,8 +7543,8 @@ items: href: resources/attacksimulationtrainingusercoverage.md - name: Get training coverage for users href: api/securityreportsroot-getattacksimulationtrainingusercoverage.md - - name: Partner billing reports - items: + - name: Partner billing reports + items: - name: Overview href: resources/partners-billing-api-overview.md - name: Billed usage From c002269cbbc21fdece02d1b5017a23f460376dfb Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 07:02:54 +0100 Subject: [PATCH 22/35] Update partners-billing-api-overview.md Edit. --- api-reference/beta/resources/partners-billing-api-overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/resources/partners-billing-api-overview.md b/api-reference/beta/resources/partners-billing-api-overview.md index 54ad77bb4d2..74dfee0a235 100644 --- a/api-reference/beta/resources/partners-billing-api-overview.md +++ b/api-reference/beta/resources/partners-billing-api-overview.md @@ -1,5 +1,5 @@ --- -title: "Use the Microsoft Graph API to export partner billing data (preview)" +title: "Use the Microsoft Graph API to export partner billing data" description: "The partner billing API in Microsoft Graph offers Microsoft direct partners a faster, more efficient way to export their high-volume billed and unbilled Azure usage data." author: "abhishek-singh-ms" ms.localizationpriority: medium @@ -8,7 +8,7 @@ doc_type: resourcePageType ms.custom: zt-include --- -# Use the Microsoft Graph API to export partner billing data (preview) +# Use the Microsoft Graph API to export partner billing data [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] From c5697f654e95e5756e2fdbd5c1cdfaf48538bc62 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 07:03:21 +0100 Subject: [PATCH 23/35] Update toc.yml Edit. --- api-reference/beta/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/toc.yml b/api-reference/beta/toc.yml index 98ba8110fcd..0380431a466 100644 --- a/api-reference/beta/toc.yml +++ b/api-reference/beta/toc.yml @@ -16349,7 +16349,7 @@ items: href: resources/attacksimulationtrainingusercoverage.md - name: Get training coverage for users href: api/securityreportsroot-getattacksimulationtrainingusercoverage.md - - name: Partner billing reports (preview) + - name: Partner billing reports items: - name: Overview href: resources/partners-billing-api-overview.md From 1c7a5702d2046c5521762e5049ec0c167b329631 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 07:08:41 +0100 Subject: [PATCH 24/35] Update alerts-callout-csp-partner-only.md Edit. --- api-reference/v1.0/includes/alerts-callout-csp-partner-only.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md index ecbd8a799be..dd2defce5bf 100644 --- a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md +++ b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md @@ -7,5 +7,5 @@ ms.topic: include > [!NOTE] -> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about about the CSP program, see [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview). +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about the CSP program, see [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview). From 16f83d4b270ebdb92e1cbf6f2d61f367ec2a4e4b Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 07:12:45 +0100 Subject: [PATCH 25/35] Update alerts-callout-csp-partner-only.md Edit. --- api-reference/beta/includes/alerts-callout-csp-partner-only.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/includes/alerts-callout-csp-partner-only.md b/api-reference/beta/includes/alerts-callout-csp-partner-only.md index f90fa35a088..f5cc78b377f 100644 --- a/api-reference/beta/includes/alerts-callout-csp-partner-only.md +++ b/api-reference/beta/includes/alerts-callout-csp-partner-only.md @@ -7,5 +7,5 @@ ms.topic: include > [!NOTE] -> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled data for a tenant. For information about the CSP program, see the [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview) page. +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about the CSP program, see [Microsoft Cloud Solution Provider](https://learn.microsoft.com/partner-center/csp-overview). From 412c2050da4db7859467d15765a1993b6514e927 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 07:13:03 +0100 Subject: [PATCH 26/35] Update alerts-callout-csp-partner-only.md Edit. --- api-reference/v1.0/includes/alerts-callout-csp-partner-only.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md index dd2defce5bf..f5cc78b377f 100644 --- a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md +++ b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md @@ -7,5 +7,5 @@ ms.topic: include > [!NOTE] -> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about the CSP program, see [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview). +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about the CSP program, see [Microsoft Cloud Solution Provider](https://learn.microsoft.com/partner-center/csp-overview). From 3569204f608d11967a42b8975639a85ef10de5cf Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 24 Jan 2024 07:17:09 +0100 Subject: [PATCH 27/35] Update partners-billing-blob.md Edit. --- api-reference/v1.0/resources/partners-billing-blob.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/v1.0/resources/partners-billing-blob.md b/api-reference/v1.0/resources/partners-billing-blob.md index f60f611ca84..5113d7519ae 100644 --- a/api-reference/v1.0/resources/partners-billing-blob.md +++ b/api-reference/v1.0/resources/partners-billing-blob.md @@ -11,6 +11,7 @@ doc_type: resourcePageType Namespace: microsoft.graph.partners.billing +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] Represents a billing blob that contains exported data. From a89a0925de6d151387c8a950fbe062a0ca310994 Mon Sep 17 00:00:00 2001 From: Abhishek Singh Date: Wed, 24 Jan 2024 14:50:24 -0800 Subject: [PATCH 28/35] added CSP alerts --- concepts/partners-billing-concept-overview.md | 2 ++ includes/alerts-callout-csp-partner-only.md | 11 +++++++++++ 2 files changed, 13 insertions(+) create mode 100644 includes/alerts-callout-csp-partner-only.md diff --git a/concepts/partners-billing-concept-overview.md b/concepts/partners-billing-concept-overview.md index 5c8ddea2e71..59f82910e6e 100644 --- a/concepts/partners-billing-concept-overview.md +++ b/concepts/partners-billing-concept-overview.md @@ -6,6 +6,8 @@ ms.localizationpriority: medium ms.prod: "reports" --- +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] + # Use the partner billing API in Microsoft Graph to access billing data (preview) The partner billing API in Microsoft Graph allow Microsoft direct partners in the Cloud Solution Provider programs to export their high-volume billed and unbilled data asynchronously. This removes the need to maintain an open connection for hours and loop through millions of transactions iteratively. Asynchronous APIs enable fast, efficient retrieval of billing and reconciliation data in manageable chunks for quicker reconciliation. diff --git a/includes/alerts-callout-csp-partner-only.md b/includes/alerts-callout-csp-partner-only.md new file mode 100644 index 00000000000..ecbd8a799be --- /dev/null +++ b/includes/alerts-callout-csp-partner-only.md @@ -0,0 +1,11 @@ +--- +author: "sourishdeb" +ms.localizationpriority: medium +ms.prod: "reports" +ms.topic: include +--- + + +> [!NOTE] +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about about the CSP program, see [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview). + From 4765e6f0e17d45a6ff3a332dc0e2cf2a15a71b93 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Thu, 25 Jan 2024 05:58:42 +0100 Subject: [PATCH 29/35] Update alerts-callout-csp-partner-only.md Edit. --- api-reference/beta/includes/alerts-callout-csp-partner-only.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/includes/alerts-callout-csp-partner-only.md b/api-reference/beta/includes/alerts-callout-csp-partner-only.md index f5cc78b377f..ffd32d115de 100644 --- a/api-reference/beta/includes/alerts-callout-csp-partner-only.md +++ b/api-reference/beta/includes/alerts-callout-csp-partner-only.md @@ -7,5 +7,5 @@ ms.topic: include > [!NOTE] -> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about the CSP program, see [Microsoft Cloud Solution Provider](https://learn.microsoft.com/partner-center/csp-overview). +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about the CSP program, see [Microsoft Cloud Solution Provider](/partner-center/csp-overview). From 49103eba3b751a7712cd01d7b11574f57a7bedc3 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Thu, 25 Jan 2024 05:59:21 +0100 Subject: [PATCH 30/35] Update alerts-callout-csp-partner-only.md Edit. --- api-reference/v1.0/includes/alerts-callout-csp-partner-only.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md index f5cc78b377f..ffd32d115de 100644 --- a/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md +++ b/api-reference/v1.0/includes/alerts-callout-csp-partner-only.md @@ -7,5 +7,5 @@ ms.topic: include > [!NOTE] -> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about the CSP program, see [Microsoft Cloud Solution Provider](https://learn.microsoft.com/partner-center/csp-overview). +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about the CSP program, see [Microsoft Cloud Solution Provider](/partner-center/csp-overview). From 4308831e46fc2f312b318c90275a01046f1fa79e Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Thu, 25 Jan 2024 06:01:31 +0100 Subject: [PATCH 31/35] Update alerts-callout-csp-partner-only.md Edit. --- includes/alerts-callout-csp-partner-only.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/includes/alerts-callout-csp-partner-only.md b/includes/alerts-callout-csp-partner-only.md index ecbd8a799be..ffd32d115de 100644 --- a/includes/alerts-callout-csp-partner-only.md +++ b/includes/alerts-callout-csp-partner-only.md @@ -7,5 +7,5 @@ ms.topic: include > [!NOTE] -> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about about the CSP program, see [Microsoft Cloud Solution Provider](https://learn.microsoft.com/en-us/partner-center/csp-overview). +> This API is available for Cloud Solution Provider (CSP) partners only to access their billed and unbilled reconciliation data for a tenant. To learn more about the CSP program, see [Microsoft Cloud Solution Provider](/partner-center/csp-overview). From e2b23d9e1c7ad1188c5ee1d8868a82ea671da5cf Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Thu, 25 Jan 2024 06:05:41 +0100 Subject: [PATCH 32/35] Update partners-billing-concept-overview.md Edit. --- concepts/partners-billing-concept-overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/concepts/partners-billing-concept-overview.md b/concepts/partners-billing-concept-overview.md index 0e5010ca16d..efcf1fb40ed 100644 --- a/concepts/partners-billing-concept-overview.md +++ b/concepts/partners-billing-concept-overview.md @@ -6,10 +6,10 @@ ms.localizationpriority: medium ms.prod: "reports" --- -[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] - # Use the partner billing API in Microsoft Graph to access billing data +[!INCLUDE [alerts-callout-csp-partner-only](../includes/alerts-callout-csp-partner-only.md)] + The partner billing API in Microsoft Graph allow Microsoft direct partners in the Cloud Solution Provider programs to export their high-volume billed and unbilled data asynchronously. This removes the need to maintain an open connection for hours and loop through millions of transactions iteratively. Asynchronous APIs enable fast, efficient retrieval of billing and reconciliation data in manageable chunks for quicker reconciliation. ## Why use the partner billing API? From d647b65f1a10536408d02fb3e432ddbeeaf61418 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Thu, 25 Jan 2024 06:07:57 +0100 Subject: [PATCH 33/35] Delete api-reference/v1.0/includes/permissions/operation-get-permissions.md Deleted since this include isn't used anywhere. --- .../v1.0/includes/permissions/operation-get-permissions.md | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 api-reference/v1.0/includes/permissions/operation-get-permissions.md diff --git a/api-reference/v1.0/includes/permissions/operation-get-permissions.md b/api-reference/v1.0/includes/permissions/operation-get-permissions.md deleted file mode 100644 index 0b40e599af1..00000000000 --- a/api-reference/v1.0/includes/permissions/operation-get-permissions.md +++ /dev/null @@ -1,6 +0,0 @@ -|Permission type|Least privileged permission|Higher privileged permissions| -|:---|:---|:---| -|Delegated (work or school account)|PartnerBilling.Read.All|Not supported.| -|Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|PartnerBilling.Read.All|Not supported.| - From 12acdd57c9f376b69bee616dbabdc4196cabf24d Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Thu, 25 Jan 2024 06:08:38 +0100 Subject: [PATCH 34/35] Delete api-reference/beta/includes/permissions/operation-get-permissions.md Deleted since this include isn't used anywhere. --- .../beta/includes/permissions/operation-get-permissions.md | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 api-reference/beta/includes/permissions/operation-get-permissions.md diff --git a/api-reference/beta/includes/permissions/operation-get-permissions.md b/api-reference/beta/includes/permissions/operation-get-permissions.md deleted file mode 100644 index 0b40e599af1..00000000000 --- a/api-reference/beta/includes/permissions/operation-get-permissions.md +++ /dev/null @@ -1,6 +0,0 @@ -|Permission type|Least privileged permission|Higher privileged permissions| -|:---|:---|:---| -|Delegated (work or school account)|PartnerBilling.Read.All|Not supported.| -|Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|PartnerBilling.Read.All|Not supported.| - From 6c3ee1847f1fff544dcf957022fac78be34543fc Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Wed, 31 Jan 2024 19:43:24 -0800 Subject: [PATCH 35/35] Update Microsoft.Partner.Billing.json --- changelog/Microsoft.Partner.Billing.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/changelog/Microsoft.Partner.Billing.json b/changelog/Microsoft.Partner.Billing.json index 5cd68442a42..09cdb621413 100644 --- a/changelog/Microsoft.Partner.Billing.json +++ b/changelog/Microsoft.Partner.Billing.json @@ -240,7 +240,7 @@ "Id": "abf7f5a2-4842-4016-a573-08731f5cb362", "Cloud": "Prod", "Version": "v1.0", - "CreatedDateTime": "2024-01-16T08:51:46.3920632Z", + "CreatedDateTime": "2024-01-31T08:51:46.3920632Z", "WorkloadArea": "Reports", "SubArea": "Partner billing reports" }