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

Artículo
05/28/2024

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

Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario solo admite la autenticación con credenciales de usuario.

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`, `week`o `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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "customerName": "A",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "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

Análisis del Centro de partners: recursos

Compartir a través de