Abrufen aller monatlichen Nutzungsdatensätze für ein Abonnement

  • Artikel

Gilt für: Partner Center | Partner Center für Microsoft Cloud for US Government

Sie können die AzureResourceMonthlyUsageRecord-Ressourcensammlung verwenden, um eine Liste der Dienste innerhalb des Abonnements eines Kunden und die zugehörigen Bewertungsinformationen zur Nutzung abzurufen.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

  • Eine Kunden-ID (customer-tenant-id). Wenn Sie die Kunden-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden und dann den Kunden aus der Kundenliste und dann Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

  • Ein Abonnementbezeichner.

Diese API unterstützt nur Microsoft Azure-Abonnements (MS-AZR-0145P). Wenn Sie einen Azure-Plan verwenden, finden Sie stattdessen Informationen unter Abrufen von Nutzungsdaten für Ein Abonnement nach Verbrauchseinheit .

C#

So rufen Sie die Ressourcennutzungsinformationen eines Abonnements ab:

  1. Verwenden Sie Ihre IAggregatePartner.Customers-Auflistung , um die ById() -Methode aufzurufen.

  2. Rufen Sie die Subscriptions-Eigenschaft und UsageRecords und dann die Resources-Eigenschaft auf.

  3. Rufen Sie die Methoden Get() oder GetAsync() auf.

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

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

Ein Beispiel finden Sie im Folgenden:

  • „Beispiel: Konsolentest der App
  • Projekt: PartnerSDK.FeatureSample
  • Klasse: SubscriptionResourceUsageRecords.cs

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1

URI-Parameter

In dieser Tabelle werden die erforderlichen Abfrageparameter aufgelistet, um die bewerteten Nutzungsinformationen abzurufen.

Name Typ Erforderlich BESCHREIBUNG
customer-tenant-id guid J Eine GUID, die dem Kunden entspricht.
abonnement-id guid J Eine GUID, die dem Abonnement entspricht.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Anforderungsbeispiel

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: 47c36033-af5d-4457-80a4-512c1626fac4

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine Auflistung von AzureResourceMonthlyUsageRecord-Ressourcen im Antworttext zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Antwortbeispiel

HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: 648a26a4-a63e-459f-844b-4f29d7913353
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"
    }
}