Faturalandırılmamış ticari tüketim satırı öğelerini alma

Makale
04/26/2024

Not

30 Eylül 2024'ün ardından bu API artık çalışmayacaktır. Sürümünüzü seçmek ve önceden planlamak için bu bilgileri kullanın.

Geçerli ve önceki faturalama dönemlerine ait faturalanmamış günlük kullanım ayrıntılarına erişmek için bu API'yi kullanın. Bu tarihten önce v2 GA'ya geçmediğiniz sürece 30 Eylül 2024'e kadar kullanabilirsiniz.
Geçerli ve önceki dönemlerde faturalanmamış günlük derecelendirmeli kullanım elde etmek için 30 Eylül 2024'e kadar API v2 GA'ya geçin.

API v2 geçiş adımları için şuraya gidin:

Faturalandırılmış ve faturalanmamış günlük derecelendirilmiş kullanım mutabakatı API'si v2 (GA)

Faturalanmamış ticari tüketim satırı öğesi ayrıntılarının koleksiyonunu alma.

Program aracılığıyla, faturalanmamış ticari tüketim satırı öğelerinin (açık kullanım satırı öğeleri olarak da bilinir) ayrıntılarının bir koleksiyonunu almak için aşağıdaki yöntemleri kullanabilirsiniz.

Önemli

Günlük derecelendirilmiş kullanım verileri, bu ürünlerin ücretlerini içermez:

Azure rezervasyonu
Azure tasarruf planı
Office
Dynamics
Microsoft Power Apps
Kalıcı yazılım
Yazılım aboneliği
Market SaaS ürünü

Not

Günlük faturalanmamış kullanım verilerinizi API veya İş Ortağı Merkezi portalı aracılığıyla alabilirsiniz. Verilerin kullanılabilir duruma gelmesi 24 saate kadar sürebilir. Ancak, konumunuza ve ölçümler kullanımı bildirdiğinde daha fazla gecikme olabilir.

Bazen, önceki aya ilişkin faturalanan kullanım verileri teslim edilene kadar en son faturalanmamış kullanım verilerini göremeyebilirsiniz. Bu, faturalanan kullanım verilerinin kararlaştırılan süre içinde teslim edilmesini sağlamak için yapılır. Faturalanan kullanım verilerini aldıktan sonra, ayın başından itibaren güncelleştirilmiş tüm faturalanmamış kullanım verilerini alabilmeniz gerekir.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

C#

Belirtilen faturanın satır öğelerini almak için:

Belirtilen faturanın fatura işlemlerine yönelik bir arabirim almak için ById yöntemini çağırın.
Fatura nesnesini almak için Get veya GetAsync yöntemini çağırın.

Fatura nesnesi , belirtilen faturayla ilgili tüm bilgileri içerir. Sağlayıcı, faturalanmamış ayrıntı bilgilerinin kaynağını (örneğin, OneTime) tanımlar. InvoiceLineItemType türü belirtir (örneğin, UsageLineItem).

Aşağıdaki örnek kod, InvoiceLineItems koleksiyonunu işlemek için bir foreach döngüsü kullanır. Her InvoiceLineItemType için ayrı bir satır öğeleri koleksiyonu alınır.

InvoiceDetail örneğine karşılık gelen satır öğeleri koleksiyonunu almak için:

Örneğin BillingProvider ve InvoiceLineItemType bilgilerini By yöntemine geçirin.
İlişkili satır öğelerini almak için Get veya GetAsync yöntemini çağırın.
Aşağıdaki örnekte gösterildiği gibi koleksiyonda geçiş yapmak için bir numaralandırıcı oluşturun.

// IAggregatePartner partnerOperations;
// string curencyCode;
// string period;
// int pageMaxSizeReconLineItems = 2000;

// all the operations executed on this partner operation instance will share the same correlation Id but will differ in request Id
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));

var seekBasedResourceCollection = scopedPartnerOperations.Invoices.ById("unbilled").By("onetime", "usagelineitems", curencyCode, period, pageMaxSizeReconLineItems).Get();

var fetchNext = true;

ConsoleKeyInfo keyInfo;

var itemNumber = 1;
while (fetchNext)
{
    Console.Out.WriteLine("\tLine items count: " + seekBasedResourceCollection.Items.Count());

    seekBasedResourceCollection.Items.ToList().ForEach(item =>
    {
        // Instance of type DailyRatedUsageLineItem
        if (item is DailyRatedUsageLineItem)
        {
            Type t = typeof(DailyRatedUsageLineItem);
            PropertyInfo[] properties = t.GetProperties();

            foreach (PropertyInfo property in properties)
            {
                // Insert code here to work with the line item properties
            }
        }
        itemNumber++;
    });

    Console.Out.WriteLine("\tPress any key to fetch next data. Press the Escape (Esc) key to quit: \n");
    keyInfo = Console.ReadKey();

    if (keyInfo.Key == ConsoleKey.Escape)
    {
        break;
    }

    fetchNext = !string.IsNullOrWhiteSpace(seekBasedResourceCollection.ContinuationToken);

    if (fetchNext)
    {
        if (seekBasedResourceCollection.Links.Next.Headers != null && seekBasedResourceCollection.Links.Next.Headers.Any())
        {
            seekBasedResourceCollection = scopedPartnerOperations.Invoices.ById("unbilled").By("onetime", "usagelineitems", curencyCode, period, pageMaxSizeReconLineItems).Seek(seekBasedResourceCollection.ContinuationToken, SeekOperation.Next);
        }
    }
}

Benzer bir örnek için bkz:

Örnek: Konsol test uygulaması
Proje: İş Ortağı Merkezi SDK Örnekleri
Sınıf: GetUnBilledConsumptionReconLineItemsPaging.cs

REST isteği

İstek söz dizimi

Kullanım örneğine bağlı olarak REST isteğiniz için aşağıdaki söz dizimlerini kullanabilirsiniz. Daha fazla bilgi için her söz diziminin açıklamalarına bakın.

Metot	İstek URI'si	Söz dizimi kullanım örneğinin açıklaması
GET	{baseURL}/v1/invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode}&period={period} HTTP/1.1	Verilen fatura için her satır öğesinin tam listesini döndürmek için bu söz dizimini kullanın.
GET	{baseURL}/v1/invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode}&period={period}&size={size} HTTP/1.1	Büyük faturalar için bu söz dizimlerini kullanın. Satır öğelerinin sayfalanmış listesini döndürmek için bu söz dizimini belirtilen boyut ve 0 tabanlı uzaklık ile kullanın.
GET	{baseURL}/v1/invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=usagelineitems¤cycode={currencycode}&period={period}&size={size}&seekOperation=Next	kullanarak `seekOperation = "Next"`mutabakat satırı öğelerinin sonraki sayfasını almak için bu söz dizimini kullanın.

URI parametreleri

İsteği oluştururken aşağıdaki URI'yi ve sorgu parametrelerini kullanın.

Adı	Tür	Zorunlu	Açıklama
sağlayıcı	string	Yes	Sağlayıcı: "OneTime".
invoice-line-item-type	string	Yes	Fatura ayrıntılarının türü: "UsageLineItems", "UsageLineItems".
currencyCode	string	Yes	Faturalanmamış satır öğelerinin para birimi kodu.
Dönem	string	Yes	Faturalanmamış mutabakat dönemi (örneğin: geçerli, önceki). Ocak ayında fatura dönemine (01/01/2020 – 01/31/2020) ait faturalanmamış kullanım verilerinizi sorgulamanız gerektiğini varsayalım, dönemi "Geçerli" olarak, diğer adıyla "Önceki" olarak seçin.
size	numara	Hayır	Döndürülecek en fazla öğe sayısı. Varsayılan boyut 2000'dir.
seekOperation	Dize	Hayır	Mutabakat satırı öğelerinin sonraki sayfasını alacak şekilde ayarlayın `seekOperation=Next` .

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

Request body

Yok.

REST yanıtı

Başarılı olursa, yanıt satır öğesi ayrıntıları koleksiyonunu içerir.

ChargeType satır öğesi için Purchasedeğeri Yeni ve Para İadesi değeri İptal'e eşlenir.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu ve diğer hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST hata kodları.

İstek yanıtı örnekleri

İstek yanıtı örneği 1

Aşağıdaki ayrıntılar bu örnek için geçerlidir:

Sağlayıcı: OneTime
InvoiceLineItemType: UsageLineItems
Dönem: Önceki

İstek örneği 1

GET https://api.partnercenter.microsoft.com/v1//invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=usagelineitems&currencycode=usd&period=previous&size=2000 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 1234ecb8-37af-45f4-a1a1-358de3ca2b9e
MS-CorrelationId: 5e612512-4345-4bb0-866e-47aeda031234
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com

Önemli

Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.

İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.

Yanıt örneği 1

HTTP/1.1 200 OK
Content-Length: 2484
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 5e612512-4345-4bb0-866e-47aeda031234
MS-RequestId: 1234ecb8-37af-45f4-a1a1-358de3ca2b9e
MS-CV: bpqyomePDUqrSSYC.0
MS-ServerId: 202010406
Date: Wed, 20 Feb 2019 19:59:27 GMT

{
    "totalCount": 2,
    "items": [
        {
            "partnerId": "00083575-bbd0-54de-b2ad-0f5b0e927d71",
            "partnerName": "MTBC",
            "customerId": "",
            "customerName": "",
            "customerDomainName": "",
            "invoiceNumber": "",
            "productId": "",
            "skuId": "",
            "availabilityId": "",
            "skuName": "VM-Series Next-Generation Firewall (Bundle 2 PAYG)",
            "productName": "VM-Series Next Generation Firewall",
            "publisherName": "Test Alto Networks, Inc.",
            "publisherId": "",
            "subscriptionId": "12345678-04d9-421c-baf8-e3b8dd62ddba",
            "subscriptionDescription": "Pay-As-You-Go",
            "chargeStartDate": "2019-01-01T00:00:00Z",
            "chargeEndDate": "2019-02-01T00:00:00Z",
            "usageDate": "2019-01-01T00:00:00Z",
            "meterType": "1 Compute Hour - 4core",
            "meterCategory": "Virtual Machine Licenses",
            "meterId": "4core",
            "meterSubCategory": "VM-Series Next Generation Firewall",
            "meterName": "VM-Series Next Generation Firewall - VM-Series Next-Generation Firewall (Bundle 2 PAYG) - 4 Core Hours",
            "meterRegion": "",
            "unitOfMeasure": "1 Hour",
            "resourceLocation": "EASTUS",
            "consumedService": "Microsoft.Compute",
            "resourceGroup": "ECH-PAN-RG",
            "resourceUri": "/subscriptions/12345678-04d9-421c-baf8-e3b8dd62ddba/resourceGroups/ECH-PAN-RG/providers/Microsoft.Compute/virtualMachines/echpanfw",
            "tags": "",
            "additionalInfo": "{  \"ImageType\": null,  \"ServiceType\": \"Standard_D3_v2\",  \"VMName\": null,  \"VMProperties\": null,  \"UsageType\": \"ComputeHR_SW\"}",
            "serviceInfo1": "",
            "serviceInfo2": "",
            "customerCountry": "",
            "mpnId": "1234567",
            "resellerMpnId": "",
            "chargeType": "",
            "unitPrice": 1.2799888920023,
            "quantity": 24.0,
            "unitType": "",
            "billingPreTaxTotal": 30.7197334080551,
            "billingCurrency": "USD",
            "pricingPreTaxTotal": 30.7197334080551,
            "pricingCurrency": "USD",
            "entitlementId": "3f47bcf1-965d-40a1-a2bc-3d5db3653250",
            "entitlementDescription": "Partner Subscription",
            "pcToBCExchangeRate": 1,
            "pcToBCExchangeRateDate": "2019-08-01T00:00:00Z",
            "effectiveUnitPrice": 0,
            "rateOfPartnerEarnedCredit": 0,
            "rateOfCredit": 0,
            "creditType": "Credit Not Applied",
            "invoiceLineItemType": "usage_line_items",
            "billingProvider": "marketplace",
        "benefitOrderId": "5ea053d6-4a0d-46ef-bc82-15065b475d01",
        "benefitId": "28ddab06-2c5b-479e-88bb-7b7bfda4e7fd",
        "benefitType": "SavingsPlan",
            "attributes": {
                "objectType": "DailyRatedUsageLineItem"
            }
         },
         {
            "partnerId": "00083575-bbd0-54de-b2ad-0f5b0e927d71",
            "partnerName": "MTBC",
            "customerId": "",
            "customerName": "",
            "customerDomainName": "",
            "invoiceNumber": "",
            "productId": "",
            "skuId": "",
            "availabilityId": "",
            "skuName": "VM-Series Next-Generation Firewall (Bundle 2 PAYG)",
            "productName": "VM-Series Next Generation Firewall",
            "publisherName": "Test Alto Networks, Inc.",
            "publisherId": "",
            "subscriptionId": "12345678-04d9-421c-baf8-e3b8dd62ddba",
            "subscriptionDescription": "Pay-As-You-Go",
            "chargeStartDate": "2019-01-01T00:00:00Z",
            "chargeEndDate": "2019-02-01T00:00:00Z",
            "usageDate": "2019-01-02T00:00:00Z",
            "meterType": "1 Compute Hour - 4core",
            "meterCategory": "Virtual Machine Licenses",
            "meterId": "4core",
            "meterSubCategory": "VM-Series Next Generation Firewall",
            "meterName": "VM-Series Next Generation Firewall - VM-Series Next-Generation Firewall (Bundle 2 PAYG) - 4 Core Hours",
            "meterRegion": "",
            "unitOfMeasure": "1 Hour",
            "resourceLocation": "EASTUS",
            "consumedService": "Microsoft.Compute",
            "resourceGroup": "ECH-PAN-RG",
            "resourceUri": "/subscriptions/12345678-04d9-421c-baf8-e3b8dd62ddba/resourceGroups/ECH-PAN-RG/providers/Microsoft.Compute/virtualMachines/echpanfw",
            "tags": "",
            "additionalInfo": "{  \"ImageType\": null,  \"ServiceType\": \"Standard_D3_v2\",  \"VMName\": null,  \"VMProperties\": null,  \"UsageType\": \"ComputeHR_SW\"}",
            "serviceInfo1": "",
            "serviceInfo2": "",
            "customerCountry": "",
            "mpnId": "1234567",
            "resellerMpnId": "",
            "chargeType": "",
            "unitPrice": 1.2799888920023,
            "quantity": 24.0,
            "unitType": "",
            "billingPreTaxTotal": 30.7197334080551,
            "billingCurrency": "USD",
            "pricingPreTaxTotal": 30.7197334080551,
            "pricingCurrency": "USD",
            "entitlementId": "31cdf47f-b249-4edd-9319-637862d12345",
            "entitlementDescription": "Partner Subscription",
            "pcToBCExchangeRate": 1,
            "pcToBCExchangeRateDate": "2019-08-01T00:00:00Z",
            "effectiveUnitPrice": 0,
            "rateOfPartnerEarnedCredit": 0,
            "rateOfCredit": 1,
            "creditType": "Azure Credit Applied",
            "invoiceLineItemTypce": "usage_line_items",
            "billingProvider": "marketplace",
        "benefitOrderId": "",
            "benefitId": "",
            "benefitType": "Charge",
            "attributes": {
                "objectType": "DailyRatedUsageLineItem"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=usagelineitems&currencycode=usd&period=previous&size=2000",
            "method": "GET",
            "headers": []
        },
        "next": {
            "uri": "/invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=usagelineitems&currencycode=usd&period=previous&size=2000&seekOperation=Next",
            "method": "GET",
            "headers": [
                {
                    "key": "MS-ContinuationToken",
                    "value": "AQAAAA=="
                }
            ]
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

İstek yanıtı örneği 2