Abrufen der Nutzungsdaten für ein Abonnements nach Ressource

  • Artikel

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

In diesem Artikel wird beschrieben, wie Sie die ResourceUsageRecord-Ressource abrufen. Diese Ressource stellt eine aggregierte Summe für den Monat für einzelne Ressourcen dar, die in Ihrem Azure-Plan bereitgestellt werden. Sie können diese Ressource verwenden, um die Ressourcennutzungsdatensätze eines Kunden für bestimmte Azure-Dienste oder -Ressourcen während des aktuellen Abrechnungszeitraums abzurufen. Diese API gibt Daten zurück, die zuvor nicht über Azure-Ausgaben-APIs verfügbar waren.

Diese Route unterstützt keine Microsoft Azure-Abonnements (MS-AZR-0145P).

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.

  • 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

C#

So rufen Sie Ressourcennutzungsdatensätze eines Kunden für einen bestimmten Azure-Dienst oder eine bestimmte Ressource während des aktuellen Abrechnungszeitraums 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. Abschließend 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.FeatureSamples
  • Klasse: GetSubscriptionUsageRecordsByResource.cs

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

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

Name Typ Erforderlich BESCHREIBUNG
customer-tenant-id guid J Eine GUID, die dem Kunden entspricht.
abonnement-id guid J Eine GUID, die dem Bezeichner einer Partner Center-Abonnementressource entspricht, die ein Microsoft Azure-Abonnement (MS-AZR-0145P) oder einen Azure-Plan darstellt. Geben Sie für Azure Plan-Abonnementressourcen die Plan-ID als Abonnement-ID in dieser Route an.

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

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine PagedResourceCollection<ResourceUsageRecord-Ressource> 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. Eine vollständige Liste finden Sie unter Fehlercodes.

Antwortbeispiel

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

{
    "totalCount": 3,
    "items": [
        {
            "subscriptionId": "{subscription-id}",
            "resourceUri": "/subscriptions/{subscription-id}/resourceGroups/TESTRG1/providers/Microsoft.Compute/disks/testVM1_OsDisk_1_531d3c99534b4649ae025d485370143e",
            "resourceType": "Microsoft.Compute",
            "entitlementId": "{entitlemen-id}",
            "entitlementName": "Partner Subscription",
            "resourceGroupName": "TESTRG1",
            "name": "testVM1_OsDisk_1_531d3c99534b4649ae025d485370143e",
            "resourceName": "testVM1_OsDisk_1_531d3c99534b4649ae025d485370143e",
            "totalCost": 2.0211938955034572,
            "currencyCode": "GBP",
            "usdTotalCost": 2.4700000000000001,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "ResourceUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "resourceUri": "/subscriptions/{subscription-id}/resourceGroups/TESTRG1/providers/Microsoft.Compute/virtualMachines/testVM1",
            "resourceType": "Microsoft.Compute",
            "entitlementId": "{entitlement-id}",
            "entitlementName": "Partner Subscription",
            "resourceGroupName": "TESTRG1",
            "name": "testVM1",
            "resourceName": "testVM1",
            "totalCost": 80.3322286322163563,
            "currencyCode": "GBP",
            "usdTotalCost": 98.1699999999999985,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "ResourceUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "resourceUri": "/subscriptions/{subscription-id}/resourceGroups/testrg1/providers/Microsoft.Storage/storageAccounts/testrg1diag153",
            "resourceType": "Microsoft.Storage",
            "entitlementId": "{entitlemen-id}",
            "entitlementName": "Partner Subscription",
            "resourceGroupName": "testrg1",
            "name": "testrg1diag153",
            "resourceName": "testrg1diag153",
            "totalCost": 0.0081829712368561032,
            "currencyCode": "GBP",
            "usdTotalCost": 0.0099999999999999997,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "ResourceUsageRecord"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/resourceusagerecords",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}