使用 REST API 來取得虛擬機器的使用量計量

發行項
07/08/2024

適用於：✔️ Linux VM ✔️ 彈性擴展集

此範例說明如何使用 Azure REST API 來擷取 Linux 虛擬機器的 CPU 使用量。

如需 REST API 的完整參考文件和範例，可於 Azure 監視器 REST 參考文章中取得。

建立要求

請使用下列 GET 要求從虛擬機器收集 CPU 百分比計量。

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&timespan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z

要求標頭

以下是必要標頭：

要求標頭	描述
內容類型：	必要。設定為 `application/json`。
Authorization:	必要。設定為有效的 `Bearer` 存取權杖。

URI 參數

名稱	描述
subscriptionId	可識別 Azure 訂用帳戶的訂用帳戶識別碼。如果您有多個訂用帳戶，請參閱使用多個訂用帳戶。
resourceGroupName	與資源相關聯的 Azure資源群組名稱。您可以從 Azure Resource Manager API、CLI 或入口網站取得這個值。
vmname	Azure 虛擬機器的名稱。
metricnames	以逗號分隔的有效 Load Balancer 計量清單。
api-version	要用於要求的 API 版本。本文件涵蓋 api-version `2018-01-01`，內含於上述 URL 中。
時間範圍	具有 `startDateTime_ISO/endDateTime_ISO` 格式的字串，可定義所傳回計量的時間範圍。此選用參數會設定為傳回此範例中一天份的資料。

要求本文

這項作業不需要要求本文。

處理回應

當計量值清單成功傳回時，系統會傳回狀態碼 200。錯誤碼的完整清單可於參考文件中取得。

範例回應

{
    "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
                        } ]
                } ]
        } ]
}

共用方式為