Bir abonelik için tüm aylık kullanım kayıtlarını alma

Makale
10/07/2024

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

Müşterinin aboneliğindeki hizmetlerin listesini ve ilişkili derecelendirilmiş kullanım bilgilerini almak için AzureResourceMonthlyUsageRecord kaynak koleksiyonunu kullanabilirsiniz.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de 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ı, müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek iş ortağınızı arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliğini bulun. Microsoft kimliği, müşteri kimliğiyle (customer-tenant-id ile aynıdır).
Abonelik tanımlayıcısı.

Bu API yalnızca Microsoft Azure (MS-AZR-0145P) aboneliklerini destekler. Azure planı kullanıyorsanız bkz. Ölçüme göre abonelik için kullanım verilerini alma .

C#

Aboneliğin kaynak kullanım bilgilerini almak için:

ById() yöntemini çağırmak için IAggregatePartner.Customers koleksiyonunuzu kullanın.
Subscriptions özelliğini ve UsageRecords'u ve ardından Resources özelliğini çağırın.
Get() veya GetAsync() yöntemlerini çağırın.

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

var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Resources.Get();

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

Örnek: Konsol test uygulaması
Proje: partnersdk.featuresample
Sınıf: SubscriptionResourceUsageRecords.cs

REST isteği

İstek söz dizimi

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

URI parametreleri

Bu tabloda, 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	Aboneliğe karşılık gelen GUID.

İ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/{id-for-subscription}/usagerecords/resources HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 65b26053-37d0-4303-9fd1-46ad8012bcb6
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesindeki AzureResourceMonthlyUsageRecord kaynaklarının bir koleksiyonunu 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 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ı.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 10 Nov 2015 19:09:59 GMT

{
    "totalCount":20,
    "items":[{
        "category":"Storage",
        "subcategory":"LOCALLY REDUNDANT",
        "quantityUsed":0.151287527825352,
        "unit":"GB",
        "id":"2a2419c0-cefe-46b2-8004-8eb002ad606c",
        "name":"Azure Resource 1",
        "totalCost":0.195779159290613,
        "currencyLocale":"en-US",
        "attributes":{
            "objectType":"AzureResourceMonthlyUsageRecord"
        }
    },
    {
        "category":"Remote App",
        "subcategory":"Remote App",
        "quantityUsed":0.932546524299563,
        "unit":"GB",
        "id":"7e4099c8-2b3d-41a6-a1bd-d5cf315989b2",
        "name":"Azure Resource 2",
        "totalCost":0.920983775016379,
        "currencyLocale":"en-US",
        "attributes":{
            "objectType":"AzureResourceMonthlyUsageRecord"
        }
    }],
    "links":{
        "self":{
            "uri":"/v1/customers/<customer-tenant-id>/subscriptions/<id-for-subscription>%20/usagerecords",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"Collection"
    }
}

Aracılığıyla paylaş