Obter todas as informações de análise de utilização do Azure

Artigo
05/28/2024

Aplica-se a: Centro de Parceiros | Centro de Parceiros operado pela 21Vianet | Centro de Parceiros para Microsoft Cloud for US Government

Como obter todas as informações de análise de utilização do Azure para os seus clientes.

Pré-requisitos

Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação apenas com credenciais de utilizador.

Pedido REST

Sintaxe do pedido

Método	URI do pedido
GET	{baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

Parâmetros URI

Parâmetro	Tipo	Description
top	string	O número de linhas de dados a devolver no pedido. O valor máximo e o valor predefinido se não for especificado são 10000. Se existirem mais linhas na consulta, o corpo da resposta inclui uma ligação seguinte que pode utilizar para pedir a página seguinte de dados.
ignorar	int	O número de linhas a ignorar na consulta. Utilize este parâmetro para página através de conjuntos de dados grandes. Por exemplo, `top=10000 and skip=0` obtém as primeiras 10000 linhas de dados, `top=10000 and skip=10000` obtém as próximas 10000 linhas de dados e assim sucessivamente.
filter	string	O parâmetro de filtro do pedido contém uma ou mais instruções que filtram as linhas na resposta. Cada instrução contém um campo e um valor que estão associados aos `eq` operadores ou `ne` e as instruções podem ser combinadas com `and` ou `or`. Pode especificar as seguintes cadeias de carateres: `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))`
agregaçãoLevel	string	Especifica o intervalo de tempo para o qual obter dados agregados. Pode ser uma das seguintes cadeias: `day`, `week`ou `month`. Se não for especificado, a predefinição é `day`. O `aggregationLevel` parâmetro não é suportado sem um `groupby`. O `aggregationLevel` parâmetro aplica-se a todos os campos de data presentes no `groupby`.
orderby	string	Uma instrução que ordena os valores de dados de resultado para cada instalação. A sintaxe é `...&orderby=field [order],field [order],...`. O `field` parâmetro pode ser uma das seguintes cadeias: `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` O parâmetro de encomenda é opcional e pode ser `asc` ou `desc` especificar ordem ascendente ou descendente para cada campo, respetivamente. A predefinição é `asc`. Exemplo: `...&orderby=meterCategory,meterUnit`
groupby	string	Uma instrução que aplica a agregação de dados apenas aos campos especificados. Pode especificar os seguintes campos: `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` As linhas de dados devolvidas conterão os campos especificados no `groupby` parâmetro e na Quantidade. O `groupby` parâmetro pode ser utilizado com o `aggregationLevel` parâmetro . Exemplo: `...&groupby=meterCategory,meterUnit`

Cabeçalhos do pedido

Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.

Corpo do pedido

Nenhum.

Exemplo de pedido

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 do REST

Se for bem-sucedido, o corpo da resposta contém uma coleção de recursos de utilização do Azure .

Códigos de erro e êxito da resposta

Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja 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
}

Ver também

Análise do Centro de Parceiros – Recursos

Partilhar via