--- 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) 所要時間：99分 Resource Inventory Open API は、リソースを作成、取得、および削除するためのエンドポイントを提供します。 この API を使用して、次のテーブルのリソースを管理します。 * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * インターフェイスカード \[cmdb_ci_interface_card\] * IP アドレス \[cmdb_ci_ip_address\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * ストランド \[cmdb_ci_strand\] * トポロジ \[cmdb_ci_topology\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブル。 * 次のいずれかのテーブルを拡張する子テーブル: * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * ストランド \[cmdb_ci_strand\] {#resource-inventory-api__ul_umw_gvn_bcc} {#resource-inventory-api__ul_utd_jmd_wxb} この API は、 ServiceNow Store で利用可能なネットワークインベントリコアアプリケーションに含まれています。 この API は、 `sn_ni_core` 名前空間内で提供されます。 呼び出し元ユーザーには sn_ni_core.inventory_integrator ロールが必要です。 この API を拡張して、必須パラメーター、要求本文の検証、およびフィールドマッピングをカスタマイズできます。詳細については、「[リソースインベントリオープン API 開発者ガイド](https://servicenow-prod.fluidtopics.net/hE9R6q~qz6U_cH7E_K5oLA#resource-inventory-dev-guide "Resource Inventory Open API を使用して、インターフェイスカード、論理接続と物理接続、ネットワークサイトなどのリソースを作成、取得、更新、および削除します。")」を参照してください。 Resource Inventory Open API は、TM Forum Resource Inventory API REST 仕様のServiceNow®実装です。この実装は、 [TMF639 Resource Inventory API User Guide v4.0.1](https://www.tmforum.org/resources/standard/tmf639-resource-inventory-api-user-guide-v4-0/) (2020 年 7 月) に基づいています。 ## リソースインベントリオープン API - DELETE /sn_ni_core/resource/{id} {#ariaid-title2} 指定されたリソースレコードを削除します。 ### URL 形式 デフォルト URL: /api/sn_ni_core/resource/{id} ### サポートされている要求パラメーター {#resource-inv-DELETE__table_tjw_q3s_g5b__entry__2} | 名前 | 説明 | |-|-| | ID | リソースのSys_id。リソースのタイプに応じて、次のいずれかのテーブルに配置されます。 * インターフェイスカード \[cmdb_ci_interface_card\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブル。 {#resource-inv-DELETE__res-inv-tables} 注: IP アドレス \[cmdb_ci_ip_address\] テーブル内のリソースは、この API を使用して削除することはできません。 データタイプ：文字列 | [表 : 1. パスパラメーター] {#resource-inv-DELETE__table_tjw_q3s_g5b} {#resource-inv-DELETE__table_cnn_cht_g5b__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 2. クエリパラメーター] {#resource-inv-DELETE__table_cnn_cht_g5b} {#resource-inv-DELETE__table_fdn_t3t_g5b__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 3. 要求本文パラメーター (JSON)] {#resource-inv-DELETE__table_fdn_t3t_g5b} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#resource-inv-DELETE__table_e4k_vhs_g5b__entry__2}{#resource-inv-DELETE__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 4. 要求ヘッダー] {#resource-inv-DELETE__table_e4k_vhs_g5b} {#resource-inv-DELETE__table_gfy_npw_f5b__entry__2} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 5. 応答ヘッダー] {#resource-inv-DELETE__table_gfy_npw_f5b} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#resource-inv-DELETE__table_b4x_lrs_g5b__entry__2}{#resource-inv-DELETE__entry-400-status-code}{#resource-inv-DELETE__entry-401-status-code}{#resource-inv-DELETE__entry-404-status-code} | ステータスコード | 説明 | |-|-| | 215 | 処理のために要求が正常に受信されました。要求は非同期に完了します。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 403 | 禁止されました。リソースの削除に失敗しました。リソースは、関連リソースによって必要になる場合があります。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 6. ステータスコード] {#resource-inv-DELETE__table_b4x_lrs_g5b} ### 応答本文のパラメーター (JSON) {#resource-inv-DELETE__entry__34} | 名前 | 説明 | |-|-| | なし | | [ ] ### cURL 要求 この例では、リソースを削除します。 curl "https://instance.service-now.com/api/sn_ni_core/resource/54ada05e875c15109a9c0f65dabb3586" \ --request DELETE \ --header "Accept:application/json" \ --user 'username':'password' 応答本文。 "" ## リソースインベントリオープン API - GET /sn_ni_core/resource {#ariaid-title3} すべてのリソースレコードのリストを取得します。 ### URL 形式 デフォルト URL: /api/sn_ni_core/resource ### サポートされている要求パラメーター {#resource-inv-GET-resource__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 7. パスパラメーター] {#resource-inv-GET-resource__entry__6}{#resource-inv-GET-resource__tmf-offset} | 名前 | 説明 | |-|-| | @type | 必須です。取得するリソースのタイプのテーブル名。API コールごとに 1 つのタイプのリソースのみを取得できます。 有効な値： * `cmdb_ci_cable` (ケーブル) * `cmdb_ci_interface_card` (インターフェイスカード) * `cmdb_ci_ip_address` (IP アドレス) * `cmdb_ci_ni_logical_path` (論理接続) * `cmdb_ci_ni_interface` (ネットワークインターフェイス) * `cmdb_ci_ni_site` (ネットワークサイト) * `cmdb_ci_ni_physical_link` (物理接続) * `cmdb_ci_strand` (ストランド) * `cmdb_ci_topology` (トポロジ) * sn_ni_core.equipment_tables sys_propertyで指定されたテーブルの名前、または指定されたテーブルを拡張するテーブルの名前。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブルの名前。 {#resource-inv-GET-resource__ul_wmt_vfz_d5b} データタイプ：文字列 | | description | リソースのフィルタリングに使用する説明。指定された説明を持つリソースのみが応答に返されます。 データタイプ：文字列 | | フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効な値： * description * href * ID * name * 注意 * ロケーション * 関連パーティー * リソース特性 * リソース関係 * リソース仕様 * 開始運用日 {#resource-inv-GET-resource__ul_pzn_4gz_d5b} データタイプ：文字列 デフォルト：すべてのフィールドを返します。 | | limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、 offset パラメーターを使用してレコード取得をページネーションします。 デフォルト値：20 データタイプ：数値 | | name | リソースのフィルタリングに使用する名前。指定された名前のリソースのみが応答に返されます。 データタイプ：文字列 | | オフセット | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。 デフォルト：0 データタイプ：数値 | | resourceSpecification.id | リソースのフィルタリングに使用するリソース仕様sys_id。sys_idは、次のいずれかのテーブルのモデルのものである必要があります。 * 機器所有者モデル \[sn_ni_core_equipment_holder_product_model\] * 設備モデル \[sn_ni_core_equipment_product_model\] * インターフェイスカードモデル \[sn_ni_core_interface_card_product_model\] * 論理接続モデル \[sn_ni_core_logical_connection_product_model\] * ネットワークインターフェイスモデル \[sn_ni_core_network_interface_product_model\] * 物理接続モデル \[sn_ni_core_physical_connection_product_model\] {#resource-inv-GET-resource__ul_a3t_1lz_d5b}指定したsys_idに一致するモデルを持つリソースのみが応答に返されます。 データタイプ：文字列 | [表 : 8. クエリパラメーター] {#resource-inv-GET-resource__entry__22} | 名前 | 説明 | |-|-| | なし | | [表 : 9. 要求本文パラメーター (JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#resource-inv-GET-resource__entry__26}{#resource-inv-GET-resource__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 10. 要求ヘッダー] {#resource-inv-GET-resource__table_lpj_dh1_vxb__entry__2} | ヘッダー | 説明 | |-|-| | Content-Range | ページネーションされた呼び出しで返されるコンテンツの範囲。 たとえば、 `offset=2` で `limit=3` の場合、 Content-Range ヘッダーの値は `アイテム 3 から 5` です。 | | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | | 「リンク」 | クエリ結果間を移動するための次のリンクが含まれています。 * 第 1 * 最終 * 次へ * 前へ {#resource-inv-GET-resource__ul_zzk_sdm_lsb} | | X-合計-数 | ページネーションされたクエリの場合、このヘッダーはサーバーで使用可能なレコードの合計数を指定します。 注: レコードの合計数が 100,000 を超える場合、このヘッダーは常に 100,000 を返します。 | [表 : 11. 応答ヘッダー] {#resource-inv-GET-resource__table_lpj_dh1_vxb} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#resource-inv-GET-resource__entry__40}{#resource-inv-GET-resource__entry-200-status-code}{#resource-inv-GET-resource__entry-400-status-code}{#resource-inv-GET-resource__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 206 | 部分的なコンテンツ。要求が正常に処理され、ページネーションされた呼び出しで指定されたコンテンツの一部範囲が返されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | [表 : 12. ステータスコード] ### 応答本文のパラメーター (JSON) {#resource-inv-GET-resource__section_nkb_1rw_f5b} {#resource-inv-GET-resource__table_okb_1rw_f5b__entry__2}{#resource-inv-GET-resource__type-descr-entry}{#resource-inv-GET-resource__related-party-parm} | 名前 | 説明 | |-|-| | @type | リソースのタイプ。 有効な値： * `cmdb_ci_cable` (ケーブル) * `cmdb_ci_interface_card` (インターフェイスカード) * `cmdb_ci_ip_address` (IP アドレス) * `cmdb_ci_ni_logical_path` (論理接続) * `cmdb_ci_ni_interface` (ネットワークインターフェイス) * `cmdb_ci_ni_site` (ネットワークサイト) * `cmdb_ci_ni_physical_link` (物理接続) * `cmdb_ci_strand` (ストランド) * `cmdb_ci_topology` (トポロジ) * sn_ni_core.equipment_tables sys_propertyで指定されたテーブルの名前、または指定されたテーブルを拡張するテーブルの名前。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブルの名前。 {#resource-inv-GET-resource__d3457e145} データタイプ：文字列 | | description | リソースの説明。 データタイプ：文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 | | ID | リソースのSys_id。リソースのタイプに応じて、次のいずれかのテーブルに配置されます。 * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * インターフェイスカード \[cmdb_ci_interface_card\] * IP アドレス \[cmdb_ci_ip_address\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * ストランド \[cmdb_ci_strand\] * トポロジ \[cmdb_ci_topology\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブル。 * 次のいずれかのテーブルを拡張する子テーブル: * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * ストランド \[cmdb_ci_strand\] {#resource-inv-GET-resource__ul_umw_gvn_bcc} {#resource-inv-GET-resource__res-inv-tables} データタイプ：文字列 | | name | リソースの名前。 データタイプ：文字列 | | 注意 | リソースに関するメモのリスト。 データタイプ：オブジェクトのアレイ "note": [ { "text": "String" } ] | | note.text | メモのテキスト。 データタイプ：文字列 | | ロケーション | リソースのネットワークサイト。 このパラメーターは、ネットワークサイト、物理接続、または論理接続リソースではサポートされていません。 データタイプ: オブジェクト "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 場所のタイプ。この値は常に `GeographicAddress` です。 データタイプ：文字列 | | place.href | 場所レコードへの相対リンク。 データタイプ：文字列 | | place.id | 場所レコードのSys_id。 データタイプ：文字列 テーブル:ネットワークサイト \[cmdb_ci_ni_site\] | | 関連パーティー | リソースの連絡先に関する詳細。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] | | relatedParty.@referredType | 関係者のタイプ。\[ タイプ \] フィールドにあります。 データタイプ：文字列 テーブル:グループ \[sys_user_group\] テーブルのタイプフィールド内。 | | relatedParty.href | 関係者レコードへの相対リンク。 データタイプ：文字列 | | relatedParty.id | 関係者レコードのSys_id。 データタイプ：文字列 テーブル： Group \[sys_user_group\] | | relatedParty.role | 関係者のロール。 データタイプ：文字列 テーブル:チーム \[cmdb_rel_team\] テーブルの \[グループタイプ\] フィールド内。 | | リソース特性 | リソースの特性のリスト。次のリソースタイプには、特定のリソース特性が必要です。 * 物理接続および論理接続リソースの場合、 `ポート A` または `ポート Z` の特性が必要です。リソースのライフサイクルステージステータスが \[使用中\] の場合は、 `ポート A` と `ポート Z` の両方が必要です。 * 機器所有者リソースの場合、 `コンテナタイプ` 特性が必要です。 {#resource-inv-GET-resource__ul_wsv_p2m_g5b} データタイプ：オブジェクトのアレイ "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | @type パラメーターで指定されたリソーステーブルのフィールド名。フィールド model_id、name、network_site、operation_notes、operational_status、short_description、start_date、または sys_id などのsys_プリフィックス付きフィールドは使用できません。 データタイプ：文字列 | | resourceCharacteristic.value | 特性の値。 データタイプ：文字列 | | resourceCharacteristic.valueType | 値のタイプ。 有効な値： * ブーリアン * 日時 * float * 整数 * ph_number * 参照 * string {#resource-inv-GET-resource__ul_bk1_rw2_g5b} データタイプ：文字列 | | リソース関係 | 関連リソースのリスト。次のリソースタイプには、特定の関連リソースが必要です。 * インターフェイスカードリソースの場合、\[コンテナタイプ\] が \[スロット\] または \[サブスロット\] である機器所有者リソースとの関係が必要です。 * ネットワークインターフェイスリソースの場合は、機器またはインターフェイスカードリソースとの関係が必要です。 * コンテナタイプがスロットまたはサブスロットである機器所有者リソースの場合、機器またはインターフェイスカードリソースとの関係が必要です。 {#resource-inv-GET-resource__ul_rlv_3dm_g5b} データタイプ：アレイ "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.relationshipType | \[ `this resource descriptor]::[related resource descriptor]` 形式の 2 つのリソース間の関係性のタイプ。たとえば、 `Contains::Contained by は` 、関連リソースがこのリソースの子であることを示します。 記述子の有効な値は、CI 関係性タイプ \[cmdb_rel_type\] テーブルの \[ 親記述子 \] 列と \[子記述子\] 列にあります。 データタイプ：文字列 | | resourceRelationship.resource | 関連リソースの詳細。関連リソースは、次のいずれかのリソースタイプである必要があります。 * ケーブル * 設備 * 機器所有者 * インターフェイスカード * 論理接続 * Network Interface * ネットワークサイト * 物理接続 * ストランド * トポロジ {#resource-inv-GET-resource__ul_wmt_vtx_d5y} データタイプ: オブジェクト "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | 関連リソースのSys_id。関連リソースのタイプに応じて、次のいずれかのテーブルに配置されています。 * インターフェイスカード \[cmdb_ci_interface_card\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器所有者を拡張するテーブル \[cmdb_ci_equipment_holder\] {#resource-inv-GET-resource__ul_vr1_4gf_g5b} データタイプ：文字列 | | resourceRelationship.resource.href | 関連リソースレコードへの相対リンク。 データタイプ：文字列 | | リソース仕様 | リソース仕様。 データタイプ: オブジェクト "resourceSpecification": { "id": "String" } | | resourceSpecification.id | リソースに関連付けられたモデルのSys_id。モデルのタイプに応じて、次のいずれかのテーブルにあります。 * ケーブルモデル \[sn_ent_cable_model\] * 機器所有者モデル \[sn_ent_nw_holder_model\] * 設備モデル \[sn_ent_nw_equipment_model\] * インターフェイスカードモデル \[sn_ent_nw_interface_model\] * 論理接続モデル \[sn_ent_logical_nw_connection_model\] * ネットワークインターフェイスモデル \[sn_ent_nw_interface_model\] * 物理接続モデル \[sn_ent_physical_nw_connection_model\] * ストランドモデル \[sn_ent_strand_model\] * トポロジモデル \[sn_ent_network_topology_model\] {#resource-inv-GET-resource__d3457e757} データタイプ：文字列 | | 開始運用日 | リソースが最初に運用を開始した日時。 データタイプ：文字列 | [ ] {#resource-inv-GET-resource__table_okb_1rw_f5b} ### cURL 要求 この例では、最初の 5 つのネットワークサイトリソースレコードの name、 id、および href フィールドを取得します。 curl "https://instance.service-now.com/api/sn_ni_core/resource?@type=cmdb_ci_ni_site&fields=name%2Cid%2Chref&limit=5" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' 応答本文。 [ { "name": "DALLAS TX CO/HUB", "id": "c23683c54051c910f8772175cacd725c", "href": "/api/sn_ni_core/resource/c23683c54051c910f8772175cacd725c" }, { "name": "PFP LOC F-800", "id": "0ac19bc54051c910f8772175cacd724b", "href": "/api/sn_ni_core/resource/0ac19bc54051c910f8772175cacd724b" }, { "name": "FIBER SERVICE TERMINAL 003", "id": "d0541fcd4051c910f8772175cacd72c8", "href": "/api/sn_ni_core/resource/d0541fcd4051c910f8772175cacd72c8" }, { "name": "270 RUMWOOD MAIN", "id": "e6f6df8d4051c910f8772175cacd72b2", "href": "/api/sn_ni_core/resource/e6f6df8d4051c910f8772175cacd72b2" }, { "name": "3620 CHESTER ROMI48073", "id": "917dd8f6870e851079c40f2d0ebb353d", "href": "/api/sn_ni_core/resource/917dd8f6870e851079c40f2d0ebb353d" } ] ## リソースインベントリオープン API - GET /sn_ni_core/resource/{id} {#ariaid-title4} 指定されたリソースレコードを取得します。 ### URL 形式 デフォルト URL: /api/sn_ni_core/resource/{id} ### サポートされている要求パラメーター {#resource-inv-GET-resource-id__table_tjw_q3s_g5b__entry__2} | 名前 | 説明 | |-|-| | ID | リソースのSys_id。リソースのタイプに応じて、次のいずれかのテーブルに配置されます。 * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * インターフェイスカード \[cmdb_ci_interface_card\] * IP アドレス \[cmdb_ci_ip_address\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * ストランド \[cmdb_ci_strand\] * トポロジ \[cmdb_ci_topology\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブル。 * 次のいずれかのテーブルを拡張する子テーブル: * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * ストランド \[cmdb_ci_strand\] {#resource-inv-GET-resource-id__ul_umw_gvn_bcc} {#resource-inv-GET-resource-id__res-inv-tables} データタイプ：文字列 | [表 : 13. パスパラメーター] {#resource-inv-GET-resource-id__table_tjw_q3s_g5b} {#resource-inv-GET-resource-id__entry__6} | 名前 | 説明 | |-|-| | フィールド | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効な値： * description * href * ID * name * 注意 * ロケーション * 関連パーティー * リソース特性 * リソース関係 * リソース仕様 * 開始運用日 {#resource-inv-GET-resource-id__ul_pzn_4gz_d5b} データタイプ：文字列 デフォルト：すべてのフィールドを返します。 | [表 : 14. クエリパラメーター] {#resource-inv-GET-resource-id__table_yh2_zhs_g5b__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 15. 要求本文パラメーター (JSON)] {#resource-inv-GET-resource-id__table_yh2_zhs_g5b} ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#resource-inv-GET-resource-id__table_e4k_vhs_g5b__entry__2}{#resource-inv-GET-resource-id__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 16. 要求ヘッダー] {#resource-inv-GET-resource-id__table_e4k_vhs_g5b} {#resource-inv-GET-resource-id__table_gfy_npw_f5b__entry__2} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 17. 応答ヘッダー] {#resource-inv-GET-resource-id__table_gfy_npw_f5b} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#resource-inv-GET-resource-id__table_yn5_ths_g5b__entry__2}{#resource-inv-GET-resource-id__entry-200-status-code}{#resource-inv-GET-resource-id__entry-400-status-code}{#resource-inv-GET-resource-id__entry-401-status-code}{#resource-inv-GET-resource-id__entry-404-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | [表 : 18. ステータスコード] {#resource-inv-GET-resource-id__table_yn5_ths_g5b} ### 応答本文のパラメーター (JSON) {#resource-inv-GET-resource-id__section_nkb_1rw_f5b} {#resource-inv-GET-resource-id__table_okb_1rw_f5b__entry__2}{#resource-inv-GET-resource-id__type-descr-entry}{#resource-inv-GET-resource-id__related-party-parm} | 名前 | 説明 | |-|-| | @type | リソースのタイプ。 有効な値： * `cmdb_ci_cable` (ケーブル) * `cmdb_ci_interface_card` (インターフェイスカード) * `cmdb_ci_ip_address` (IP アドレス) * `cmdb_ci_ni_logical_path` (論理接続) * `cmdb_ci_ni_interface` (ネットワークインターフェイス) * `cmdb_ci_ni_site` (ネットワークサイト) * `cmdb_ci_ni_physical_link` (物理接続) * `cmdb_ci_strand` (ストランド) * `cmdb_ci_topology` (トポロジ) * sn_ni_core.equipment_tables sys_propertyで指定されたテーブルの名前、または指定されたテーブルを拡張するテーブルの名前。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブルの名前。 {#resource-inv-GET-resource-id__ul_wmt_vfz_d5b} データタイプ：文字列 | | description | リソースの説明。 データタイプ：文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 | | ID | リソースのSys_id。リソースのタイプに応じて、次のいずれかのテーブルに配置されます。 * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * インターフェイスカード \[cmdb_ci_interface_card\] * IP アドレス \[cmdb_ci_ip_address\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * ストランド \[cmdb_ci_strand\] * トポロジ \[cmdb_ci_topology\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブル。 * 次のいずれかのテーブルを拡張する子テーブル: * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * ストランド \[cmdb_ci_strand\] {#resource-inv-GET-resource-id__d3457e278} {#resource-inv-GET-resource-id__d3457e234} データタイプ：文字列 | | name | リソースの名前。 データタイプ：文字列 | | 注意 | リソースに関するメモのリスト。 データタイプ：オブジェクトのアレイ "note": [ { "text": "String" } ] | | note.text | メモのテキスト。 データタイプ：文字列 | | ロケーション | リソースのネットワークサイト。 このパラメーターは、ネットワークサイト、物理接続、または論理接続リソースではサポートされていません。 データタイプ: オブジェクト "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 場所のタイプ。この値は常に `GeographicAddress` です。 データタイプ：文字列 | | place.href | 場所レコードへの相対リンク。 データタイプ：文字列 | | place.id | 場所レコードのSys_id。 データタイプ：文字列 テーブル:ネットワークサイト \[cmdb_ci_ni_site\] | | 関連パーティー | リソースの連絡先に関する詳細。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] | | relatedParty.@referredType | 関係者のタイプ。\[ タイプ \] フィールドにあります。 データタイプ：文字列 テーブル:グループ \[sys_user_group\] テーブルのタイプフィールド内。 | | relatedParty.href | 関係者レコードへの相対リンク。 データタイプ：文字列 | | relatedParty.id | 関係者レコードのSys_id。 データタイプ：文字列 テーブル： Group \[sys_user_group\] | | リソース特性 | リソースの特性のリスト。次のリソースタイプには、特定のリソース特性が必要です。 * 物理接続および論理接続リソースの場合、 `ポート A` または `ポート Z` の特性が必要です。リソースのライフサイクルステージステータスが \[使用中\] の場合は、 `ポート A` と `ポート Z` の両方が必要です。 * 機器所有者リソースの場合、 `コンテナタイプ` 特性が必要です。 {#resource-inv-GET-resource-id__ul_wsv_p2m_g5b} データタイプ：オブジェクトのアレイ "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | @type パラメーターで指定されたリソーステーブルのフィールド名。フィールド model_id、name、network_site、operation_notes、operational_status、short_description、start_date、または sys_id などのsys_プリフィックス付きフィールドは使用できません。 データタイプ：文字列 | | resourceCharacteristic.value | 特性の値。 データタイプ：文字列 | | resourceCharacteristic.valueType | 値のタイプ。 有効な値： * ブーリアン * 日時 * float * 整数 * ph_number * 参照 * string {#resource-inv-GET-resource-id__ul_bk1_rw2_g5b} データタイプ：文字列 | | リソース関係 | 関連リソースのリスト。次のリソースタイプには、特定の関連リソースが必要です。 * インターフェイスカードリソースの場合、\[コンテナタイプ\] が \[スロット\] または \[サブスロット\] である機器所有者リソースとの関係が必要です。 * ネットワークインターフェイスリソースの場合は、機器またはインターフェイスカードリソースとの関係が必要です。 * コンテナタイプがスロットまたはサブスロットである機器所有者リソースの場合、機器またはインターフェイスカードリソースとの関係が必要です。 {#resource-inv-GET-resource-id__ul_rlv_3dm_g5b} データタイプ：アレイ "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.relationshipType | \[ `this resource descriptor]::[related resource descriptor]` 形式の 2 つのリソース間の関係性のタイプ。たとえば、 `Contains::Contained by は` 、関連リソースがこのリソースの子であることを示します。 記述子の有効な値は、CI 関係性タイプ \[cmdb_rel_type\] テーブルの \[ 親記述子 \] 列と \[子記述子\] 列にあります。 データタイプ：文字列 | | resourceRelationship.resource | 関連リソースの詳細。関連リソースは、次のいずれかのリソースタイプである必要があります。 * ケーブル * 設備 * 機器所有者 * インターフェイスカード * 論理接続 * Network Interface * ネットワークサイト * 物理接続 * ストランド * トポロジ {#resource-inv-GET-resource-id__ul_wmt_vtx_d5y} データタイプ: オブジェクト "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | 関連リソースのSys_id。関連リソースのタイプに応じて、次のいずれかのテーブルに配置されています。 * インターフェイスカード \[cmdb_ci_interface_card\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器所有者を拡張するテーブル \[cmdb_ci_equipment_holder\] {#resource-inv-GET-resource-id__ul_vr1_4gf_g5b} データタイプ：文字列 | | resourceRelationship.resource.href | 関連リソースレコードへの相対リンク。 データタイプ：文字列 | | リソース仕様 | リソース仕様。 データタイプ: オブジェクト "resourceSpecification": { "id": "String" } | | resourceSpecification.id | リソースに関連付けられたモデルのSys_id。モデルのタイプに応じて、次のいずれかのテーブルにあります。 * ケーブルモデル \[sn_ent_cable_model\] * 機器所有者モデル \[sn_ent_nw_holder_model\] * 設備モデル \[sn_ent_nw_equipment_model\] * インターフェイスカードモデル \[sn_ent_nw_interface_model\] * 論理接続モデル \[sn_ent_logical_nw_connection_model\] * ネットワークインターフェイスモデル \[sn_ent_nw_interface_model\] * 物理接続モデル \[sn_ent_physical_nw_connection_model\] * ストランドモデル \[sn_ent_strand_model\] * トポロジモデル \[sn_ent_network_topology_model\] {#resource-inv-GET-resource-id__ul_a3t_1lz_d5b} データタイプ：文字列 | | 開始運用日 | リソースが最初に運用を開始した日時。 データタイプ：文字列 | [ ] {#resource-inv-GET-resource-id__table_okb_1rw_f5b} ### cURL 要求 この例では、指定されたリソースレコードを取得します。 curl "https://instance.service-now.com/api/sn_ni_core/resource/915da8e140ddc910f8772175cacd72de" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' 応答本文。 { "href": "/api/sn_ni_core/resource/915da8e140ddc910f8772175cacd72de", "id": "915da8e140ddc910f8772175cacd72de", "name": "DLLSTXMR/ESS7450/IOM-01/MDA-01/NI-01", "place": { "id": "c23683c54051c910f8772175cacd725c", "href": "/api/now/table/cmdb_ci_ni_site/c23683c54051c910f8772175cacd725c", "@referredType": "GeographicAddress" }, "resourceCharacteristic": [ { "name": "attested", "valueType": "boolean", "value": "false" }, { "name": "availability", "valueType": "string", "value": "used" }, { "name": "cabled", "valueType": "boolean", "value": "false" }, { "name": "can_print", "valueType": "boolean", "value": "false" }, { "name": "connector_type", "valueType": "string", "value": "sc" }, { "name": "cost_cc", "valueType": "string", "value": "USD" }, { "name": "equipment_clli", "valueType": "string", "value": "DLLSTXESS01" }, { "name": "fault_count", "valueType": "integer", "value": "0" }, { "name": "install_status", "valueType": "integer", "value": "1" }, { "name": "life_cycle_stage", "valueType": "reference", "value": "Operational" }, { "name": "life_cycle_stage_status", "valueType": "reference", "value": "In Use" }, { "name": "manufacturer", "valueType": "reference", "value": "a2f6a4914055c910f8772175cacd723a" }, { "name": "monitor", "valueType": "boolean", "value": "false" }, { "name": "network_domain", "valueType": "string", "value": "core" }, { "name": "ni_type", "valueType": "reference", "value": "646cf25fe42e0510f877e70ec9bcaca8" }, { "name": "port_bandwidth", "valueType": "reference", "value": "ff39ae92eb900110700ca73bc152286d" }, { "name": "replaceable", "valueType": "boolean", "value": "false" }, { "name": "skip_sync", "valueType": "boolean", "value": "false" }, { "name": "telco_equipment", "valueType": "reference", "value": "583e7b95405dc910f8772175cacd7292" }, { "name": "unverified", "valueType": "boolean", "value": "false" }, { "name": "virtual", "valueType": "boolean", "value": "false" } ], "resourceRelationship": [ { "relationshipType": "Contained by::Contains", "resource": { "id": "81baac6140ddc910f8772175cacd728e", "href": "/api/sn_ni_core/resource/81baac6140ddc910f8772175cacd728e" } }, { "relationshipType": "Contained by::Contains", "resource": { "id": "bf624bc640194d10f8772175cacd7225", "href": "/api/sn_ni_core/resource/bf624bc640194d10f8772175cacd7225" } } ], "resourceSpecification": { "id": "980416b0874e8110d28eb259dabb356b", "href": "/api/now/table/sn_ni_core_network_inventory_product_model/980416b0874e8110d28eb259dabb356b", "@referredType": "NetworkInterfaceModel" }, "@type": "cmdb_ci_ni_interface" } ## リソースインベントリオープン API - PATCH /sn_ni_core/resource/{id} {#ariaid-title5} 指定されたリソースレコードを更新します。 ### URL 形式 デフォルト URL: /api/sn_ni_core/resource/{id} ### サポートされている要求パラメーター {#resource-inv-PATCH-resource-id__entry__2} | 名前 | 説明 | |-|-| | ID | リソースのSys_id。リソースのタイプに応じて、次のいずれかのテーブルに配置されます。 * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * インターフェイスカード \[cmdb_ci_interface_card\] * IP アドレス \[cmdb_ci_ip_address\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * ストランド \[cmdb_ci_strand\] * トポロジ \[cmdb_ci_topology\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブル。 * 次のいずれかのテーブルを拡張する子テーブル: * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * ストランド \[cmdb_ci_strand\] {#resource-inv-PATCH-resource-id__ul_umw_gvn_bcc} {#resource-inv-PATCH-resource-id__res-inv-tables} データタイプ：文字列 | [表 : 19. パスパラメーター] {#resource-inv-PATCH-resource-id__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 20. クエリパラメーター] {#resource-inv-PATCH-resource-id__entry__10}{#resource-inv-PATCH-resource-id__type-descr-entry}{#resource-inv-PATCH-resource-id__note-text-entry}{#resource-inv-PATCH-resource-id__place-id-entry}{#resource-inv-PATCH-resource-id__rel-party-id-parm}{#resource-inv-PATCH-resource-id__res-char-name-parm}{#resource-inv-PATCH-resource-id__res-char-value-parm}{#resource-inv-PATCH-resource-id__rel-type-parm}{#resource-inv-PATCH-resource-id__rel-resource-parm}{#resource-inv-PATCH-resource-id__rel-resource-id-parm}{#resource-inv-PATCH-resource-id__res-spec-id-parm} | 名前 | 説明 | |-|-| | @type | リソースのタイプ。 有効な値： * `cmdb_ci_cable` (ケーブル) * `cmdb_ci_interface_card` (インターフェイスカード) * `cmdb_ci_ip_address` (IP アドレス) * `cmdb_ci_ni_logical_path` (論理接続) * `cmdb_ci_ni_interface` (ネットワークインターフェイス) * `cmdb_ci_ni_site` (ネットワークサイト) * `cmdb_ci_ni_physical_link` (物理接続) * `cmdb_ci_strand` (ストランド) * `cmdb_ci_topology` (トポロジ) * sn_ni_core.equipment_tables sys_propertyで指定されたテーブルの名前、または指定されたテーブルを拡張するテーブルの名前。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブルの名前。 {#resource-inv-PATCH-resource-id__ul_wmt_vfz_d5b} データタイプ：文字列 | | description | リソースの説明。 データタイプ：文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 | | name | リソースの名前。 データタイプ：文字列 | | 注意 | リソースに関するメモのリスト。 データタイプ：オブジェクトのアレイ "note": [ { "text": "String" } ] | | note.text | noteパラメーターを使用する場合は必須です。 メモのテキスト。 データタイプ：文字列 | | ロケーション | リソースのネットワークサイト。 このパラメーターは、ネットワークサイト、物理接続、または論理接続リソースではサポートされていません。 データタイプ: オブジェクト "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 場所のタイプ。この値は常に `GeographicAddress` です。 データタイプ：文字列 | | place.href | 場所レコードへの相対リンク。 データタイプ：文字列 | | place.id | placeパラメーターを使用する場合は必須です。 場所レコードのSys_id。 データタイプ：文字列 テーブル:ネットワークサイト \[cmdb_ci_ni_site\] | | 関連パーティー | リソースの連絡先に関する詳細。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] 注: リソースからの relatedParty レコードの削除は、このエンドポイントではサポートされていません。レコードは、Teams \[cmdb_rel_team\] テーブルから手動で削除できます。 | | relatedParty.@referredType | 関係者のタイプ。\[ タイプ \] フィールドにあります。 データタイプ：文字列 テーブル:グループ \[sys_user_group\] テーブルのタイプフィールド内。 | | relatedParty.href | 関係者レコードへの相対リンク。 データタイプ：文字列 | | relatedParty.id | relatedPartyパラメーターを使用する場合は必須です。 関係者レコードのSys_id。 データタイプ：文字列 テーブル： Group \[sys_user_group\] | | relatedParty.role | 関係者のロール。 データタイプ：文字列 テーブル:チーム \[cmdb_rel_team\] テーブルの \[グループタイプ\] フィールド内。 | | リソース特性 | リソースの特性のリスト。次のリソースタイプには、特定のリソース特性が必要です。 * 物理接続および論理接続リソースの場合、 `ポート A` または `ポート Z` の特性が必要です。リソースのライフサイクルステージステータスが \[使用中\] の場合は、 `ポート A` と `ポート Z` の両方が必要です。 * 機器所有者リソースの場合、 `コンテナタイプ` 特性が必要です。 {#resource-inv-PATCH-resource-id__ul_wsv_p2m_g5b} データタイプ：オブジェクトのアレイ "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | resourceCharacteristicパラメーターを使用する場合は必須です。 @type パラメーターで指定されたリソーステーブルのフィールド名。フィールド model_id、name、network_site、operation_notes、operational_status、short_description、start_date、または sys_id などのsys_プリフィックス付きフィールドは使用できません。 データタイプ：文字列 | | resourceCharacteristic.value | resourceCharacteristicパラメーターを使用する場合は必須です。 特性の値。 データタイプ：文字列 | | resourceCharacteristic.valueType | 値のタイプ。 有効な値： * ブーリアン * 日時 * float * 整数 * ph_number * 参照 * string {#resource-inv-PATCH-resource-id__ul_bk1_rw2_g5b} データタイプ：文字列 | | リソース関係 | 関連リソースのリスト。次のリソースタイプには、特定の関連リソースが必要です。 * インターフェイスカードリソースの場合、\[コンテナタイプ\] が \[スロット\] または \[サブスロット\] である機器所有者リソースとの関係が必要です。 * ネットワークインターフェイスリソースの場合は、機器またはインターフェイスカードリソースとの関係が必要です。 * コンテナタイプがスロットまたはサブスロットである機器所有者リソースの場合、機器またはインターフェイスカードリソースとの関係が必要です。 {#resource-inv-PATCH-resource-id__ul_rlv_3dm_g5b} データタイプ：アレイ "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.relationshipType | resourceRelationshipパラメーターを使用する場合は必須です。 \[ `this resource descriptor]::[related resource descriptor]` 形式の 2 つのリソース間の関係性のタイプ。たとえば、 `Contains::Contained by は` 、関連リソースがこのリソースの子であることを示します。 記述子の有効な値は、CI 関係性タイプ \[cmdb_rel_type\] テーブルの \[ 親記述子 \] 列と \[子記述子\] 列にあります。 データタイプ：文字列 | | resourceRelationship.resource | resourceRelationshipパラメーターを使用する場合は必須です。 関連リソースの詳細。関連リソースは、次のいずれかのリソースタイプである必要があります。 * ケーブル * 設備 * 機器所有者 * インターフェイスカード * 論理接続 * Network Interface * ネットワークサイト * 物理接続 * ストランド * トポロジ {#resource-inv-PATCH-resource-id__ul_wmt_vtx_d5y} データタイプ: オブジェクト "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | resourceRelationshipパラメーターを使用する場合は必須です。 関連リソースのSys_id。関連リソースのタイプに応じて、次のいずれかのテーブルに配置されています。 * インターフェイスカード \[cmdb_ci_interface_card\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器所有者を拡張するテーブル \[cmdb_ci_equipment_holder\] {#resource-inv-PATCH-resource-id__ul_vr1_4gf_g5b} データタイプ：文字列 | | resourceRelationship.resource.href | 関連リソースレコードへの相対リンク。 データタイプ：文字列 | | リソース仕様 | リソース仕様。 データタイプ: オブジェクト "resourceSpecification": { "id": "String" } | | resourceSpecification.id | resourceSpecificationパラメーターを使用する場合は必須です。 リソースに関連付けられたモデルのSys_id。モデルのタイプに応じて、次のいずれかのテーブルにあります。 * ケーブルモデル \[sn_ent_cable_model\] * 機器所有者モデル \[sn_ent_nw_holder_model\] * 設備モデル \[sn_ent_nw_equipment_model\] * インターフェイスカードモデル \[sn_ent_nw_interface_model\] * 論理接続モデル \[sn_ent_logical_nw_connection_model\] * ネットワークインターフェイスモデル \[sn_ent_nw_interface_model\] * 物理接続モデル \[sn_ent_physical_nw_connection_model\] * ストランドモデル \[sn_ent_strand_model\] * トポロジモデル \[sn_ent_network_topology_model\] {#resource-inv-PATCH-resource-id__ul_a3t_1lz_d5b} データタイプ：文字列 | | 開始運用日 | リソースが最初に運用を開始した日時。 データタイプ：文字列 | [表 : 21. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#resource-inv-PATCH-resource-id__entry__66}{#resource-inv-PATCH-resource-id__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/merge-patch+json のみをサポートします。 | [表 : 22. 要求ヘッダー] {#resource-inv-PATCH-resource-id__entry__72} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 23. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#resource-inv-PATCH-resource-id__entry__76}{#resource-inv-PATCH-resource-id__entry-200-status-code}{#resource-inv-PATCH-resource-id__entry-400-status-code}{#resource-inv-PATCH-resource-id__entry-401-status-code}{#resource-inv-PATCH-resource-id__entry-404-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 415 | 要求本文がサポートされていない形式であるか、Content-Type 要求ヘッダーが正しく設定されていません。 | [表 : 24. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#resource-inv-PATCH-resource-id__entry__88}{#resource-inv-PATCH-resource-id__d3457e141}{#resource-inv-PATCH-resource-id__related-party-parm} | 名前 | 説明 | |-|-| | @type | リソースのタイプ。 有効な値： * `cmdb_ci_cable` (ケーブル) * `cmdb_ci_interface_card` (インターフェイスカード) * `cmdb_ci_ip_address` (IP アドレス) * `cmdb_ci_ni_logical_path` (論理接続) * `cmdb_ci_ni_interface` (ネットワークインターフェイス) * `cmdb_ci_ni_site` (ネットワークサイト) * `cmdb_ci_ni_physical_link` (物理接続) * `cmdb_ci_strand` (ストランド) * `cmdb_ci_topology` (トポロジ) * sn_ni_core.equipment_tables sys_propertyで指定されたテーブルの名前、または指定されたテーブルを拡張するテーブルの名前。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブルの名前。 {#resource-inv-PATCH-resource-id__d3457e145} データタイプ：文字列 | | description | リソースの説明。 データタイプ：文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 | | ID | リソースのSys_id。リソースのタイプに応じて、次のいずれかのテーブルに配置されます。 * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * インターフェイスカード \[cmdb_ci_interface_card\] * IP アドレス \[cmdb_ci_ip_address\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * ストランド \[cmdb_ci_strand\] * トポロジ \[cmdb_ci_topology\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブル。 * 次のいずれかのテーブルを拡張する子テーブル: * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * ストランド \[cmdb_ci_strand\] {#resource-inv-PATCH-resource-id__d3457e278} {#resource-inv-PATCH-resource-id__d3457e234} データタイプ：文字列 | | name | リソースの名前。 データタイプ：文字列 | | 注意 | リソースに関するメモのリスト。 データタイプ：オブジェクトのアレイ "note": [ { "text": "String" } ] | | note.text | メモのテキスト。 データタイプ：文字列 | | ロケーション | リソースのネットワークサイト。 このパラメーターは、ネットワークサイト、物理接続、または論理接続リソースではサポートされていません。 データタイプ: オブジェクト "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 場所のタイプ。この値は常に `GeographicAddress` です。 データタイプ：文字列 | | place.href | 場所レコードへの相対リンク。 データタイプ：文字列 | | place.id | 場所レコードのSys_id。 データタイプ：文字列 テーブル:ネットワークサイト \[cmdb_ci_ni_site\] | | 関連パーティー | リソースの連絡先に関する詳細。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] | | relatedParty.@referredType | 関係者のタイプ。\[ タイプ \] フィールドにあります。 データタイプ：文字列 テーブル:グループ \[sys_user_group\] テーブルのタイプフィールド内。 | | relatedParty.href | 関係者レコードへの相対リンク。 データタイプ：文字列 | | relatedParty.id | 関係者レコードのSys_id。 データタイプ：文字列 テーブル： Group \[sys_user_group\] | | relatedParty.role | 関係者のロール。 データタイプ：文字列 テーブル:チーム \[cmdb_rel_team\] テーブルの \[グループタイプ\] フィールド内。 | | リソース特性 | リソースの特性のリスト。次のリソースタイプには、特定のリソース特性が必要です。 * 物理接続および論理接続リソースの場合、 `ポート A` または `ポート Z` の特性が必要です。リソースのライフサイクルステージステータスが \[使用中\] の場合は、 `ポート A` と `ポート Z` の両方が必要です。 * 機器所有者リソースの場合、 `コンテナタイプ` 特性が必要です。 {#resource-inv-PATCH-resource-id__d3457e477} データタイプ：オブジェクトのアレイ "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | @type パラメーターで指定されたリソーステーブルのフィールド名。フィールド model_id、name、network_site、operation_notes、operational_status、short_description、start_date、または sys_id などのsys_プリフィックス付きフィールドは使用できません。 データタイプ：文字列 | | resourceCharacteristic.value | 特性の値。 データタイプ：文字列 | | resourceCharacteristic.valueType | 値のタイプ。 有効な値： * ブーリアン * 日時 * float * 整数 * ph_number * 参照 * string {#resource-inv-PATCH-resource-id__d3457e548} データタイプ：文字列 | | リソース関係 | 関連リソースのリスト。次のリソースタイプには、特定の関連リソースが必要です。 * インターフェイスカードリソースの場合、\[コンテナタイプ\] が \[スロット\] または \[サブスロット\] である機器所有者リソースとの関係が必要です。 * ネットワークインターフェイスリソースの場合は、機器またはインターフェイスカードリソースとの関係が必要です。 * コンテナタイプがスロットまたはサブスロットである機器所有者リソースの場合、機器またはインターフェイスカードリソースとの関係が必要です。 {#resource-inv-PATCH-resource-id__d3457e583} データタイプ：アレイ "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.relationshipType | \[ `this resource descriptor]::[related resource descriptor]` 形式の 2 つのリソース間の関係性のタイプ。たとえば、 `Contains::Contained by は` 、関連リソースがこのリソースの子であることを示します。 記述子の有効な値は、CI 関係性タイプ \[cmdb_rel_type\] テーブルの \[ 親記述子 \] 列と \[子記述子\] 列にあります。 データタイプ：文字列 | | resourceRelationship.resource | 関連リソースの詳細。関連リソースは、次のいずれかのリソースタイプである必要があります。 * ケーブル * 設備 * 機器所有者 * インターフェイスカード * 論理接続 * Network Interface * ネットワークサイト * 物理接続 * ストランド * トポロジ {#resource-inv-PATCH-resource-id__d3457e640} データタイプ: オブジェクト "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | 関連リソースのSys_id。関連リソースのタイプに応じて、次のいずれかのテーブルに配置されています。 * インターフェイスカード \[cmdb_ci_interface_card\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器所有者を拡張するテーブル \[cmdb_ci_equipment_holder\] {#resource-inv-PATCH-resource-id__d3457e692} データタイプ：文字列 | | resourceRelationship.resource.href | 関連リソースレコードへの相対リンク。 データタイプ：文字列 | | リソース仕様 | リソース仕様。 データタイプ: オブジェクト "resourceSpecification": { "id": "String" } | | resourceSpecification.id | リソースに関連付けられたモデルのSys_id。モデルのタイプに応じて、次のいずれかのテーブルにあります。 * ケーブルモデル \[sn_ent_cable_model\] * 機器所有者モデル \[sn_ent_nw_holder_model\] * 設備モデル \[sn_ent_nw_equipment_model\] * インターフェイスカードモデル \[sn_ent_nw_interface_model\] * 論理接続モデル \[sn_ent_logical_nw_connection_model\] * ネットワークインターフェイスモデル \[sn_ent_nw_interface_model\] * 物理接続モデル \[sn_ent_physical_nw_connection_model\] * ストランドモデル \[sn_ent_strand_model\] * トポロジモデル \[sn_ent_network_topology_model\] {#resource-inv-PATCH-resource-id__d3457e757} データタイプ：文字列 | | 開始運用日 | リソースが最初に運用を開始した日時。 データタイプ：文字列 | [ ] ### cURL 要求 この例では、リソースの名前を更新します。 curl "http://instance.servicenow.com/api/sn_ni_core/resource/583e7b95405dc910f8772175cacd7292" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type: application/merge-patch+json" \ --user 'username':'password' \ --data '{"name": "new name"}' 応答本文。 { "href": "/api/sn_ni_core/resource/583e7b95405dc910f8772175cacd7292", "id": "583e7b95405dc910f8772175cacd7292", "name": "new name", "note": [ { "text": "TECHNICIAN SCHECULED TO BE ONSITE THE WEEK OF APRIL 4, 2022." } ], "place": { "id": "c23683c54051c910f8772175cacd725c", "href": "/api/now/table/cmdb_ci_ni_site/c23683c54051c910f8772175cacd725c", "@referredType": "GeographicAddress" }, "resourceCharacteristic": [ { "name": "alarmable", "valueType": "boolean", "value": "true" }, { "name": "attested", "valueType": "boolean", "value": "false" }, { "name": "can_hub", "valueType": "boolean", "value": "false" }, { "name": "can_partitionvlans", "valueType": "boolean", "value": "false" }, { "name": "can_print", "valueType": "boolean", "value": "false" }, { "name": "can_route", "valueType": "boolean", "value": "false" }, { "name": "can_switch", "valueType": "boolean", "value": "false" }, { "name": "comments", "valueType": "string", "value": "ETHERNET SWITCH" }, { "name": "cost_cc", "valueType": "string", "value": "USD" }, { "name": "cpu_count", "valueType": "integer", "value": "1" }, { "name": "equipment_clli", "valueType": "string", "value": "DLLSTXESS01" }, { "name": "fault_count", "valueType": "integer", "value": "0" }, { "name": "firmware_manufacturer", "valueType": "reference", "value": "0c441abbc6112275000025157c651c89" }, { "name": "firmware_version", "valueType": "string", "value": "A09DX887" }, { "name": "hardware_status", "valueType": "string", "value": "installed" }, { "name": "install_status", "valueType": "integer", "value": "1" }, { "name": "internet_facing", "valueType": "boolean", "value": "true" }, { "name": "inventory_category", "valueType": "string", "value": "equipment" }, { "name": "last_service_date", "valueType": "datetime", "value": "2022-02-18T16:36:54.000Z" }, { "name": "life_cycle_stage", "valueType": "reference", "value": "Deploy" }, { "name": "life_cycle_stage_status", "valueType": "reference", "value": "Reserved" }, { "name": "managed_by", "valueType": "reference", "value": "46c9e158a9fe198101d44d0d22cb640d" }, { "name": "manufacturer", "valueType": "reference", "value": "b7e831bdc0a80169015ae101f3c4d6cd" }, { "name": "model_number", "valueType": "string", "value": "7450ESS-1" }, { "name": "monitor", "valueType": "boolean", "value": "false" }, { "name": "network_domain", "valueType": "string", "value": "core" }, { "name": "ni_function", "valueType": "reference", "value": "2d22153940990d10f8772175cacd728b" }, { "name": "ni_role", "valueType": "reference", "value": "c68e3f15405dc910f8772175cacd72f1" }, { "name": "ni_type", "valueType": "reference", "value": "3772e8d54015c910f8772175cacd721c" }, { "name": "ram", "valueType": "integer", "value": "3000" }, { "name": "replaceable", "valueType": "boolean", "value": "true" }, { "name": "serial_number", "valueType": "string", "value": "7894564568225" }, { "name": "skip_sync", "valueType": "boolean", "value": "false" }, { "name": "spare", "valueType": "boolean", "value": "true" }, { "name": "template_id", "valueType": "reference", "value": "49433535e5d28110f877657a33339131" }, { "name": "unit_position", "valueType": "integer", "value": "2" }, { "name": "unverified", "valueType": "boolean", "value": "false" } ], "resourceRelationship": [ { "relationshipType": "Contains::Contained by", "resource": { "id": "f5d1c429405dc910f8772175cacd723f", "href": "/api/sn_ni_core/resource/f5d1c429405dc910f8772175cacd723f" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "d6e100e5405dc910f8772175cacd72e9", "href": "/api/sn_ni_core/resource/d6e100e5405dc910f8772175cacd72e9" } }, { "relationshipType": "Contained by::Contains", "resource": { "id": "5b10e8154015c910f8772175cacd724d", "href": "/api/sn_ni_core/resource/5b10e8154015c910f8772175cacd724d" } } ], "resourceSpecification": { "id": "0ae34df1e5528110f877657a33339119", "href": "/api/now/table/cmdb_model/0ae34df1e5528110f877657a33339119", "@referredType": "EquipmentModel" }, "@type": "cmdb_ci_ni_telco_equipment" } ## リソースインベントリオープン API - POST /sn_ni_core/resource {#ariaid-title6} リソースレコードを作成します。 ### URL 形式 デフォルト URL: /api/sn_ni_core/resource ### サポートされている要求パラメーター {#resource-inv-POST-resource__table_vzn_xns_g5b__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 25. パスパラメーター] {#resource-inv-POST-resource__table_vzn_xns_g5b} {#resource-inv-POST-resource__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 26. クエリパラメーター] {#resource-inv-POST-resource__entry__10}{#resource-inv-POST-resource__type-descr-entry}{#resource-inv-POST-resource__name-entry}{#resource-inv-POST-resource__note-text-entry}{#resource-inv-POST-resource__place-entry}{#resource-inv-POST-resource__place-id-entry}{#resource-inv-POST-resource__related-party-parm}{#resource-inv-POST-resource__rel-party-id-parm}{#resource-inv-POST-resource__res-char-name-parm}{#resource-inv-POST-resource__res-char-value-parm}{#resource-inv-POST-resource__rel-type-parm}{#resource-inv-POST-resource__rel-resource-parm}{#resource-inv-POST-resource__rel-resource-id-parm}{#resource-inv-POST-resource__res-spec-id-parm} | 名前 | 説明 | |-|-| | @type | リソースのタイプ。 有効な値： * `cmdb_ci_cable` (ケーブル) * `cmdb_ci_interface_card` (インターフェイスカード) * `cmdb_ci_ip_address` (IP アドレス) * `cmdb_ci_ni_logical_path` (論理接続) * `cmdb_ci_ni_interface` (ネットワークインターフェイス) * `cmdb_ci_ni_site` (ネットワークサイト) * `cmdb_ci_ni_physical_link` (物理接続) * `cmdb_ci_strand` (ストランド) * `cmdb_ci_topology` (トポロジ) * sn_ni_core.equipment_tables sys_propertyで指定されたテーブルの名前、または指定されたテーブルを拡張するテーブルの名前。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブルの名前。 {#resource-inv-POST-resource__ul_wmt_vfz_d5b} データタイプ：文字列 | | description | リソースの説明。 データタイプ：文字列 | | name | 必須です。 リソースの名前。 データタイプ：文字列 | | 注意 | リソースに関するメモのリスト。 データタイプ：オブジェクトのアレイ "note": [ { "text": "String" } ] | | note.text | noteパラメーターを使用する場合は必須です。 メモのテキスト。 データタイプ：文字列 | | ロケーション | コンテナタイプがケージ、ベイ、キャビネット、ラック、ラインアップ、またはインベントリモデルバンドルである機器所有者リソースに必要です。すべての機器リソースに必要です。 リソースのネットワークサイト。 このパラメーターは、ネットワークサイト、物理接続、または論理接続リソースではサポートされていません。 データタイプ: オブジェクト "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 場所のタイプ。この値は常に `GeographicAddress` です。 データタイプ：文字列 | | place.href | 場所レコードへの相対リンク。 データタイプ：文字列 | | place.id | placeパラメーターを使用する場合は必須です。 場所レコードのSys_id。 データタイプ：文字列 テーブル:ネットワークサイト \[cmdb_ci_ni_site\] | | 関連パーティー | リソースの連絡先に関する詳細。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] | | relatedParty.@referredType | 関係者のタイプ。\[ タイプ \] フィールドにあります。 データタイプ：文字列 テーブル:グループ \[sys_user_group\] テーブルのタイプフィールド内。 | | relatedParty.href | 関係者レコードへの相対リンク。 データタイプ：文字列 | | relatedParty.id | relatedPartyパラメーターを使用する場合は必須です。 関係者レコードのSys_id。 データタイプ：文字列 テーブル： Group \[sys_user_group\] | | リソース特性 | リソースの特性のリスト。次のリソースタイプには、特定のリソース特性が必要です。 * 物理接続および論理接続リソースの場合、 `ポート A` または `ポート Z` の特性が必要です。リソースのライフサイクルステージステータスが \[使用中\] の場合は、 `ポート A` と `ポート Z` の両方が必要です。 * 機器所有者リソースの場合、 `コンテナタイプ` 特性が必要です。 {#resource-inv-POST-resource__ul_wsv_p2m_g5b} データタイプ：オブジェクトのアレイ "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | resourceCharacteristicパラメーターを使用する場合は必須です。 @type パラメーターで指定されたリソーステーブルのフィールド名。フィールド model_id、name、network_site、operation_notes、operational_status、short_description、start_date、または sys_id などのsys_プリフィックス付きフィールドは使用できません。 データタイプ：文字列 | | resourceCharacteristic.value | resourceCharacteristicパラメーターを使用する場合は必須です。 特性の値。 データタイプ：文字列 | | resourceCharacteristic.valueType | 値のタイプ。 有効な値： * ブーリアン * 日時 * float * 整数 * ph_number * 参照 * string {#resource-inv-POST-resource__ul_bk1_rw2_g5b} データタイプ：文字列 | | リソース関係 | 関連リソースのリスト。次のリソースタイプには、特定の関連リソースが必要です。 * インターフェイスカードリソースの場合、\[コンテナタイプ\] が \[スロット\] または \[サブスロット\] である機器所有者リソースとの関係が必要です。 * ネットワークインターフェイスリソースの場合は、機器またはインターフェイスカードリソースとの関係が必要です。 * コンテナタイプがスロットまたはサブスロットである機器所有者リソースの場合、機器またはインターフェイスカードリソースとの関係が必要です。 {#resource-inv-POST-resource__ul_rlv_3dm_g5b} データタイプ：アレイ "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.relationshipType | resourceRelationshipパラメーターを使用する場合は必須です。 \[ `this resource descriptor]::[related resource descriptor]` 形式の 2 つのリソース間の関係性のタイプ。たとえば、 `Contains::Contained by は` 、関連リソースがこのリソースの子であることを示します。 記述子の有効な値は、CI 関係性タイプ \[cmdb_rel_type\] テーブルの \[ 親記述子 \] 列と \[子記述子\] 列にあります。 データタイプ：文字列 | | resourceRelationship.resource | resourceRelationshipパラメーターを使用する場合は必須です。 関連リソースの詳細。関連リソースは、次のいずれかのリソースタイプである必要があります。 * ケーブル * 設備 * 機器所有者 * インターフェイスカード * 論理接続 * Network Interface * ネットワークサイト * 物理接続 * ストランド * トポロジ {#resource-inv-POST-resource__ul_wmt_vtx_d5y} データタイプ: オブジェクト "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | resourceRelationshipパラメーターを使用する場合は必須です。 関連リソースのSys_id。関連リソースのタイプに応じて、次のいずれかのテーブルに配置されています。 * インターフェイスカード \[cmdb_ci_interface_card\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器所有者を拡張するテーブル \[cmdb_ci_equipment_holder\] {#resource-inv-POST-resource__ul_vr1_4gf_g5b} データタイプ：文字列 | | resourceRelationship.resource.href | 関連リソースレコードへの相対リンク。 データタイプ：文字列 | | リソース仕様 | リソース仕様。 データタイプ: オブジェクト "resourceSpecification": { "id": "String" } | | resourceSpecification.id | resourceSpecificationパラメーターを使用する場合は必須です。 リソースに関連付けられたモデルのSys_id。モデルのタイプに応じて、次のいずれかのテーブルにあります。 * ケーブルモデル \[sn_ent_cable_model\] * 機器所有者モデル \[sn_ent_nw_holder_model\] * 設備モデル \[sn_ent_nw_equipment_model\] * インターフェイスカードモデル \[sn_ent_nw_interface_model\] * 論理接続モデル \[sn_ent_logical_nw_connection_model\] * ネットワークインターフェイスモデル \[sn_ent_nw_interface_model\] * 物理接続モデル \[sn_ent_physical_nw_connection_model\] * ストランドモデル \[sn_ent_strand_model\] * トポロジモデル \[sn_ent_network_topology_model\] {#resource-inv-POST-resource__ul_a3t_1lz_d5b} データタイプ：文字列 | | 開始運用日 | リソースが最初に運用を開始した日時。 データタイプ：文字列 | [表 : 27. 要求本文パラメーター (JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#resource-inv-POST-resource__entry__62}{#resource-inv-POST-resource__accept-JSON-only-entry-RESTAPI}{#resource-inv-POST-resource__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 28. 要求ヘッダー] {#resource-inv-POST-resource__entry__68} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | | ロケーション | 作成されたリソースの URL。 | [表 : 29. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#resource-inv-POST-resource__table_b4x_lrs_g5b__entry__2}{#resource-inv-POST-resource__entry-400-status-code}{#resource-inv-POST-resource__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 215 | 処理のために要求が正常に受信されました。要求は非同期に完了します。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | [表 : 30. ステータスコード] {#resource-inv-POST-resource__table_b4x_lrs_g5b} ### 応答本文のパラメーター (JSON) {#resource-inv-POST-resource__section_nkb_1rw_f5b} {#resource-inv-POST-resource__table_okb_1rw_f5b__entry__2}{#resource-inv-POST-resource__d3457e141}{#resource-inv-POST-resource__d3457e401} | 名前 | 説明 | |-|-| | @type | リソースのタイプ。 有効な値： * `cmdb_ci_cable` (ケーブル) * `cmdb_ci_interface_card` (インターフェイスカード) * `cmdb_ci_ip_address` (IP アドレス) * `cmdb_ci_ni_logical_path` (論理接続) * `cmdb_ci_ni_interface` (ネットワークインターフェイス) * `cmdb_ci_ni_site` (ネットワークサイト) * `cmdb_ci_ni_physical_link` (物理接続) * `cmdb_ci_strand` (ストランド) * `cmdb_ci_topology` (トポロジ) * sn_ni_core.equipment_tables sys_propertyで指定されたテーブルの名前、または指定されたテーブルを拡張するテーブルの名前。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブルの名前。 {#resource-inv-POST-resource__d3457e145} データタイプ：文字列 | | description | リソースの説明。 データタイプ：文字列 | | href | リソースレコードへの相対リンク。 データタイプ：文字列 | | ID | リソースのSys_id。リソースのタイプに応じて、次のいずれかのテーブルに配置されます。 * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * インターフェイスカード \[cmdb_ci_interface_card\] * IP アドレス \[cmdb_ci_ip_address\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * ストランド \[cmdb_ci_strand\] * トポロジ \[cmdb_ci_topology\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブル。 * 次のいずれかのテーブルを拡張する子テーブル: * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * ストランド \[cmdb_ci_strand\] {#resource-inv-POST-resource__ul_umw_gvn_bcc} {#resource-inv-POST-resource__res-inv-tables} データタイプ：文字列 | | name | リソースの名前。 データタイプ：文字列 | | 注意 | リソースに関するメモのリスト。 データタイプ：オブジェクトのアレイ "note": [ { "text": "String" } ] | | note.text | メモのテキスト。 データタイプ：文字列 | | ロケーション | リソースのネットワークサイト。 このパラメーターは、ネットワークサイト、物理接続、または論理接続リソースではサポートされていません。 データタイプ: オブジェクト "place": { "@referredType": "String", "href": "String", "id": "String" } | | place.@referredType | 場所のタイプ。この値は常に `GeographicAddress` です。 データタイプ：文字列 | | place.href | 場所レコードへの相対リンク。 データタイプ：文字列 | | place.id | 場所レコードのSys_id。 データタイプ：文字列 テーブル:ネットワークサイト \[cmdb_ci_ni_site\] | | 関連パーティー | リソースの連絡先に関する詳細。 データタイプ：オブジェクトのアレイ "relatedParty": [ { "@referredType": "String", "href": "String", "id": "String", "role": "String" } ] | | relatedParty.@referredType | 関係者のタイプ。\[ タイプ \] フィールドにあります。 データタイプ：文字列 テーブル:グループ \[sys_user_group\] テーブルのタイプフィールド内。 | | relatedParty.href | 関係者レコードへの相対リンク。 データタイプ：文字列 | | relatedParty.id | 関係者レコードのSys_id。 データタイプ：文字列 テーブル： Group \[sys_user_group\] | | リソース特性 | リソースの特性のリスト。次のリソースタイプには、特定のリソース特性が必要です。 * 物理接続および論理接続リソースの場合、 `ポート A` または `ポート Z` の特性が必要です。リソースのライフサイクルステージステータスが \[使用中\] の場合は、 `ポート A` と `ポート Z` の両方が必要です。 * 機器所有者リソースの場合、 `コンテナタイプ` 特性が必要です。 {#resource-inv-POST-resource__d3457e477} データタイプ：オブジェクトのアレイ "resourceCharacteristic": [ { "name": "String", "value": "String", "valueType": "String" } ] | | resourceCharacteristic.name | @type パラメーターで指定されたリソーステーブルのフィールド名。フィールド model_id、name、network_site、operation_notes、operational_status、short_description、start_date、または sys_id などのsys_プリフィックス付きフィールドは使用できません。 データタイプ：文字列 | | resourceCharacteristic.value | 特性の値。 データタイプ：文字列 | | resourceCharacteristic.valueType | 値のタイプ。 有効な値： * ブーリアン * 日時 * float * 整数 * ph_number * 参照 * string {#resource-inv-POST-resource__d3457e548} データタイプ：文字列 | | リソース関係 | 関連リソースのリスト。次のリソースタイプには、特定の関連リソースが必要です。 * インターフェイスカードリソースの場合、\[コンテナタイプ\] が \[スロット\] または \[サブスロット\] である機器所有者リソースとの関係が必要です。 * ネットワークインターフェイスリソースの場合は、機器またはインターフェイスカードリソースとの関係が必要です。 * コンテナタイプがスロットまたはサブスロットである機器所有者リソースの場合、機器またはインターフェイスカードリソースとの関係が必要です。 {#resource-inv-POST-resource__d3457e583} データタイプ：アレイ "resourceRelationship": [ { "relationshipType": "String", "resource": {Object} } ] | | resourceRelationship.relationshipType | \[ `this resource descriptor]::[related resource descriptor]` 形式の 2 つのリソース間の関係性のタイプ。たとえば、 `Contains::Contained by は` 、関連リソースがこのリソースの子であることを示します。 記述子の有効な値は、CI 関係性タイプ \[cmdb_rel_type\] テーブルの \[ 親記述子 \] 列と \[子記述子\] 列にあります。 データタイプ：文字列 | | resourceRelationship.resource | 関連リソースの詳細。関連リソースは、次のいずれかのリソースタイプである必要があります。 * ケーブル * 設備 * 機器所有者 * インターフェイスカード * 論理接続 * Network Interface * ネットワークサイト * 物理接続 * ストランド * トポロジ {#resource-inv-POST-resource__d3457e640} データタイプ: オブジェクト "resource": { "id": "String", "href": "String" } | | resourceRelationship.resource.id | 関連リソースのSys_id。関連リソースのタイプに応じて、次のいずれかのテーブルに配置されています。 * インターフェイスカード \[cmdb_ci_interface_card\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器所有者を拡張するテーブル \[cmdb_ci_equipment_holder\] {#resource-inv-POST-resource__d3457e692} データタイプ：文字列 | | resourceRelationship.resource.href | 関連リソースレコードへの相対リンク。 データタイプ：文字列 | | リソース仕様 | リソース仕様。 データタイプ: オブジェクト "resourceSpecification": { "id": "String" } | | resourceSpecification.id | リソースに関連付けられたモデルのSys_id。モデルのタイプに応じて、次のいずれかのテーブルにあります。 * ケーブルモデル \[sn_ent_cable_model\] * 機器所有者モデル \[sn_ent_nw_holder_model\] * 設備モデル \[sn_ent_nw_equipment_model\] * インターフェイスカードモデル \[sn_ent_nw_interface_model\] * 論理接続モデル \[sn_ent_logical_nw_connection_model\] * ネットワークインターフェイスモデル \[sn_ent_nw_interface_model\] * 物理接続モデル \[sn_ent_physical_nw_connection_model\] * ストランドモデル \[sn_ent_strand_model\] * トポロジモデル \[sn_ent_network_topology_model\] {#resource-inv-POST-resource__d3457e757} データタイプ：文字列 | | 開始運用日 | リソースが最初に運用を開始した日時。 データタイプ：文字列 | [ ] {#resource-inv-POST-resource__table_okb_1rw_f5b} ### cURL 要求 この例では、コロラド州デンバーにネットワークサイトを作成します。 curl "https://instance.service-now.com/api/sn_ni_core/resource" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"name\": \"DENVER CO CO/HUB\", \"note\": [ { \"text\": \"Cisco maintenance team onsite June 22, 2022.\" } ], \"resourceCharacteristic\": [ { \"name\": \"attested\", \"valueType\": \"boolean\", \"value\": \"false\" }, { \"name\": \"can_print\", \"valueType\": \"boolean\", \"value\": \"false\" }, { \"name\": \"clli_code\", \"valueType\": \"string\", \"value\": \"DNVRCOMR02T\" }, { \"name\": \"comments\", \"valueType\": \"string\", \"value\": \"Site is scheduled for diesel generator test July 13, 2022 at 9am CST.\" }, { \"name\": \"cost_cc\", \"valueType\": \"string\", \"value\": \"USD\" }, { \"name\": \"county\", \"valueType\": \"string\", \"value\": \"DENVER\" }, { \"name\": \"data_center_code\", \"valueType\": \"string\", \"value\": \"DNVR00564\" }, { \"name\": \"fault_count\", \"valueType\": \"integer\", \"value\": \"0\" }, { \"name\": \"install_status\", \"valueType\": \"integer\", \"value\": \"1\" }, { \"name\": \"life_cycle_stage\", \"valueType\": \"reference\", \"value\": \"Operational\" }, { \"name\": \"life_cycle_stage_status\", \"valueType\": \"reference\", \"value\": \"In Use\" }, { \"name\": \"location\", \"valueType\": \"reference\", \"value\": \"25ab8f300a0a0bb300d99f69c3ac24cd\" }, { \"name\": \"managed_by\", \"valueType\": \"reference\", \"value\": \"b0f31e5673500010c2e7660c4cf6a711\" }, { \"name\": \"monitor\", \"valueType\": \"boolean\", \"value\": \"false\" }, { \"name\": \"network_domain\", \"valueType\": \"string\", \"value\": \"core\" }, { \"name\": \"ni_type\", \"valueType\": \"reference\", \"value\": \"8e8f3770404d0110f8772175cacd7204\" }, { \"name\": \"pots_number\", \"valueType\": \"ph_number\", \"value\": \"(214) 555-1234\" }, { \"name\": \"skip_sync\", \"valueType\": \"boolean\", \"value\": \"false\" }, { \"name\": \"third_party_ownership\", \"valueType\": \"boolean\", \"value\": \"false\" }, { \"name\": \"unverified\", \"valueType\": \"boolean\", \"value\": \"false\" } ], \"resourceRelationship\": [ { \"relationshipType\": \"Connects to::Connected by\", \"resource\": { \"id\": \"e6f6df8d4051c910f8772175cacd72b2\", \"href\": \"/api/sn_ni_core/resource/e6f6df8d4051c910f8772175cacd72b2\" } }, { \"relationshipType\": \"Connects to::Connected by\", \"resource\": { \"id\": \"0ac19bc54051c910f8772175cacd724b\", \"href\": \"/api/sn_ni_core/resource/0ac19bc54051c910f8772175cacd724b\" } }, { \"relationshipType\": \"Connects to::Connected by\", \"resource\": { \"id\": \"997e5c11875851109a9c0f65dabb35ac\", \"href\": \"/api/sn_ni_core/resource/997e5c11875851109a9c0f65dabb35ac\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"5b10e8154015c910f8772175cacd724d\", \"href\": \"/api/sn_ni_core/resource/5b10e8154015c910f8772175cacd724d\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"57e73b51405dc910f8772175cacd726e\", \"href\": \"/api/sn_ni_core/resource/57e73b51405dc910f8772175cacd726e\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"bf58f751405dc910f8772175cacd72e8\", \"href\": \"/api/sn_ni_core/resource/bf58f751405dc910f8772175cacd72e8\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"b5711e31405d0d10f8772175cacd7232\", \"href\": \"/api/sn_ni_core/resource/b5711e31405d0d10f8772175cacd7232\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"ed811e31405d0d10f8772175cacd72d3\", \"href\": \"/api/sn_ni_core/resource/ed811e31405d0d10f8772175cacd72d3\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"d74937d1405dc910f8772175cacd7288\", \"href\": \"/api/sn_ni_core/resource/d74937d1405dc910f8772175cacd7288\" } }, { \"relationshipType\": \"Contains::Contained by\", \"resource\": { \"id\": \"da0df2e3e4e64510f877e70ec9bcacc6\", \"href\": \"/api/sn_ni_core/resource/da0df2e3e4e64510f877e70ec9bcacc6\" } } ], \"@type\": \"cmdb_ci_ni_site\" }" \ --user 'username':'password' 応答本文。 { "href": "/api/sn_ni_core/resource/00399f0aed349150f877305f29f832b2", "id": "00399f0aed349150f877305f29f832b2", "name": "DENVER CO CO/HUB", "note": [ { "text": "Cisco maintenance team onsite June 22, 2022." } ], "resourceCharacteristic": [ { "name": "altitude_units", "valueType": "string", "value": "feet" }, { "name": "attestation_status", "valueType": "string", "value": "Not Yet Reviewed" }, { "name": "attested", "valueType": "boolean", "value": "false" }, { "name": "can_print", "valueType": "boolean", "value": "false" }, { "name": "clli_code", "valueType": "string", "value": "DNVRCOMR02T" }, { "name": "comments", "valueType": "string", "value": "Site is scheduled for diesel generator test July 13, 2022 at 9am CST." }, { "name": "cost_cc", "valueType": "string", "value": "USD" }, { "name": "county", "valueType": "string", "value": "DENVER" }, { "name": "data_center_code", "valueType": "string", "value": "DNVR00564" }, { "name": "discovery_source", "valueType": "string", "value": "Resource Inventory Open API" }, { "name": "fault_count", "valueType": "integer", "value": "0" }, { "name": "first_discovered", "valueType": "datetime", "value": "2022-07-21T19:38:04.000Z" }, { "name": "install_status", "valueType": "integer", "value": "1" }, { "name": "last_discovered", "valueType": "datetime", "value": "2022-07-21T19:38:04.000Z" }, { "name": "life_cycle_stage", "valueType": "reference", "value": "Operational" }, { "name": "life_cycle_stage_status", "valueType": "reference", "value": "In Use" }, { "name": "location", "valueType": "reference", "value": "25ab8f300a0a0bb300d99f69c3ac24cd" }, { "name": "managed_by", "valueType": "reference", "value": "b0f31e5673500010c2e7660c4cf6a711" }, { "name": "monitor", "valueType": "boolean", "value": "false" }, { "name": "network_domain", "valueType": "string", "value": "core" }, { "name": "ni_type", "valueType": "reference", "value": "8e8f3770404d0110f8772175cacd7204" }, { "name": "pots_number", "valueType": "ph_number", "value": "(214) 555-1234" }, { "name": "skip_sync", "valueType": "boolean", "value": "false" }, { "name": "third_party_ownership", "valueType": "boolean", "value": "false" }, { "name": "unverified", "valueType": "boolean", "value": "false" } ], "resourceRelationship": [ { "relationshipType": "Connects to::Connected by", "resource": { "id": "e6f6df8d4051c910f8772175cacd72b2", "href": "/api/sn_ni_core/resource/e6f6df8d4051c910f8772175cacd72b2" } }, { "relationshipType": "Connects to::Connected by", "resource": { "id": "0ac19bc54051c910f8772175cacd724b", "href": "/api/sn_ni_core/resource/0ac19bc54051c910f8772175cacd724b" } }, { "relationshipType": "Connects to::Connected by", "resource": { "id": "997e5c11875851109a9c0f65dabb35ac", "href": "/api/sn_ni_core/resource/997e5c11875851109a9c0f65dabb35ac" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "5b10e8154015c910f8772175cacd724d", "href": "/api/sn_ni_core/resource/5b10e8154015c910f8772175cacd724d" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "57e73b51405dc910f8772175cacd726e", "href": "/api/sn_ni_core/resource/57e73b51405dc910f8772175cacd726e" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "bf58f751405dc910f8772175cacd72e8", "href": "/api/sn_ni_core/resource/bf58f751405dc910f8772175cacd72e8" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "b5711e31405d0d10f8772175cacd7232", "href": "/api/sn_ni_core/resource/b5711e31405d0d10f8772175cacd7232" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "ed811e31405d0d10f8772175cacd72d3", "href": "/api/sn_ni_core/resource/ed811e31405d0d10f8772175cacd72d3" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "d74937d1405dc910f8772175cacd7288", "href": "/api/sn_ni_core/resource/d74937d1405dc910f8772175cacd7288" } }, { "relationshipType": "Contains::Contained by", "resource": { "id": "da0df2e3e4e64510f877e70ec9bcacc6", "href": "/api/sn_ni_core/resource/da0df2e3e4e64510f877e70ec9bcacc6" } } ], "@type": "cmdb_ci_ni_site" } ## リソースインベントリオープン API - POST /sn_ni_core/resourceinventoryviatemplate {#ariaid-title7} テンプレートに基づいてリソース構成アイテム (CI) と関連 CI 階層を作成します。 このエンドポイントを呼び出す前に、インベントリテンプレート \[sn_ni_core_inventory_template\] テーブルにインベントリテンプレートを作成する必要があります。インベントリテンプレートでは、関連する CI の階層全体を定義できます。その後、単一の API 要求ですべての CI と関係を作成できます。 ### URL 形式 デフォルト URL: /api/sn_ni_core/resourceinventoryviatemplate ### サポートされている要求パラメーター {#resource-inv-POST-template__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 31. パスパラメーター] {#resource-inv-POST-template__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 32. クエリパラメーター] {#resource-inv-POST-template__entry__10} | 名前 | 説明 | |-|-| | 上書き | 上書きする列と使用する値のリスト。 データタイプ: オブジェクト "overrides": { "column_name": "String" } | | overrides.column_name | overridesパラメーターを使用する場合は必須です。列名と値。 データタイプ：文字列 | | parentId | 必須です。親 CI のSys_id。親 CI のタイプに応じて、次のいずれかのテーブルに配置されます。 * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * インターフェイスカード \[cmdb_ci_interface_card\] * IP アドレス \[cmdb_ci_ip_address\] * 論理接続 \[cmdb_ci_ni_logical_path\] * ネットワークインターフェイス \[cmdb_ci_ni_interface\] * ネットワークサイト \[cmdb_ci_ni_site\] * 物理接続 \[cmdb_ci_ni_physical_link\] * ストランド \[cmdb_ci_strand\] * トポロジ \[cmdb_ci_topology\] * sn_ni_core.equipment_tables sys_propertyによって指定されたテーブル、および指定されたテーブルを拡張するテーブル。 * 機器ホルダー \[cmdb_ci_equipment_holder\] を拡張するテーブル。 * 次のいずれかのテーブルを拡張する子テーブル: * ケーブル \[cmdb_ci_cable\] * 機器ホルダー \[cmdb_ci_equipment_holder\] * ストランド \[cmdb_ci_strand\] {#resource-inv-POST-template__ul_umw_gvn_bcc} {#resource-inv-POST-template__ul_ihw_mmd_wxb} データタイプ：文字列 | | template_id | 必須です。テンプレートのSys_id。 データタイプ：文字列 テーブル:インベントリテンプレート \[sn_ni_core_inventory_template\] | | templateOverrides | テンプレートの上書きのリスト。 データタイプ：オブジェクトのアレイ "templateOverrides": [ { "overrideTemplateId": "String", "templateId": "String" } ] | | templateOverrides.overrideTemplateId | templateOverridesパラメーターを使用する場合は必須です。利用可能なテンプレートsys_id。 データタイプ：文字列 | | templateOverrides.templateId | templateOverridesパラメーターを使用する場合は必須です。関連テンプレートsys_id。 データタイプ：文字列 | [表 : 33. 要求本文パラメーター (JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#resource-inv-POST-template__table_ss4_qtt_g5b__entry__2}{#resource-inv-POST-template__accept-JSON-only-entry-RESTAPI}{#resource-inv-POST-template__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 34. 要求ヘッダー] {#resource-inv-POST-template__table_ss4_qtt_g5b} {#resource-inv-POST-template__table_b21_rtt_g5b__entry__2} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | | ロケーション | 階層の最上位にある作成された CI の URL。 | [表 : 35. 応答ヘッダー] {#resource-inv-POST-template__table_b21_rtt_g5b} ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#resource-inv-POST-template__table_b4x_lrs_g5b__entry__2}{#resource-inv-POST-template__entry-400-status-code}{#resource-inv-POST-template__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 201 | リソースが作成されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 500 | エラー。要求でエラーが発生しました。たとえば、要求が検証チェックに失敗しました。 | [表 : 36. ステータスコード] {#resource-inv-POST-template__table_b4x_lrs_g5b} ### 応答本文のパラメーター (JSON) {#resource-inv-POST-template__entry__48} | 名前 | 説明 | |-|-| | result | 作成された CI に関する情報を含む結果オブジェクト。 データタイプ: オブジェクト "result": { "sys_id": "String" } | | result.sys_id | 階層の最上位にある作成された CI のSys_id。 データタイプ：文字列 | [ ] ### cURL 要求 この例では、テンプレートを使用して CI 階層を作成します。 curl "https://instance.service-now.com/api/sn_ni_core/resourceinventoryviatemplate" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ "templateId": "90475711ed6ec110f877d2f57b8accda", "parentId": "917dd8f6870e851079c40f2d0ebb353d", "overrides": { "equipment_clli": "test" }, "templateOverrides": [ { "templateId": "ac3b679ded6ec110f877d2f57b8acc29", "overrideTemplateId": "f9604efb54e18110f87749bbc4ad38d8" }, { "templateId": "171c23dded6ec110f877d2f57b8acc33", "overrideTemplateId": "0f38e59187424110e14f64e73cbb35b4" } ] }" \ --user 'username':'password' 応答本文。 "result": { "sys_id": "00598f0aed346259f388105f29f892c4" }