Ölçüme göre abonelik için kullanım verilerini alma

Makale
10/07/2024

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

MeterUsageRecord kaynak koleksiyonunu kullanarak geçerli faturalama döneminde belirli Azure hizmetleri veya kaynakları için müşterinin ölçüm kullanım kayıtlarını alabilirsiniz. Bu kaynak koleksiyonu, azure planınızın tamamında geçerli faturalama döngüsü için her ölçüm için toplanan toplamı 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 kimliği

Bu yeni yol, yalnızca Microsoft Azure (MS-AZR-0145P) abonelikleri için çalışmaya devam edecek olan ile eşdeğerdir subscriptions/{subscription-id}/usagerecords/resources. Bu yeni yol hem Microsoft Azure (MS-AZR-0145P) aboneliklerini hem de Azure planlarını destekleyecektir. Azure planınız için bu bilgileri almak için bu yeni yola geçmeniz gerekir. Aşağıdaki bölümlerde belirtilen özellikler dışında, yanıt eski yol ile aynıdır.

C#

Geçerli faturalama döneminde belirli bir Azure hizmeti veya kaynağı için müşterinin ölçüm kullanım kayıtlarını almak için:

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

Subscriptions özelliğini ve UsageRecords'u ve ardından Meters ö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 usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Meters.Get();

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

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

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/meterusagerecords 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	Microsoft Azure (MS-AZR-0145P) aboneliğini veya Azure planını temsil eden bir İş Ortağı Merkezi abonelik kaynağının tanımlayıcısına karşılık gelen GUID. 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}/meterusagerecords 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 PagedResourceCollection<MeterUsageRecord> kaynağı 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 satın almış.

Microsoft Azure (MS-AZR-0145P) aboneliği olan müşteriler için API yanıtıyla ilgili bir değişiklik yapılmaz.

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

{
    "totalCount": 1,
    "items": [
        {
            "status": "active",
            "offerId": "MS-AZR-0145P",
            "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
            "id": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
            "resourceName": "Microsoft Azure",
            "name": "Microsoft Azure",
            "totalCost": 22.861172,
            "currencyLocale": "fr-FR",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
            "attributes": {
                "objectType": "SubscriptionMonthlyUsageRecord"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/{customer-tenant-id}/subscriptions/usagerecords/",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

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 API yanıtında aşağıdaki değişiklikler 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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Fri, 26 Feb 2016 20:31:45 GMT

{
    "totalCount": 4,
    "items": [
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNVX-005J-Data Transfer In (GB)",
            "meterName": "Data Transfer In",
            "category": "Bandwidth",
            "subcategory": "Bandwidth",
            "quantityUsed": 0.01129,
            "unit": "1 GB",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNVX-005J-Data Transfer Out (GB)",
            "meterName": "Data Transfer Out",
            "category": "Bandwidth",
            "subcategory": "Bandwidth",
            "quantityUsed": 0.000224,
            "unit": "1 GB",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNZ5-006G-10K Batch Write Operations",
            "meterName": "Batch Write Operations",
            "category": "Storage",
            "subcategory": "Tables",
            "quantityUsed": 0.2462,
            "unit": "10K",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNZ5-006G-Data Stored (GB/Month)",
            "meterName": "LRS Data Stored",
            "category": "Storage",
            "subcategory": "Tables",
            "quantityUsed": 0.002632,
            "unit": "1 GB/Month",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/meterusagerecords",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

Aracılığıyla paylaş