Azure REST API를 사용하여 Load Balancer 사용 현황 메트릭 가져오기

아티클
06/26/2024

Azure REST API를 사용하여 일정 기간 동안 표준 Load Balancer에서 처리한 바이트 수를 수집합니다.

REST API에 대한 전체 참조 설명서 및 추가 샘플은 Azure Monitor REST 참조에서 사용할 수 있습니다.

요청 빌드

다음 GET 요청을 사용하여 표준 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`로 설정합니다.
권한 부여	필수입니다. 유효한 `Bearer`액세스 토큰으로 설정합니다.

URI 매개 변수

이름	설명
subscriptionId	Azure 구독을 식별하는 구독 ID입니다. 구독이 여러 개인 경우 여러 구독으로 작업을 참조합니다.
resourceGroupName	리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API, CLI 또는 포털에서 이 값을 얻을 수 있습니다.
loadBalancerName	Azure Load Balancer의 이름입니다.
메트릭 이름	쉼표로 구분된 유효한 Load Balancer 메트릭 목록입니다.
api-version	요청에 사용할 API 버전입니다. 이 문서에서는 위 URL에 포함되어 있는 api-version `2018-01-01`을 다룹니다.
timespan	쿼리의 시간 범위입니다. 다음 형식이 `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"
}

다음을 통해 공유