--- 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 --- # プッシュメトリクス API # プッシュメトリクス API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分 プッシュメトリクス API には、生のメトリックインテリジェンスデータを外部ソースから MID サーバー にプッシュできるエンドポイントが用意されています。 この API は、生データを外部ソースから MID サーバー にプッシュするクライアントサイドツールに基づいています。メトリックインテリジェンス 拡張は、\[REST リスナーを有効にする\] オプションを有効にして構成する必要があります。MID サーバーの設定の詳細については、「[メトリックインテリジェンスの開始」](https://www.servicenow.com/docs/access?context=get-started-metrics&version=australia&pubname=australia-it-operations-management&ft:locale=en-US)を参照してください。 認証要件の詳細については、「 [MID Web サーバー拡張の構成](https://www.servicenow.com/docs/access?context=configure-mid-web-server-extension&version=australia&pubname=australia-it-operations-management&ft:locale=en-US)」を参照してください。 ## プッシュメトリクス:POST /mid/sa/metrics {#ariaid-title2} 生の メトリックインテリジェンス データを外部ソースから MID サーバーにプッシュします。 ### URL 形式 {#sa-POST-metrics__section_nbn_xsv_3mb} デフォルト URL: /api/mid/sa/metrics ### サポートされている要求パラメーター {#sa-POST-metrics__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 1. パスパラメーター] {#sa-POST-metrics__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 2. クエリパラメーター] {#sa-POST-metrics__entry__10} | 名前 | 説明 | |-|-| | ci2metric_id | 構成アイテム (CI) を識別するために使用するキーと値のペアのリスト。以前は ci_identifierとして知られていました。スクリプトは引き続き ci_identifierを受け付けます。 データタイプ: オブジェクト | | metric_type | メトリクスの名前。 データタイプ：文字列 | | node | IP アドレス、FQDN、CI の名前、またはホスト。次の例では、ディスクがインストールされている Linux サーバーの名前です。 データタイプ：文字列 | | resource_path | メトリクスデータが収集されているリソースのパス。以下の例では、 `C:\` がメトリクスデータが収集されるリソースです。 データタイプ：文字列 | | ソース | 評価指標タイプをモニタリングするデータソース。 データタイプ：文字列 | | timestamp | メトリクスのエポックタイムスタンプ。 データタイプ：数値 単位：ミリ秒 | | 単位 | ソースのメトリクスタイプに関連付けられているユニットタイプ。 表: モニタリングシステムのメトリクスタイプ \[sa_source_metric_type\] データタイプ：文字列 | | 値 | メトリクスの値。 データタイプ：数値 | [表 : 3. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#sa-POST-metrics__entry__28}{#sa-POST-metrics__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 4. 要求ヘッダー] {#sa-POST-metrics__entry__32} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#sa-POST-metrics__entry__36}{#sa-POST-metrics__entry-200-status-code}{#sa-POST-metrics__entry-401-status-code}{#sa-POST-metrics__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 6. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#sa-POST-metrics__entry__44} | 名前 | 説明 | |-|-| | なし | | [ ] ### cURL 要求 この例に示すように、要求本体は角かっこで囲む必要があります。 curl -X POST "https:///api/mid/sa/metrics" -H "Content-Type: application/json" -U "username":"password" -d "[{ "metric_type": "Disk C: % Free Space", "resource_path": "C:\\", "node": "lnux100", "value": 50, "timestamp": 1473183012000, "ci2metric_id": { "node": "lnux100" }, "source": "Splunk" }]"