Obtener un resumen de uso para todas las suscripciones de un cliente

Artículo
10/07/2024

Se aplica a: Centro de partners | Centro de partners para Microsoft Cloud for US Government

Puede usar el recurso CustomerUsageSummary para obtener el uso de un cliente de un servicio o recurso de Azure específico durante el período de facturación actual.

Nota:

Por lo general, los datos de uso no facturados diarios están disponibles a través de la API o el portal del Centro de partners después de 24 horas. Dependiendo de la ubicación y del uso del informe de medidores, pueden producirse retrasos adicionales.

A veces, es posible que no vea los datos de uso no facturados más recientes desde el principio del mes hasta que se entreguen los datos de uso facturados del mes anterior. Esto es para asegurarse de que los datos de uso facturados se entregan de forma eficaz dentro del Acuerdo de Nivel de Servicio. Una vez que reciba los datos de uso facturados, puede empezar a recuperar todos los datos de uso no facturados actualizados desde el principio del mes.

Requisitos previos

Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.
Un id. de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

C#

Para obtener un resumen de uso de todas las suscripciones de un cliente:

Use la colección IAggregatePartner.Customers para llamar al método ById().

Llame a la propiedad UsageSummary, seguida de los métodos Get() o GetAsync():

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;

var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();

Para obtener un ejemplo, vea lo siguiente:

Ejemplo: Aplicación de prueba de consola
Proyecto: PartnerSDK.FeatureSamples
Clase: GetCustomerUsageSummary.cs

Solicitud REST

Sintaxis de la solicitud

Método	URI de solicitud
GET	{baseURL}/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1

Parámetro de URI

En esta tabla se muestra el parámetro de consulta necesario para obtener la información de uso calificada del cliente.

Nombre	Type	Obligatorio	Descripción
customer-tenant-id	guid	Y	GUID correspondiente al cliente.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Ninguno.

Ejemplo de solicitud

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: aaaa0000-bb11-2222-33cc-444444dddddd

Respuesta REST

Si se ejecuta correctamente, este método devuelve un recurso CustomerUsageSummary en el cuerpo de la respuesta.

Códigos de error y de respuesta correctos

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. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener una lista completa, consulte Códigos de error.

Ejemplo de respuesta para la suscripción de Microsoft Azure (MS-AZR-0145P)

En este ejemplo, el cliente compró una oferta de Azure PayG de 145P.

Para los clientes con suscripciones de Microsoft Azure (MS-AZR-0145P), no habrá ningún cambio en la respuesta de la API.

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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 Azure

En este ejemplo, el cliente compró un plan de Azure.

Para los clientes con planes de Azure, hay los siguientes cambios en la respuesta de la API:

currencyLocale se reemplaza por currencyCode
usdTotalCost es un nuevo campo

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget": {
        "amount": 97,
        "attributes": {
            "objectType": "SpendingBudget"
        }
    },
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "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"
    }
}

Compartir vía