--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP 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) 所要時間：17分 DCIM メトリクスデータフィード API は、外部システムからデータセンターインフラストラクチャ管理 (DCIM) メトリクスデータを受け取り、そのデータをメトリックベースデータベースに保存するためのエンドポイントを提供します。 この API は、温度、湿度、電力使用量などのほぼリアルタイムのメトリクスデータを受信します。 この API は、スクリプト拡張ポイント TNIDCIMFeedParser を実装することで、選択した外部システムで使用するために拡張できます。例として、デフォルトの実装 TNIDCIMFeedParserImpl を使用できます。拡張ポイントの詳細については、「 [拡張ポイントを使用してアプリケーション機能を拡張する](https://servicenow-prod.fluidtopics.net/G87TESYnVG~l0kK52ieKZg "拡張ポイントを使用して、元のアプリケーションコードを変更せずにアプリケーションの機能を拡張します。選択した ServiceNow AI Platform アプリケーションで利用可能な既存の拡張ポイントを使用することも、独自のインスタンスでカスタムアプリケーションを開発するときに拡張ポイントを追加することもできます。")」を参照してください。 この API は、 ServiceNow Store で利用可能な Network Inventory Advanced アプリケーションに含まれています。この API には、 メトリックベース プラグイン (com.snc.clotho) も必要です。 呼び出し元ユーザーには、sn_ni_adv.metric_integrator ロールが必要です。 ## DCIM メトリクスデータフィード:POST /sn_ni_adv/dcim/feed/{vendorname} {#ariaid-title2} 温度、湿度、電力使用量などのメトリクスデータを メトリックベース に保存します。 デフォルトでは、このエンドポイントを使用して、次のタイプの構成アイテム (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 を TNIDCIMFeedParser 拡張ポイントの実装に含める必要があります。 データタイプ：文字列 | [表 : 1. パスパラメーター] {#dcim-mdf-POST-feed__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 2. クエリパラメーター] {#dcim-mdf-POST-feed__entry__10} | 名前 | 説明 | |-|-| | データ | 必須。メトリックベースに保存するデータ。 データタイプ: オブジェクト 注: このオブジェクトに含める必要がある要素は、 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パラメーターが`べき乗`の場合は必須です。 データタイプ: オブジェクト "apparentPower": { "unit": "String", "value": "String" } | | data.apparentPower.unit | 測定単位。許可される値は `kVA` のみです。 データタイプ：文字列 | | data.apparentPower.value | 記録されたキロボルトアンペアの読み取り値。 データタイプ：文字列 | | data.asset | 資産データ。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\] フィールド:名前 データタイプ：文字列 | | data.asset.level | 資産の種類。キャビネット、ケージ、およびゾーンに使用されます。 可能な値： * 内閣 * 籠 * ゾーン {#dcim-mdf-POST-feed__ul_kfk_rwc_cgc} データタイプ：文字列 | | data.asset.type | 資産の種類。回路に使用されます。許可される値は `CIRCUIT` のみです。 データタイプ：文字列 | | data.cabinet | キャビネットの名前。typeパラメーターが`従量制電力`または`電力`である場合、キャビネットに必要です。 テーブル:コンテナキャビネット \[cmdb_ci_container_cabinet\] フィールド:名前 データタイプ：文字列 | | data.cabinetRating | キャビネットの定格電力使用量はキロボルトアンペアです。typeパラメーターが`べき乗`の場合は必須です。 データタイプ: オブジェクト "cabinetRating": { "unit": "String", "value": "String" } | | data.cabinetRating.unit | 測定単位。許可される値は `kVA` のみです。 データタイプ：文字列 | | data.cabinetRating.value | キャビネットの電力使用量定格。 データタイプ：文字列 | | data.cage | ケージの名前。typeパラメーターが`従量制電力`または`電力`である場合、ケージに必要です。 テーブル:ケージ \[cmdb_ci_cage\] フィールド:名前 データタイプ：文字列 | | data.contractualPower | 契約によって割り当てられた電力使用量 (キロボルトアンペア)。typeパラメーターが`べき乗`の場合は必須です。 データタイプ: オブジェクト "contractualPower": { "unit": "String", "value": "String" } | | data.contractualPower.unit | 測定単位。許可される値は `kVA` のみです。 データタイプ：文字列 | | data.contractualPower.value | 契約によって割り当てられた電力使用量。 データタイプ：文字列 | | data.ibx | データセンターの名前。 データセンターのメトリクスデータを保存する場合は必須です。 テーブル:データセンター \[cmdb_ci_datacenter\] データタイプ：文字列 | | data.kilowattHour | 電力使用量データ (キロワット時)typeパラメーターが`従量制電力`の場合は必須です。 データタイプ: オブジェクト "kilowattHour": { "unit": "String", "value": "String" } | | data.kilowattHour.unit | 測定単位。指定できる値は `kWh` のみです。 データタイプ：文字列 | | data.kilowattHour.value | 記録されたキロワット時の読み取り値。 データタイプ：文字列 | | data.peakLastSevenDays | 過去 1 週間の最大電力使用量 (キロボルトアンペア)。typeパラメーターが`べき乗`の場合は必須です。 データタイプ: オブジェクト "peakLastSevenDays": { "unit": "String", "value": "String" } | | data.peakLastSevenDays.unit | 測定単位。許可される値は `kVA` のみです。 データタイプ：文字列 | | data.peakLastSevenDays.value | 先週の最大電力使用量の値。 データタイプ：文字列 | | data.peakLastSevenDaysRatio | 過去 1 週間以内に契約によって割り当てられた電力のうち使用された電力の最大割合。typeパラメーターが`べき乗`の場合は必須です。 データタイプ: オブジェクト "peakLastSevenDaysRatio": { "unit": "String", "value": "String" } | | data.peakLastSevenDaysRatio.unit | 測定単位。許可される値は `PERCENT` のみです。 データタイプ：文字列 | | data.peakLastSevenDaysRatio.value | 使用される電力の最大割合。 データタイプ：文字列 | | data.powerConsumptionToContractual | 契約によって割り当てられた量に対する電力の使用率。typeパラメーターが`べき乗`の場合は必須です。 データタイプ: オブジェクト "powerConsumptionToContractual": { "unit": "String", "value": "String" } | | data.powerConsumptionToContractual.unit | 測定単位。許可される値は `PERCENT` のみです。 データタイプ：文字列 | | data.powerConsumptionToContractual.value | 使用された電力の割合。 データタイプ：文字列 | | data.powerFactor | 力率データ。typeパラメーターが`べき乗`の場合は必須です。 データタイプ: オブジェクト "powerFactor": { "unit": "String", "value": "String" } | | data.powerFactor.unit | 測定単位。許可される値は `pf` のみです。 データタイプ：文字列 | | data.powerFactor.value | 力率の値。 データタイプ：文字列 | | data.reading | 収集された環境データ。typeパラメーターが`環境パラメーター`の場合は必須です。 データタイプ: オブジェクト "reading": { "unit": "String", "value": "String" } | | data.reading.unit | 測定単位。 可能な値： * `CELSIUS:`data.tag.id`が温度`の場合に使用されます。 * `PERCENT`:data.tag.id`湿度`の場合に使用されます。 {#dcim-mdf-POST-feed__ul_ry2_lnc_cgc} データタイプ：文字列 | | data.reading.value | 記録された値。 データタイプ：文字列 | | data.readingTime | 必須。データが収集された日時。 この値は、ISO 8601 形式の UTC である必要があります。例: `2025-07-03T16:22:15.000Z`。 データタイプ：文字列 | | data.realPower | 電力使用量データ (キロワット)。typeパラメーターが`べき乗`の場合は必須です。 データタイプ: オブジェクト "realPower": { "unit": "String", "value": "String" } | | data.realPower.unit | 測定単位。指定できる値は `kW` のみです。 データタイプ：文字列 | | data.realPower.value | 記録されたキロワットの読み取り値。 データタイプ：文字列 | | data.soldCurrent | 契約によって割り当てられた電流 (アンペア)。typeパラメーターが`べき乗`の場合は必須です。 データタイプ: オブジェクト "soldCurrent": { "unit": "String", "value": "String" } | | data.soldCurrent.unit | 測定単位。指定できる値は `A` のみです。 データタイプ：文字列 | | data.soldCurrent.value | 契約によって割り当てられた電流。 データタイプ：文字列 | | data.tag | 環境データのタイプを含むオブジェクト。typeパラメーターが`環境パラメーター`の場合は必須です。 データタイプ: オブジェクト "tag": { "id": "String" } | | data.tag.id | 環境データのタイプ。 可能な値： * 湿度 * 温度 {#dcim-mdf-POST-feed__ul_wkj_mmc_cgc} データタイプ：文字列 | | type | 必須。メトリクスデータのタイプ。 可能な値： * `環境:`湿度または温度に使用されます。 * `従量制電力`:キロワット時 (kWh) 単位で電力使用量に使用されます。 * `power`:キロワット (kW) およびキロボルトアンペア (kVA) 単位の電力使用量に使用されます。 {#dcim-mdf-POST-feed__ul_cjt_5yb_cgc} データタイプ：文字列 | [表 : 3. 要求本文パラメーター (JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#dcim-mdf-POST-feed__entry__102}{#dcim-mdf-POST-feed__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json;charset=UTF-8 のみをサポートします。 | | 認証 | 基本的な。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 4. 要求ヘッダー] {#dcim-mdf-POST-feed__entry__110} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json;charset=UTF-8 のみをサポートします。 | [表 : 5. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#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.status | 要求のステータス。 データタイプ：文字列 | | 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" } }