--- 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 --- # CMDB インスタンス API # CMDB インスタンス API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：105分 CMDB インスタンス API は、既存の 構成管理データベース (CMDB) テーブルに対する作成、読み取り、更新、および削除の操作を行うためのエンドポイントを提供します。一度に挿入、更新、または削除できるレコードは 1 つだけです。 この API では、ユーザーに ITIL ロールが必要です。 ## CMDB インスタンス:DELETE /now/cmdb/instance/{classname}/{sys_id}/relation/{rel_sys_id} {#ariaid-title2} 指定された構成アイテム (CI) の関係を削除します。 ### URL 形式 {#cmdb-DELETE-instance-relation__section_urs_wnr_cmb} バージョニングされた URL: /api/now/{api_version}/cmdb/instance/{className}/{sys_id}/relation/{rel_sys_id} デフォルト URL: /api/now/cmdb/instance/{className}/{sys_id}/relation/{rel_sys_id} 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#cmdb-DELETE-instance-relation__entry__2}{#cmdb-DELETE-instance-relation__entry-className-cmdb} | 名前 | 説明 | |-|-| | className | CMDB クラス名。これは、cmdb_ci_linux_server や cmdb_ci_apache_web_server などの目的の CI レコードを含むテーブルの名前です。 データタイプ：文字列 | | rel_sys_id | 削除する関係のSys_id。 データタイプ：文字列 | | sys_id | CI のSys_id。 データタイプ：文字列 | [表 : 1. パスパラメーター] {#cmdb-DELETE-instance-relation__entry__10} | 名前 | 説明 | |-|-| | なし | | [表 : 2. クエリパラメーター] {#cmdb-DELETE-instance-relation__entry__14} | 名前 | 説明 | |-|-| | なし | | [表 : 3. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#cmdb-DELETE-instance-relation__entry__18} | ヘッダー | 説明 | |-|-| | なし | | [表 : 4. 要求ヘッダー] {#cmdb-DELETE-instance-relation__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#cmdb-DELETE-instance-relation__entry__26}{#cmdb-DELETE-instance-relation__entry-200-status-code}{#cmdb-DELETE-instance-relation__entry-400-status-code}{#cmdb-DELETE-instance-relation__entry-401-status-code}{#cmdb-DELETE-instance-relation__entry-404-status-code}{#cmdb-DELETE-instance-relation__entry-405-status-code}{#cmdb-DELETE-instance-relation__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 405 | メソッドが無効です。機能が無効になっています。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 6. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#cmdb-DELETE-instance-relation__entry__40} | 名前 | 説明 | |-|-| | なし | | [ ] ### cURL 要求のサンプル curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/0f4ac6c4b750230096c3e4f6ee11a9fe/relation/b0dbda5347c12200e0ef563dbb9a718f" \ --request DELETE \ --user 'username':'password' ## CMDB インスタンス:GET /now/cmdb/instance/{classname} {#ariaid-title3} 指定された 構成管理データベース (CMDB) クラス (テーブル) で利用可能な構成アイテム (CI) を返します。 ### URL 形式 {#cmdb-GET-instance-classname__section_d25_3qr_cmb} バージョニングされた URL: /api/now/{api_version}/cmdb/instance/{className} デフォルト URL: /api/now/cmdb/instance/{className} 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#cmdb-GET-instance-classname__entry__2}{#cmdb-GET-instance-classname__entry-className-cmdb} | 名前 | 説明 | |-|-| | className | CMDB クラス名。これは、cmdb_ci_linux_server や cmdb_ci_apache_web_server などの目的の CI レコードを含むテーブルの名前です。 データタイプ：文字列 | [表 : 7. パスパラメーター] {#cmdb-GET-instance-classname__entry__6}{#cmdb-GET-instance-classname__sysparm-limit-RESTAPI}{#cmdb-GET-instance-classname__sysparm_offset-ph-RESTAPI}{#cmdb-GET-instance-classname__sysparm-query-RESTAPI} | 名前 | 説明 | |-|-| | sysparm_limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、 sysparm_offset パラメーターを使用してレコード取得をページネーションします。 この制限は、ACL 評価の前に適用されます。アクセス権のあるレコードを含めて、レコードが返されない場合は、アクセス権のあるレコードが最初に返されるようにレコードの順序を並べ替えます。 注: sysparm_limit値が異常に大きいと、システムのパフォーマンスに影響を与える可能性があります。 データタイプ：数値 デフォルト：10000 | | sysparm_offset | レコード取得を開始する開始レコードインデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。 たとえば、このエンドポイントを初めて呼び出すとき、 sysparm_offset は「0」に設定されます。使用可能なすべてのレコードを単純にページングするには、すべてのレコードの最後に到達するまで `sysparm_offset=sysparm_offset+sysparm_limit` を使用します。{#cmdb-GET-instance-classname__sysparm_offset-p-RESTAPI} sysparm_offset パラメーターに負の数を渡さないでください。 データタイプ：数値 デフォルト：0 | | sysparm_query | 結果セットのフィルタリングに使用される[エンコードクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)。UI フィルターを使用して、適切にエンコードされたクエリを取得できます。 構文: `sysparm_query=`。列名、演算子、および値は大文字と小文字を区別します。 * \:フィルターを適用するテーブル列の名前。 * \:次の値をサポートします。 * `=`:\は\<値\>と完全に一致します。 * `!=`:\ が \ と一致しません。 * `LIKE:`\には指定された文字列 \ が含まれています。データタイプが文字列である\フィールドでのみ機能します。 * `STARTSWITH:`\は、指定された文字列 \ で始まります。データタイプが文字列である\フィールドでのみ機能します。 * `ENDSWITH`:\は指定された文字列 \ で終わります。データタイプが文字列である\フィールドでのみ機能します。 * `^`:クエリ条件を追加するための AND 演算子。結果セットに含まれるレコードは両方の条件に一致します。 * `^OR`:クエリ条件を追加するための OR 演算子。結果セットに含まれるレコードは、少なくとも 1 つの条件に一致します。 {#cmdb-GET-instance-classname__ul_bgf_5vz_mlb} * \:フィルターを適用する値。 {#cmdb-GET-instance-classname__ul_g2p_svz_mlb}演算子の詳細については、「[Operators available for filters and queries](https://www.servicenow.com/docs/access?context=r_OpAvailableFiltersQueries&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)」を参照してください。 クエリには複数の条件を含めることができます。たとえば、次のクエリは、発信者が現在のユーザーであり、レコードがアクティブなレコードを返します。 `sysparm_query=caller_id=javascript:gs.getUserID()^active=true` エンコードクエリでは、昇順および降順による並べ替えの機能もサポートされています。特定のフィールドに基づいて応答をソートするには、sysparm_queryで `ORDERBY` 句と `ORDERBYDESC` 句を使用します。 構文: * `ORDERBY` * `ORDERBYDESC` {#cmdb-GET-instance-classname__ul_sq4_rc1_nlb} たとえば、次のクエリでは、すべてのアクティブなレコードを取得し、結果を番号の昇順に並べ替え、次にカテゴリ別に降順に並べ替えます。 `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCカテゴリ` デフォルトでは、無効なフィールド名など、クエリの一部が無効な場合、インスタンスは無効な部分を無視します。次に、クエリの有効な部分のみを使用して行を返します。プロパティ glide.invalid_query.returns_no_rows を true に設定すると、代わりに無効なクエリに対して行を返さないようにします。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンス全体のすべてのクエリの動作を制御します。 データタイプ：文字列 | [表 : 8. クエリパラメーター] {#cmdb-GET-instance-classname__entry__14} | 名前 | 説明 | |-|-| | なし | | [表 : 9. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#cmdb-GET-instance-classname__entry__18}{#cmdb-GET-instance-classname__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 10. 要求ヘッダー] {#cmdb-GET-instance-classname__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 11. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#cmdb-GET-instance-classname__entry__26}{#cmdb-GET-instance-classname__entry-200-status-code}{#cmdb-GET-instance-classname__entry-400-status-code}{#cmdb-GET-instance-classname__entry-401-status-code}{#cmdb-GET-instance-classname__entry-404-status-code}{#cmdb-GET-instance-classname__entry-405-status-code}{#cmdb-GET-instance-classname__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 405 | メソッドが無効です。機能が無効になっています。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 12. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#cmdb-GET-instance-classname__entry__40} | 名前 | 説明 | |-|-| | name | 指定されたクラス内の CI の名前。 データタイプ：文字列 | | sys_id | CI のSys_id。 データタイプ：文字列 | [ ] ### cURL 要求のサンプル curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' "result": [ { "sys_id": "3a290cc60a0a0bb400000bdb386af1cf", "name": "PS LinuxApp01" }, { "sys_id": "3a5dd3dbc0a8ce0100655f1ec66ed42c", "name": "PS LinuxApp02" } ] ## CMDB インスタンス:GET /now/cmdb/instance/{classname}/{sys_id} {#ariaid-title4} 指定された構成アイテム (CI) レコードの属性と関係情報を返します。 ### URL 形式 {#cmdb-GET-instance-classname-sys_id__section_p22_d5r_cmb} バージョニングされた URL: /api/now/{api_version}/cmdb/instance/{className}/{sys_id} デフォルト URL: /api/now/cmdb/instance/{className}/{sys_id} 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#cmdb-GET-instance-classname-sys_id__entry__2}{#cmdb-GET-instance-classname-sys_id__version-not_optional-RESTAPI}{#cmdb-GET-instance-classname-sys_id__entry-className-cmdb} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | className | CMDB クラス名。これは、cmdb_ci_linux_server や cmdb_ci_apache_web_server などの目的の CI レコードを含むテーブルの名前です。 データタイプ：文字列 | | sys_id | 取得する CI レコードのSys_id。 データタイプ：文字列 | [表 : 13. パスパラメーター] {#cmdb-GET-instance-classname-sys_id__entry__10} | 名前 | 説明 | |-|-| | なし | | [表 : 14. クエリパラメーター] {#cmdb-GET-instance-classname-sys_id__entry__14} | 名前 | 説明 | |-|-| | なし | | [表 : 15. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#cmdb-GET-instance-classname-sys_id__entry__18}{#cmdb-GET-instance-classname-sys_id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 16. 要求ヘッダー] {#cmdb-GET-instance-classname-sys_id__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 17. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#cmdb-GET-instance-classname-sys_id__entry__26}{#cmdb-GET-instance-classname-sys_id__entry-200-status-code}{#cmdb-GET-instance-classname-sys_id__entry-400-status-code}{#cmdb-GET-instance-classname-sys_id__entry-401-status-code}{#cmdb-GET-instance-classname-sys_id__entry-404-status-code}{#cmdb-GET-instance-classname-sys_id__entry-405-status-code}{#cmdb-GET-instance-classname-sys_id__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 405 | メソッドが無効です。機能が無効になっています。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 18. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#cmdb-GET-instance-classname-sys_id__table_d5p_jn4_3mb__entry__2}{#cmdb-GET-instance-classname-sys_id__entry-result-error-cmdb-ph}{#cmdb-GET-instance-classname-sys_id__entry-result-error_detail-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-error_message-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_sys_id-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_target-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_target_display_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_target_link-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_target_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_type-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_type_display_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_type_link-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-inbound_relations_type_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_sys_id-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_target-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_target_display_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_target_link-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_target_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_type-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_type_display_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_type_link-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-outbound_relations_type_value-cmdb}{#cmdb-GET-instance-classname-sys_id__entry-result-status-cmdb} | 名前 | 説明 | |-|-| | 属性 | 現在 CI レコードにあるデータ属性。使用可能な属性は、指定された CMDB クラスによって異なります。利用可能な属性は、cmdb_ci_linux_server や cmdb_ci_mfp_printer など、通常は「cmdb_ci」で始まる関連する CMDB テーブルにあります。 データタイプ: オブジェクト | | エラー | エンドポイント要求の処理中に発生したエラーに関する情報。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | エラーに関する追加情報。 データタイプ：文字列 | | error.message | エラーを特定するメッセージ。 データタイプ：文字列 | | inbound_relations | CI に関連付けられた受信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | inbound_relations.sys_id | 受信 CI 関係のSys_id。CI 関係 \[cmdb_rel_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.target | ターゲット受信関係を説明する情報。 データタイプ: オブジェクト "target": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.target.display_value | ユーザーインターフェイスに表示する受信関係の名前。 データタイプ：文字列 | | inbound_relations.target.link | CMDB 構成アイテム \[cmdb_ci\] テーブルから受信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | inbound_relations.target.value | 受信 CI のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.type | 受信関係のタイプに関する情報。 データタイプ: オブジェクト "type": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.type.display_value | ユーザーインターフェイスに表示する受信タイプの名前。 データタイプ：文字列 | | inbound_relations.type.link | テーブル CI 関係性タイプ \[cmdb_rel_type\] テーブルから受信関係タイプを取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | inbound_relations.type.value | 受信リレーションシップのタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | outbound_relations | CI に関連付けられた送信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | outbound_relations.sys_id | アウトバウント CI 関係のSys_id。CI 関係 \[cmdb_rel_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.target | 必須です。ターゲット送信関係に関する情報。 データタイプ: オブジェクト "target": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.target.display_value | ユーザーインターフェイスに表示する送信関係の名前。 データタイプ：文字列 | | outbound_relations.target.link | CMDB 構成アイテム \[cmdb_ci\] テーブルから送信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | outbound_relations.target.value | 送信 CI のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.type | 送信関係のタイプに関する情報。 データタイプ: オブジェクト "type": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.type.display_value | ユーザーインターフェイスに表示する送信タイプの名前。 データタイプ：文字列 | | outbound_relations.type.link | テーブル CI 関係性タイプ \[cmdb_rel_type\] テーブルから送信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | outbound_relations.type.value | 送信関係のタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | status | エラーが発生した場合にのみ表示されます。エンドポイント処理のステータス。 可能な値:失敗 データタイプ：文字列 | [表 : 19. 応答パラメーター] {#cmdb-GET-instance-classname-sys_id__table_d5p_jn4_3mb} ### cURL 要求のサンプル curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/70bc4e11c0a8210d01f074cbe6bd73b4" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "outbound_relations": [ { "sys_id": "3a62e64ac0a8ce0100aead1e3fd5439f", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } }, { "sys_id": "3a67513fc0a8ce0100914a76cea11b02", "type": { "display_value": "Exchanges data with::Exchanges data with", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90", "value": "607ad1b2c0a8010e01941856b365af90" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } } ], "attributes": { "firewall_status": "Intranet", "os_address_width": "", "attested_date": "", "operational_status": "1", "os_service_pack": "", "cpu_core_thread": "", "cpu_manufacturer": "", "sys_updated_on": "2020-07-08 11:16:51", "discovery_source": "", "first_discovered": "", "due_in": "", "used_for": "Production", "invoice_number": "", "gl_account": "", "sys_created_by": "glide.maint", "warranty_expiration": "", "ram": "2048", "cpu_name": "", "cpu_speed": "2800", "owned_by": "", "checked_out": "", "kernel_release": "", "sys_domain_path": "/", "classification": "Production", "disk_space": "40", "object_id": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "2020-01-04 07:00:00", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "cd_speed": "", "floppy": "", "managed_by": { "display_value": "Lynda Caraway", "link": "https://instance.service-now.com/api/now/table/sys_user/8a826bf03710200044e0bfc8bcbe5d72", "value": "8a826bf03710200044e0bfc8bcbe5d72" }, "os_domain": "", "last_discovered": "", "can_print": "false", "sys_class_name": "cmdb_ci_linux_server", "manufacturer": { "display_value": "Iris", "link": "https://instance.servicenow.com/api/now/table/core_company/c115c2f737e3100044e0bfc8bcbe5d46", "value": "c115c2f737e3100044e0bfc8bcbe5d46" }, "cpu_count": "1", "vendor": { "display_value": "Cloudward Inc", "link": "https://instance.servicenow.com/api/now/table/core_company/3efe8c4c37423000158bbfc8bcbe5d7d", "value": "3efe8c4c37423000158bbfc8bcbe5d7d" }, "life_cycle_stage_status": "", "model_number": "", "assigned_to": "", "start_date": "", "os_version": "2.6.9-22.0.1.ELsmp", "serial_number": "", "cd_rom": "false", "support_group": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": { "display_value": "P1000091 - Iris 5875", "link": "https://instance.servicenow.com/api/now/table/alm_asset/0bc1ba8837f3100044e0bfc8bcbe5dbb", "value": "0bc1ba8837f3100044e0bfc8bcbe5dbb" }, "form_factor": "", "cpu_core_count": "", "skip_sync": "false", "attestation_score": "", "sys_updated_by": "system", "sys_created_on": "2008-10-26 17:17:28", "sys_domain": { "display_value": "global", "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global" }, "cpu_type": "Intel", "install_date": "2019-08-18 08:00:00", "asset_tag": "P1000091", "dr_backup": "", "hardware_substatus": "", "fqdn": "", "change_control": "", "internet_facing": "false", "delivery_date": "", "hardware_status": "", "install_status": "1", "supported_by": "", "name": "PS LinuxApp01", "subcategory": "", "default_gateway": "", "chassis_type": "", "virtual": "false", "assignment_group": "", "managed_by_group": "", "sys_id": "3a290cc60a0a0bb400000bdb386af1cf", "po_number": "", "checked_in": "", "sys_class_path": "/!!/!2/!(/!!/!0", "mac_address": "", "company": { "display_value": "ACME Corporation", "link": "https://instance.servicenow.com/api/now/table/core_company/e7c1f3d53790200044e0bfc8bcbe5deb", "value": "e7c1f3d53790200044e0bfc8bcbe5deb" }, "justification": "", "department": "", "cost": "45557.5", "comments": "", "os": "Linux Red Hat", "sys_mod_count": "24", "monitor": "false", "model_id": { "display_value": "Iris 5875", "link": "https://instance.servicenow.com/api/now/table/cmdb_model/5f5fbcc3c0a8010e00f3b27814f3b96b", "value": "5f5fbcc3c0a8010e00f3b27814f3b96b" }, "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": { "display_value": "322 West 52nd Street, New York,NY", "link": "https://instance.servicenow.com/api/now/table/cmn_location/25ab9f690a0a0bb3001c5fec1d0d7bcb", "value": "25ab9f690a0a0bb3001c5fec1d0d7bcb" }, "category": "Do not migrate to asset", "fault_count": "0", "host_name": "", "lease_id": "" }, "inbound_relations": [ { "sys_id": "3a5e4d8ac0a8ce010005145afb730818", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439", "value": "3a27d4370a0a0bb4006316812bf45439" } }, { "sys_id": "3a5e4d9cc0a8ce010097f2f5c2f65fd8", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache02", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27f1520a0a0bb400ecd6ff7afcf036", "value": "3a27f1520a0a0bb400ecd6ff7afcf036" } }, { "sys_id": "3a5e4d9fc0a8ce0100a3754fac26fe56", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache03", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a2810c20a0a0bb400268337d6e942ca", "value": "3a2810c20a0a0bb400268337d6e942ca" } } ] } } ## CMDB インスタンス:POST /now/cmdb/instance/{classname} {#ariaid-title5} 指定された 構成管理データベース (CMDB) テーブル内に指定された送信および受信関係を持つ単一の構成アイテム (CI) を作成します。 注: CMDB クラスに依存識別ルールが定義されている場合、入力ペイロードには既存の CI のsys_idが含まれている必要があります。たとえば、 outbound_relations の場合、 target パラメーターには、子になる既存の CI のsys_idが含まれている必要があります。inbound_relationsの場合は親になります。 "depends_on": { "outbound_relations": { "target": "b4fd7c8437201000deeabfc8bcbe5dc1", "type": "60bc4e22c0a8010e01f074cbe6bd73c3" } } ### URL 形式 {#cmdb-POST-instance__section_z23_pzr_cmb} バージョニングされた URL: /api/now/{api_version}/cmdb/instance/{className} デフォルト URL: /api/now/cmdb/instance/{className} 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#cmdb-POST-instance__entry__2}{#cmdb-POST-instance__entry-className-cmdb} | 名前 | 説明 | |-|-| | className | CMDB クラス名。これは、cmdb_ci_linux_server や cmdb_ci_apache_web_server などの目的の CI レコードを含むテーブルの名前です。 データタイプ：文字列 | [表 : 20. パスパラメーター] {#cmdb-POST-instance__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 21. クエリパラメーター] {#cmdb-POST-instance__entry__10}{#cmdb-POST-instance__entry-attributes-cmdb}{#cmdb-POST-instance__entry-inbound_relations-cmdb}{#cmdb-POST-instance__entry-inbound_relations_target-cmdb}{#cmdb-POST-instance__entry-inbound_relations_type-cmdb}{#cmdb-POST-instance__entry-request-outbound_relations_target-cmdb}{#cmdb-POST-instance__entry-request-outbound_relations_type-cmdb}{#cmdb-POST-instance__entry-source-cmdb} | 名前 | 説明 | |-|-| | 属性 | CI レコードで定義するデータ属性。使用可能な属性は、指定された CMDB クラスによって異なります。利用可能な属性は、cmdb_ci_linux_server や cmdb_ci_mfp_printer など、通常は「cmdb_ci」で始まる関連する CMDB テーブルにあります。 データタイプ: オブジェクト | | inbound_relations | CI に関連付ける受信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "inbound_relations": [ { "target": "String", "type": "String" } ] | | inbound_relations.target | inbound_relationsが指定されている場合は必須です。指定された CI に関連付けるターゲット受信関係のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.type | inbound_relationsが指定されている場合は必須です。受信リレーションシップのタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | outbound_relations | CI に関連付ける送信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "outbound_relations": [ { "target": "String", "type": "String" } ] | | outbound_relations.target | outbound_relationsが指定されている場合は必須です。ターゲット送信関係のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.type | outbound_relationsが指定されている場合は必須です。送信関係のタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | ソース | 必須です。情報を更新したエンティティ。これは、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドで指定された選択値のいずれかである必要があります。 データタイプ：文字列 | [表 : 22. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#cmdb-POST-instance__entry__28}{#cmdb-POST-instance__accept-RESTAPI}{#cmdb-POST-instance__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 23. 要求ヘッダー] {#cmdb-POST-instance__entry__34} | ヘッダー | 説明 | |-|-| | なし | | [表 : 24. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#cmdb-POST-instance__entry__38}{#cmdb-POST-instance__entry-200-status-code}{#cmdb-POST-instance__entry-400-status-code}{#cmdb-POST-instance__entry-401-status-code}{#cmdb-POST-instance__entry-404-status-code}{#cmdb-POST-instance__entry-405-status-code}{#cmdb-POST-instance__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 405 | メソッドが無効です。機能が無効になっています。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 25. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#cmdb-POST-instance__table_ags_gn4_3mb__entry__2}{#cmdb-POST-instance__entry-result-error-cmdb-ph}{#cmdb-POST-instance__entry-result-error_detail-cmdb}{#cmdb-POST-instance__entry-result-error_message-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_sys_id-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_target-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_target_display_value-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_target_link-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_target_value-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_type-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_type_display_value-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_type_link-cmdb}{#cmdb-POST-instance__entry-result-inbound_relations_type_value-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_sys_id-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_target-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_target_display_value-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_target_link-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_target_value-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_type-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_type_display_value-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_type_link-cmdb}{#cmdb-POST-instance__entry-result-outbound_relations_type_value-cmdb}{#cmdb-POST-instance__entry-result-status-cmdb} | 名前 | 説明 | |-|-| | 属性 | 現在 CI レコードにあるデータ属性。使用可能な属性は、指定された CMDB クラスによって異なります。利用可能な属性は、cmdb_ci_linux_server や cmdb_ci_mfp_printer など、通常は「cmdb_ci」で始まる関連する CMDB テーブルにあります。 データタイプ: オブジェクト | | エラー | エンドポイント要求の処理中に発生したエラーに関する情報。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | エラーに関する追加情報。 データタイプ：文字列 | | error.message | エラーを特定するメッセージ。 データタイプ：文字列 | | inbound_relations | CI に関連付けられた受信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | inbound_relations.sys_id | 受信 CI 関係のSys_id。CI 関係 \[cmdb_rel_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.target | ターゲット受信関係を説明する情報。 データタイプ: オブジェクト "target": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.target.display_value | ユーザーインターフェイスに表示する受信関係の名前。 データタイプ：文字列 | | inbound_relations.target.link | CMDB 構成アイテム \[cmdb_ci\] テーブルから受信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | inbound_relations.target.value | 受信 CI のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.type | 受信関係のタイプに関する情報。 データタイプ: オブジェクト "type": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.type.display_value | ユーザーインターフェイスに表示する受信タイプの名前。 データタイプ：文字列 | | inbound_relations.type.link | テーブル CI 関係性タイプ \[cmdb_rel_type\] テーブルから受信関係タイプを取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | inbound_relations.type.value | 受信リレーションシップのタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | outbound_relations | CI に関連付けられた送信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | outbound_relations.sys_id | アウトバウント CI 関係のSys_id。CI 関係 \[cmdb_rel_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.target | 必須です。ターゲット送信関係に関する情報。 データタイプ: オブジェクト "target": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.target.display_value | ユーザーインターフェイスに表示する送信関係の名前。 データタイプ：文字列 | | outbound_relations.target.link | CMDB 構成アイテム \[cmdb_ci\] テーブルから送信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | outbound_relations.target.value | 送信 CI のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.type | 送信関係のタイプに関する情報。 データタイプ: オブジェクト "type": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.type.display_value | ユーザーインターフェイスに表示する送信タイプの名前。 データタイプ：文字列 | | outbound_relations.type.link | テーブル CI 関係性タイプ \[cmdb_rel_type\] テーブルから送信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | outbound_relations.type.value | 送信関係のタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | status | エラーが発生した場合にのみ表示されます。エンドポイント処理のステータス。 可能な値:失敗 データタイプ：文字列 | [表 : 26. 応答パラメーター] {#cmdb-POST-instance__table_ags_gn4_3mb} ### cURL 要求 次のコード例は、このエンドポイントを呼び出す方法を示しています。 curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password" \ --data { "outbound_relations": [ { "type" : "1a9cb166f1571100a92eb60da2bce5c5", "target" : "3a307c930a0a0bb400353965d0b8861f" }, { "type" : "607ad1b2c0a8010e01941856b365af90", "target" : "3a307c930a0a0bb400353965d0b8861f" } ], "attributes": { "name" : "lnux999", "firewall_status": "Intranet" }, "source": "ServiceNow", "inbound_relations": [ { "type" : "1a9cb166f1571100a92eb60da2bce5c5", "target" : "3a27d4370a0a0bb4006316812bf45439" } ] } { "result": { "outbound_relations": [ { "sys_id": "403ff2641b425010593876a61a4bcb4b", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } }, { "sys_id": "443ff2641b425010593876a61a4bcb4c", "type": { "display_value": "Exchanges data with::Exchanges data with", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90", "value": "607ad1b2c0a8010e01941856b365af90" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } } ], "attributes": { "firewall_status": "Intranet", "os_address_width": "", "attested_date": "", "operational_status": "1", "os_service_pack": "", "cpu_core_thread": "", "cpu_manufacturer": "", "sys_updated_on": "2020-07-13 20:27:28", "discovery_source": "ServiceNow", "first_discovered": "2020-07-13 20:27:28", "due_in": "", "used_for": "Production", "invoice_number": "", "gl_account": "", "sys_created_by": "dora.gray", "warranty_expiration": "", "ram": "", "cpu_name": "", "cpu_speed": "", "owned_by": "", "checked_out": "", "kernel_release": "", "sys_domain_path": "/", "classification": "Production", "disk_space": "", "object_id": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "cd_speed": "", "floppy": "", "managed_by": "", "os_domain": "", "last_discovered": "2020-07-13 20:27:28", "can_print": "false", "sys_class_name": "cmdb_ci_linux_server", "manufacturer": "", "cpu_count": "", "vendor": "", "life_cycle_stage_status": "", "model_number": "", "assigned_to": "", "start_date": "", "os_version": "", "serial_number": "", "cd_rom": "false", "support_group": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": "", "form_factor": "", "cpu_core_count": "", "skip_sync": "false", "attestation_score": "", "sys_updated_by": "dora.gray", "sys_created_on": "2020-07-13 20:27:28", "sys_domain": { "display_value": "global", "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global" }, "cpu_type": "", "install_date": "", "asset_tag": "", "dr_backup": "", "hardware_substatus": "", "fqdn": "", "change_control": "", "internet_facing": "true", "delivery_date": "", "hardware_status": "installed", "install_status": "1", "supported_by": "", "name": "lnux299", "subcategory": "Computer", "default_gateway": "", "chassis_type": "", "virtual": "false", "assignment_group": "", "managed_by_group": "", "sys_id": "0c3ff2641b425010593876a61a4bcb39", "po_number": "", "checked_in": "", "sys_class_path": "/!!/!2/!(/!!/!0", "mac_address": "", "company": "", "justification": "", "department": "", "cost": "", "comments": "", "os": "", "sys_mod_count": "0", "monitor": "false", "model_id": "", "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": "", "category": "Hardware", "fault_count": "0", "host_name": "", "lease_id": "" }, "inbound_relations": [ { "sys_id": "c03ff2641b425010593876a61a4bcb49", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439", "value": "3a27d4370a0a0bb4006316812bf45439" } } ] } } ### cURL 要求 {#cmdb-POST-instance__example_bbs_f4y_3xb} 次のコード例は、依存識別ルールが定義されているクラスに対してこのエンドポイントを呼び出す方法を示しています。outbound_relations.targetはペイロードに含まれ、既存の CI のsys_idが含まれている必要があります。 curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password" \ --data { "attributes": { "name": "test", "sys_class_name":"cmdb_ci_db_mssql_instance", "instance_name":"Iname" }, "source": "ServiceNow", "depends_on": { "outbound_relations": { "target": "b4fd7c8437201000deeabfc8bcbe5dc1", "type": "60bc4e22c0a8010e01f074cbe6bd73c3" } } } } { "result": { "outbound_relations": [ { "sys_id": "505cfa3a53662110af64ddeeff7b1217", "type": { "display_value": "Runs on::Runs", "link": http://instance.servicenow.com/api/now/table/cmdb_rel_type/60bc4e22c0a8010e01f074cbe6bd73c3, "value": "60bc4e22c0a8010e01f074cbe6bd73c3" }, "target": { "display_value": "*ANNIE-IBM", "link": http://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/b4fd7c8437201000deeabfc8bcbe5dc1, "value": "b4fd7c8437201000deeabfc8bcbe5dc1" } } ], "attributes": { "attested_date": "", "operational_status": "1", "running_process_command": "", "sys_updated_on": "2023-05-05 21:28:24", "type": "", "running_process_key_parameters": "", "rp_command_hash": "", "discovery_source": "ServiceNow", "first_discovered": "2023-05-05 21:28:24", "due_in": "", "service_pack": "", "used_for": "Production", "is_clustered": "false", "invoice_number": "", "gl_account": "", "sys_created_by": "admin", "warranty_expiration": "", "owned_by": "", "checked_out": "", "rp_key_parameters_hash": "", "sys_domain_path": "/", "business_unit": "", "version": "", "cpu_sockets": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "managed_by": "", "port_dynamic": "false", "last_discovered": "2023-05-05 21:28:24", "can_print": "false", "sys_class_name": "cmdb_ci_db_mssql_instance", "manufacturer": "", "cl_port": "", "vendor": "", "life_cycle_stage_status": "", "model_number": "", "config_file": "", "assigned_to": "", "start_date": "", "instance_name": "Iname", "serial_number": "", "engine_edition": "", "support_group": "", "version_name": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": "", "config_directory": "", "tcp_port": "", "listener_name": "", "skip_sync": "false", "pid": "", "attestation_score": "", "sys_updated_by": "admin", "install_directory": "", "sys_created_on": "2023-05-05 21:28:24", "sys_domain": { "display_value": "global", "link": http://instance.servicenow.com/api/now/table/sys_user_group/global, "value": "global" }, "install_date": "", "asset_tag": "", "fqdn": "", "change_control": "", "delivery_date": "", "install_status": "1", "supported_by": "", "name": "test", "subcategory": "Database", "assignment_group": "", "edition": "", "managed_by_group": "", "sys_id": "185cba3a53662110af64ddeeff7b12af", "po_number": "", "database": "", "checked_in": "", "sys_class_path": "/!!/!(/!2/!,", "mac_address": "", "company": "", "justification": "", "department": "", "cost": "", "comments": "", "attestation_status": "Not Yet Reviewed", "sys_mod_count": "0", "monitor": "false", "model_id": "", "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": "", "category": "Resource", "fault_count": "0", "lease_id": "" }, "inbound_relations": [] } } ### cURL 要求 {#cmdb-POST-instance__example_gj4_45b_kxb} 次のコード例は、依存識別ルールが定義されているクラスに対してsys_idが渡されない場合に返される内容を示しています。sys_idが無効な場合も、同じ結果が発生します。 curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password" \ --data "{ "attributes": { "name": "test", "sys_class_name":"cmdb_ci_db_mssql_instance", "instance_name":"Iname" }, "source": "ServiceNow", "depends_on": { "outbound_relations": { "type": "60bc4e22c0a8010e01f074cbe6bd73c3" } } } { "error": { "detail": "Exception while executing request: null Check logs for error trace or enable glide.rest.debug property to verify REST request processing", "message": "Exception while executing request: null" }, "status": "failure" } ## CMDB インスタンス:PUT /now/cmdb/instance/{classname}/{sys_id} {#ariaid-title6} 指定された構成アイテム (CI) レコードを、指定された属性の名前と値のペアで更新します。このエンドポイントは、関連する関係を作成、更新、または削除しません。 注: このエンドポイントは HTML 仕様に準拠していません。標準の PUT エンドポイントは、要求に含まれていない要素を削除するという点で破壊的です。このエンドポイントは、指定されていない要素を削除しません。 ### URL 形式 {#cmdb-PUT-instance__section_o2s_nms_cmb} バージョニングされた URL: /api/now/{api_version}/cmdb/instance/{className}/{sys_id} デフォルト URL: /api/now/cmdb/instance/{className}/{sys_id} 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#cmdb-PUT-instance__entry__2}{#cmdb-PUT-instance__entry-className-cmdb}{#cmdb-PUT-instance__entry-sys_id-cmdb} | 名前 | 説明 | |-|-| | className | CMDB クラス名。これは、cmdb_ci_linux_server や cmdb_ci_apache_web_server などの目的の CI レコードを含むテーブルの名前です。 データタイプ：文字列 | | sys_id | 更新する CI レコードのSys_id。 データタイプ：文字列 | [表 : 27. パスパラメーター] {#cmdb-PUT-instance__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 28. クエリパラメーター] {#cmdb-PUT-instance__entry__12}{#cmdb-PUT-instance__entry-attributes-cmdb}{#cmdb-PUT-instance__entry-source-cmdb} | 名前 | 説明 | |-|-| | 属性 | CI レコードで置き換えるデータ属性。使用可能な属性は、指定された CMDB クラスによって異なります。利用可能な属性は、cmdb_ci_linux_server や cmdb_ci_mfp_printer など、通常は「cmdb_ci」で始まる関連する CMDB テーブルにあります。 証明書の詳細については、「 [CIs attestation](https://www.servicenow.com/docs/access?context=attesting-cis&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」を参照してください。 データタイプ: オブジェクト | | ソース | 必須です。情報を更新したエンティティ。これは、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドで指定された選択値のいずれかである必要があります。 データタイプ：文字列 | [表 : 29. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#cmdb-PUT-instance__entry__18}{#cmdb-PUT-instance__accept-RESTAPI}{#cmdb-PUT-instance__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 30. 要求ヘッダー] {#cmdb-PUT-instance__entry__24} | ヘッダー | 説明 | |-|-| | なし | | [表 : 31. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#cmdb-PUT-instance__entry__28}{#cmdb-PUT-instance__entry-200-status-code}{#cmdb-PUT-instance__entry-400-status-code}{#cmdb-PUT-instance__entry-401-status-code}{#cmdb-PUT-instance__entry-404-status-code}{#cmdb-PUT-instance__entry-405-status-code}{#cmdb-PUT-instance__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 405 | メソッドが無効です。機能が無効になっています。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 32. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#cmdb-PUT-instance__table_ens_hq4_3mb__entry__2}{#cmdb-PUT-instance__entry-result-error-cmdb-ph}{#cmdb-PUT-instance__entry-result-error_detail-cmdb}{#cmdb-PUT-instance__entry-result-error_message-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_sys_id-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_target-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_target_display_value-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_target_link-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_target_value-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_type-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_type_display_value-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_type_link-cmdb}{#cmdb-PUT-instance__entry-result-inbound_relations_type_value-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_sys_id-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_target-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_target_display_value-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_target_link-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_target_value-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_type-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_type_display_value-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_type_link-cmdb}{#cmdb-PUT-instance__entry-result-outbound_relations_type_value-cmdb}{#cmdb-PUT-instance__entry-result-status-cmdb} | 名前 | 説明 | |-|-| | 属性 | 現在 CI レコードにあるデータ属性。使用可能な属性は、指定された CMDB クラスによって異なります。利用可能な属性は、cmdb_ci_linux_server や cmdb_ci_mfp_printer など、通常は「cmdb_ci」で始まる関連する CMDB テーブルにあります。 データタイプ: オブジェクト | | エラー | エンドポイント要求の処理中に発生したエラーに関する情報。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | エラーに関する追加情報。 データタイプ：文字列 | | error.message | エラーを特定するメッセージ。 データタイプ：文字列 | | inbound_relations | CI に関連付けられた受信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | inbound_relations.sys_id | 受信 CI 関係のSys_id。CI 関係 \[cmdb_rel_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.target | ターゲット受信関係を説明する情報。 データタイプ: オブジェクト "target": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.target.display_value | ユーザーインターフェイスに表示する受信関係の名前。 データタイプ：文字列 | | inbound_relations.target.link | CMDB 構成アイテム \[cmdb_ci\] テーブルから受信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | inbound_relations.target.value | 受信 CI のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.type | 受信関係のタイプに関する情報。 データタイプ: オブジェクト "type": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.type.display_value | ユーザーインターフェイスに表示する受信タイプの名前。 データタイプ：文字列 | | inbound_relations.type.link | テーブル CI 関係性タイプ \[cmdb_rel_type\] テーブルから受信関係タイプを取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | inbound_relations.type.value | 受信リレーションシップのタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | outbound_relations | CI に関連付けられた送信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | outbound_relations.sys_id | アウトバウント CI 関係のSys_id。CI 関係 \[cmdb_rel_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.target | 必須です。ターゲット送信関係に関する情報。 データタイプ: オブジェクト "target": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.target.display_value | ユーザーインターフェイスに表示する送信関係の名前。 データタイプ：文字列 | | outbound_relations.target.link | CMDB 構成アイテム \[cmdb_ci\] テーブルから送信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | outbound_relations.target.value | 送信 CI のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.type | 送信関係のタイプに関する情報。 データタイプ: オブジェクト "type": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.type.display_value | ユーザーインターフェイスに表示する送信タイプの名前。 データタイプ：文字列 | | outbound_relations.type.link | テーブル CI 関係性タイプ \[cmdb_rel_type\] テーブルから送信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | outbound_relations.type.value | 送信関係のタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | status | エラーが発生した場合にのみ表示されます。エンドポイント処理のステータス。 可能な値:失敗 データタイプ：文字列 | [表 : 33. 応答パラメーター] {#cmdb-PUT-instance__table_ens_hq4_3mb} ### cURL 要求のサンプル curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/70bc4e11c0a8210d01f074cbe6bd73b4" \ --request PUT \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password" \ --data { "attributes": { "firewall_status": "Extranet", "discovery_source": "ServiceNows", "name": "Linux299", "used_for": "Pre-production", "container": "Box" }, "source": "ServiceNow" } { "result": { "outbound_relations": [ { "sys_id": "403ff2641b425010593876a61a4bcb4b", "type": { "display_value": "Depends on::Used by", "link": "https://instance.service-now.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS ORA01", "link": "https://instance.service-now.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } }, { "sys_id": "443ff2641b425010593876a61a4bcb4c", "type": { "display_value": "Exchanges data with::Exchanges data with", "link": "https://instance.service-now.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90", "value": "607ad1b2c0a8010e01941856b365af90" }, "target": { "display_value": "PS ORA01", "link": "https://instance.service-now.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } } ], "attributes": { "firewall_status": "Extranet", "os_address_width": "", "attested_date": "", "operational_status": "1", "os_service_pack": "", "cpu_core_thread": "", "cpu_manufacturer": "", "sys_updated_on": "2020-07-13 20:59:40", "discovery_source": "ServiceNow", "first_discovered": "2020-07-13 20:27:28", "due_in": "", "used_for": "Pre-production", "invoice_number": "", "gl_account": "", "sys_created_by": "dora.gray", "warranty_expiration": "", "ram": "", "cpu_name": "", "cpu_speed": "", "owned_by": "", "checked_out": "", "kernel_release": "", "sys_domain_path": "/", "classification": "Production", "disk_space": "", "object_id": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "cd_speed": "", "floppy": "", "managed_by": "", "os_domain": "", "last_discovered": "2020-07-13 20:59:40", "can_print": "false", "sys_class_name": "cmdb_ci_linux_server", "manufacturer": "", "cpu_count": "", "vendor": "", "life_cycle_stage_status": "", "model_number": "", "assigned_to": "", "start_date": "", "os_version": "", "serial_number": "", "cd_rom": "false", "support_group": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": { "display_value": "Unknown", "link": "https://instance.service-now.com/api/now/table/alm_asset/21cfba641b425010593876a61a4bcb52", "value": "21cfba641b425010593876a61a4bcb52" }, "form_factor": "", "cpu_core_count": "", "skip_sync": "false", "attestation_score": "", "sys_updated_by": "dora.gray", "sys_created_on": "2020-07-13 20:27:28", "sys_domain": { "display_value": "global", "link": "https://instance.service-now.com/api/now/table/sys_user_group/global", "value": "global" }, "cpu_type": "", "install_date": "", "asset_tag": "", "dr_backup": "", "hardware_substatus": "", "fqdn": "", "change_control": "", "internet_facing": "true", "delivery_date": "", "hardware_status": "installed", "install_status": "1", "supported_by": "", "name": "Linux299", "subcategory": "Computer", "default_gateway": "", "chassis_type": "", "virtual": "false", "assignment_group": "", "managed_by_group": "", "sys_id": "0c3ff2641b425010593876a61a4bcb39", "po_number": "", "checked_in": "", "sys_class_path": "/!!/!2/!(/!!/!0", "mac_address": "", "company": "", "justification": "", "department": "", "cost": "", "comments": "", "os": "", "sys_mod_count": "3", "monitor": "false", "model_id": { "display_value": "Unknown", "link": "https://instance.service-now.com/api/now/table/cmdb_model/0ce0a2681b4e1010593876a61a4bcba6", "value": "0ce0a2681b4e1010593876a61a4bcba6" }, "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": "", "category": "Hardware", "fault_count": "0", "host_name": "", "lease_id": "" }, "inbound_relations": [ { "sys_id": "c03ff2641b425010593876a61a4bcb49", "type": { "display_value": "Depends on::Used by", "link": "https://instance.service-now.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache01", "link": "https://instance.service-now.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439", "value": "3a27d4370a0a0bb4006316812bf45439" } } ] } } ## CMDB インスタンス:POST /now/cmdb/instance/{classname}/{sys_id}/relation {#ariaid-title7} 指定された構成アイテム (CI) に受信関係や送信関係 (あるいはその両方) を追加します。指定された CI が親です。 ### URL 形式 {#cmdb-POST-instance-relation__section_hz1_mgs_cmb} バージョニングされた URL: /api/now/{api_version}/cmdb/instance/{className}/{sys_id}/relation デフォルト URL: /api/now/cmdb/instance/{className}/{sys_id}/relation 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#cmdb-POST-instance-relation__entry__2}{#cmdb-POST-instance-relation__entry-className-cmdb}{#cmdb-POST-instance-relation__entry-sys_id-cmdb} | 名前 | 説明 | |-|-| | className | CMDB クラス名。これは、cmdb_ci_linux_server や cmdb_ci_apache_web_server などの目的の CI レコードを含むテーブルの名前です。 データタイプ：文字列 | | sys_id | 更新する CI レコードのSys_id。 データタイプ：文字列 | [表 : 34. パスパラメーター] {#cmdb-POST-instance-relation__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 35. クエリパラメーター] {#cmdb-POST-instance-relation__entry__12}{#cmdb-POST-instance-relation__entry-inbound_relations-cmdb}{#cmdb-POST-instance-relation__entry-inbound_relations_target-cmdb}{#cmdb-POST-instance-relation__entry-inbound_relations_type-cmdb}{#cmdb-POST-instance-relation__entry-outbound_relations-cmdb}{#cmdb-POST-instance-relation__entry-request-outbound_relations_target-cmdb}{#cmdb-POST-instance-relation__entry-request-outbound_relations_type-cmdb}{#cmdb-POST-instance-relation__entry-source-cmdb} | 名前 | 説明 | |-|-| | inbound_relations | CI に関連付ける受信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "inbound_relations": [ { "target": "String", "type": "String" } ] | | inbound_relations.target | inbound_relationsが指定されている場合は必須です。指定された CI に関連付けるターゲット受信関係のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.type | inbound_relationsが指定されている場合は必須です。受信リレーションシップのタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | outbound_relations | CI に関連付ける送信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "outbound_relations": [ { "target": "String", "type": "String" } ] | | outbound_relations.target | outbound_relationsが指定されている場合は必須です。ターゲット送信関係のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.type | outbound_relationsが指定されている場合は必須です。送信関係のタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | ソース | 必須です。情報を更新したエンティティ。これは、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドで指定された選択値のいずれかである必要があります。 データタイプ：文字列 | [表 : 36. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#cmdb-POST-instance-relation__entry__28}{#cmdb-POST-instance-relation__accept-RESTAPI}{#cmdb-POST-instance-relation__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 37. 要求ヘッダー] {#cmdb-POST-instance-relation__entry__34} | ヘッダー | 説明 | |-|-| | なし | | [表 : 38. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#cmdb-POST-instance-relation__entry__38}{#cmdb-POST-instance-relation__entry-200-status-code}{#cmdb-POST-instance-relation__entry-400-status-code}{#cmdb-POST-instance-relation__entry-401-status-code}{#cmdb-POST-instance-relation__entry-404-status-code}{#cmdb-POST-instance-relation__entry-405-status-code}{#cmdb-POST-instance-relation__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 405 | メソッドが無効です。機能が無効になっています。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 39. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#cmdb-POST-instance-relation__table_hj2_qn4_3mb__entry__2}{#cmdb-POST-instance-relation__entry-result-error-cmdb-ph}{#cmdb-POST-instance-relation__entry-result-error_detail-cmdb}{#cmdb-POST-instance-relation__entry-result-error_message-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_sys_id-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_target-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_target_display_value-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_target_link-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_target_value-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_type-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_type_display_value-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_type_link-cmdb}{#cmdb-POST-instance-relation__entry-result-inbound_relations_type_value-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_sys_id-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_target-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_target_display_value-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_target_link-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_target_value-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_type-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_type_display_value-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_type_link-cmdb}{#cmdb-POST-instance-relation__entry-result-outbound_relations_type_value-cmdb}{#cmdb-POST-instance-relation__entry-result-status-cmdb} | 名前 | 説明 | |-|-| | 属性 | 現在 CI レコードにあるデータ属性。使用可能な属性は、指定された CMDB クラスによって異なります。利用可能な属性は、cmdb_ci_linux_server や cmdb_ci_mfp_printer など、通常は「cmdb_ci」で始まる関連する CMDB テーブルにあります。 データタイプ: オブジェクト | | エラー | エンドポイント要求の処理中に発生したエラーに関する情報。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | エラーに関する追加情報。 データタイプ：文字列 | | error.message | エラーを特定するメッセージ。 データタイプ：文字列 | | inbound_relations | CI に関連付けられた受信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | inbound_relations.sys_id | 受信 CI 関係のSys_id。CI 関係 \[cmdb_rel_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.target | ターゲット受信関係を説明する情報。 データタイプ: オブジェクト "target": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.target.display_value | ユーザーインターフェイスに表示する受信関係の名前。 データタイプ：文字列 | | inbound_relations.target.link | CMDB 構成アイテム \[cmdb_ci\] テーブルから受信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | inbound_relations.target.value | 受信 CI のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.type | 受信関係のタイプに関する情報。 データタイプ: オブジェクト "type": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.type.display_value | ユーザーインターフェイスに表示する受信タイプの名前。 データタイプ：文字列 | | inbound_relations.type.link | テーブル CI 関係性タイプ \[cmdb_rel_type\] テーブルから受信関係タイプを取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | inbound_relations.type.value | 受信リレーションシップのタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | outbound_relations | CI に関連付けられた送信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | outbound_relations.sys_id | アウトバウント CI 関係のSys_id。CI 関係 \[cmdb_rel_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.target | 必須です。ターゲット送信関係に関する情報。 データタイプ: オブジェクト "target": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.target.display_value | ユーザーインターフェイスに表示する送信関係の名前。 データタイプ：文字列 | | outbound_relations.target.link | CMDB 構成アイテム \[cmdb_ci\] テーブルから送信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | outbound_relations.target.value | 送信 CI のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.type | 送信関係のタイプに関する情報。 データタイプ: オブジェクト "type": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.type.display_value | ユーザーインターフェイスに表示する送信タイプの名前。 データタイプ：文字列 | | outbound_relations.type.link | テーブル CI 関係性タイプ \[cmdb_rel_type\] テーブルから送信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | outbound_relations.type.value | 送信関係のタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | status | エラーが発生した場合にのみ表示されます。エンドポイント処理のステータス。 可能な値:失敗 データタイプ：文字列 | [表 : 40. 応答パラメーター] {#cmdb-POST-instance-relation__table_hj2_qn4_3mb} ### cURL 要求のサンプル curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/3a290cc60a0a0bb400000bdb386af1cf/relation" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password" \ --data { "outbound_relations": [ { "type" : "1a9cb166f1571100a92eb60da2bce5c5", "target" : "3a307c930a0a0bb400353965d0b8861f" }, { "type" : "607ad1b2c0a8010e01941856b365af90", "target" : "3a307c930a0a0bb400353965d0b8861f" } ], "source": "ServiceNow", "inbound_relations": [ { "type" : "1a9cb166f1571100a92eb60da2bce5c5", "target" : "3a27d4370a0a0bb4006316812bf45439" } ] } { "result": { "outbound_relations": [ { "sys_id": "403ff2641b425010593876a61a4bcb4b", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } }, { "sys_id": "443ff2641b425010593876a61a4bcb4c", "type": { "display_value": "Exchanges data with::Exchanges data with", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90", "value": "607ad1b2c0a8010e01941856b365af90" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } } ], "attributes": { "firewall_status": "Active", "os_address_width": "", "attested_date": "", "operational_status": "1", "os_service_pack": "", "cpu_core_thread": "", "cpu_manufacturer": "", "sys_updated_on": "2020-07-13 21:24:05", "discovery_source": "ServiceNow", "first_discovered": "2020-07-13 20:27:28", "due_in": "", "used_for": "Production", "invoice_number": "", "gl_account": "", "sys_created_by": "dora.gray", "warranty_expiration": "", "ram": "", "cpu_name": "", "cpu_speed": "", "owned_by": "", "checked_out": "", "kernel_release": "", "sys_domain_path": "/", "classification": "Production", "disk_space": "", "object_id": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "cd_speed": "", "floppy": "", "managed_by": "", "os_domain": "", "last_discovered": "2020-07-13 21:24:05", "can_print": "false", "sys_class_name": "cmdb_ci_linux_server", "manufacturer": "", "cpu_count": "", "vendor": "", "life_cycle_stage_status": "", "model_number": "", "assigned_to": "", "start_date": "", "os_version": "", "serial_number": "", "cd_rom": "false", "support_group": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": { "display_value": "Unknown", "link": "https://instance.servicenow.com/api/now/table/alm_asset/21cfba641b425010593876a61a4bcb52", "value": "21cfba641b425010593876a61a4bcb52" }, "form_factor": "", "cpu_core_count": "", "skip_sync": "false", "attestation_score": "", "sys_updated_by": "dora.gray", "sys_created_on": "2020-07-13 20:27:28", "sys_domain": { "display_value": "global", "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global" }, "cpu_type": "", "install_date": "", "asset_tag": "", "dr_backup": "", "hardware_substatus": "", "fqdn": "", "change_control": "", "internet_facing": "true", "delivery_date": "", "hardware_status": "installed", "install_status": "1", "supported_by": "", "name": "Linux299", "subcategory": "Computer", "default_gateway": "", "chassis_type": "", "virtual": "false", "assignment_group": "", "managed_by_group": "", "sys_id": "0c3ff2641b425010593876a61a4bcb39", "po_number": "", "checked_in": "", "sys_class_path": "/!!/!2/!(/!!/!0", "mac_address": "", "company": "", "justification": "", "department": "", "cost": "", "comments": "", "os": "", "sys_mod_count": "4", "monitor": "false", "model_id": { "display_value": "Unknown", "link": "https://instance.servicenow.com/api/now/table/cmdb_model/0ce0a2681b4e1010593876a61a4bcba6", "value": "0ce0a2681b4e1010593876a61a4bcba6" }, "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": "", "category": "Hardware", "fault_count": "0", "host_name": "", "lease_id": "" }, "inbound_relations": [ { "sys_id": "c03ff2641b425010593876a61a4bcb49", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439", "value": "3a27d4370a0a0bb4006316812bf45439" } } ] } } ## CMDB インスタンス:PATCH /now/cmdb/instance/{classname}/{sys_id} {#ariaid-title8} 指定された構成アイテム (CI) レコードの属性を、指定された名前と値のペアに置き換えます。このエンドポイントは、関連する関係を作成、更新、または削除しません。 ### URL 形式 {#cmdb-PATCH-instance__section_w3r_dxr_cmb} バージョニングされた URL: /api/now/{api_version}/cmdb/instance/{className}/{sys_id} デフォルト URL: /api/now/cmdb/instance/{className}/{sys_id} 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#cmdb-PATCH-instance__entry__2}{#cmdb-PATCH-instance__entry-className-cmdb}{#cmdb-PATCH-instance__entry-sys_id-cmdb} | 名前 | 説明 | |-|-| | className | CMDB クラス名。これは、cmdb_ci_linux_server や cmdb_ci_apache_web_server などの目的の CI レコードを含むテーブルの名前です。 データタイプ：文字列 | | sys_id | 更新する CI レコードのSys_id。 データタイプ：文字列 | [表 : 41. パスパラメーター] {#cmdb-PATCH-instance__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 42. クエリパラメーター] {#cmdb-PATCH-instance__entry__12}{#cmdb-PATCH-instance__entry-attributes-cmdb}{#cmdb-PATCH-instance__entry-source-cmdb} | 名前 | 説明 | |-|-| | 属性 | CI レコードで置き換えるデータ属性。使用可能な属性は、指定された CMDB クラスによって異なります。利用可能な属性は、cmdb_ci_linux_server や cmdb_ci_mfp_printer など、通常は「cmdb_ci」で始まる関連する CMDB テーブルにあります。 証明書の詳細については、「 [CIs attestation](https://www.servicenow.com/docs/access?context=attesting-cis&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」を参照してください。 データタイプ: オブジェクト | | ソース | 必須です。情報を更新したエンティティ。これは、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドで指定された選択値のいずれかである必要があります。 データタイプ：文字列 | [表 : 43. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#cmdb-PATCH-instance__entry__18}{#cmdb-PATCH-instance__accept-RESTAPI}{#cmdb-PATCH-instance__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 44. 要求ヘッダー] {#cmdb-PATCH-instance__entry__24} | ヘッダー | 説明 | |-|-| | なし | | [表 : 45. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#cmdb-PATCH-instance__entry__28}{#cmdb-PATCH-instance__entry-200-status-code}{#cmdb-PATCH-instance__entry-400-status-code}{#cmdb-PATCH-instance__entry-401-status-code}{#cmdb-PATCH-instance__entry-404-status-code}{#cmdb-PATCH-instance__entry-405-status-code}{#cmdb-PATCH-instance__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 405 | メソッドが無効です。機能が無効になっています。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 46. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#cmdb-PATCH-instance__table_ojn_3n4_3mb__entry__2}{#cmdb-PATCH-instance__entry-result-error-cmdb-ph}{#cmdb-PATCH-instance__entry-result-error_detail-cmdb}{#cmdb-PATCH-instance__entry-result-error_message-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_sys_id-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_target-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_target_display_value-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_target_link-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_target_value-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_type-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_type_display_value-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_type_link-cmdb}{#cmdb-PATCH-instance__entry-result-inbound_relations_type_value-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_sys_id-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_target-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_target_display_value-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_target_link-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_target_value-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_type-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_type_display_value-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_type_link-cmdb}{#cmdb-PATCH-instance__entry-result-outbound_relations_type_value-cmdb}{#cmdb-PATCH-instance__entry-result-status-cmdb} | 名前 | 説明 | |-|-| | 属性 | 現在 CI レコードにあるデータ属性。使用可能な属性は、指定された CMDB クラスによって異なります。利用可能な属性は、cmdb_ci_linux_server や cmdb_ci_mfp_printer など、通常は「cmdb_ci」で始まる関連する CMDB テーブルにあります。 データタイプ: オブジェクト | | エラー | エンドポイント要求の処理中に発生したエラーに関する情報。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | エラーに関する追加情報。 データタイプ：文字列 | | error.message | エラーを特定するメッセージ。 データタイプ：文字列 | | inbound_relations | CI に関連付けられた受信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | inbound_relations.sys_id | 受信 CI 関係のSys_id。CI 関係 \[cmdb_rel_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.target | ターゲット受信関係を説明する情報。 データタイプ: オブジェクト "target": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.target.display_value | ユーザーインターフェイスに表示する受信関係の名前。 データタイプ：文字列 | | inbound_relations.target.link | CMDB 構成アイテム \[cmdb_ci\] テーブルから受信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | inbound_relations.target.value | 受信 CI のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | inbound_relations.type | 受信関係のタイプに関する情報。 データタイプ: オブジェクト "type": { "display_value": "String", "link": "String", "value": "String" } | | inbound_relations.type.display_value | ユーザーインターフェイスに表示する受信タイプの名前。 データタイプ：文字列 | | inbound_relations.type.link | テーブル CI 関係性タイプ \[cmdb_rel_type\] テーブルから受信関係タイプを取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | inbound_relations.type.value | 受信リレーションシップのタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | outbound_relations | CI に関連付けられた送信関係を定義するオブジェクトのリスト。 データタイプ：アレイ "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ] | | outbound_relations.sys_id | アウトバウント CI 関係のSys_id。CI 関係 \[cmdb_rel_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.target | 必須です。ターゲット送信関係に関する情報。 データタイプ: オブジェクト "target": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.target.display_value | ユーザーインターフェイスに表示する送信関係の名前。 データタイプ：文字列 | | outbound_relations.target.link | CMDB 構成アイテム \[cmdb_ci\] テーブルから送信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | outbound_relations.target.value | 送信 CI のSys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | outbound_relations.type | 送信関係のタイプに関する情報。 データタイプ: オブジェクト "type": { "display_value": "String", "link": "String", "value": "String" } | | outbound_relations.type.display_value | ユーザーインターフェイスに表示する送信タイプの名前。 データタイプ：文字列 | | outbound_relations.type.link | テーブル CI 関係性タイプ \[cmdb_rel_type\] テーブルから送信関係を取得するために使用する REST エンドポイント URL。 データタイプ：文字列 | | outbound_relations.type.value | 送信関係のタイプのSys_id。CI 関係性タイプ \[cmdb_rel_type\] テーブルにあります。 データタイプ：文字列 | | status | エラーが発生した場合にのみ表示されます。エンドポイント処理のステータス。 可能な値:失敗 データタイプ：文字列 | [表 : 47. 応答パラメーター] {#cmdb-PATCH-instance__table_ojn_3n4_3mb} ### cURL 要求のサンプル curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_class_sw/70bc4e11c0a8210d01f074cbe6bd73b4" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json"\ --user "username":"password"\ --data { "attributes": { "firewall_status": "Active", "name": "Linux299", "used_for": "Production" }, "source": "ServiceNow" } { "result": { "outbound_relations": [ { "sys_id": "403ff2641b425010593876a61a4bcb4b", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } }, { "sys_id": "443ff2641b425010593876a61a4bcb4c", "type": { "display_value": "Exchanges data with::Exchanges data with", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90", "value": "607ad1b2c0a8010e01941856b365af90" }, "target": { "display_value": "PS ORA01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f", "value": "3a307c930a0a0bb400353965d0b8861f" } } ], "attributes": { "firewall_status": "Active", "os_address_width": "", "attested_date": "", "operational_status": "1", "os_service_pack": "", "cpu_core_thread": "", "cpu_manufacturer": "", "sys_updated_on": "2020-07-13 21:24:05", "discovery_source": "ServiceNow", "first_discovered": "2020-07-13 20:27:28", "due_in": "", "used_for": "Production", "invoice_number": "", "gl_account": "", "sys_created_by": "dora.gray", "warranty_expiration": "", "ram": "", "cpu_name": "", "cpu_speed": "", "owned_by": "", "checked_out": "", "kernel_release": "", "sys_domain_path": "/", "classification": "Production", "disk_space": "", "object_id": "", "maintenance_schedule": "", "cost_center": "", "attested_by": "", "dns_domain": "", "assigned": "", "purchase_date": "", "life_cycle_stage": "", "short_description": "", "cd_speed": "", "floppy": "", "managed_by": "", "os_domain": "", "last_discovered": "2020-07-13 21:24:05", "can_print": "false", "sys_class_name": "cmdb_ci_linux_server", "manufacturer": "", "cpu_count": "", "vendor": "", "life_cycle_stage_status": "", "model_number": "", "assigned_to": "", "start_date": "", "os_version": "", "serial_number": "", "cd_rom": "false", "support_group": "", "unverified": "false", "correlation_id": "", "attributes": "", "asset": { "display_value": "Unknown", "link": "https://instance.servicenow.com/api/now/table/alm_asset/21cfba641b425010593876a61a4bcb52", "value": "21cfba641b425010593876a61a4bcb52" }, "form_factor": "", "cpu_core_count": "", "skip_sync": "false", "attestation_score": "", "sys_updated_by": "dora.gray", "sys_created_on": "2020-07-13 20:27:28", "sys_domain": { "display_value": "global", "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global", "value": "global" }, "cpu_type": "", "install_date": "", "asset_tag": "", "dr_backup": "", "hardware_substatus": "", "fqdn": "", "change_control": "", "internet_facing": "true", "delivery_date": "", "hardware_status": "installed", "install_status": "1", "supported_by": "", "name": "Linux299", "subcategory": "Computer", "default_gateway": "", "chassis_type": "", "virtual": "false", "assignment_group": "", "managed_by_group": "", "sys_id": "0c3ff2641b425010593876a61a4bcb39", "po_number": "", "checked_in": "", "sys_class_path": "/!!/!2/!(/!!/!0", "mac_address": "", "company": "", "justification": "", "department": "", "cost": "", "comments": "", "os": "", "sys_mod_count": "4", "monitor": "false", "model_id": { "display_value": "Unknown", "link": "https://instance.servicenow.com/api/now/table/cmdb_model/0ce0a2681b4e1010593876a61a4bcba6", "value": "0ce0a2681b4e1010593876a61a4bcba6" }, "ip_address": "", "duplicate_of": "", "sys_tags": "", "cost_cc": "USD", "order_date": "", "schedule": "", "environment": "", "due": "", "attested": "false", "location": "", "category": "Hardware", "fault_count": "0", "host_name": "", "lease_id": "" }, "inbound_relations": [ { "sys_id": "c03ff2641b425010593876a61a4bcb49", "type": { "display_value": "Depends on::Used by", "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5", "value": "1a9cb166f1571100a92eb60da2bce5c5" }, "target": { "display_value": "PS Apache01", "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439", "value": "3a27d4370a0a0bb4006316812bf45439" } } ] } }