---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DCIM 메트릭 데이터 피드 API

# DCIM 메트릭 데이터 피드 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 16분

DCIM 메트릭 데이터 피드 API는 외부 시스템에서 DCIM(Data Center Infrastructure Management) 메트릭 데이터를 승인하고 데이터베이스에 데이터를 MetricBase 저장하는 엔드포인트를 제공합니다.
이 API는 온도, 습도 및 전력 사용량과 같은 거의 실시간 메트릭 데이터를 수신합니다.

이 API는 스크립팅된 확장점 TNIDCIMFeedParser를 구현하여 선택한 외부 시스템에서 사용하도록 확장할 수 있습니다. 기본 구현 TNIDCIMFeedParserImpl 을 예로 사용할 수 있습니다. 확장점에 대한 자세한 내용은 문서를 참조하십시오 [확장점을 사용하여 애플리케이션 기능 확장](https://servicenow-prod.fluidtopics.net/hlS~T2BSuFPBR6CRMdrvhw "확장점을 사용하면 원래 애플리케이션 코드를 변경하지 않고도 애플리케이션의 기능을 확장할 수 있습니다. 선택한 ServiceNow AI Platform 애플리케이션에서 사용할 수 있는 기존 확장점을 사용하거나 자체 인스턴스에서 사용자 지정 애플리케이션을 개발할 때 확장점을 추가할 수 있습니다.").

이 API는 에서 사용할 수 있는 Network Inventory Advanced 애플리케이션에 포함되어 있습니다 ServiceNow Store. 이 API에는 플러그인(com.snc.clotho)도 MetricBase 필요합니다.

호출하는 사용자에게 sn_ni_adv.metric_integrator 역할이 있어야 합니다.

## DCIM 메트릭 데이터 피드 - POST /sn_ni_adv/dcim/feed/{vendorname} {#ariaid-title2}

온도, 습도 및 전력 사용량 MetricBase과 같은 메트릭 데이터를 에 저장합니다.
기본적으로 이 엔드포인트는 다음 유형의 구성 항목(CI)에 대한 데이터를 저장하는 데 사용할 수 있습니다.

* 회로 \[cmdb_ci_circuit\]
* 캐비닛 \[cmdb_ci_container_cabinet\]
* 케이지 \[cmdb_ci_cage\]
* 데이터 센터 \[cmdb_ci_datacenter\]
* 데이터 센터 영역 \[cmdb_ci_zone\]
{#dcim-mdf-POST-feed__ul_v5c_3t2_cgc}

이 엔드포인트를 추가 CI 유형과 함께 사용하려면 [메트릭 정의를 생성하고](https://www.servicenow.com/docs/access?context=set-up-data-monitoring&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 스크립팅된 확장점 TNIDCIMFeedParser를 구현합니다.

### URL 형식

기본 URL: /api/sn_ni_adv/dcim/feed/{vendorname}

### 지원되는 요청 매개변수

{#dcim-mdf-POST-feed__entry__2}

| 이름 | 설명 |
|-|-|
| 벤더 이름 | 메트릭 데이터를 수신할 외부 시스템의 이름입니다. 이 API의 기본 구현을 사용하는 경우 이 값은 `equinix`입니다. 다른 외부 시스템에서 이 API를 사용하는 경우 vendorname 여기에 사용된 API는 TNIDCIMFeedParser 확장점 구현에 포함되어야 합니다. 데이터 유형: 문자열 |
[표 1. 경로 매개변수]

{#dcim-mdf-POST-feed__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 2. 쿼리 매개변수]

{#dcim-mdf-POST-feed__entry__10}

| 이름 | 설명 |
|-|-|
| 데이터 | 필수 에 저장할 MetricBase데이터 . 데이터 유형: 객체 주: 이 개체에 포함되어야 하는 요소는 매개 변수 및 구성 항목 유형(예: 데이터센터 또는 회로)에 따라 type 달라집니다. "data": { "apparentPower": {Object}, "asset": {Object}, "cabinet": "String", "cabinetRating": {Object}, "cage": "String", "contractualPower": {Object}, "ibx": "String", "kilowattHour": {Object}, "peakLastSevenDays": {Object}, "peakLastSevenDaysRatio": {Object}, "powerConsumptionToContractual": {Object}, "powerFactor": {Object}, "reading": {Object}, "readingTime": "String", "realPower": {Object}, "soldCurrent": {Object}, "tag": {Object} } |
| data.apparentPower | 킬로볼트-암페어 단위의 피상 전력 데이터입니다. 매개변수가 type`power`인 경우 필요합니다. 데이터 유형: 객체 "apparentPower": { "unit": "String", "value": "String" } |
| data.apparentPower.unit | 측정 단위입니다. 허용되는 유일한 값은 `kVA`입니다. 데이터 유형: 문자열 |
| data.apparentPower.value | 기록된 킬로볼트-암페어 판독값입니다. 데이터 유형: 문자열 |
| 데이터.자산 | 자산 데이터입니다. 매개변수가 type`계량 전력` 또는 `전력`일 때 회로에 필요합니다. 매개변수가 `환경`적인 경우 캐비닛, 케이지 및 구역에 type 필요합니다. 데이터 유형: 객체 "asset": { "id": "String", "level": "String", "type": "String" } |
| data.asset.id | 자산의 이름입니다. 표: 회로 \[cmdb_ci_circuit\], 캐비닛 \[cmdb_ci_container_cabinet\], 케이지 \[cmdb_ci_cage\] 또는 데이터 센터 영역 \[cmdb_ci_zone\] 필드: 이름 데이터 유형: 문자열 |
| 데이터.자산.수준 | 자산의 유형입니다. 캐비닛, 케이지 및 구역에 사용됩니다. 가능한 값: * 내각 * 농 * 구역 {#dcim-mdf-POST-feed__ul_kfk_rwc_cgc} 데이터 유형: 문자열 |
| 데이터.자산.유형 | 자산의 유형입니다. 회로에 사용됩니다. 유일하게 허용되는 값은 `CIRCUIT`입니다. 데이터 유형: 문자열 |
| 데이터.캐비닛 | 캐비닛의 이름입니다. 매개변수가 type`계량된 전력` 또는 `전력`인 경우 캐비닛에 필요합니다. 테이블: 컨테이너 캐비닛 \[cmdb_ci_container_cabinet\] 필드: 이름 데이터 유형: 문자열 |
| data.cabinetRating | 캐비닛의 전력 사용량은 킬로볼트-암페어로 평가됩니다. 매개변수가 type`power`인 경우 필요합니다. 데이터 유형: 객체 "cabinetRating": { "unit": "String", "value": "String" } |
| data.cabinetRating.unit | 측정 단위입니다. 허용되는 유일한 값은 `kVA`입니다. 데이터 유형: 문자열 |
| data.cabinetRating.value | 캐비닛의 전력 사용 등급입니다. 데이터 유형: 문자열 |
| 데이터.케이지 | 케이지의 이름입니다. 매개변수가 type`metered-power` 또는 `power`인 경우 케이지에 필요합니다. 테이블: 케이지 \[cmdb_ci_cage\] 필드: 이름 데이터 유형: 문자열 |
| data.contractualPower | 계약에 의해 할당된 전력 사용량(킬로볼트-암페어)입니다. 매개변수가 type`power`인 경우 필요합니다. 데이터 유형: 객체 "contractualPower": { "unit": "String", "value": "String" } |
| data.contractualPower.unit | 측정 단위입니다. 허용되는 유일한 값은 `kVA`입니다. 데이터 유형: 문자열 |
| 데이터.계약전력.값 | 계약에 할당된 전력 사용량입니다. 데이터 유형: 문자열 |
| 데이터.ibx | 데이터센터의 이름입니다. 데이터센터에 대한 메트릭 데이터를 저장할 때 필요합니다. 테이블: 데이터 센터 \[cmdb_ci_datacenter\] 데이터 유형: 문자열 |
| 데이터.킬로와트시 | 킬로와트시 단위의 전력 사용량 데이터입니다. 매개변수가 type`metered-power`인 경우 필요합니다. 데이터 유형: 객체 "kilowattHour": { "unit": "String", "value": "String" } |
| data.kilowattHour.unit | 측정 단위입니다. 허용되는 유일한 값은 `kWh`입니다. 데이터 유형: 문자열 |
| data.kilowattHour.value | 기록된 킬로와트시 판독값입니다. 데이터 유형: 문자열 |
| data.peakLastSevenDays | 지난 주 최대 전력 사용량(킬로볼트-암페어)입니다. 매개변수가 type`power`인 경우 필요합니다. 데이터 유형: 객체 "peakLastSevenDays": { "unit": "String", "value": "String" } |
| data.peakLastSevenDays.unit | 측정 단위입니다. 허용되는 유일한 값은 `kVA`입니다. 데이터 유형: 문자열 |
| data.peakLastSevenDays.value | 지난주의 최대 전력 사용량 값입니다. 데이터 유형: 문자열 |
| data.peakLastSevenDaysRatio | 지난 주에 계약에 의해 할당된 금액 중 사용된 전력의 최대 백분율입니다. 매개변수가 type`power`인 경우 필요합니다. 데이터 유형: 객체 "peakLastSevenDaysRatio": { "unit": "String", "value": "String" } |
| data.peakLastSevenDaysRatio.unit | 측정 단위입니다. 유일하게 허용되는 값은 `PERCENT`입니다. 데이터 유형: 문자열 |
| data.peakLastSevenDaysRatio.value | 사용된 전력의 최대 백분율입니다. 데이터 유형: 문자열 |
| data.powerConsumptionToContractual | 계약에 의해 할당된 금액 중 사용된 전력의 백분율입니다. 매개변수가 type`power`인 경우 필요합니다. 데이터 유형: 객체 "powerConsumptionToContractual": { "unit": "String", "value": "String" } |
| data.powerConsumptionToContractual.unit | 측정 단위입니다. 유일하게 허용되는 값은 `PERCENT`입니다. 데이터 유형: 문자열 |
| data.powerConsumptionToContractual.value | 사용된 전력의 백분율입니다. 데이터 유형: 문자열 |
| data.powerFactor | 역률 데이터입니다. 매개변수가 type`power`인 경우 필요합니다. 데이터 유형: 객체 "powerFactor": { "unit": "String", "value": "String" } |
| 데이터.powerFactor.unit | 측정 단위입니다. 유일하게 허용되는 값은 `pf`입니다. 데이터 유형: 문자열 |
| 데이터.파워팩터.값 | 역률 값입니다. 데이터 유형: 문자열 |
| 데이터.읽기 | 수집된 환경 데이터입니다. 매개변수가 type`환경`인 경우 필요합니다. 데이터 유형: 객체 "reading": { "unit": "String", "value": "String" } |
| 데이터.읽기.단위 | 측정 단위입니다. 가능한 값: * `섭씨:``온도`일 때 data.tag.id 사용합니다. * `PERCENT:``습도`가 높을 때 data.tag.id 사용합니다. {#dcim-mdf-POST-feed__ul_ry2_lnc_cgc} 데이터 유형: 문자열 |
| 데이터.읽기.값 | 기록된 값입니다. 데이터 유형: 문자열 |
| data.readingTime | 필수 데이터가 수집된 날짜 및 시간입니다. 이 값은 ISO 8601 형식의 UTC여야 합니다. 예: `2025-07-03T16:22:15.000Z`. 데이터 유형: 문자열 |
| data.realPower | 킬로와트 단위의 전력 사용량 데이터입니다. 매개변수가 type`power`인 경우 필요합니다. 데이터 유형: 객체 "realPower": { "unit": "String", "value": "String" } |
| 데이터.realPower.unit | 측정 단위입니다. 유일하게 허용되는 값은 `kW`입니다. 데이터 유형: 문자열 |
| 데이터.realPower.value | 기록된 킬로와트 판독값입니다. 데이터 유형: 문자열 |
| data.soldCurrent | 계약에 의해 할당된 전류(암페어)입니다. 매개변수가 type`power`인 경우 필요합니다. 데이터 유형: 객체 "soldCurrent": { "unit": "String", "value": "String" } |
| data.soldCurrent.unit | 측정 단위입니다. 유일하게 허용되는 값은 `A`입니다. 데이터 유형: 문자열 |
| data.soldCurrent.value | 계약에 의해 할당된 전류입니다. 데이터 유형: 문자열 |
| 데이터.태그 | 환경 데이터의 유형을 포함하는 객체입니다. 매개변수가 type`환경`인 경우 필요합니다. 데이터 유형: 객체 "tag": { "id": "String" } |
| data.tag.id | 환경 데이터의 유형입니다. 가능한 값: * 습도 * 온도 {#dcim-mdf-POST-feed__ul_wkj_mmc_cgc} 데이터 유형: 문자열 |
| 유형 | 필수 메트릭 데이터의 유형입니다. 가능한 값: * `환경`: 습도 또는 온도에 사용됩니다. * `metered-power`: 킬로와트시(kWh) 단위의 전력 사용량에 사용됩니다. * `전력`: 킬로와트(kW) 및 킬로볼트-암페어(kVA) 단위의 전력 사용에 사용됩니다. {#dcim-mdf-POST-feed__ul_cjt_5yb_cgc} 데이터 유형: 문자열 |
[표 3. 요청 본문 매개변수(JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#dcim-mdf-POST-feed__entry__102}{#dcim-mdf-POST-feed__content_type-JSON-only-entry-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json;charset=UTF-8. |
| 권한 부여 | 기초의. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 4. 요청 헤더]

{#dcim-mdf-POST-feed__entry__110}

| 머리글 | 설명 |
|-|-|
| 콘텐츠-형식 | 응답 본문의 데이터 형식입니다. .만 지원합니다 application/json;charset=UTF-8. |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#dcim-mdf-POST-feed__entry__114}{#dcim-mdf-POST-feed__entry-200-status-code}{#dcim-mdf-POST-feed__entry-400-status-code}{#dcim-mdf-POST-feed__entry-401-status-code}{#dcim-mdf-POST-feed__entry-403-status-code}{#dcim-mdf-POST-feed__entry-404-status-code}{#dcim-mdf-POST-feed__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 403 | 금지되었습니다. 사용자에게 지정된 기록에 대한 액세스 권한이 없습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 429 | 요청이 너무 많습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수(JSON)

{#dcim-mdf-POST-feed__entry__130}

| 이름 | 설명 |
|-|-|
| 결과 | 요청에 대한 상세 정보입니다. 데이터 유형: 객체 "result": { "status": "String", "sys_id": "String" } |
| 결과.상태 | 요청의 상태입니다. 데이터 유형: 문자열 |
| result.sys_id | 메트릭 데이터로 업데이트된 CI의 Sys_id입니다. 표: 회로 \[cmdb_ci_circuit\], 캐비닛 \[cmdb_ci_container_cabinet\], 케이지 \[cmdb_ci_cage\], 데이터 센터 \[cmdb_ci_datacenter\] 또는 데이터 센터 영역 \[cmdb_ci_zone\] 데이터 유형: 문자열 |
[ ]

### cURL 요청

데이터 센터에 대한 계량된 전력 데이터를 저장합니다.

    curl "https://instance.service-now.com/api/sn_ni_adv/dcim/feed/vendorname" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        "type": "metered-power",
        "data": {
            "ibx": "Datacenter Name",
            "kilowattHour": {
                "value": "40509.323",
                "unit": "kWh"
            },
            "readingTime": "2025-07-03T16:22:15.000Z"
        }
    }" \
    --user 'username':'password'

응답 본문.

    {
        "result": {
            "status": "success",
            "sys_id": "c88dde85ff2662109cb9ffffffffffcc"
        }
    }

### cURL 요청 {#dcim-mdf-POST-feed__example_dq1_lz2_cgc}

회로에 대한 전력 데이터를 저장합니다.

    curl "https://instance.service-now.com/api/sn_ni_adv/dcim/feed/vendorname" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        "type": "power",
        "data": {
            "asset": {
                "id": "Circuit Name",
                "type": "CIRCUIT"
            },
            "realPower": {
                "value": "0.522",
                "unit": "kW"
            },
            "apparentPower": {
                "value": "1.070",
                "unit": "kVA"
            },
            "contractualPower": {
                "value": "60.000",
                "unit": "kVA"
            },
            "powerFactor": {
                "value": "0.48",
                "unit": "pf"
            },
            "soldCurrent": {
                "value": "15.000",
                "unit": "A"
            },
            "powerConsumptionToContractual": {
                "value": "32.151",
                "unit": "PERCENT"
            },
            "cabinetRating": {
                "value": "123.300",
                "unit": "kVA"
            },
            "peakLastSevenDays": {
                "value": "1.146",
                "unit": "kVA"
            },
            "peakLastSevenDaysRatio": {
                "value": "34.424",
                "unit": "PERCENT"
            },
            "readingTime": "2025-07-03T16:22:15.000Z"
        }
    }" \
    --user 'username':'password'

응답 본문.

    {
        "result": {
            "status": "success",
            "sys_id": "c67dbe45fc2662109cb9ffffffffffcd"
        }
    }

### cURL 요청 {#dcim-mdf-POST-feed__example_gks_zz2_cgc}

구역에 대한 온도 데이터를 저장합니다.

    curl "https://instance.service-now.com/api/sn_ni_adv/dcim/feed/vendorname" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        "type": "environmental",
        "data": {
            "asset": {
                "id": "Zone Name",
                "level": "ZONE"
            },
            "reading": {
                "value": "23.300",
                "unit": "CELSIUS"
            },
            "tag": {
                "id": "temperature"
            },
            "readingTime": "2025-07-03T16:22:15.000Z"
        }
    }" \
    --user 'username':'password'

응답 본문.

    {
        "result": {
            "status": "success",
            "sys_id": "c64dbc42fe2862109cb9ffffffffffed"
        }
    }

### cURL 요청 {#dcim-mdf-POST-feed__example_oml_31f_cgc}

캐비닛에 대한 습도 데이터를 저장합니다.

    curl "https://instance.service-now.com/api/sn_ni_adv/dcim/feed/vendorname" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        "type": "environmental",
        "data": {
            "asset": {
                "id": "Test Cabinet",
                "level": "CABINET"
            },
            "reading": {
                "value": "66.120",
                "unit": "PERCENT"
            },
            "tag": {
                "id": "humidity"
            },
            "readingTime": "2025-07-03T16:22:15.000Z"
        }
    }" \
    --user 'username':'password'

응답 본문.

    {
        "result": {
            "status": "success",
            "sys_id": "c24dbc82fe3862107cb9ffffffffffbc"
        }
    }