Obtener un resumen de uso de todas las suscripciones de un clienteGet a usage summary for all of a customer's subscriptions

Se aplica a:Applies to:

  • Centro de partnersPartner Center
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Puede usar el recurso CustomerUsageSummary para obtener el uso que hace un cliente de un servicio o recurso de Azure específico durante el período de facturación actual.You can use the CustomerUsageSummary resource to get a customer's usage of a specific Azure service or resource during the current billing period.

Requisitos previosPrerequisites

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners.Credentials as described in Partner Center authentication. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.This scenario supports authentication with App+User credentials only.

  • Un id. de cliente (customer-tenant-id).A customer ID (customer-tenant-id). Si no conoces el identificador del cliente, puedes buscarlo en el panel del Centro de partners.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecciona CSP en el menú del Centro de partners, seguido de Clientes.Select CSP from the Partner Center menu, followed by Customers. En la lista de clientes, selecciona el cliente y, a continuación, elige Cuenta.Select the customer from the customer list, then select Account. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. El identificador de Microsoft es el mismo que el de cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

C#C#

Para obtener un resumen de uso de todas las suscripciones de un cliente:To get a usage summary for all of a customer's subscriptions:

  1. Use la colección colección iaggregatepartner. customers para llamar al método ById () .Use your IAggregatePartner.Customers collection to call the ById() method.

  2. Llame a la propiedad Summary , seguido de los métodos get () o GetAsync () :Call the UsageSummary property, followed by the Get() or GetAsync() methods:

    // IAggregatePartner partnerOperations;
    // var selectedCustomerId as string;
    
    var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();
    

Para obtener un ejemplo, vea lo siguiente:For an example, see the following:

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/customers/{customer-tenant-ID}/usagesummary http/1.1{baseURL}/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1

Parámetro de URIURI parameter

En esta tabla se muestra el parámetro de consulta necesario para obtener la información de uso calificado del cliente.This table lists the required query parameter to get the customer's rated usage information.

NombreName TipoType ObligatorioRequired DescripciónDescription
customer-tenant-idcustomer-tenant-id guidguid YY GUID correspondiente al cliente.A GUID corresponding to the customer.

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

Ninguno.None.

Ejemplo de solicitudRequest example

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4

Respuesta RESTREST response

Si es correcto, este método devuelve un recurso CustomerUsageSummary en el cuerpo de la respuesta.If successful, this method returns a CustomerUsageSummary resource in the response body.

Códigos de error y de respuesta correctosResponse success and error codes

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, the error type, and additional parameters. Para obtener una lista completa, consulte códigos de error.For a full list, see Error Codes.

Ejemplo de respuesta de la suscripción a Microsoft Azure (MS-AZR-0145P)Response example for Microsoft Azure (MS-AZR-0145P) subscription

En este ejemplo, el cliente ha adquirido una oferta de 145P Azure PayG .In this example, the customer purchased a 145P Azure PayG offer.

En el caso de los clientes con suscripciones de Microsoft Azure (MS-AZR-0145P), no habrá ningún cambio en la respuesta de la API.For customers with Microsoft Azure (MS-AZR-0145P) subscriptions, there will be no change to the API response.

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

{
    "budget":{
        "ammount":300.000000,
        "attributes":{
            "objectType":"SpendingBudget"
        }
    },
    "id":"65726577-C208-40FD-9735-8C85AC9CAC68",
    "name":"600 test",
    "billingStartDate":"2016-02-06T00:00:00-08:00",
    "billingEndDate":"2016-03-05T00:00:00-08:00",
    "totalCost":0.0,
    "currencyLocale":"en-US",
    "lastModifiedDate":"2016-02-26T09:42:54.5130558+00:00",
    "links":{
        "self":{
            "uri":"/customers/{customer-tenant-id}/usagesummary",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"CustomerUsageSummary"
    }
}

Ejemplo de respuesta para el plan de AzureResponse example for Azure plan

En este ejemplo, el cliente compró un plan de Azure.In this example, the customer purchased an Azure plan.

En el caso de los clientes con planes de Azure, se pueden realizar los siguientes cambios en la respuesta de la API:For customers with Azure plans, there are the following changes to the API response:

  • currencyLocale se reemplaza por currencyCodecurrencyLocale is replaced with currencyCode
  • usdTotalCost es un nuevo campousdTotalCost is a new field
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

{
    "budget": {
        "amount": 97,
        "attributes": {
            "objectType": "SpendingBudget"
        }
    },
    "resourceId": "44908a11-641b-4c53-b7fc-0f2bfca8a581",
    "resourceName": "Modern Azure Customer UK",
    "billingStartDate": "2019-09-01T00:00:00+00:00",
    "billingEndDate": "2019-10-01T00:00:00+00:00",
    "totalCost": 28.82860766744404945074,
    "currencyCode": "GBP",
    "usdTotalCost": 35.23000000000000362337,
    "lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
    "attributes": {
        "objectType": "CustomerUsageSummary"
    }
}