Obtener toda la información de análisis del uso de Azure

  • Artículo

Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

Cómo obtener toda la información de análisis de uso de Azure para los clientes.

Requisitos previos

Solicitud REST

Sintaxis de la solicitud

Método URI de la solicitud
GET {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

Parámetros del identificador URI

Parámetro Tipo Descripción
top string Número de filas de datos que se devuelven en la solicitud. El valor máximo y el valor predeterminado, si no se especifican, es 10 000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo que puedes usar para solicitar la siguiente página de datos.
skip int Número de filas que se omiten en la consulta. Usa este parámetro para consultar grandes conjuntos de datos. Por ejemplo, top=10000 and skip=0 recupera las primeras 10000 filas de datos, top=10000 and skip=10000 recupera las siguientes 10000 filas de datos, etc.
filter string El parámetro filter de la solicitud contiene una o más instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un campo y un valor que están asociados a los eq operadores o ne , y las instrucciones se pueden combinar mediante and o or. Puede especificar las siguientes cadenas:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Ejemplo:
.../usage/azure?filter=meterCategory eq 'Data Management'

Ejemplo:
.../usage/azure?filter=meterCategory eq 'Data Management' or (usageDate le cast('2018-01-01', Edm.DateTimeOffset) and usageDate le cast('2018-04-01', Edm.DateTimeOffset))
aggregationLevel string Especifica el intervalo de tiempo necesario para el que quieres recuperar datos agregados. Puede ser una de las siguientes cadenas: day, weeko month. Si no se especifica nada, el valor predeterminado es day.

El aggregationLevel parámetro no se admite sin .groupby El aggregationLevel parámetro se aplica a todos los campos de fecha presentes en groupby.
orderby string Instrucción que ordena los valores de datos de resultado para cada instalación. La sintaxis es ...&orderby=field [order],field [order],.... El field parámetro puede ser una de las cadenas siguientes:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


El parámetro order es opcional y puede ser asc o desc especificar un orden ascendente o descendente para cada campo, respectivamente. El valor predeterminado es asc.

Ejemplo:
...&orderby=meterCategory,meterUnit
groupby string Una instrucción que aplica la agregación de datos únicamente a los campos especificados. Puedes especificar los siguientes campos:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Las filas de datos devueltas contendrán los campos especificados en el groupby parámetro y quantity.

El groupby parámetro se puede usar con el aggregationLevel parámetro .

Ejemplo:
...&groupby=meterCategory,meterUnit

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/partner/v1/analytics/usage/azure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

Respuesta REST

Si se ejecuta correctamente, el cuerpo de la respuesta contiene una colección de recursos de uso de Azure .

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 la lista completa, consulte Códigos de error.

Ejemplo de respuesta

{
  "customerTenantId": "39A1DFAC-4969-4F31-AF94-D76588189CFE",
  "customerName": "A",
  "subscriptionId": "EC649980-D623-49F5-B7C1-80CC772B83A8",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

Consulte también