使用 Azure REST API 取得 Load Balancer 的使用計量

發行項
12/04/2024

使用 Azure REST API，來收集 Standard Load Balancer 在一段時間內所處理的位元組數目。

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

建立要求

請使用下列 GET 要求以從 Standard Load Balancer 收集 ByteCount 計量。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=ByteCount&timespan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z

要求標頭

以下是必要標頭：

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

URI 參數

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

要求本文

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

處理回應

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

範例回應

{
    "cost": 0,
    "timespan": "2018-06-05T03:00:00Z/2018-06-07T03:00:00Z",
    "interval": "PT1M",
    "value": [
        {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/providers/Microsoft.Insights/metrics/ByteCount",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "ByteCount",
                "localizedValue": "Byte Count"
            },
            "unit": "Count",
            "timeseries": [
                {
                    "metadatavalues": [],
                    "data": [
                        {
                            "timeStamp": "2018-06-06T17:24:00Z",
                            "total": 1067921034.0
                        },
                        {
                            "timeStamp": "2018-06-06T17:25:00Z",
                            "total": 0.0
                        },
                        {
                            "timeStamp": "2018-06-06T17:26:00Z",
                            "total": 3781344.0
                        },
                    ]
                }
            ]
        }
    ],
    "namespace": "Microsoft.Network/loadBalancers",
    "resourceregion": "eastus"
}

共用方式為