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

Artigo
05/28/2024

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

Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte apenas à autenticação com credenciais de usuário.

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`, `week`ou `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": "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
}

Confira também

Análise do Partner Center – recursos

Compartilhar via