Získání záznamů o využití předplatného pro zákazníka

Článek
10/07/2024

Platí pro: Partnerské centrum | Partnerské centrum pro Microsoft Cloud for US Government

Pomocí kolekce prostředků SubscriptionMonthlyUsageRecord můžete získat záznamy o využití předplatného pro zákazníka konkrétní služby nebo prostředku Azure během aktuálního fakturačního období. Tento prostředek představuje všechna předplatná pro zákazníka. Pro zákazníka s plánem Azure tento prostředek vrátí seznam těchto plánů (ne jednotlivá předplatná Azure).

Požadavky

Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování pouze pomocí přihlašovacích údajů aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud ID zákazníka neznáte, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci , pak zákazníka ze seznamu zákazníků a pak Účet. Na stránce Účet zákazníka vyhledejte ID Microsoft v části Informace o účtu zákazníka . ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

C#

Pokud chcete získat záznamy o využití předplatného pro zákazníka konkrétní služby nebo prostředku Azure během aktuálního fakturačního období, proveďte následující kroky:

K volání metody ById() použijte kolekci IAggregatePartner.Customers.

Potom volejte vlastnost Subscriptions (Předplatná ) a UsageRecords (Záznamy využití ). Dokončete voláním metod Get() nebo GetAsync().

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

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

Příklad:

Ukázka: Testovací aplikace konzoly
Projekt: PartnerSDK.FeatureSamples
Třída: GetSubscriptionUsageRecords.cs

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/customers/{id_tenanta}/subscriptions/usagerecords HTTP/1.1

Parametr identifikátoru URI

Tato tabulka uvádí požadovaný parametr dotazu k získání informací o využití s hodnocením zákazníka.

Název	Typ	Vyžadováno	Popis
customer-tenant-ID	Identifikátor guid	Y	Identifikátor GUID odpovídající zákazníkovi.

Hlavičky požadavku

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Žádné

Příklad požadavku

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/usagerecords HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Odpověď REST

V případě úspěchu tato metoda vrátí prostředek SubscriptionMonthlyUsageRecord v těle odpovědi.

Úspěšné odpovědi a kódy chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo neúspěch, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi pro předplatná Microsoft Azure (MS-AZR-0145P)

V tomto příkladu si zákazník koupil nabídku Azure s průběžnými platbou 145P .

U zákazníků s předplatnými Microsoft Azure (MS-AZR-0145P) nedojde v odpovědi rozhraní API k žádné změně.

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"
    }
}

Příklad odpovědi REST pro plán Azure

V tomto příkladu si zákazník koupil plán Azure.

U zákazníků s plány Azure dochází v odpovědi rozhraní API k následujícím změnám:

currencyLocale se nahradí kódem měny.
usdTotalCost je nové pole

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": 2,
    "items": [
        {
            "status": "active",
            "partnerOnRecord": "some-id",
            "offerId": "DZH318Z0BPS6:0001:DZH318Z0BML6",
            "resourceId": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
            "id": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
            "resourceName": "Azure plan",
            "name": "Azure plan",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
            "attributes": {
                "objectType": "SubscriptionMonthlyUsageRecord"
            }
        },
        {
            "status": "active",
            "partnerOnRecord": "some-id",
            "offerId": "DZH318Z0BPS6:0001:DZH318Z0BML6",
            "resourceId": "c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3",
            "id": "c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3",
            "resourceName": "Azure plan",
            "name": "Azure plan",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
            "attributes": {
                "objectType": "SubscriptionMonthlyUsageRecord"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/usagerecords",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

Sdílet prostřednictvím