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

Makale
10/07/2024

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

Müşterinin geçerli faturalama döneminde belirli bir Azure hizmetini veya kaynağını kullanmasını sağlamak için CustomerUsageSummary kaynağını kullanabilirsiniz.

Dekont

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ında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde Müşteriler çalışma alanını, ardından müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek bunu arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği'ni 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:

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

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:

Örnek: Konsol test uygulaması
Proje: PartnerSDK.FeatureSamples
Sınıf: GetCustomerUsageSummary.cs

REST isteği

İstek söz dizimi

Metot	İ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.

Veri Akışı Adı	Tür	Zorunlu	Açıklama
customer-tenant-id	Guıd	Y	Müşteriye karşılık gelen GUID.

İstek üst bilgileri

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

Request body

Yok.

İ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 bir CustomerUsageSummary kaynağı 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 145P Azure PayG teklifi satın almış.

Microsoft Azure (MS-AZR-0145P) abonelikleri olan müşteriler için API yanıtını değiştirmeyecektir.

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ı olan müşteriler için API yanıtını aşağıdaki değişikliklerden geçirin:

currencyLocale , currencyCode ile değiştirildi
usdTotalCost yeni bir 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"
    }
}

Aracılığıyla paylaş