Získání souhrnu využití pro partnera

  • Článek

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

Pomocí prostředku PartnerUsageSummary můžete získat souhrn využití partnera pro všechny zákazníky, kteří si koupili konkrétní službu nebo prostředek Azure během aktuálního fakturačního období.

Celková částka vrácená tímto rozhraním API nevrátí spotřebu pro zákazníky, kteří mají plán Azure. Plánuje se vyřazení v budoucnu.

Požadavky

C#

Pokud chcete získat souhrn využití pro všechny zákazníky, kteří si koupili konkrétní službu Nebo prostředek Azure během aktuálního fakturačního období:

  1. Použijte IAggregatePartner.

  2. Zavolejte vlastnost UsageSummary následovanou metodami Get() nebo GetAsync():

    // IAggregatePartner partnerOperations;

var usageSummary = partnerOperations.UsageSummary.Get();

Příklad:

Požadavek REST

Syntaxe požadavku

Metoda Identifikátor URI žádosti
GET {baseURL}/v1/usagesummary HTTP/1.1

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/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4

Odpověď REST

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

Kódy úspěšných odpovědí a chyb

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

Příklad odpovědi

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