Obtener registros de uso de suscripciones para un clienteGet subscription usage records for a customer

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 la colección de recursos SubscriptionMonthlyUsageRecord para obtener registros de uso de suscripciones para un cliente de un servicio o recurso de Azure específico durante el período de facturación actual.You can use the SubscriptionMonthlyUsageRecord resource collection to get subscription usage records for a customer of a specific Azure service or resource during the current billing period. Este recurso representa todas las suscripciones del cliente.This resource represents all subscriptions for the customer. Para un cliente con un plan de Azure, este recurso devuelve una lista de esos planes (no suscripciones individuales de Azure).For a customer with an Azure plan, this resource returns a list of those plans (not individual Azure subscriptions).

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 registros de uso de suscripciones para un cliente de un servicio o recurso de Azure específico durante el período de facturación actual:To get subscription usage records for a customer of a specific Azure service or resource during the current billing period.:

  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 UsageRecords .Then call the Subscriptions property, as well as UsageRecords 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 usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.UsageRecords.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/usagerecords http/1.1{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/usagerecords 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}/subscriptions/usagerecords 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 SubscriptionMonthlyUsageRecord en el cuerpo de la respuesta.If successful, this method returns a SubscriptionMonthlyUsageRecord 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

{
    "totalCount": 1,
    "items": [
        {
            "status": "active",
            "offerId": "MS-AZR-0145P",
            "resourceId": "11111111-F347-41B6-B02C-187B1B778A43",
            "id": "11111111-F347-41B6-B02C-187B1B778A43",
            "resourceName": "Microsoft Azure",
            "name": "Microsoft Azure",
            "totalCost": 22.861172,
            "currencyLocale": "fr-FR",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
            "attributes": {
                "objectType": "SubscriptionMonthlyUsageRecord"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/usagerecords/",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

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, se pueden realizar los siguientes cambios en la respuesta de la API:For customers with Azure plans, there are the following changes in 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

{
    "totalCount": 2,
    "items": [
        {
            "status": "active",
            "partnerOnRecord": "some-id",
            "offerId": "DZH318Z0BPS6:0001:DZH318Z0BML6",
            "resourceId": "11111111-7d58-6654-69fa-0797198155d3",
            "id": "11111111-7d58-6654-69fa-0797198155d3",
            "resourceName": "Azure plan",
            "name": "Azure plan",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
            "attributes": {
                "objectType": "SubscriptionMonthlyUsageRecord"
            }
        },
        {
            "status": "active",
            "partnerOnRecord": "some-id",
            "offerId": "DZH318Z0BPS6:0001:DZH318Z0BML6",
            "resourceId": "11111111-25aa-ebb8-2bb4-fb406307babd",
            "id": "11111111-25aa-ebb8-2bb4-fb406307babd",
            "resourceName": "Azure plan",
            "name": "Azure plan",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
            "attributes": {
                "objectType": "SubscriptionMonthlyUsageRecord"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/usagerecords",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}