Obter os dados de uso da assinatura por recursoGet usage data for subscription by resource

Aplica-se a:Applies to:

  • Partner CenterPartner Center
  • Partner Center do Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Partner Center do Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Este artigo descreve como obter o recurso ResourceUsageRecord .This article describes how to get the ResourceUsageRecord resource. Esse recurso representa um total agregado para o mês para recursos individuais provisionados em seu plano do Azure.This resource represents an aggregated total for the month for individual resources provisioned in your Azure plan. Você pode usar esse recurso para obter registros de uso de recursos do cliente para serviços ou recursos específicos do Azure durante o período de cobrança atual.You can use this resource to get a customer's resource usage records for specific Azure services or resources during the current billing period. Essa API retorna dados que não estavam disponíveis anteriormente por meio de APIs de gastos do Azure.This API returns data that was not available previously through Azure spending APIs.

Esta rota não oferece suporte a assinaturas do Microsoft Azure (MS-AZR-0145P).This route does not support Microsoft Azure (MS-AZR-0145P) subscriptions.

Pré-requisitosPrerequisites

  • Credenciais, conforme descrito em Autenticação do Partner Center.Credentials as described in Partner Center authentication. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de usuário.This scenario supports authentication with App+User credentials only.

  • Uma ID do cliente (customer-tenant-id).A customer ID (customer-tenant-id). Se você não souber a ID do cliente, poderá procurar no painel do Partner Center.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecione CSP no menu do Partner Center e, em seguida, Clientes.Select CSP from the Partner Center menu, followed by Customers. Selecione o cliente na lista de clientes e selecione Conta.Select the customer from the customer list, then select Account. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Um identificador de assinaturaA subscription identifier

C#C#

Para obter registros de uso de recursos de um cliente para um serviço ou recurso específico do Azure durante o período de cobrança atual:To get resource usage records of a customer for a specific Azure service or resource during the current billing period:

  1. Use sua coleção IAggregatePartner. Customers para chamar o método ById () .Use your IAggregatePartner.Customers collection to call the ById() method.

  2. Chame a propriedade subscriptions, bem como UsageRecords, em seguida, a propriedade Resources .Call the Subscriptions property, as well as UsageRecords, then the Resources property. Conclua chamando os métodos get () ou getasync ().Finish by calling the Get() or GetAsync() methods.

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

Para obter um exemplo, consulte o seguinte:For an example, see the following:

  • Exemplo: Aplicativo de teste do consoleSample: Console test app
  • Projeto: PartnerSDK. FeatureSamplesProject: PartnerSDK.FeatureSamples
  • Classe: GetSubscriptionUsageRecordsByResource.csClass: GetSubscriptionUsageRecordsByResource.cs

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
GETGET {baseURL}/v1/Customers/{Customer-Tenant-ID}/subscriptions/{Subscription-ID}/resourceusagerecords http/1.1{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/resourceusagerecords HTTP/1.1

Parâmetros do URIURI parameters

Esta tabela lista os parâmetros de consulta necessários para obter as informações de uso classificadas pelo cliente.This table lists the required query parameters to get the customer's rated usage information.

NomeName TipoType ObrigatórioRequired DescriçãoDescription
customer-tenant-idcustomer-tenant-id guidguid SY Um GUID correspondente ao cliente.A GUID corresponding to the customer.
ID da assinaturasubscription-id guidguid SY Um GUID correspondente ao identificador de um recurso de assinaturado Partner Center, que representa uma assinatura Microsoft Azure (MS-AZR-0145P) ou um plano do Azure.A GUID corresponding to the identifier of a Partner Center subscription resource, which represents a Microsoft Azure (MS-AZR-0145P) subscription or an Azure plan. Para recursos de assinatura do plano do Azure, forneça a ID do plano como a ID da assinatura nesta rota.For Azure plan subscription resources, provide the plan-id as the subscription-id in this route.

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

Nenhum.None.

Exemplo de solicitaçãoRequest example

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

Resposta RESTREST response

Se for bem-sucedido, esse método retornará um recurso **PagedResourceCollection <ResourceUsageRecord> ** no corpo da resposta.If successful, this method returns a PagedResourceCollection<ResourceUsageRecord> resource in the response body.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, the error type, and additional parameters. Para obter uma lista completa, consulte códigos de erro.For a full list, see Error Codes.

Exemplo de respostaResponse example

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