Müşterinin aboneliği için kullanım özetini alma

Makale
10/07/2024

Şunlar için geçerlidir: İş Ortağı Merkezi | Microsoft Cloud for US Government için İş Ortağı Merkezi

Bir müşterinin abonelik kullanım özetini almak için SubscriptionUsageSummary kaynağını kullanabilirsiniz. Bu kaynak, geçerli faturalama döneminde belirli bir Azure hizmetinin veya kaynağının abonelik kullanım özetini temsil eder.

Ö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'ndeMüşteriler çalışma alanını ve 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.
Abonelik tanımlayıcısı

C#

Müşterinin aboneliğinin abonelik kullanım özetini almak için:

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

Ardından Subscriptions özelliğini ve UsageSummary özelliğini çağırın . Get() veya GetAsync() yöntemlerini çağırarak işlemi tamamlayın.

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

var subscriptionUsageSummary = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageSummary.Get();

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

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

REST isteği

İstek söz dizimi

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

URI parametreleri

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

Ad	Tür	Gerekli	Açıklama
customer-tenant-id	Guıd	Y	Müşteriye karşılık gelen GUID.
subscription-id	Guıd	Y	Bir aboneliğin tanımlayıcısına karşılık gelen GUID. Bir Azure planı için bu, Azure planını temsil eden ilgili İş Ortağı Merkezi abonelik kaynağının tanımlayıcısıdır. Azure planı abonelik kaynakları için bu yolda abonelik kimliği olarak plan-id* değerini sağlayın.*

İstek üst bilgileri

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

İstek gövdesi

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-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 SubscriptionUsageSummary kaynağını döndürür.

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

Her yanıt, başarıyı veya başarısızlığı ve ek hata ayıklama bilgilerini gösteren bir HTTP durum koduyla 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) abonelikleri 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

{
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "id": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "resourceName": "Microsoft Azure",
    "name": "Microsoft Azure",
    "billingStartDate": "2019-08-28T00:00:00-07:00",
    "billingEndDate": "2019-09-27T00:00:00-07:00",
    "totalCost": 22.861172,
    "currencyLocale": "fr-FR",
    "lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}

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

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

Azure planları olan müşteriler için aşağıdaki API yanıt değişiklikleri vardır:

currencyLocale, currencyCode ile değiştirildi
usdTotalCost yeni bir alan

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "resourceId": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
    "resourceName": "Azure plan",
    "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",
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}

Aracılığıyla paylaş