Obtener los datos de uso de la suscripción, según el medidor
Se aplica a: Centro de partners | Centro de partners para Microsoft Cloud for US Government
Puede usar la colección de recursos MeterUsageRecord para obtener registros de uso de medidores de un cliente para determinados servicios o recursos de Azure durante el período de facturación actual. Esta colección de recursos representa un total agregado para cada medidor del ciclo de facturación actual, en todo el plan de Azure.
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 si selecciona el área de trabajo Clientes , el cliente de la lista de clientes y, a continuación, cuenta. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).Un identificador de suscripción
Esta nueva ruta es equivalente a subscriptions/{subscription-id}/usagerecords/resources, que seguirá funcionando solo para las suscripciones de Microsoft Azure (MS-AZR-0145P). Esta nueva ruta admitirá tanto las suscripciones de Microsoft Azure (MS-AZR-0145P) como los planes de Azure. Para obtener esta información para el plan de Azure, debe cambiar a esta nueva ruta. Aparte de las propiedades mencionadas en las secciones siguientes, la respuesta es la misma que la ruta anterior.
C#
Para obtener registros de uso de medidores de un cliente para un servicio o recurso de Azure específico durante el período de facturación actual:
Use la colección IAggregatePartner.Customers para llamar al método ById().
Llame a la propiedad Subscriptions y UsageRecords y, a continuación, a la propiedad Meters . Para finalizar, llame a los métodos Get() o GetAsync().
// IAggregatePartner partnerOperations; // var selectedCustomerId as string; // var selectedSubscriptionId as string; var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Meters.Get();
Para obtener un ejemplo, vea el ejemplo siguiente:
- Ejemplo: Aplicación de prueba de la consola
- Project: PartnerSDK.FeatureSamples
- Clase: GetSubscriptionUsageRecordsByMeter.cs
Solicitud REST
Sintaxis de la solicitud
| Método | URI de la solicitud |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/meterusagerecords HTTP/1.1 |
Parámetros del identificador URI
En esta tabla se enumeran los parámetros de consulta necesarios para obtener la información de uso calificada del cliente.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| customer-tenant-id | guid | Y | GUID correspondiente al cliente. |
| subscription-id | guid | Y | GUID correspondiente al identificador de un recurso de suscripción del Centro de partners, que representa una suscripción de Microsoft Azure (MS-AZR-0145P) o un plan de Azure. En el caso de los recursos de suscripción del plan de Azure, proporcione el identificador de plan como identificador de suscripción en esta ruta. |
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}/subscriptions/{subscription-id}/meterusagerecords HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
Respuesta REST
Si se ejecuta correctamente, este método devuelve un recurso PagedResourceCollection<MeterUsageRecord> 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 suscripciones de Microsoft Azure (MS-AZR-0145P)
En este ejemplo, el cliente compró 145P azure PayG.
Para los clientes con una suscripción 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: 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 REST para el plan de Azure
En este ejemplo, el cliente compró un plan de Azure.
En el caso de 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: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Fri, 26 Feb 2016 20:31:45 GMT
{
"totalCount": 4,
"items": [
{
"subscriptionId": "{subscription-id}",
"meterId": "DZH318Z0BNVX-005J-Data Transfer In (GB)",
"meterName": "Data Transfer In",
"category": "Bandwidth",
"subcategory": "Bandwidth",
"quantityUsed": 0.01129,
"unit": "1 GB",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
"attributes": {
"objectType": "MeterUsageRecord"
}
},
{
"subscriptionId": "{subscription-id}",
"meterId": "DZH318Z0BNVX-005J-Data Transfer Out (GB)",
"meterName": "Data Transfer Out",
"category": "Bandwidth",
"subcategory": "Bandwidth",
"quantityUsed": 0.000224,
"unit": "1 GB",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
"attributes": {
"objectType": "MeterUsageRecord"
}
},
{
"subscriptionId": "{subscription-id}",
"meterId": "DZH318Z0BNZ5-006G-10K Batch Write Operations",
"meterName": "Batch Write Operations",
"category": "Storage",
"subcategory": "Tables",
"quantityUsed": 0.2462,
"unit": "10K",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
"attributes": {
"objectType": "MeterUsageRecord"
}
},
{
"subscriptionId": "{subscription-id}",
"meterId": "DZH318Z0BNZ5-006G-Data Stored (GB/Month)",
"meterName": "LRS Data Stored",
"category": "Storage",
"subcategory": "Tables",
"quantityUsed": 0.002632,
"unit": "1 GB/Month",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
"attributes": {
"objectType": "MeterUsageRecord"
}
}
],
"links": {
"self": {
"uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/meterusagerecords",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Comentaris
Properament: al llarg del 2024 eliminarem gradualment GitHub Issues com a mecanisme de retroalimentació del contingut i el substituirem per un nou sistema de retroalimentació. Per obtenir més informació, consulteu: https://aka.ms/ContentUserFeedback.
Envieu i consulteu els comentaris de