Müşterinin tüm abonelikleri için kullanım özeti alma

için geçerlidir: İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Geçerli faturalama döneminde bir müşterinin belirli bir Azure hizmeti veya kaynağını kullanımını öğrenmek için CustomerUsageSummary kaynağını kullanabilirsiniz.

Not

Genel olarak, günlük derecelendirilmemiş kullanım verileri 24 saat sonra API veya İş Ortağı Merkezi portalı aracılığıyla kullanılabilir. Konumunuza bağlı olarak ve ölçümler kullanımı bildirdiğinde ek gecikmeler yaşanabilir.

Bazen, ayın başından önceki ayın faturalanan kullanım verileri teslim edilene kadar en son faturalanmamış kullanım verilerini göremeyebilirsiniz. Bu, faturalanan kullanım verilerinin SLA içinde verimli bir şekilde teslim edilediğinden emin olmaktır. Faturalanan kullanım verilerini aldıktan sonra, ayın başından itibaren güncelleştirilmiş tüm faturalanmamış kullanım verilerini almaya başlayabilirsiniz.

Önkoşullar

  • İş Ortağı Merkezi kimlik doğrulaması'nde açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.

  • Bir müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'de Müşteriler çalışma alanını seçip müşteri listesinden müşteriyi, ardından Hesap'ı seçerek arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği arayın. Microsoft kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.

C#

Müşterinin tüm aboneliklerinin kullanım özetini almak için:

  1. ById() yöntemini çağırmak için IAggregatePartner.Customers koleksiyonunuzu kullanın.

  2. UsageSummary özelliğini ve ardından get() veya GetAsync() yöntemlerini çağırın:

    // IAggregatePartner partnerOperations;
// var selectedCustomerId as string;

var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();

Bir örnek için aşağıdakilere bakın:

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
GET {baseURL}/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1

URI parametresi

Bu tabloda, müşterinin derecelendirilmiş kullanım bilgilerini almak için gerekli sorgu parametresi listelenir.

Adı Tür Gerekli Açıklama
customer-tenant-id rehber Y Müşteriye karşılık gelen GUID.

İstek başlıkları

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

İstek gövdesi

Hiç kimse.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde CustomerUsageSummary bir kaynak döndürür.

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

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Hata Kodları.

Microsoft Azure (MS-AZR-0145P) aboneliği için yanıt örneği

Bu örnekte müşteri bir 145P Azure PayG teklifi satın almış.

Microsoft Azure (MS-AZR-0145P) aboneliklerine sahip müşteriler için API yanıtlarında hiçbir değişiklik olmaz.

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget":{
        "ammount":300.000000,
        "attributes":{
            "objectType":"SpendingBudget"
        }
    },
    "id":"65726577-C208-40FD-9735-8C85AC9CAC68",
    "name":"600 test",
    "billingStartDate":"2016-02-06T00:00:00-08:00",
    "billingEndDate":"2016-03-05T00:00:00-08:00",
    "totalCost":0.0,
    "currencyLocale":"en-US",
    "lastModifiedDate":"2016-02-26T09:42:54.5130558+00:00",
    "links":{
        "self":{
            "uri":"/customers/{customer-tenant-id}/usagesummary",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"CustomerUsageSummary"
    }
}

Azure planı için yanıt örneği

Bu örnekte müşteri bir Azure planı satın almış.

Azure planlarına sahip müşteriler için API yanıtta aşağıdaki değişiklikler vardır:

  • para birimi yereli yerine para birimi kodu ile değiştirildi
  • usdTotalCost yeni bir veri alanı
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget": {
        "amount": 97,
        "attributes": {
            "objectType": "SpendingBudget"
        }
    },
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "resourceName": "Modern Azure Customer UK",
    "billingStartDate": "2019-09-01T00:00:00+00:00",
    "billingEndDate": "2019-10-01T00:00:00+00:00",
    "totalCost": 28.82860766744404945074,
    "currencyCode": "GBP",
    "usdTotalCost": 35.23000000000000362337,
    "lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
    "attributes": {
        "objectType": "CustomerUsageSummary"
    }
}
  • Last updated on