Obter métricas de uso de máquina virtual usando a API REST
Aplica-se a: ✔️ Linux VMs ✔️ Conjuntos de escala flexível
Este exemplo mostra como recuperar o uso da CPU para uma Máquina Virtual Linux usando a API REST do Azure.
A documentação de referência completa e os exemplos para a API REST estão disponíveis no artigo de referência REST do Azure Monitor.
Criar o pedido
Use a seguinte solicitação GET para coletar a métrica Porcentagem de CPU de uma máquina virtual.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU×pan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z
Cabeçalhos do pedido
Os seguintes cabeçalhos são obrigatórios:
Cabeçalho do pedido | Description |
---|---|
Tipo de Conteúdo: | Obrigatório. Definido como application/json . |
Autorização: | Obrigatório. Definido como um token de acesso Bearer válido. |
Parâmetros de URI
Nome | Descrição |
---|---|
subscriptionId | A ID de assinatura que identifica uma assinatura do Azure. Se tiver várias subscrições, consulte Trabalhar com várias subscrições. |
resourceGroupName | O nome do grupo de recursos do Azure associado ao recurso. Você pode obter esse valor da API do Azure Resource Manager, CLI ou do portal. |
vmname | O nome da Máquina Virtual do Azure. |
MétricasNomes | Lista separada por vírgulas de métricas válidas do Load Balancer. |
api-version | A versão da API a ser usada para a solicitação. Este documento abrange a versão 2018-01-01 api, incluída no URL acima. |
timespan | String com o seguinte formato startDateTime_ISO/endDateTime_ISO que define o intervalo de tempo das métricas retornadas. Este parâmetro opcional é definido para retornar o valor de um dia de dados no exemplo. |
Corpo do pedido
Nenhum corpo de solicitação é necessário para esta operação.
Processar a resposta
O código de status 200 é retornado quando a lista de valores métricos é retornada com êxito. Uma lista completa de códigos de erro está disponível na documentação de referência.
Resposta de exemplo
{
"cost": 0,
"timespan": "2018-06-08T23:48:10Z/2018-06-09T00:48:10Z",
"interval": "PT1M",
"value": [
{
"id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU",
"type": "Microsoft.Insights/metrics",
"name": {
"value": "Percentage CPU",
"localizedValue": "Percentage CPU"
},
"unit": "Percent",
"timeseries": [
{
"metadatavalues": [],
"data": [
{
"timeStamp": "2018-06-08T23:48:00Z",
"average": 0.44
},
{
"timeStamp": "2018-06-08T23:49:00Z",
"average": 0.31
},
{
"timeStamp": "2018-06-08T23:50:00Z",
"average": 0.29
},
{
"timeStamp": "2018-06-08T23:51:00Z",
"average": 0.29
},
{
"timeStamp": "2018-06-08T23:52:00Z",
"average": 0.285
} ]
} ]
} ]
}