Compartir a través de

Obtener registros de uso de un cliente para Azure

Se aplica a: Centro de socios | Centro de socios para la nube de Microsoft para el gobierno de EE. UU.

Puede obtener los registros de uso de la suscripción de Azure de un cliente durante un período de tiempo especificado mediante la API de uso de Azure.

Prerrequisitos

  • Credenciales tal como se describe en Autenticación del Centro de asociados. Este escenario admite la autenticación con credenciales de aplicación independiente y de aplicación+usuario.

  • Un ID de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en Partner Center 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 Id. de Microsoft en la sección Información de la cuenta de cliente. El ID de Microsoft es el mismo que el ID de cliente (customer-tenant-id).

  • Un identificador de suscripción.

Esta API devuelve el consumo diario y por hora sin clasificar durante un intervalo de tiempo arbitrario. Sin embargo, esta API no es compatible con los planes de Azure. Si tiene un plan de Azure, consulte los artículos Obtener elementos de línea de consumo facturados sin facturar y Obtener elementos de línea de consumo facturado facturado en su lugar. En estos artículos se describe cómo obtener el consumo nominal a nivel diario por metro por recurso. Esta tasa de consumo es equivalente a los datos de grano diarios proporcionados por la API de uso de Azure. Deberá usar el identificador de factura para recuperar los datos de uso facturados. O bien, puede usar los períodos actual y anteriores para obtener estimaciones de uso no facturado. Actualmente, los datos detallados por hora y los filtros de intervalo de fechas arbitrarios no se admiten para los recursos de suscripción del plan de Azure.

API Azure Utilization

Esta API de uso de Azure proporciona acceso a los registros de uso durante un período de tiempo que representa cuándo se notificó el uso en el sistema de facturación. Proporciona acceso a los mismos datos de utilización que se utilizan para crear y calcular el archivo de conciliación. Sin embargo, no tiene conocimiento de la lógica del archivo de conciliación del sistema de facturación. No debe esperar que los resultados del resumen del archivo de conciliación coincidan con el resultado recuperado de esta API exactamente durante el mismo período de tiempo.

Por ejemplo, el sistema de facturación toma los mismos datos de utilización y aplica reglas de morosidad para determinar lo que se contabiliza en un archivo de conciliación. Cuando se cierra un período de facturación, todo el uso hasta el final del día en que finaliza el período de facturación se incluye en el archivo de conciliación. Cualquier uso tardío dentro del período de facturación que se informe dentro de las 24 horas posteriores a la finalización del período de facturación se contabiliza en el siguiente archivo de conciliación. Para conocer las reglas de morosidad de cómo se factura al asociado, consulte Obtención de datos de consumo para una suscripción de Azure.

Esta API de REST está paginada. Si la carga de respuesta es mayor que una sola página, debe seguir el siguiente vínculo para obtener la siguiente página de registros de utilización.

Escenario: el asociado A ha transferido la propiedad de facturación de la suscripción heredada de Azure (145P) al asociado B

Si un asociado transfiere la propiedad de facturación de una suscripción heredada de Azure a otro asociado, cuando el nuevo asociado llama a la API de uso para la suscripción transferida, tiene que usar el identificador de suscripción comercial (que se muestra en su cuenta del Centro de partners) en lugar del identificador de derechos de Azure. El identificador de derechos de Azure aparece para el socio B solo cuando es administrador en nombre de (AOBO) en Azure Portal del cliente.

Para llamar correctamente a la API de utilización de la suscripción transferida, el nuevo socio debe usar el ID de suscripción de Commerce.

C#

Para obtener los registros de uso de Azure:

  1. Obtenga el ID de cliente y el ID de suscripción.

  2. Llame al método IAzureUtilizationCollection.Query para devolver un ResourceCollection que contenga los registros de uso.

  3. Obtenga un enumerador de registros de uso de Azure para recorrer las páginas de uso. Este paso es necesario, ya que la colección de recursos está paginada.

// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;

IPartner partner = PartnerService.Instance.CreatePartnerOperations(credentials);

// Retrieve the utilization records for the last year in pages of 100 records.
var utilizationRecords = partner.Customers[customerId].Subscriptions[subscriptionId].Utilization.Azure.Query(
    DateTimeOffset.Now.AddYears(-1),
    DateTimeOffset.Now,
    size: 100);

// Create an Azure utilization enumerator which will aid us in traversing the utilization pages.
var utilizationRecordEnumerator = partner.Enumerators.Utilization.Azure.Create(utilizationRecords);

while (utilizationRecordEnumerator.HasValue)
{
    //
    // Insert code here to work with this page.
    //

    // Get the next page.
    utilizationRecordEnumerator.Next();
}

Java

El SDK de Java del Centro de partners se puede usar para administrar los recursos del Centro de partners. Es un proyecto de código abierto mantenido por la comunidad de partners y no es compatible oficialmente con Microsoft. Puede obtener ayuda de la comunidad o crear un problema en GitHub si experimenta un problema.

Para obtener los registros de uso de Azure, primero necesita un identificador de cliente y un identificador de suscripción. A continuación, llame a la función IAzureUtilizationCollection.query para devolver un ResourceCollection que contenga los registros de uso. Dado que la colección de recursos está paginada, debe obtener un enumerador de registros de uso de Azure para recorrer las páginas de uso.

// IAggregatePartner partnerOperations;
// String customerId;
// String subscriptionId;

ResourceCollection<AzureUtilizationRecord> utilizationRecords = partnerOperations.getCustomers()
  .byId(customerId).getSubscriptions().byId(subscriptionId)
  .getUtilization().getAzure().query(
      new DateTime().minusYears(1),
      new DateTime(),
      AzureUtilizationGranularity.Daily,
      true,
      100);

// Create an Azure utilization enumerator which will aid us in traversing the utilization pages
IResourceCollectionEnumerator<ResourceCollection<AzureUtilizationRecord>> utilizationRecordEnumerator =
    partnerOperations.getEnumerators().getUtilization().getAzure().create(utilizationRecords);

while (utilizationRecordEnumerator.hasValue())
{
    //
    // Insert code here to work with this page.
    //

    // get the next page
    utilizationRecordEnumerator.next();
}

PowerShell

El módulo PowerShell para el Centro de socios se puede usar para administrar los recursos del Centro de socios. Es un proyecto de código abierto mantenido por la comunidad de partners y no es compatible oficialmente con Microsoft. Puede obtener ayuda de la comunidad o crear un problema en GitHub si experimenta un problema.

Para obtener los registros de uso de Azure, primero necesita un identificador de cliente y un identificador de suscripción. A continuación, llame a Get-PartnerCustomerSubscriptionUtilization. Este comando devolverá todos los registros disponibles durante el período de tiempo especificado.

# $customerId
# $subscriptionId

Get-PartnerCustomerSubscriptionUtilization -CustomerId $customerId -SubscriptionId $subscriptionId -StartDate (Get-Date).AddDays(-2).ToUniversalTime() -Granularity Hourly -ShowDetails

Solicitud REST

Sintaxis de la solicitud

Método Solicitud de URI
OBTENER {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/utilizations/azure?start_time={start-time}&end_time={end-time}&granularity={granularity}&show_details={True}

Parámetros de URI

Utilice la siguiente ruta de acceso y parámetros de consulta para obtener los registros de utilización.

Nombre Tipo Obligatorio Descripción
identificación de cliente-inquilino cuerda / cadena Sí Cadena con formato GUID que identifica al cliente.
identificador-de-suscripción cuerda / cadena Sí Cadena con formato GUID que identifica la suscripción.
hora_de_inicio cadena en formato de desplazamiento de fecha y hora UTC Sí El inicio del intervalo de tiempo que representa cuándo se notificó la utilización en el sistema de facturación.
end_time cadena en formato de desplazamiento de fecha y hora UTC Sí El final del intervalo de tiempo que representa cuándo se notificó el uso en el sistema de facturación.
granularidad cuerda / cadena No Define la granularidad de las agregaciones de uso. Las opciones disponibles son: daily (predeterminado) y hourly.
show_details booleano No Especifica si se van a obtener los detalles de uso del nivel de instancia. El valor predeterminado es true.
tamaño número No Especifica el número de agregaciones devueltas por una sola llamada a la API. El valor predeterminado es 1000. El máximo es 1000.

Cabeceras de solicitud

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

Cuerpo de la solicitud

Ninguno

Ejemplo de solicitud

La siguiente solicitud de ejemplo genera resultados similares a los que mostrará el archivo de conciliación para el período 7/2 - 8/1. Es posible que estos resultados no coincidan exactamente (consulte la sección API de uso de Azure para obtener más información).

Esta solicitud de ejemplo devuelve datos de utilización notificados en el sistema de facturación entre el 7/2 a las 12 a.m. (UTC) y el 8/2 a las 12 a.m. (UTC).

GET https://api.partnercenter.microsoft.com/v1/customers/E499C962-9218-4DBA-8B83-8ADC94F47B9F/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/utilizations/azure?start_time=2017-07-02T00:00:00-08:00&end_time=2017-08-02T00:00:00-08:00 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e6a3b6b2-230a-4813-999d-57f883b60d38
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Respuesta REST

Si se realiza correctamente, este método devuelve una colección de recursos de registro de uso de Azure en el cuerpo de la respuesta. Si los datos de uso de Azure aún no están listos en un sistema dependiente, este método devuelve un código de estado HTTP 204 con un encabezado Retry-After.

Códigos de éxito y de error de la respuesta

Cada respuesta incluye un código de estado HTTP que indica el éxito o error y la información adicional de depuración. Utilice una herramienta de seguimiento de red para leer el código de estado HTTP, el tipo de código de error y los parámetros adicionales.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 2630
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e6a3b6b2-230a-4813-999d-57f883b60d38
MS-CV: PjuGoYrw806o6A3Y.0
MS-ServerId: 030020525
Date: Fri, 04 Aug 2017 23:48:28 GMT

{
  "totalCount": 2,
  "items": [
    {
      "usageStartTime": "2017-06-07T17:00:00-07:00",
      "usageEndTime": "2017-06-08T17:00:00-07:00",
      "resource": {
        "id": "8767aeb3-6909-4db2-9927-3f51e9a9085e",
        "name": "Storage Admin",
        "category": "Storage",
        "subcategory": "Block Blob",
        "region": "Azure Stack"
      },
      "quantity": 0.217790327034891,
      "unit": "1 GB/Hr",
      "infoFields": {},
      "instanceData": {
        "resourceUri": "/subscriptions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/resourcegroups/system.local/providers/Microsoft.Storage/storageaccounts/srphealthaccount",
        "location": "azurestack",
        "partNumber": "",
        "orderNumber": "",
        "additionalInfo": {
          "azureStack.MeterId": "09F8879E-87E9-4305-A572-4B7BE209F857",
          "azureStack.SubscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
          "azureStack.Location": "local",
          "azureStack.EventDateTime": "06/05/2017 06:00:00"
        }
      },
      "attributes": {
        "objectType": "AzureUtilizationRecord"
      }
    },
    {
      "usageStartTime": "2017-06-07T17:00:00-07:00",
      "usageEndTime": "2017-06-08T17:00:00-07:00",
      "resource": {
        "id": "8767aeb3-6909-4db2-9927-3f51e9a9085e",
        "name": "Storage Admin",
        "category": "Storage",
        "subcategory": "Block Blob",
        "region": "Azure Stack"
      },
      "quantity": 0.217790327034891,
      "unit": "1 GB/Hr",
      "infoFields": {},
      "instanceData": {
        "resourceUri": "/subscriptions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f/resourcegroups/system.local/providers/Microsoft.Storage/storageaccounts/srphealthaccount",
        "location": "azurestack",
        "partNumber": "",
        "orderNumber": "",
        "additionalInfo": {
          "azureStack.MeterId": "09F8879E-87E9-4305-A572-4B7BE209F857",
          "azureStack.SubscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
          "azureStack.Location": "local",
          "azureStack.EventDateTime": "06/05/2017 06:00:00"
        },
        "attributes": {
          "objectType": "AzureUtilizationRecord"
        }
      },

      "links": {
        "self": {
          "uri": "customers/E499C962-9218-4DBA-8B83-8ADC94F47B9F/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/utilizations/azure?start_time=2017-06-10T00:00:00Z&end_time=2017-07-09T00:00:00Z&granularity=Daily&show_details=True&size=1000",
          "method": "GET",
          "headers": []
        }
      },
      "attributes": {
        "objectType": "Collection"
      }
    }
  ]
}
  • Last updated on