Bagikan melalui

Mendapatkan ringkasan penggunaan untuk mitra

  • Artikel

Berlaku untuk: Pusat Mitra | Pusat Mitra untuk Microsoft Cloud for US Government

Anda dapat menggunakan sumber daya PartnerUsageSummary untuk mendapatkan ringkasan penggunaan mitra dari semua pelanggan yang membeli layanan atau sumber daya Azure tertentu selama periode penagihan saat ini.

Total yang dikembalikan oleh API ini tidak akan mengembalikan konsumsi untuk pelanggan yang memiliki paket Azure. Direncanakan untuk penghentian di masa depan.

Prasyarat

  • Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi dengan kredensial App+User.

C#

Untuk mendapatkan ringkasan penggunaan untuk semua pelanggan yang membeli layanan atau sumber daya Azure tertentu selama periode penagihan saat ini:

  1. Gunakan IAggregatePartner Anda.

  2. Panggil properti UsageSummary, diikuti dengan metode Get() atau GetAsync():

    // IAggregatePartner partnerOperations;

var usageSummary = partnerOperations.UsageSummary.Get();

Misalnya, lihat yang berikut ini:

Permintaan REST

Minta sintaks

Metode URI Permintaan
GET {baseURL}/v1/usagesummary HTTP/1.1

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tidak ada.

Contoh permintaan

GET https://api.partnercenter.microsoft.com/v1/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4

Respons REST

Jika berhasil, metode ini mengembalikan sumber daya PartnerUsageSummary dalam isi respons.

Respons keberhasilan dan kode kesalahan

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter tambahan. Untuk daftar lengkapnya, lihat Kode Kesalahan.

Contoh respons

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "customersOverBudget": 1,
    "customersTrendingOver": 0,
    "customersWithUsageBasedSubscription": 11,
    "resourceId": "11111111-4574-4539-bc42-0e539b9684c0",
    "id": "11111111-4574-4539-bc42-0e539b9684c0",
    "resourceName": "PLAMUATT2NETNEW",
    "name": "PLAMUATT2NETNEW",
    "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": "/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "PartnerUsageSummary"
    }
}