Obtener el Resumen de uso de la suscripción del clienteGet usage summary for customer's subscription

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 SubscriptionUsageSummary para obtener un resumen de uso de la suscripción de un cliente.You can use the SubscriptionUsageSummary resource to get a subscription usage summary for a customer. Este recurso representa el Resumen de uso de la suscripción de un servicio o recurso de Azure específico durante el período de facturación actual.This resource represents the subscription usage summary 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).

  • Un identificador de suscripciónA subscription identifier

C#C#

Para obtener un resumen de uso de la suscripción para la suscripción de un cliente:To get a subscription usage summary for a customer's subscription:

  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. Después, llame a la propiedad subscriptions, así como a la propiedad Summary .Then call the Subscriptions property, as well as UsageSummary property. Finalice llamando a los métodos GET () o GetAsync ().Finish by calling the Get() or GetAsync() methods.

    // IAggregatePartner partnerOperations;
    // var selectedCustomerId as string;
    // var selectedSubscriptionId as string;
    
    var subscriptionUsageSummary = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).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}/subscriptions/{subscription-ID}/usagesummary http/1.1{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/usagesummary HTTP/1.1

Parámetros de URIURI parameters

En esta tabla se enumeran los parámetros de consulta necesarios para obtener la información de uso clasificada del cliente.This table lists the required query parameters 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.
identificador de suscripciónsubscription-id guidguid YY GUID correspondiente al identificador de una suscripción.A GUID corresponding to the identifier of a subscription. Para un plan de Azure, este es el identificador del recurso de suscripcióndel centro de Partners correspondiente, que representa el plan de Azure.For an Azure plan, this is the identifier of the corresponding Partner Center subscription resource, which represents the Azure plan. En el caso de los recursos de suscripción de Azure plan, proporcione el identificador de plan como identificador de suscripción en esta ruta.For Azure plan subscription resources, provide the plan-id as the subscription-id in this route.

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}/subscriptions/{subscription-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 SubscriptionUsageSummary en el cuerpo de la respuesta.If successful, this method returns a SubscriptionUsageSummary 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 para suscripciones de Microsoft Azure (MS-AZR-0145P)Response example for Microsoft Azure (MS-AZR-0145P) subscriptions

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

{
    "resourceId": "ABCDEFGH-F347-41B6-B02C-187B1B778A43",
    "id": "ABCDEFGH-F347-41B6-B02C-187B1B778A43",
    "resourceName": "Microsoft Azure",
    "name": "Microsoft Azure",
    "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": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}

Ejemplo de respuesta de REST para Azure planREST response 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, existen los siguientes cambios de respuesta de API:For customers with Azure plans, there are the following API response changes:

  • 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-512c1626fac1
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "resourceId": "11111111-dca5-6f31-d3a6-dbbfad9be0fc",
    "resourceName": "Azure plan",
    "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",
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}