REST API를 사용하여 가상 머신 사용률 메트릭 가져오기

아티클
08/24/2024

적용 대상: ✔️ Linux VM ✔️ 유연한 확장 집합

이 예제에서는 Azure REST API를 사용하여 Linux 가상 머신의 CPU 사용량을 검색하는 방법을 보여 줍니다.

REST API에 대한 전체 참조 설명서와 샘플은 Azure Monitor 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`로 설정합니다.
권한 부여	필수입니다. 유효한 `Bearer` 액세스 토큰으로 설정합니다.

URI 매개 변수

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

다음을 통해 공유