Compartilhar via

Obter todas as informações de análise de uso do Azure

  • Artigo

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government

Como obter todas as informações de análise de uso do Azure para seus clientes.

Pré-requisitos

Solicitação REST

Sintaxe da solicitação

Método URI da solicitação
GET {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

Parâmetros do URI

Parâmetro Type Descrição
top string O número de linhas de dados a serem retornadas na solicitação. O valor máximo e o valor padrão; se não forem especificados, será 10.000. Se houver mais linhas na consulta, o corpo da resposta incluirá um link que você poderá usar para solicitar a próxima página de dados.
skip INT O número de linhas a serem ignoradas na consulta. Use este parâmetro para percorrer grandes conjuntos de dados. Por exemplo, top=10000 and skip=0 recupera as primeiras 10.000 linhas de dados, top=10000 and skip=10000 recupera as próximas 10.000 linhas de dados e assim por diante.
filter string O parâmetro filter da solicitação contém uma ou mais instruções que filtram as linhas da resposta. Cada instrução contém um campo e um valor associados aos eq operadores ou ne , e as instruções podem ser combinadas usando and ou or. Você pode especificar as seguintes cadeias de caracteres:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


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

Exemplo:
.../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 o intervalo de tempo para o qual recuperar dados agregados. Pode ser uma das seguintes cadeias de caracteres: day, weekou month. Se não for especificado, o padrão será day.

Não aggregationLevel há suporte para o parâmetro sem um groupby. O aggregationLevel parâmetro se aplica a todos os campos de data presentes no groupby.
orderby string Uma instrução que classifica os valores dos dados resultantes de cada instalação. A sintaxe é ...&orderby=field [order],field [order],.... O field parâmetro pode ser uma das seguintes cadeias de caracteres:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


O parâmetro order é opcional e pode ser asc ou desc especificar ordem crescente ou decrescente para cada campo, respectivamente. O padrão é asc.

Exemplo:
...&orderby=meterCategory,meterUnit
groupby string Uma instrução que aplica a agregação de dados apenas aos campos especificados. Você pode especificar os campos a seguir:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


As linhas de dados retornadas conterão os campos especificados no groupby parâmetro e na Quantidade.

O groupby parâmetro pode ser usado com o aggregationLevel parâmetro .

Exemplo:
...&groupby=meterCategory,meterUnit

Cabeçalhos de solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum.

Exemplo de solicitação

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

Resposta REST

Se tiver êxito, o corpo da resposta conterá uma coleção de recursos de uso do Azure .

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de Erro.

Exemplo de resposta

{
  "customerTenantId": "39A1DFAC-4969-4F31-AF94-D76588189CFE",
  "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
}

Confira também