Obter todas as informações de análise de utilização do Azure
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": "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
}