--- sourceDocument: Xanadu API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference Release : - xanadu ft:locale : - ja-JP ft:publication_title : - Xanadu API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Change Management API # Change Management API {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：345分 Change Management API は、ServiceNow 変更管理 プロセスとのサードパーティアプリケーションの統合を可能にするエンドポイントを提供します。 アプリケーションを ServiceNow 変更管理 プロセスと統合することで、開始された場所に関係なく、すべての変更要求が信頼できる一元化された情報源を使用でき、単一の監査ソースが提供されます。 ServiceNow クライアントサイドアプリケーションを開発するときに、この REST API を使用して、変更管理プロセスを外部アプリケーションと統合します。 この REST API を使用すると、インテグレーターは次のことができます。 * 公開された標準的な変更の要求テンプレートから標準的な変更の要求を開始します。 * 緊急タイプまたは通常タイプの変更要求を作成します。 * 任意の変更要求の変更要求テーブルに存在するフィールドを更新します。 * 変更タスクテーブルに存在するフィールドを更新し、作成からクローズ/キャンセルまでタスクを実施します。 * 特定の変更要求、標準テンプレート、変更要求タスク、または変更モデルを取得します。 * ページネーションを使用して、複数の変更要求、標準テンプレート、変更要求タスクを取得します。 * リスク評価を実行します。 * 影響を受けたサービスをリフレッシュします。 * 変更要求に関連する承認アクティビティを生成して処理します。 * 潜在的なスケジュールの競合を特定し、競合が存在しない期間を特定します。 * 変更要求、変更要求タスク、および競合チェックプロセスを削除します。 * 変更モデルレコードに基づいて変更要求レコードを作成します。 * 指定された変更要求で利用可能なステータスのリスト (現在のステータスを含む) を取得します。 {#change-management-api__ul_rmh_xmm_dhb} Change Management API は、ワークフロースタジオ および Workflowを使用して ITIL タイプと変更モデルをサポートします。変更モデルは、目的に適した変更を提供します。タイプとモデルは、変更要求が次のステータスに進む前に満たす必要がある移行基準を定義します。この基準は、ステータス、ワークフロー、ツール、およびビジネスルールを使用して定義できます。 * 従来の ITIL タイプ：標準、緊急、および通常。 * 変更モデルのステータス：新規、予約済み、実装、レビュー、およびクローズ済み。 {#change-management-api__ul_lxs_wzs_qpb} ServiceNow インスタンス内で追加の変更モデルを構成し、この API のエンドポイントを使用して、それらの変更モデルに基づいて変更要求を作成できます。[Change Management - GET /sn_chg_rest/change/{sys_id}](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-model-sys_id "指定された sys_id で識別される変更モデルを取得します。") および [Change Management - GET /sn_chg_rest/change/model](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-model "指定された基準に基づいて 1 つ以上の変更モデルを取得します。") エンドポイントを使用して、インスタンスで利用可能な変更モデルを取得します。次に、[Change Management - POST /sn_chg_rest/change](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-POST-change-sys_id "変更要求に基づいて変更要求レコードを作成します。1 回の呼び出し内で複数の変更要求を作成することはサポートされていません。") を使用して、指定された変更モデルに基づいて変更要求を作成します。 変更モデルの構成については、「 [変更管理の構成](https://www.servicenow.com/docs/access?context=configure-change-management&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。 Change Management エンドポイントにアクセスするには、次のロールが必要です。 * DELETE：change_manager または admin * GET：change_manager、itil、sn_change_read、または admin * PATCH/POST：change_manager、itil、または admin {#change-management-api__ul_wwd_k45_rnb} さらに、管理者は変更プロパティを設定して、Change Management の動作を設定できます。これらのプロパティのリストと使用可能な機能の説明については、「 [変更管理プロパティ](https://www.servicenow.com/docs/access?context=r_ChangeManagementProperties&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。 ## Change Management - DELETE /sn_chg_rest/change/{change_sys_id}/task/{task_sys_id} {#ariaid-title2} 指定された sys_id で識別される変更要求タスクを削除します。 ### URL 形式 {#change-DELETE-c_id-task-t_id__section_odv_43n_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{change_sys_id}/task/{task_sys_id} デフォルトの URL：/api/sn_chg_rest/change/{change_sys_id}/task/{task_sys_id} ### サポートされている要求パラメーター {#change-DELETE-c_id-task-t_id__entry__2}{#change-DELETE-c_id-task-t_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | change_sys_id | タスクが関連付けられている変更要求の sys_id。変更要求 \[change_request\] テーブルにあります。指定された変更要求にタスクが実際に関連付けられていることを確認します。 データタイプ：文字列 | | task_sys_id | 削除する変更要求タスクの sys_id。変更タスク \[change_task\] テーブルにあります。 データタイプ：文字列 | [表 : 1. パスパラメーター] {#change-DELETE-c_id-task-t_id__entry__10} | 名前 | 説明 | |-|-| | なし | | [表 : 2. クエリパラメーター] {#change-DELETE-c_id-task-t_id__entry__14} | 名前 | 説明 | |-|-| | なし | | [表 : 3. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-c_id-task-t_id__entry__18}{#change-DELETE-c_id-task-t_id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 4. 要求ヘッダー] {#change-DELETE-c_id-task-t_id__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-c_id-task-t_id__entry__26}{#change-DELETE-c_id-task-t_id__entry-200-status-code}{#change-DELETE-c_id-task-t_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 6. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-DELETE-c_id-task-t_id__entry__38} | 名前 | 説明 | |-|-| | name-value pairs | 削除前に識別された変更要求タスクのすべてのフィールド (キー) とその関連付けられた値。 データタイプ：オブジェクト | | parent | このタスクが関連付けられた変更要求の情報。 データタイプ：オブジェクト parent: { display_value: "String", value: "String" } | | parent.display_value | UI に表示する親タスクの sys_id。 データタイプ：文字列 | | parent.value | 親タスクの sys_id。 データタイプ：文字列 | | sys_id | 削除された変更要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task/12629ec4b750230096c3e4f6ee11a9d5" \ --request DELETE \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "12629ec4b750230096c3e4f6ee11a9d5", display_value: "12629ec4b750230096c3e4f6ee11a9d5" }, parent: { value: "0f4ac6c4b750230096c3e4f6ee11a9fe", display_value: "CHG0033046 " }, ..., // all valid fields in record, example below short_description: { value: "Retire both nodes", display_value: "Retire both nodes" } } ] } ## Change Management - DELETE /sn_chg_rest/change/{sys_id} {#ariaid-title3} 指定された sys_id に関連付けられた変更要求を削除します。 ### URL 形式 バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/{sys_id} ### サポートされている要求パラメーター {#change-DELETE-change-sys_id__entry__2}{#change-DELETE-change-sys_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 削除する変更要求レコードの sys_id。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 7. パスパラメーター] {#change-DELETE-change-sys_id__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 8. クエリパラメーター] {#change-DELETE-change-sys_id__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 9. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-change-sys_id__entry__16}{#change-DELETE-change-sys_id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 10. 要求ヘッダー] {#change-DELETE-change-sys_id__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 11. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-change-sys_id__entry__24}{#change-DELETE-change-sys_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 12. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-DELETE-change-sys_id__entry__36} | 名前 | 説明 | |-|-| | result | 削除された変更要求レコード。このオブジェクトの各要素は、変更要求 \[change_request\] テーブルのレコードのフィールドに対応します。 データタイプ：オブジェクト | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \ --request DELETE \ --header "Accept:application/json" \ --user "username":"password" { "result": { "reason": { "display_value": "", "value": "" }, "parent": { "display_value": "", "value": "" }, "watch_list": { "display_value": "", "value": "" }, "proposed_change": { "display_value": "", "value": "" }, "upon_reject": { "display_value": "Cancel all future Tasks", "value": "cancel" }, "sys_updated_on": { "display_value": "2015-07-06 11:59:27", "value": "2015-07-06 18:59:27", "display_value_internal": "2015-07-06 11:59:27" }, "type": { "display_value": "Standard", "value": "standard" }, "approval_history": { "display_value": "", "value": "" }, "skills": { "display_value": "", "value": "" }, "test_plan": { "display_value": "--Confirm that there are no monitoring alerts for the router", "value": "--Confirm that there are no monitoring alerts for the router" }, "number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "is_bulk": { "display_value": "false", "value": false }, "cab_delegate": { "display_value": "", "value": "" }, "requested_by_date": { "display_value": "", "value": "", "display_value_internal": "" }, "ci_class": { "display_value": "cmdb_ci", "value": "cmdb_ci" }, "state": { "display_value": "Closed", "value": 3.0 }, "sys_created_by": { "display_value": "admin", "value": "admin" }, "knowledge": { "display_value": "false", "value": false }, "order": { "display_value": "", "value": "" }, "phase": { "display_value": "Requested", "value": "requested" }, "cmdb_ci": { "display_value": "", "value": "" }, "delivery_plan": { "display_value": "", "value": "" }, "impact": { "display_value": "3 - Low", "value": 3.0 }, "contract": { "display_value": "", "value": "" }, "active": { "display_value": "false", "value": false }, "work_notes_list": { "display_value": "", "value": "" }, "priority": { "display_value": "4 - Low", "value": 4.0 }, "sys_domain_path": { "display_value": "/", "value": "/" }, "cab_recommendation": { "display_value": "", "value": "" }, "production_system": { "display_value": "false", "value": false }, "rejection_goto": { "display_value": "", "value": "" }, "review_date": { "display_value": "", "value": "", "display_value_internal": "" }, "requested_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "business_duration": { "display_value": "", "value": "" }, "group_list": { "display_value": "", "value": "" }, "change_plan": { "display_value": "", "value": "" }, "approval_set": { "display_value": "", "value": "", "display_value_internal": "" }, "wf_activity": { "display_value": "", "value": "" }, "implementation_plan": { "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform", "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform" }, "universal_request": { "display_value": "", "value": "" }, "end_date": { "display_value": "", "value": "", "display_value_internal": "" }, "short_description": { "display_value": "Reboot the server at 6 am", "value": "Reboot the server at 6 am" }, "correlation_display": { "display_value": "", "value": "" }, "work_start": { "display_value": "2015-07-06 11:56:04", "value": "2015-07-06 18:56:04", "display_value_internal": "2015-07-06 11:56:04" }, "delivery_task": { "display_value": "", "value": "" }, "outside_maintenance_schedule": { "display_value": "false", "value": false }, "additional_assignee_list": { "display_value": "", "value": "" }, "std_change_producer_version": { "display_value": "Clear BGP sessions on a Cisco router - 1", "value": "16c2273c47010200e90d87e8dee49006" }, "sys_class_name": { "display_value": "Change Request", "value": "change_request" }, "service_offering": { "display_value": "", "value": "" }, "closed_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "follow_up": { "display_value": "", "value": "", "display_value_internal": "" }, "review_status": { "display_value": "", "value": "" }, "reassignment_count": { "display_value": "2", "value": 2.0 }, "start_date": { "display_value": "", "value": "", "display_value_internal": "" }, "assigned_to": { "display_value": "", "value": "" }, "variables": { "display_value": "variable_pool", "value": "variable_pool" }, "sla_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments_and_work_notes": { "display_value": "", "value": "" }, "escalation": { "display_value": "Normal", "value": 0.0 }, "upon_approval": { "display_value": "Proceed to Next Task", "value": "proceed" }, "correlation_id": { "display_value": "", "value": "" }, "made_sla": { "display_value": "true", "value": true }, "backout_plan": { "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work", "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work" }, "conflict_status": { "display_value": "Not Run", "value": "Not Run" }, "task_effective_number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "opened_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "user_input": { "display_value": "", "value": "" }, "sys_created_on": { "display_value": "2015-07-06 11:55:46", "value": "2015-07-06 18:55:46", "display_value_internal": "2015-07-06 11:55:46" }, "on_hold_task": { "display_value": "", "value": "" }, "sys_domain": { "display_value": "global", "value": "global" }, "route_reason": { "display_value": "", "value": "" }, "closed_at": { "display_value": "2015-07-06 11:56:23", "value": "2015-07-06 18:56:23", "display_value_internal": "2015-07-06 11:56:23" }, "review_comments": { "display_value": "", "value": "" }, "business_service": { "display_value": "", "value": "" }, "time_worked": { "display_value": "", "value": "" }, "chg_model": { "display_value": "", "value": "" }, "expected_start": { "display_value": "", "value": "", "display_value_internal": "" }, "opened_at": { "display_value": "2015-06-09 11:55:46", "value": "2015-06-09 18:55:46", "display_value_internal": "2015-06-09 11:55:46" }, "work_end": { "display_value": "2015-07-06 11:56:10", "value": "2015-07-06 18:56:10", "display_value_internal": "2015-07-06 11:56:10" }, "phase_state": { "display_value": "Open", "value": "open" }, "cab_date": { "display_value": "", "value": "", "display_value_internal": "" }, "work_notes": { "display_value": "", "value": "" }, "close_code": { "display_value": "Successful", "value": "successful" }, "assignment_group": { "display_value": "Network", "value": "287ebd7da9fe198100f92cc8d1d2154e" }, "description": { "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n", "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n" }, "on_hold_reason": { "display_value": "", "value": "" }, "calendar_duration": { "display_value": "", "value": "" }, "close_notes": { "display_value": "Completed without issues", "value": "Completed without issues" }, "sys_id": { "display_value": "b0dbda5347c12200e0ef563dbb9a718f", "value": "b0dbda5347c12200e0ef563dbb9a718f" }, "contact_type": { "display_value": "Phone", "value": "phone" }, "cab_required": { "display_value": "false", "value": false }, "urgency": { "display_value": "3 - Low", "value": 3.0 }, "scope": { "display_value": "Medium", "value": 3.0 }, "company": { "display_value": "", "value": "" }, "justification": { "display_value": "", "value": "" }, "activity_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments": { "display_value": "", "value": "" }, "approval": { "display_value": "Approved", "value": "approved" }, "due_date": { "display_value": "", "value": "", "display_value_internal": "" }, "sys_mod_count": { "display_value": "10", "value": 10.0 }, "on_hold": { "display_value": "false", "value": false }, "sys_tags": { "display_value": "", "value": "" }, "conflict_last_run": { "display_value": "", "value": "", "display_value_internal": "" }, "risk_value": { "display_value": "", "value": "" }, "unauthorized": { "display_value": "false", "value": false }, "risk": { "display_value": "Moderate", "value": 3.0 }, "location": { "display_value": "", "value": "" }, "category": { "display_value": "Other", "value": "Other" }, "risk_impact_analysis": { "display_value": "", "value": "" } } } ## Change Management - DELETE /sn_chg_rest/change/{sys_id}/conflict {#ariaid-title4} 指定された変更要求 (sys_id) の実行中の競合チェックプロセスをキャンセルします。 ### URL 形式 {#change-DELETE-conflict__section_x3q_tnn_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id}/conflict デフォルトの URL：/api/sn_chg_rest/change/{sys_id}/conflict ### サポートされている要求パラメーター {#change-DELETE-conflict__entry__2}{#change-DELETE-conflict__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 実行中の競合チェックプロセスをキャンセルする変更要求レコードの sys_id。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 13. パスパラメーター] {#change-DELETE-conflict__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 14. クエリパラメーター] {#change-DELETE-conflict__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 15. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-conflict__entry__16} | ヘッダー | 説明 | |-|-| | なし | | [表 : 16. 要求ヘッダー] {#change-DELETE-conflict__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 17. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-conflict__entry__24}{#change-DELETE-conflict__entry-200-status-code}{#change-DELETE-conflict__entry-401-status-code}{#change-DELETE-conflict__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。キャンセル要求が失敗しました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 18. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-DELETE-conflict__entry__36} | 名前 | 説明 | |-|-| | なし | | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \ --request DELETE \ --user "username":"password" None ## Change Management - DELETE /sn_chg_rest/change/emergency/{sys_id} {#ariaid-title5} 指定された sys_id で識別される緊急の変更要求を削除します。 ### URL 形式 {#change-DELETE-emergency__section_d4x_m3t_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/emergency/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/emergency/{sys_id} ### サポートされている要求パラメーター {#change-DELETE-emergency__entry__2}{#change-DELETE-emergency__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 削除する緊急の変更要求の sys_id。変更要求 \[change_request\] テーブルにあります。 | [表 : 19. パスパラメーター] {#change-DELETE-emergency__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 20. クエリパラメーター] {#change-DELETE-emergency__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 21. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-emergency__entry__16}{#change-DELETE-emergency__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 22. 要求ヘッダー] {#change-DELETE-emergency__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 23. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-emergency__entry__24}{#change-DELETE-emergency__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 24. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-DELETE-emergency__entry__36} | 名前 | 説明 | |-|-| | name-value pairs | 関連する変更要求のすべてのフィールドの値。 データタイプ：オブジェクト | | state | 削除前の変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Emergency」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「emergency」です。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \ --request DELETE \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "b0dbda5347c12200e0ef563dbb9a718f", display_value: "b0dbda5347c12200e0ef563dbb9a718f" }, state: { value: "-5", display_value: "New" }, type: { value: "emergency", display_value: "Emergency" }, ..., // all valid fields in record, example below short_description: { value: "Remove server", display_value: "Remove server" }, }, ] } ## Change Management - DELETE /sn_chg_rest/change/normal/{sys_id} {#ariaid-title6} 指定された sys_id で識別される通常の変更要求を削除します。 ### URL 形式 {#change-DELETE-normal__section_pkx_xns_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/normal/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/normal/{sys_id} ### サポートされている要求パラメーター {#change-DELETE-normal__entry__2}{#change-DELETE-normal__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更要求 \[change_request\] テーブルにある、削除する通常の変更要求の sys_id。 データタイプ：文字列 | [表 : 25. パスパラメーター] {#change-DELETE-normal__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 26. クエリパラメーター] {#change-DELETE-normal__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 27. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-normal__entry__16}{#change-DELETE-normal__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 28. 要求ヘッダー] {#change-DELETE-normal__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 29. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-normal__entry__24}{#change-DELETE-normal__entry-200-status-code}{#change-DELETE-normal__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 30. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-DELETE-normal__entry__36} | 名前 | 説明 | |-|-| | name-value pairs | 関連する変更要求のすべてのフィールドの値。 データタイプ：オブジェクト | | state | 削除前の変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Normal」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「normal」です。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f" \ --request DELETE \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", state: { value: "-5", display_value: "New" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, example below short_description: { value: "Remove server", display_value: "Remove server" }, }, ] } ## Change Management - DELETE /sn_chg_rest/change/standard/{sys_id} {#ariaid-title7} 指定された sys_id で識別される標準的な変更の要求を削除します。 ### URL 形式 {#change-DELETE-standard__section_tdv_s3l_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/standard/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/standard/{sys_id} ### サポートされている要求パラメーター {#change-DELETE-standard__entry__2}{#change-DELETE-standard__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 削除する標準的な変更の要求の sys_id。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 31. パスパラメーター] {#change-DELETE-standard__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 32. クエリパラメーター] {#change-DELETE-standard__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 33. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-standard__entry__16}{#change-DELETE-standard__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 34. 要求ヘッダー] {#change-DELETE-standard__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 35. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-DELETE-standard__table_wwn_rhd_ct__entry__2}{#change-DELETE-standard__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 36. ステータスコード] {#change-DELETE-standard__table_wwn_rhd_ct} ### 応答本文のパラメーター (JSON または XML) {#change-DELETE-standard__entry__34} | 名前 | 説明 | |-|-| | name-value pairs | 識別された変更要求のすべてのフィールド (キー) とその関連付けられた値。 | | state | 削除前の変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の一意の識別子。 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/1c87925347c12200e0ef563dbb9a7177" \ --request DELETE \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "1c87925347c12200e0ef563dbb9a7177", state: { value: "-5", display_value: "New" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" }, }, ] } ## Change Management - GET /sn_chg_rest/change/ci/{cmdb_ci_sys_id}/schedule {#ariaid-title8} 構成アイテム ID と期間で利用可能なタイムスロットを取得できるようにします。オプションで予定開始時間を含めることができます。 必要なロール： sn_change_writer 注: このエンドポイントを実行すると、利用可能な開始時間と終了時間が表示されません。応答本文の worker.link プロパティにあるリンクを使用して、スケジュールスデータを取得します。 関連項目： * [GET /sn_chg_rest/change/{change_sys_id}/schedule](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-change-sys_id-sched "変更要求に利用可能なタイムスロットを取得できるようにします。") * [PATCH /sn_chg_rest/change/{change_sys_id}/schedule/first_available](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-PATCH-c_id-sched-first "最初に見つかった利用可能なタイムスロットを使用して、変更要求の予定開始時間と予定終了時間を更新します。") {#change-GET-c_id-schedule__ul_orx_mts_npb} ### URL 形式 バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/ci/{cmdb_ci_sys_id}/schedule デフォルトの URL：/api/sn_chg_rest/change/ci/{cmdb_ci_sys_id}/schedule ### サポートされている要求パラメーター {#change-GET-c_id-schedule__entry__2}{#change-GET-c_id-schedule__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | cmdb_ci_sys_id | 構成アイテム \[cmdb_ci\] テーブルのレコードの sys_id。このエンドポイントには変更要求は必要ありません。 | [表 : 37. パスパラメーター] {#change-GET-c_id-schedule__table_fd4_yhf_jpb__entry__2} | 名前 | 説明 | |-|-| | duration_in_seconds | 変更の期間 (秒)、つまり、変更要求タスクの完了に必要な時間。 データタイプ：整数 | | planned_start_time | オプション。変更要求の実装開始が予定されている日時 (UTC)。 この時間以降の利用可能なタイムスロットの開始時間を取得します。指定しない場合、現在の時刻が開始時間として使用されます。 時間形式：yyyy-mm-dd hh:mm:ss データタイプ：文字列 | [表 : 38. クエリパラメーター] {#change-GET-c_id-schedule__table_fd4_yhf_jpb} {#change-GET-c_id-schedule__entry__14} | 名前 | 説明 | |-|-| | なし | | [表 : 39. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-c_id-schedule__entry__18}{#change-GET-c_id-schedule__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 40. 要求ヘッダー] {#change-GET-c_id-schedule__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 41. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-c_id-schedule__entry__26} | ステータスコード | 説明 | |-|-| | 202 | システムが要求を承認しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 考えられる問題： * 指定された sys_id の cmdb_ci が見つかりません。レコードが存在しないか、ユーザーに読み取りアクセス権がありません。 * duration_in_seconds クエリパラメータ値が指定されていません。 * 無効な duration_in_seconds または planned_start_time クエリパラメーター値が指定されました。 {#change-GET-c_id-schedule__ul_rpf_3sk_npb} | [表 : 42. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-c_id-schedule__section_p33_ccf_jpb} {#change-GET-c_id-schedule__table_is2_n4s_jpb__entry__2}{#change-GET-c_id-schedule__row-result-error-cmdb}{#change-GET-c_id-schedule__row-result-error_detail-cmdb}{#change-GET-c_id-schedule__row-result-error_message-cmdb} | 名前 | 説明 | |-|-| | error | エンドポイント要求の処理中に発生したエラーに関する情報。 データタイプ：オブジェクト "error": { "detail": "String", "message": "String", "status": "String" } | | error.detail | エラーに関する追加情報。 データタイプ：文字列 | | error.message | エラーを識別するメッセージ。 データタイプ：文字列 | | messages | メッセージ情報。 データタイプ：オブジェクト "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | messages.errorMessages | 要求の処理中にエラーメッセージが表示されました。 データタイプ：アレイ | | messages.infoMessages | 要求の処理中に情報メッセージが表示されました。 データタイプ：アレイ | | messages.warningMessages | 要求の処理中に警告メッセージが表示されました。 データタイプ：アレイ | | 要求 | 元のエンドポイント要求。 データタイプ：文字列 | | state | ワーカーの現在のステータスに関する情報。 データタイプ：オブジェクト state: { display_value: "String", value: Number } | | state.display_value | ワーカーのステータス値を表示します。これらの値は state.value パラメーターに直接関連付けられています。 可能な値： * 完了 * エラー * 対応中 * 待機中 {#change-GET-c_id-schedule__ul_ehh_nxy_jhb} データタイプ：文字列 | | state.value | ワーカーのステータスの数値。 可能な値： * 1 * 2 * 3 * 4 {#change-GET-c_id-schedule__ul_zw1_fxy_jhb} データタイプ：数値 | | type | 要求のタイプを示します。 有効な値：schedule データタイプ：文字列 | | worker | 関連付けられたワーカーに関する情報。 データタイプ：オブジェクト "worker": { "link": "String", "sysId": "String" } | | worker.link | タイムスロットデータを取得するためのリンク。結果を表示するには、[GET /sn_chg_rest/change/worker/{sys_id}](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-worker "指定された非同期ワーカーの現在のステータス、情報、およびエラーを取得します。") で sys_id を使用します。 データタイプ：文字列 | | worker.sysId | 変更要求と関連付けるワーカーの sys_id。 データタイプ：文字列 | | status | エラーが発生した場合にのみ表示されます。エンドポイント処理のステータス。 可能な値：failure データタイプ：文字列 | [ ] {#change-GET-c_id-schedule__table_is2_n4s_jpb} ### 利用可能なタイムスロットを取得 {#change-GET-c_id-schedule__cmapi-sched-get-ci} worker.link で指定された値を使用して、スケジュール枠の詳細を取得します。値の形式は次のとおりです。 https://instance.service-now.com/api/sn_chg_rest/change/worker/\ 結果を表示するには、[GET /sn_chg_rest/change/worker/{sys_id}](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-worker "指定された非同期ワーカーの現在のステータス、情報、およびエラーを取得します。") で worker_sys_id を使用します。 応答の本文にはステータスが含まれ、処理が完了すると結果が提供されます。 ワーカー応答本文のパラメーターの結果は、タイムスロットの可用性によって異なります。 * 指定されたタイムスロットがスケジュールタイムスロット内の変更要求で利用可能な場合、ワーカー API は payload.spans プロパティで利用可能なタイムスロットをリストします。それ以外の場合は、payload.spans プロパティは結果に表示されません。 * 定義されたスケジューリングタイムスロット内に指定された変更要求期間で利用可能なタイムスロットがない場合、messages.infoMessages は次のように表示されます：`D` 注: 変更要求スケジューリングタイムスロットのデフォルト値は 90 日です。この値を変更するには、change.conflict.next_available.schedule_window プロパティを変更します。詳細については、「 [競合分析プロパティの構成](https://www.servicenow.com/docs/access?context=configure-conflict-properties&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。{#change-GET-c_id-schedule__cmapi-wkr-no-slots-90-li} {#change-GET-c_id-schedule__cmapi-wkr-no-slots-90-li} 次の GET /sn_chg_rest/change/worker/{sys_id} の例は、worker.link の詳細で指定された ID を使用して提供された出力を示しています。結果には、タスク期間で利用可能なオープンなタイムスパンがリストされます。 { "result": { "worker": { "sysId": "d7d1f2b4a444b010f87712198fe9caae", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/d7d1f2b4a444b010f87712198fe9caae" }, "request": "{\"cmdb_ci_sys_id\":\"82967cdd0ad3370236092104ce988d76\",\"planned_start_time\":\"\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 3, "display_value": "Complete" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] }, "payload": { "spans": [ { "start": { "value": "2021-05-15 08:00:00", "display_value": "2021-05-15 01:00:00" }, "end": { "value": "2021-05-15 11:00:00", "display_value": "2021-05-15 04:00:00" } }, { "start": { "value": "2021-05-22 08:00:00", "display_value": "2021-05-22 01:00:00" }, "end": { "value": "2021-05-22 11:00:00", "display_value": "2021-05-22 04:00:00" } }, ... ] } } } ### cURL 要求 curl "https://instance.service-now.com/api/sn_chg_rest/change/ci//schedule?duration_in_seconds=10800" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" 結果には、GET /sn_chg_rest/change/worker/endpoint で提供された sys_id を実行するために使用できる worker.link の詳細が含まれています。 { "result": { "worker": { "sysId": "1049419c1b4c3010f58a6572604bcb7a", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/1049419c1b4c3010f58a6572604bcb7a" }, "request": "{\"cmdb_ci_sys_id\":\"\",\"planned_start_time\":\"\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 1, "display_value": "Waiting" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] } } } ## Change Management - GET /sn_chg_rest/change {#ariaid-title9} 指定された基準に基づいて 1 つ以上の変更要求を取得します。 ### URL 形式 バージョニングされた URL：/api/sn_chg_rest/{api_version}/change デフォルトの URL：/api/sn_chg_rest/change ### サポートされている要求パラメーター {#change-GET-change__entry__2}{#change-GET-change__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 43. パスパラメーター] {#change-GET-change__entry__6}{#change-GET-change__sysparm_offset-ph-RESTAPI}{#change-GET-change__sysparm-query-RESTAPI} | 名前 | 説明 | |-|-| | name-value pairs | 結果セットをフィルタリングするために使用する名前と値のペア。名前は、指定された値がフィルタリングされるフィールドです。このパラメーターは、sysparm_query と相互に排他的です。たとえば、`&sysparm_query=active=true` を使用する代わりに、`&active=true` を使用して呼び出しステートメントを簡素化できます。フィールドが選択フィールドや参照タイプフィールドの場合も、表示値を使用できます (`&state=7` の代わりに `&state=closed` など)。複数のキーと値のペアを指定するには、それぞれをアンパサンドで区切ります (`&active=true&assigned_to=john.smith` など)。 データタイプ：文字列 | | order | 返された変更要求をソートするためのフィールド。 データタイプ：文字列 デフォルト：name | | sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「`sysparm_offset=sysparm_offset+sysparm_limit`」を使用します。{#change-GET-change__sysparm_offset-p-RESTAPI} sysparm_offset パラメーターに負の数値を渡さないでください。 データタイプ：数値 デフォルト：0 | | sysparm_query | 結果セットをフィルタリングするために使用される[エンコードされたクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)。UI フィルターを使用して、適切にエンコードクエリーを取得できます。 構文：`sysparm_query=`。 * \：フィルターを適用するテーブル列の名前。 * \：次の値をサポートします。 * =：\ と完全一致します。 * !=：\ と一致しません。 * \^：複数のクエリステートメントの論理 AND。 * \^OR：複数のクエリステートメントの論理 OR。 * LIKE：指定された文字列が \ に含まれています。データタイプが文字列である \ フィールドに対してのみ機能します。 * STARTSWITH：\ は指定された文字列で始まります。データタイプが文字列である \ フィールドに対してのみ機能します。 * ENDSWITH：\ は指定した文字列で終了します。データタイプが文字列である \ フィールドに対してのみ機能します。 {#change-GET-change__ul_bgf_5vz_mlb} \：照合する値。 {#change-GET-change__ul_g2p_svz_mlb} すべてのパラメーターで大文字と小文字が区別されます。クエリには、sysparm_query=\\\\[\\\\\] のように、複数のエントリを含めることができます。 例： `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` エンコードクエリーは、機能別の順番もサポートしています。特定のフィールドに基づいて回答を並べ替えるには、`ORDERBY` と `ORDERBYDESC` の句を sysparm_query で使用します。 構文： * `ORDERBY` * `ORDERBYDESC` {#change-GET-change__ul_sq4_rc1_nlb} 例：`sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` このクエリは、すべてのアクティブなレコードをフィルタリングし、結果を番号で昇順に並べ替えた後、カテゴリで降順に並べ替えます。 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ：文字列 | | textSearch | すべての通常の変更要求レコードフィールドを検索するために使用する文字列。この検索では、ServiceNow の全文検索プラットフォーム機能を使用します。ServiceNow検索機能の詳細については、「[検索の管理](https://www.servicenow.com/docs/access?context=search-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 デフォルト：IR_AND_OR_QUERY | [表 : 44. クエリパラメーター] {#change-GET-change__entry__18} | 名前 | 説明 | |-|-| | なし | | [表 : 45. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-change__entry__22}{#change-GET-change__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 46. 要求ヘッダー] {#change-GET-change__entry__26} | ヘッダー | 説明 | |-|-| | なし | | [表 : 47. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-change__entry__30}{#change-GET-change__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 48. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-change__entry__38}{#change-GET-change__action_status-entry-chg_req}{#change-GET-change__active-entry-chg_req}{#change-GET-change__activity_due-entry-chg_req}{#change-GET-change__add_assignee_list-entry-chg_req}{#change-GET-change__approval-entry-chg_req}{#change-GET-change__approval_history-entry-chg_req}{#change-GET-change__approval_set-entry-chg_req}{#change-GET-change__assigned_to-entry-chg_req}{#change-GET-change__assign_group-entry-chg_req}{#change-GET-change__backout_plan-entry-chg_req}{#change-GET-change__business_dur-entry-chg_req}{#change-GET-change__business_service-entry-chg_req}{#change-GET-change__cab_date-entry-chg_req}{#change-GET-change__cab_delegate-entry-chg_req}{#change-GET-change__cab_rec-entry-chg_req}{#change-GET-change__cab_req-entry-chg_req}{#change-GET-change__cal_dur-entry-chg_req}{#change-GET-change__category-entry-chg_req}{#change-GET-change__change_plan-entry-chg_req}{#change-GET-change__chg_model-entry-chg_req}{#change-GET-change__closed_at-entry-chg_req}{#change-GET-change__closed_by-entry-chg_req}{#change-GET-change__close_code-entry-chg_req}{#change-GET-change__close_notes-entry-chg_req}{#change-GET-change__cmdb_ci-entry-chg_req}{#change-GET-change__comments-entry-chg_req}{#change-GET-change__comments_work_notes-entry-chg_req}{#change-GET-change__company-entry-chg_req}{#change-GET-change__conflict_last_run-entry-chg_req}{#change-GET-change__conflict_status-entry-chg_req}{#change-GET-change__contact_type-entry-chg_req}{#change-GET-change__contract-entry-chg_req}{#change-GET-change__corr_display-entry-chg_req}{#change-GET-change__corr_id-entry-chg_req}{#change-GET-change__delivery_plan-entry-chg_req}{#change-GET-change__delivery_task-entry-chg_req}{#change-GET-change__description-entry-chg_req}{#change-GET-change__end_date-entry-chg_req}{#change-GET-change__escalation-entry-chg_req}{#change-GET-change__expected_start-entry-chg_req}{#change-GET-change__follow_up-entry-chg_req}{#change-GET-change__group_list-entry-chg_req}{#change-GET-change__impact-entry-chg_req}{#change-GET-change__imp_plan-entry-chg_req}{#change-GET-change__justification-entry-chg_req}{#change-GET-change__knowledge-entry-chg_req}{#change-GET-change__location-entry-chg_req}{#change-GET-change__made_sla-entry-chg_req}{#change-GET-change__needs_attention-entry-chg_req}{#change-GET-change__number-entry-chg_req}{#change-GET-change__on_hold-entry-chg_req}{#change-GET-change__on_hold_reason-entry-chg_req}{#change-GET-change__on_hold_task-entry-chg_req}{#change-GET-change__opened_at-entry-chg_req}{#change-GET-change__opened_by-entry-chg_req}{#change-GET-change__order-entry-chg_req}{#change-GET-change__outside_maint_sched-entry-chg_req}{#change-GET-change__parent-entry-chg_req}{#change-GET-change__phase-entry-chg_req}{#change-GET-change__phase_state-entry-chg_req}{#change-GET-change__priority-entry-chg_req}{#change-GET-change__prod_system-entry-chg_req}{#change-GET-change__reason-entry-chg_req}{#change-GET-change__reassign_count-entry-chg_req}{#change-GET-change__rejection_goto-entry-chg_req}{#change-GET-change__requested_by-entry-chg_req}{#change-GET-change__requested_by_date-entry-chg_req}{#change-GET-change__review_comments-entry-chg_req}{#change-GET-change__review_date-entry-chg_req}{#change-GET-change__review_status-entry-chg_req}{#change-GET-change__risk-entry-chg_req}{#change-GET-change__risk_impact_analysis-entry-chg_req}{#change-GET-change__route_reason-entry-chg_req}{#change-GET-change__scope-entry-chg_req}{#change-GET-change__sevice_offering-entry-chg_req}{#change-GET-change__short_desc-entry-chg_req}{#change-GET-change__skills-entry-chg_req}{#change-GET-change__sla_due-entry-chg_req}{#change-GET-change__start_date-entry-chg_req}{#change-GET-change__state-entry-chg_req}{#change-GET-change__std_chg_prodversion-entry-chg_req}{#change-GET-change__sys_class_name-entry-chg_req}{#change-GET-change__sys_create_by-entry-chg_req}{#change-GET-change__sys_created_on-entry-chg_req}{#change-GET-change__sys_domain-entry-chg_req}{#change-GET-change__sys_domain_path-entry-chg_req}{#change-GET-change__sys_id-entry-chg_req}{#change-GET-change__sys_mod_count-entry-chg_req}{#change-GET-change__sys_updated_by-entry-chg_req}{#change-GET-change__sys_updated_on-entry-chg_req}{#change-GET-change__task_eff_number-entry-chg_req}{#change-GET-change__task_for-entry-chg_req}{#change-GET-change__test_plan-entry-chg_req}{#change-GET-change__time_worked-entry-chg_req}{#change-GET-change__type-entry-chg_req}{#change-GET-change__unauthorized-entry-chg_req}{#change-GET-change__universal_request-entry-chg_req}{#change-GET-change__upon_approval-entry-chg_req}{#change-GET-change__upon_reject-entry-chg_req}{#change-GET-change__urgency-entry-chg_req}{#change-GET-change__user_input-entry-chg_req}{#change-GET-change__variables-entry-chg_req}{#change-GET-change__watch_list-entry-chg_req}{#change-GET-change__wf_activity-entry-chg_req}{#change-GET-change__work_end-entry-chg_req}{#change-GET-change__work_notes-entry-chg_req}{#change-GET-change__work_notes_list-entry-chg_req}{#change-GET-change__work_start-entry-chg_req} | 要素 | 説明 | |-|-| | result | 1 つ以上の変更要求レコードオブジェクトを含むリスト。各オブジェクトは変更要求を表します。変更要求オブジェクトの各要素は、変更要求 \[change_request\] テーブルの関連付けられたレコードのフィールドに対応します。 すべての要素には、value および display_value の名前と値のペアが含まれています。日付フィールドには、display_value_internal の名前と値のペアが含まれています。 データタイプ：アレイ | | action_status | 関連する変更要求の現在のアクションステータス。 可能な値： * 1：社内でブロック済み * 2：顧客によりブロック済み * 3：社内でおよび顧客によりブロック済み * 4：要注意 {#change-GET-change__ul_nhd_tc3_2hb} データタイプ：数値 | | active | 変更要求がアクティブかどうかを示すフラグ。 可能な値： * true：変更要求はアクティブです * false：変更要求はアクティブではありません {#change-GET-change__ul_dqy_5jb_2hb} データタイプ：ブール デフォルト：true | | activity_due | 関連付けられたケースの完了予定日時。 データタイプ：文字列 | | additional_assignee_list | 変更要求の作業にアサインされた追加のユーザーの sys_id のリスト。 データタイプ：アレイ | | approval | 必要な承認プロセスのタイプ。 データタイプ：文字列 デフォルト：not requested | | approval_history | 最新の承認履歴ジャーナルエントリ。 データタイプ：文字列 | | approval_set | 関連するアクションが承認された日時。 データタイプ：文字列 | | assigned_to | 変更要求にアサインされたユーザーの sys_id。 データタイプ：文字列 | | assignment_group | 変更要求にアサインされたグループの sys_id。 データタイプ：文字列 | | backout_plan | 変更を取り消す必要がある場合に実行する計画の説明。 データタイプ：文字列 | | business_duration | 変更の完了までにかかったスケジュールされた作業時間、作業日数、および作業週数。 データタイプ：文字列 | | business_service | 変更要求に関連付けられたビジネスサービスの sys_id。サービス \[cmdb_ci_service\] テーブルにあります。 データタイプ：文字列 | | cab_date | 変更諮問委員会 (CAB) の会議の日付。 データタイプ：文字列 | | cab_delegate | CAB 会議中に CAB マネージャーの代理を務めることができるユーザーの sys_id。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 | | cab_recommendation | 変更要求の CAB の提言の説明。 データタイプ：文字列 最大長：4,000 | | cab_required | CAB が必須かどうかを示すフラグ 。 可能な値： * true：変更諮問委員会が必要です。 * false：変更諮問委員会は必要ではありません。 {#change-GET-change__ul_jbv_tb4_tnb} データタイプ：ブール デフォルト値：false | | calendar_duration | 現在 変更管理 で使用されていません。 データタイプ：文字列 | | category | 変更のカテゴリ (たとえば、ハードウェア、ネットワーク、ソフトウェアなどです)。 データタイプ：文字列 デフォルト：Other | | change_plan | 変更要求を管理および制御するためのアクティビティとロール。 データタイプ：文字列 | | chg_model | 関連する変更要求の基になった変更モデルの sys_id。変更モデル \[chg_model\] テーブルにあります。変更モデルは、変更要求に対して完了する必要があるステータスフロー、移行、およびプロセスアクティビティを定義します。 データタイプ：文字列 | | closed_at | 関連する変更要求がクローズされた日時。 データタイプ：文字列 | | closed_by | 変更要求をクローズしたユーザーの sys_id。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 | | close_code | 変更要求がクローズされたときに変更要求に割り当てられたコード。たとえば、成功、成功 (問題あり)、不成功などです。 データタイプ：文字列 | | close_notes | ユーザーが変更要求をクローズしたときに入力したメモ。 データタイプ：文字列 | | cmdb_ci | 変更要求に関連付けられた構成アイテムの sys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | コメント | 関連する変更要求に入力された顧客向け作業メモのリスト。 データタイプ：アレイ | | comments_and_work_notes | 関連する変更要求に入力された内部および顧客向けの両方の作業メモのリスト。 データタイプ：アレイ 最大長：4,000 | | company | 変更要求と関連付けられた会社の sys_id。会社 \[core_company\] テーブルにあります。 データタイプ：文字列 | | conflict_last_run | 変更要求で競合の検出スクリプトが最後に実行された日時。 データタイプ：文字列 | | conflict_status | 競合の検出スクリプトによって検出された現在の競合ステータス (競合、未実行など)。 データタイプ：文字列 最大長：40 デフォルト：未実行 | | contact_type | 変更要求が最初に要求された方法。 可能な値： * chat * email * phone * social * web データタイプ：文字列 | | contract | 変更要求と関連付けられた契約の sys_id。契約 \[ast_contract\] テーブルにあります。 データタイプ：文字列 | | correlation_display | correlation_id のユーザーに分かりやすい名前。 データタイプ：文字列 最大長：100 | | correlation_id | サードパーティシステム内の一致する変更要求レコードのグローバル一意識別子 (GUID)。 データタイプ：文字列 最大長：100 | | delivery_plan | 使用されなくなりました。変更要求と関連付ける配送計画の sys_id。実行計画 \[sc_cat_item_delivery_plan\] テーブルにあります。 データタイプ：文字列 | | delivery_task | 使用されなくなりました。変更要求と関連付ける配送タスクの sys_id。実行計画タスク \[sc_cat_item_delivery_task\] テーブルにあります。 データタイプ：文字列 | | description | 変更要求の詳細な説明。 データタイプ：文字列 最大長：4,000 | | due_date | タスクの期日。変更要求プロセスでは使用されません。 データタイプ：文字列 | | end_date | 変更要求が完了する日時。 データタイプ：文字列 | | escalation | 現在のエスカレーションレベル。 可能な値： * 0：通常 * 1：中 * 2：高 * 3：期限切れ {#change-GET-change__ul_kkn_123_2hb} データタイプ：数値 (整数) デフォルト：0 | | expected_start | タスクを開始する日時。変更要求プロセスでは使用されません。 データタイプ：文字列 | | follow_up | ユーザーが変更要求を要求した人物をフォローアップした日時。 データタイプ：文字列 | | group_list | 変更要求に関連付けられたグループの sys_id と名前のリスト。 データタイプ：アレイ 最大長：4,000 | | impact | 変更要求が顧客に与える影響。 可能な値： * 1 ：高 * 2 ：中 * 3：低 {#change-GET-change__ul_j2x_j23_2hb} データタイプ：数値 (整数) デフォルト値：3 | | implementation_plan | この変更を実装するために実行する段階的なステップ。また、ステップごとに、ステップとアサイニーの間の依存関係も含まれています。 データタイプ：文字列 最大長：4,000 | | 理由 | この変更を実装するメリットと、この変更が実装されない場合の影響。 データタイプ：文字列 最大長：4,000 | | knowledge | 変更要求に関連付けられたナレッジベース (KB) 記事があるかどうかを示すフラグ。 可能な値： * true：KB 記事が関連付けられています * false：KB 記事は関連付けられていません {#change-GET-change__ul_ehz_hp1_wnb} データタイプ：ブール | | location | 変更要求で参照される機器の場所の sys_id と名前。場所 \[cmn_location\] テーブルにあります。 データタイプ：文字列 | | made_sla | 使用されなくなりました。変更要求が関連するサービスレベルアグリーメントに従って実装されたかどうかを示すフラグ。 データタイプ：ブール | | needs_attention | 変更要求に注意が必要かどうかを示すフラグ。 可能な値： * true：変更要求に追加の注意が必要です。 * false：変更要求に追加の注意は必要ありません。 {#change-GET-change__ul_zzn_gnc_2hb} データタイプ：ブール デフォルト値：false | | number | システムによって変更要求に割り当てられた変更番号 (CHG0040007 など)。 データタイプ：文字列 | | on_hold | 変更要求が現在保留中かどうかを示すフラグ。 可能な値： * true：保留中 * false：保留中ではありません {#change-GET-change__ul_xjn_nv1_wnb} データタイプ：ブール デフォルト値：false | | on_hold_reason | on_hold パラメーターが「true」の場合、変更要求が保留にされている理由の説明。 データタイプ：文字列 最大長：4,000 | | on_hold_task | on_hold パラメーターが「true」の場合、保留が解除される前に完了する必要があるタスクの sys_id のリスト。 データタイプ：文字列 最大長：4,000 | | open_at | 変更リリースが作成された日時。 データタイプ：文字列 | | opened_by | 変更リリースを作成したユーザーの sys_id と名前。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 | | order | 変更管理 では使用されていません。データベースからレコードを取得するときなどにレコードを並べ替える基準となるオプションの数値フィールド。 データタイプ：数値 (整数) | | outside_maintenance_schedule | 変更要求に対して外部の会社によるメンテナンスがスケジュールされているかどうかを示すフラグ。 可能な値： * true：外部メンテナンスがスケジュールされています * false：外部メンテナンスがスケジュールされていません データタイプ：ブール デフォルト値：false | | parent | この変更要求に対する親タスクの sys_id と名前 (存在する場合)。タスク \[task\] テーブルにあります。 データタイプ：文字列 | | phase | 変更要求の現在のフェーズ。これにより、変更の内容がより詳細に定義されます。 可能な値： * accept * build * プラン * requested データタイプ：文字列 | | phase_state | 変更のために作成する必要がある change_phase レコード。カテゴリに依存するので、変更のタイプごとに異なる change_phase レコードがある場合があります。各 change_phase にはスケジュールと一連の承認者を設定できるため、change_phase レコードは承認プロセスを制御する機会を提供します。 可能な値： * complete * on hold * open * rejected * requested * work in progress {#change-GET-change__ul_rng_ly1_wnb} データタイプ：文字列 | | priority | 変更要求の優先度。 可能な値： * 1：重大 * 2：高 * 3：中 * 4：低 データタイプ：数値 (整数) デフォルト：4 | | production_system | 変更要求が本番環境の ServiceNow インスタンスに対するものかどうかを示すフラグ。 可能な値： * true：本番環境 * false：非本番環境 データタイプ：ブール | | reason | 変更要求が開始された理由の説明。 可能な値： * ビジネス要件 * ハードウェアのアップグレード * 法律 * 場所の変更 * ネットワーク要件 * 新規または削除された CI * その他 * 問題が解決された * 製品またはサービスが変更されました * ソフトウェアのアップグレード * ユーザー要求 データタイプ：文字列 最大長：40 | | reassignment_count | 変更要求が新しいオーナーに再アサインされた回数。 データタイプ：数値 (整数) デフォルト：0 | | rejection_goto | 変更要求が却下された場合に実行するタスクの sys_id。タスク \[task\] テーブルにあります。 データタイプ：文字列 | | requested_by | 変更を要求したユーザーの sys_id。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 | | requested_by_date | 変更の実装が要求された日時。 データタイプ：文字列 | | review_comments | 変更要求のレビュー時に入力されたコメント。 データタイプ：文字列 最大長：4,000 | | review_date | 変更要求がレビューされた日付。 データタイプ：文字列 | | review_status | 変更要求の要求されたレビューの現在のステータス。 データタイプ：文字列 | | risk | 変更要求に関連付けられたリスクのレベル。 有効な値： * 1 ：高 * 2 ：中 * 3：低 {#change-GET-change__ul_ejt_tn4_wnb} データタイプ：数値 デフォルト値：3 | | risk_impact_analysis | 変更要求の実装に関するリスクと分析の説明。 データタイプ：文字列 最大長：4,000 | | route_reason | 現在 変更管理 で使用されていません。変更要求が転送された理由。 可能な値： * 1：解決する転送 * 9：解決しない転送 {#change-GET-change__ul_yvl_cxq_znb} データタイプ：数値 | | scope | 変更要求のサイズ。 可能な値： * 1：大規模 * 2：大 * 3 ：中程度 * 4：小 * 5：非常に小さい {#change-GET-change__ul_b3j_3xq_znb} データタイプ：数値 デフォルト値：3 | | service_offering | 変更要求に関連付けられたサービスオファリングの sys_id。サービスオファリングは、可用性、スコープ、価格設定、およびパッケージングのオプションに関して、サービスのレベルを一意に定義します。オファリング \[service_offering\] テーブルにあります。 データタイプ：文字列 | | short_description | 変更要求の説明。 データタイプ：文字列 最大長：40 | | skills | 変更要求を実装するために必要なすべてのスキルの sys_id のリスト。スキル \[cmn_skill\] テーブルにあります。 データタイプ：アレイ | | sla_due | 使用されなくなりました。関連するサービスレベルアグリーメントに基づいて変更要求を完了する必要がある日時。 データタイプ：文字列 | | sn_esign_document | 変更要求に添付された電子署名済みドキュメントの sys_id。添付ファイル \[sys_attachment\] テーブルにあります。 データタイプ：文字列 | | sn_esign_esignature_configuration | 関連するドキュメントに使用される電子署名テンプレートの sys_id。電子署名テンプレート \[sn_esign_configuration\] テーブルにあります。 データタイプ：文字列 | | start_date | 変更要求の実装開始が予定されている日時。 データタイプ：文字列 | | state | 変更要求の現在のステータス。可能な値は変更モデルで定義されます。 データタイプ：数値 (整数) デフォルト値：1 | | std_change_producer_version | 変更要求と関連付けるレコードプロデューサーおよび変更提案の sys_id。また、提案から作成された成功した変更要求と失敗した変更要求の数と割合も含まれます。標準的な変更テンプレートのバージョン \[std_change_producer_version\] テーブルにあります。 データタイプ：文字列 | | sys_class_name | 変更要求が配置されているテーブルの名前。 データタイプ：文字列 | | sys_created_by | 変更要求を最初に作成したユーザーの名前。 データタイプ：文字列 最大長：40 | | sys_created_on | 関連付けられた変更要求レコードが最初に作成された日時。 データタイプ：文字列 | | sys_domain | インスタンスでドメインを使用している場合は、変更モジュールレコードが関連付けられているドメインの名前。 データタイプ：文字列 | | sys_domain_path | インスタンスでドメインを使用している場合は、関連付けられた変更モジュールレコードが存在するドメインパス。 データタイプ：文字列 | | sys_id | 関連付けられた変更要求レコードの一意の識別子。 データタイプ：文字列 | | sys_mod_count | ケースが最初に作成されてからの更新回数。 データタイプ：数値 (整数) | | sys_updated_by | ケースを最後に更新したユーザー。 データタイプ：文字列 最大長：40 | | sys_updated_on | ケースが最後に更新された日時。 データタイプ：文字列 | | task_effective_number | ユニバーサル要求番号。 データタイプ：文字列 最大長：40 | | task_for | 変更管理 では使用されていません。タスクが作成されたユーザーの sys_id。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 | | test_plan | 変更に関連するテスト計画の説明。 データタイプ：文字列 最大長：4,000 | | time_worked | 変更要求の合計作業時間。 データタイプ：文字列 | | type | 変更要求のタイプ。 可能な値： * emergency * normal * standard データタイプ：文字列 最大長：40 | | unauthorized | 変更要求が認可されていないかどうかを示すフラグ。 可能な値： * true：認可されていない * false：認可済み {#change-GET-change__ul_gd3_q1p_wnb} データタイプ：ブール | | universal_request | この変更要求が属する親ユニバーサル要求の sys_id。タスク \[task\] テーブルにあります。 データタイプ：文字列 | | upon_approval | 変更要求が承認された場合に実行するアクション。 可能な値： * do_nothing * proceed データタイプ：文字列 最大長：40 デフォルト：proceed | | upon_reject | 変更要求が却下された場合に実行するアクション。 可能な値： * cancel * goto {#change-GET-change__ul_mnw_cg3_2hb} データタイプ：文字列 最大長：40 デフォルト：cancel | | urgency | 変更要求の緊急度。 可能な値： * 1 ：高 * 2 ：中 * 3：低 {#change-GET-change__ul_td4_3g3_2hb} データタイプ：数値 (整数) デフォルト値：3 | | user_input | 追加のユーザー入力。 データタイプ：文字列 最大長：4,000 | | variables | 変更要求に関連付けられた変数の名前と値のペア。 データタイプ：文字列 最大長：40 | | watch_list | 追加のコメントが追加された場合、または変更要求のステータスが「解決済み」または「クローズ済み」に変更された場合に、この変更要求に関する通知を受信するユーザーの sys_id のリスト。ユーザー \[sys_user\] テーブルにあります。 データタイプ：アレイ | | wf_activity | 変更要求に関連付けられたワークフローアクティビティレコードの sys_id。ワークフローアクティビティ \[wf_activity\] テーブルにあります。 データタイプ：文字列 | | work_end | 変更要求の作業が終了した日時。 データタイプ：文字列 | | work_notes | 変更要求の解決方法に関する情報、または変更要求の解決手順。 データタイプ：文字列 最大長：4,000 | | work_notes_list | 作業メモが追加されたときに、この変更要求についての通知を受け取る内部ユーザーの sys_id のリスト。ユーザー \[sys_user\] テーブルにあります。 データタイプ：アレイ | | work_start | 変更要求の作業が開始された日時。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" 簡潔にするため、結果には 1 つの変更要求レコードのみが含まれます。 { "result": [ { "reason": { "display_value": "", "value": "" }, "parent": { "display_value": "", "value": "" }, "watch_list": { "display_value": "", "value": "" }, "proposed_change": { "display_value": "", "value": "" }, "upon_reject": { "display_value": "Cancel all future Tasks", "value": "cancel" }, "sys_updated_on": { "display_value": "2015-07-06 11:59:27", "value": "2015-07-06 18:59:27", "display_value_internal": "2015-07-06 11:59:27" }, "type": { "display_value": "Standard", "value": "standard" }, "approval_history": { "display_value": "", "value": "" }, "skills": { "display_value": "", "value": "" }, "test_plan": { "display_value": "--Confirm that there are no monitoring alerts for the router", "value": "--Confirm that there are no monitoring alerts for the router" }, "number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "is_bulk": { "display_value": "false", "value": false }, "cab_delegate": { "display_value": "", "value": "" }, "requested_by_date": { "display_value": "", "value": "", "display_value_internal": "" }, "ci_class": { "display_value": "cmdb_ci", "value": "cmdb_ci" }, "state": { "display_value": "Closed", "value": 3.0 }, "sys_created_by": { "display_value": "admin", "value": "admin" }, "knowledge": { "display_value": "false", "value": false }, "order": { "display_value": "", "value": "" }, "phase": { "display_value": "Requested", "value": "requested" }, "cmdb_ci": { "display_value": "", "value": "" }, "delivery_plan": { "display_value": "", "value": "" }, "impact": { "display_value": "3 - Low", "value": 3.0 }, "contract": { "display_value": "", "value": "" }, "active": { "display_value": "false", "value": false }, "work_notes_list": { "display_value": "", "value": "" }, "priority": { "display_value": "4 - Low", "value": 4.0 }, "sys_domain_path": { "display_value": "/", "value": "/" }, "cab_recommendation": { "display_value": "", "value": "" }, "production_system": { "display_value": "false", "value": false }, "rejection_goto": { "display_value": "", "value": "" }, "review_date": { "display_value": "", "value": "", "display_value_internal": "" }, "requested_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "business_duration": { "display_value": "", "value": "" }, "group_list": { "display_value": "", "value": "" }, "change_plan": { "display_value": "", "value": "" }, "approval_set": { "display_value": "", "value": "", "display_value_internal": "" }, "wf_activity": { "display_value": "", "value": "" }, "implementation_plan": { "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform", "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform" }, "universal_request": { "display_value": "", "value": "" }, "end_date": { "display_value": "", "value": "", "display_value_internal": "" }, "short_description": { "display_value": "Clear BGP sessions on a Cisco router", "value": "Clear BGP sessions on a Cisco router" }, "correlation_display": { "display_value": "", "value": "" }, "work_start": { "display_value": "2015-07-06 11:56:04", "value": "2015-07-06 18:56:04", "display_value_internal": "2015-07-06 11:56:04" }, "delivery_task": { "display_value": "", "value": "" }, "outside_maintenance_schedule": { "display_value": "false", "value": false }, "additional_assignee_list": { "display_value": "", "value": "" }, "std_change_producer_version": { "display_value": "Clear BGP sessions on a Cisco router - 1", "value": "16c2273c47010200e90d87e8dee49006" }, "sys_class_name": { "display_value": "Change Request", "value": "change_request" }, "service_offering": { "display_value": "", "value": "" }, "closed_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "follow_up": { "display_value": "", "value": "", "display_value_internal": "" }, "review_status": { "display_value": "", "value": "" }, "reassignment_count": { "display_value": "2", "value": 2.0 }, "start_date": { "display_value": "", "value": "", "display_value_internal": "" }, "assigned_to": { "display_value": "", "value": "" }, "variables": { "display_value": "variable_pool", "value": "variable_pool" }, "sla_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments_and_work_notes": { "display_value": "", "value": "" }, "escalation": { "display_value": "Normal", "value": 0.0 }, "upon_approval": { "display_value": "Proceed to Next Task", "value": "proceed" }, "correlation_id": { "display_value": "", "value": "" }, "made_sla": { "display_value": "true", "value": true }, "backout_plan": { "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work", "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work" }, "conflict_status": { "display_value": "Not Run", "value": "Not Run" }, "task_effective_number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "opened_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "user_input": { "display_value": "", "value": "" }, "sys_created_on": { "display_value": "2015-07-06 11:55:46", "value": "2015-07-06 18:55:46", "display_value_internal": "2015-07-06 11:55:46" }, "on_hold_task": { "display_value": "", "value": "" }, "sys_domain": { "display_value": "global", "value": "global" }, "route_reason": { "display_value": "", "value": "" }, "closed_at": { "display_value": "2015-07-06 11:56:23", "value": "2015-07-06 18:56:23", "display_value_internal": "2015-07-06 11:56:23" }, "review_comments": { "display_value": "", "value": "" }, "business_service": { "display_value": "", "value": "" }, "time_worked": { "display_value": "", "value": "" }, "chg_model": { "display_value": "", "value": "" }, "expected_start": { "display_value": "", "value": "", "display_value_internal": "" }, "opened_at": { "display_value": "2015-06-09 11:55:46", "value": "2015-06-09 18:55:46", "display_value_internal": "2015-06-09 11:55:46" }, "work_end": { "display_value": "2015-07-06 11:56:10", "value": "2015-07-06 18:56:10", "display_value_internal": "2015-07-06 11:56:10" }, "phase_state": { "display_value": "Open", "value": "open" }, "cab_date": { "display_value": "", "value": "", "display_value_internal": "" }, "work_notes": { "display_value": "", "value": "" }, "close_code": { "display_value": "Successful", "value": "successful" }, "assignment_group": { "display_value": "Network", "value": "287ebd7da9fe198100f92cc8d1d2154e" }, "description": { "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n", "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n" }, "on_hold_reason": { "display_value": "", "value": "" }, "calendar_duration": { "display_value": "", "value": "" }, "close_notes": { "display_value": "Completed without issues", "value": "Completed without issues" }, "sys_id": { "display_value": "1766f1de47410200e90d87e8dee490f6", "value": "1766f1de47410200e90d87e8dee490f6" }, "contact_type": { "display_value": "Phone", "value": "phone" }, "cab_required": { "display_value": "false", "value": false }, "urgency": { "display_value": "3 - Low", "value": 3.0 }, "scope": { "display_value": "Medium", "value": 3.0 }, "company": { "display_value": "", "value": "" }, "justification": { "display_value": "", "value": "" }, "activity_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments": { "display_value": "", "value": "" }, "approval": { "display_value": "Approved", "value": "approved" }, "due_date": { "display_value": "", "value": "", "display_value_internal": "" }, "sys_mod_count": { "display_value": "10", "value": 10.0 }, "on_hold": { "display_value": "false", "value": false }, "sys_tags": { "display_value": "", "value": "" }, "conflict_last_run": { "display_value": "", "value": "", "display_value_internal": "" }, "risk_value": { "display_value": "", "value": "" }, "unauthorized": { "display_value": "false", "value": false }, "risk": { "display_value": "Moderate", "value": 3.0 }, "location": { "display_value": "", "value": "" }, "category": { "display_value": "Other", "value": "Other" }, "risk_impact_analysis": { "display_value": "", "value": "" } } ] } ## Change Management - GET /sn_chg_rest/change/{change_sys_id}/nextstates {#ariaid-title10} 指定された変更要求で利用可能なステータスのリスト (現在のステータスを含む) を取得します。 実装された Change Management のバージョンに基づいて次のステータスに移行する方法も、利用可能であれば提供します。変更が変更モデル駆動型の場合、エンドポイントは合格または不合格の条件を返します。また、指定された移行のすべての条件に合格しているかどうかに関する情報も提供します。この情報は、タイプ駆動型および従来の変更要求では使用できません。 ### URL 形式 バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{change_sys_id}/nextstates デフォルトの URL：/api/sn_chg_rest/change/{change_sys_id}/nextstates ### サポートされている要求パラメーター {#change-GET-chg_sys_id-nextstates__entry__2}{#change-GET-chg_sys_id-nextstates__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | change_sys_id | 変更要求の sys_id。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 49. パスパラメーター] {#change-GET-chg_sys_id-nextstates__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 50. クエリパラメーター] {#change-GET-chg_sys_id-nextstates__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 51. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-chg_sys_id-nextstates__entry__16}{#change-GET-chg_sys_id-nextstates__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 52. 要求ヘッダー] {#change-GET-chg_sys_id-nextstates__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 53. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-chg_sys_id-nextstates__entry__24}{#change-GET-chg_sys_id-nextstates__entry-200-status-code}{#change-GET-chg_sys_id-nextstates__entry-404-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 404 | 見つかりません。要求アイテムが見つかりませんでした。 | [表 : 54. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-chg_sys_id-nextstates__entry__30} | 名前 | 説明 | |-|-| | available_states | 指定された変更要求で利用可能なステータスの値 (現在のステータスを含む)。 データタイプ：アレイ | | state_label | 利用可能なステータスにラベルを関連付けるキーと値のペア。 データタイプ：オブジェクト | | state_transitions | 利用可能な各ステータスに移行するために何が必要かに関する情報。利用可能な個別の「移行先ステータス」はそれぞれ独自のアレイ内にあり、独自のオブジェクト内にあるその移行先ステータスに対してそれぞれ異なる条件セットがあります。 データタイプ：アレイ "state_transitions": [ { "automatic_transition": Boolean, "conditions": [Array], "display_value": "String", "from_state": "String", "sys_id": "String", "to_state": "String", "transition_available": Boolean } ] | | state_transitions.automatic_transition | このステータスに自動的に移行するかどうかを示すフラグ。 有効な値： * true：変更要求は自動的にこのステータスに移行します。 * false：変更要求は自動的にこのステータスに移行しません。 {#change-GET-chg_sys_id-nextstates__ul_w1g_3zl_jtb} データタイプ：ブーリアン | | state_transitions.conditions | ステータスに関連付けられた条件のリスト。 データタイプ：オブジェクトのアレイ "conditions": [ { "condition": {Object}, "passed": Boolean } ] | | state_transitions.conditions.condition | 特定の条件の値。 データタイプ：オブジェクト "condition": { "description": "String", "name": "String", "sys_id": "String" } | | state_transitions.conditions.condition.description | 条件の説明。 データタイプ：文字列 | | state_transitions.conditions.condition.name | 条件の名前。 データタイプ：文字列 | | state_transitions.conditions.condition.sys_id | 条件の sys_id。 データタイプ：文字列 | | state_transitions.conditions.passed | 変更要求が関連する条件を満たしているかどうかを示すフラグ。 有効な値： * true：条件を満たしています。 * false：条件を満たしていません。 {#change-GET-chg_sys_id-nextstates__ul_x2m_ccm_jtb} | | state_transitions.display_value | 表示されるステータスの説明。 データタイプ：文字列 | | state_transitions.from_state | 変更要求の移行元ステータスの値。 データタイプ：文字列 | | state_transitions.sys_id | 移行ステータスの sys_id。 データタイプ：文字列 | | state_transitions.to_state | 変更要求の移行先ステータスの値。 データタイプ：文字列 | | state_transitions.transition_available | 変更要求が現在のステータスからこのステータスに移行できるかどうかを示すフラグ。 有効な値： * true：このステータスに移行できます。 * false：このステータスに移行できません。 | [ ] ### cURL 要求 次のコード例は、このエンドポイントを呼び出す方法を示しています。 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f"/nextstates \ --request GET \ --header "Accept:application/json" \ --user "username":"password" 返される結果： { "result": { "available_states": [ "0", "4", "-1" ], // State values "state_transitions": [ [ { "sys_id": "7a0d2ccdc343101035ae3f52c1d3ae2e", // sttrm_state_transition sys id "display_value": "Implement to Review", "from_state": "-1", "to_state": "0", "transition_available": false, // If true, can move to this state "automatic_transition": true, // If true, automatically moves to this state "conditions": [ { "passed": false, // If true, change request met this condition "condition": { "name": "No active Change Tasks", "description": null, "sys_id": "3c1d2ccdc343101035ae3f52c1d3aea4" } } ] }, { "sys_id": "db401481c343101035ae3f52c1d3aedd", "display_value": "Implement to Review", "from_state": "-1", "to_state": "0", "transition_available": true, "automatic_transition": false, "conditions": [ { "passed": true, "condition": { "name": "Not On hold", "description": null, "sys_id": "2132deb6c303101035ae3f52c1d3ae8c" } } ] } ], [ { "sys_id": "5327c551c343101035ae3f52c1d3aeec", "display_value": "Implement to Canceled", "from_state": "-1", "to_state": "4", "transition_available": true, "automatic_transition": false, "conditions": [] } ] ], "state_label": { // state value to label pairs "0": "Review", "4": "Canceled", "-1": "Implement" } } } ## Change Management - GET /sn_chg_rest/change/{change_sys_id}/schedule {#ariaid-title11} 変更要求に利用可能なタイムスロットを取得できるようにします。 必要なロール： sn_change_writer 注: このエンドポイントを実行すると、利用可能な開始時間と終了時間が表示されません。応答本文の worker.link プロパティにあるリンクを使用して、スケジュールスデータを取得します。 関連項目： * [GET /sn_chg_rest/change/ci/{cmdb_ci_sys_id}/schedule](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-c_id-schedule "構成アイテム ID と期間で利用可能なタイムスロットを取得できるようにします。オプションで予定開始時間を含めることができます。") * [PATCH /sn_chg_rest/change/{change_sys_id}/schedule/first_available](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-PATCH-c_id-sched-first "最初に見つかった利用可能なタイムスロットを使用して、変更要求の予定開始時間と予定終了時間を更新します。") {#change-GET-change-sys_id-sched__ul_orx_mts_npb} ### URL 形式 バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{change_sys_id}/schedule デフォルトの URL：/api/sn_chg_rest/change/{change_sys_id}/schedule ### サポートされている要求パラメーター {#change-GET-change-sys_id-sched__entry__2}{#change-GET-change-sys_id-sched__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | change_sys_id | 次の利用可能なタイムスロットを検索する変更要求の sys_id。\[change_request\] テーブルにあります。 選択した変更要求には、予定開始時間と予定終了時間のある構成アイテム (cmdb_ci) が必要です。 | [表 : 55. パスパラメーター] {#change-GET-change-sys_id-sched__table_fd4_yhf_jpb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 56. クエリパラメーター] {#change-GET-change-sys_id-sched__table_fd4_yhf_jpb} {#change-GET-change-sys_id-sched__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 57. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-change-sys_id-sched__entry__16}{#change-GET-change-sys_id-sched__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 58. 要求ヘッダー] {#change-GET-change-sys_id-sched__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 59. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-change-sys_id-sched__entry__24} | ステータスコード | 説明 | |-|-| | 202 | システムが要求を承認しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 考えられる問題： * 指定された変更要求に予定開始時間と予定終了時間がありません。 * 指定した変更要求には、関連付けられた構成アイテム (cmdb_ci) がありません。 * ユーザーに変更要求のフィールドへの読み取りアクセス権がありません。 {#change-GET-change-sys_id-sched__ul_nng_24r_spb} | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 考えられる問題： * 指定された情報に基づく変更要求を見つけることができません。 * ユーザーにはこのレコードへの読み取りアクセス権がありません。 {#change-GET-change-sys_id-sched__ul_ery_g1j_rpb} | [表 : 60. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-change-sys_id-sched__section_p33_ccf_jpb} {#change-GET-change-sys_id-sched__table_is2_n4s_jpb__entry__2}{#change-GET-change-sys_id-sched__row-result-error-cmdb}{#change-GET-change-sys_id-sched__row-result-error_detail-cmdb}{#change-GET-change-sys_id-sched__row-result-error_message-cmdb} | 名前 | 説明 | |-|-| | error | エンドポイント要求の処理中に発生したエラーに関する情報。 データタイプ：オブジェクト "error": { "detail": "String", "message": "String", "status": "String" } | | error.detail | エラーに関する追加情報。 データタイプ：文字列 | | error.message | エラーを識別するメッセージ。 データタイプ：文字列 | | messages | メッセージ情報。 データタイプ：オブジェクト "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | messages.errorMessages | 要求の処理中にエラーメッセージが表示されました。 データタイプ：アレイ | | messages.infoMessages | 要求の処理中に情報メッセージが表示されました。 データタイプ：アレイ | | messages.warningMessages | 要求の処理中に警告メッセージが表示されました。 データタイプ：アレイ | | 要求 | 元のエンドポイント要求。 データタイプ：文字列 | | state | ワーカーの現在のステータスに関する情報。 データタイプ：オブジェクト state: { display_value: "String", value: Number } | | state.display_value | ワーカーのステータス値を表示します。これらの値は state.value パラメーターに直接関連付けられています。 可能な値： * 完了 * エラー * 対応中 * 待機中 {#change-GET-change-sys_id-sched__ul_ehh_nxy_jhb} データタイプ：文字列 | | state.value | ワーカーのステータスの数値。 可能な値： * 1 * 2 * 3 * 4 {#change-GET-change-sys_id-sched__ul_zw1_fxy_jhb} データタイプ：数値 | | type | 要求のタイプを示します。 有効な値：schedule データタイプ：文字列 | | worker | 関連付けられたワーカーに関する情報。 データタイプ：オブジェクト "worker": { "link": "String", "sysId": "String" } | | worker.link | タイムスロットデータを取得するためのリンク。結果を表示するには、[GET /sn_chg_rest/change/worker/{sys_id}](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-worker "指定された非同期ワーカーの現在のステータス、情報、およびエラーを取得します。") で sys_id を使用します。 データタイプ：文字列 | | worker.sysId | 変更要求と関連付けるワーカーの sys_id。 データタイプ：文字列 | | status | エラーが発生した場合にのみ表示されます。エンドポイント処理のステータス。 可能な値：failure データタイプ：文字列 | [ ] {#change-GET-change-sys_id-sched__table_is2_n4s_jpb} ### 利用可能なタイムスロットを取得 {#change-GET-change-sys_id-sched__cmapi-sched-get-change} worker.link で指定された値を使用して、スケジュール枠の詳細を取得します。値の形式は次のとおりです。 https://instance.service-now.com/api/sn_chg_rest/change/worker/\ 結果を表示するには、[GET /sn_chg_rest/change/worker/{worker_sys_id}](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-worker "指定された非同期ワーカーの現在のステータス、情報、およびエラーを取得します。") で worker_sys_id を使用します。 応答の本文にはステータスが含まれ、処理が完了すると結果が提供されます。 ワーカー応答本文のパラメーターの結果は、タイムスロットの可用性によって異なります。 * 指定されたタイムスロットがスケジュールタイムスロット内の変更要求で利用可能な場合、ワーカー API は payload.spans プロパティで利用可能なタイムスロットをリストします。それ以外の場合は、payload.spans プロパティは結果に表示されません。 * 定義されたスケジューリングタイムスロット内に指定された変更要求期間で利用可能なタイムスロットがない場合、messages.infoMessages は次のように表示されます：`D` 注: 変更要求スケジューリングタイムスロットのデフォルト値は 90 日です。この値を変更するには、change.conflict.next_available.schedule_window プロパティを変更します。詳細については、「 [競合分析プロパティの構成](https://www.servicenow.com/docs/access?context=configure-conflict-properties&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。{#change-GET-change-sys_id-sched__cmapi-wkr-no-slots-90-li} {#change-GET-change-sys_id-sched__cmapi-wkr-no-slots-90-li} 次の GET /sn_chg_rest/change/worker/{sys_id} の例は、worker.link の詳細で指定された ID を使用して提供された出力を示しています。結果には、タスク期間で利用可能なオープンなタイムスパンがリストされます。 { "result": { "worker": { "sysId": "9b3f62e0a4c87010f87712198fe9cad1", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/9b3f62e0a4c87010f87712198fe9cad1" }, "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 3, "display_value": "Complete" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] }, "payload": { "spans": [ { "start": { "value": "2021-05-08 08:00:00", "display_value": "2021-05-08 01:00:00" }, "end": { "value": "2021-05-08 11:00:00", "display_value": "2021-05-08 04:00:00" } }, { "start": { "value": "2021-05-15 08:00:00", "display_value": "2021-05-15 01:00:00" }, "end": { "value": "2021-05-15 11:00:00", "display_value": "2021-05-15 04:00:00" } }, ... ] } } } ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/change/{change_sys_id}/schedule" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" 結果には、GET /sn_chg_rest/change/worker/endpoint で提供された sys_id を実行するために使用できる worker.link の詳細が含まれています。 { "result": { "worker": { "sysId": "9b3f62e0a4c87010f87712198fe9cad1", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/9b3f62e0a4c87010f87712198fe9cad1" }, "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 1, "display_value": "Waiting" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] } } } ## Change Management - GET /sn_chg_rest/change/{change_sys_id}/task {#ariaid-title12} 指定された基準に基づいて、指定された変更要求に関連付けられた 1 つ以上のタスクを取得します。 ### URL 形式 {#change-GET-c_id-task__section_jjh_pvm_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{change_sys_id}/task デフォルトの URL：/api/sn_chg_rest/change/{change_sys_id}/task ### サポートされている要求パラメーター {#change-GET-c_id-task__entry__2}{#change-GET-c_id-task__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | change_sys_id | タスクを取得する変更要求の sys_id。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 61. パスパラメーター] {#change-GET-c_id-task__table_tnj_bxm_ylb__entry__2}{#change-GET-c_id-task__sysparm_offset-ph-RESTAPI} | 名前 | 説明 | |-|-| | key-value pairs | 要求の作成時に変更するフィールド。キーはテンプレート内のフィールド名で、値はフィールドに入力する情報です。 変更できず、渡された場合に無視されるフィールド： * ビジネスルール * ACL で定義されている読み取り専用フィールド * 存在しないフィールド {#change-GET-c_id-task__ul_uh4_dxm_ylb} データタイプ：文字列 | | order | 返された変更要求をソートするためのフィールド。デフォルト: number データタイプ：文字列 | | sysparm_limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：数値 デフォルト：500 | | sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「`sysparm_offset=sysparm_offset+sysparm_limit`」を使用します。{#change-GET-c_id-task__sysparm_offset-p-RESTAPI} sysparm_offset パラメーターに負の数値を渡さないでください。 データタイプ：数値 デフォルト：0 | | sysparm_query | 結果セットをフィルタリングするために使用される[エンコードされたクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)。UI フィルターを使用して、適切にエンコードクエリーを取得できます。 構文：`sysparm_query=`。 * \：フィルターを適用するテーブル列の名前。 * \：次の値をサポートします。 * =：\ と完全一致します。 * !=：\ と一致しません。 * \^：複数のクエリステートメントの論理 AND。 * \^OR：複数のクエリステートメントの論理 OR。 * LIKE：指定された文字列が \ に含まれています。データタイプが文字列である \ フィールドに対してのみ機能します。 * STARTSWITH：\ は指定された文字列で始まります。データタイプが文字列である \ フィールドに対してのみ機能します。 * ENDSWITH：\ は指定した文字列で終了します。データタイプが文字列である \ フィールドに対してのみ機能します。 {#change-GET-c_id-task__ul_bgf_5vz_mlb} \：照合する値。 {#change-GET-c_id-task__ul_g2p_svz_mlb} すべてのパラメーターで大文字と小文字が区別されます。クエリには、sysparm_query=\\\\[\\\\\] のように、複数のエントリを含めることができます。 例： `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` エンコードクエリーは、機能別の順番もサポートしています。特定のフィールドに基づいて回答を並べ替えるには、`ORDERBY` と `ORDERBYDESC` の句を sysparm_query で使用します。 構文： * `ORDERBY` * `ORDERBYDESC` {#change-GET-c_id-task__ul_sq4_rc1_nlb} 例：`sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` このクエリは、すべてのアクティブなレコードをフィルタリングし、結果を番号で昇順に並べ替えた後、カテゴリで降順に並べ替えます。 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ：文字列 | | textSearch | すべての変更タスクレコードフィールドを検索するために使用する文字列。この検索では、ServiceNow の全文検索プラットフォーム機能が使用され、デフォルトで `IR_AND_OR_QUERY` に設定されます。 データタイプ：文字列 | [表 : 62. クエリパラメーター] {#change-GET-c_id-task__table_tnj_bxm_ylb} {#change-GET-c_id-task__entry__22} | 名前 | 説明 | |-|-| | なし | | [表 : 63. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-c_id-task__entry__26}{#change-GET-c_id-task__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 64. 要求ヘッダー] {#change-GET-c_id-task__entry__30} | ヘッダー | 説明 | |-|-| | なし | | [表 : 65. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-c_id-task__entry__34}{#change-GET-c_id-task__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 66. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-c_id-task__entry__46} | 名前 | 説明 | |-|-| | name-value pairs | 削除前に識別された変更要求タスクのすべてのフィールド (キー) とその関連付けられた値。 データタイプ：オブジェクト | | parent | タスクに関連付けられた変更要求の情報。 データタイプ：オブジェクト parent: { display_value: "String", value: "String" } | | parent.display_value | UI に表示する変更要求の情報。 データタイプ：文字列 | | parent.value | タスクに関連付けられた変更要求の sys_id。 データタイプ：文字列 | | sys_id | 変更要求タスクの sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求タスクの sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求タスクの sys_id。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' { result: [ { sys_id: { value: "12629ec4b750230096c3e4f6ee11a9d5", display_value: "12629ec4b750230096c3e4f6ee11a9d5" }, parent: { value: "0f4ac6c4b750230096c3e4f6ee11a9fe ", display_value: "CHG0033046 " }, ..., // all valid fields in record, example below short_description: { value: "Retire node", display_value: "Retire node" } }, { // next record found }, ... // and so on ] } ## Change Management - GET /sn_chg_rest/change/{sys_id} {#ariaid-title13} 指定された sys_id で識別される変更要求を取得します。 ### URL 形式 バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/{sys_id} ### サポートされている要求パラメーター {#change-GET-change-sys_id__entry__2}{#change-GET-change-sys_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更要求 \[change_request\] テーブルから取得する変更要求レコードの sys_id。 データタイプ：文字列 | [表 : 67. パスパラメーター] {#change-GET-change-sys_id__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 68. クエリパラメーター] {#change-GET-change-sys_id__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 69. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-change-sys_id__entry__16}{#change-GET-change-sys_id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 70. 要求ヘッダー] {#change-GET-change-sys_id__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 71. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-change-sys_id__entry__24}{#change-GET-change-sys_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 72. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-change-sys_id__entry__36}{#change-GET-change-sys_id__action_status-entry-chg_req}{#change-GET-change-sys_id__active-entry-chg_req}{#change-GET-change-sys_id__activity_due-entry-chg_req}{#change-GET-change-sys_id__add_assignee_list-entry-chg_req}{#change-GET-change-sys_id__approval-entry-chg_req}{#change-GET-change-sys_id__approval_history-entry-chg_req}{#change-GET-change-sys_id__approval_set-entry-chg_req}{#change-GET-change-sys_id__assigned_to-entry-chg_req}{#change-GET-change-sys_id__assign_group-entry-chg_req}{#change-GET-change-sys_id__backout_plan-entry-chg_req}{#change-GET-change-sys_id__business_dur-entry-chg_req}{#change-GET-change-sys_id__business_service-entry-chg_req}{#change-GET-change-sys_id__cab_date-entry-chg_req}{#change-GET-change-sys_id__cab_delegate-entry-chg_req}{#change-GET-change-sys_id__cab_rec-entry-chg_req}{#change-GET-change-sys_id__cab_req-entry-chg_req}{#change-GET-change-sys_id__cal_dur-entry-chg_req}{#change-GET-change-sys_id__category-entry-chg_req}{#change-GET-change-sys_id__change_plan-entry-chg_req}{#change-GET-change-sys_id__chg_model-entry-chg_req}{#change-GET-change-sys_id__closed_at-entry-chg_req}{#change-GET-change-sys_id__closed_by-entry-chg_req}{#change-GET-change-sys_id__close_code-entry-chg_req}{#change-GET-change-sys_id__close_notes-entry-chg_req}{#change-GET-change-sys_id__cmdb_ci-entry-chg_req}{#change-GET-change-sys_id__comments-entry-chg_req}{#change-GET-change-sys_id__comments_work_notes-entry-chg_req}{#change-GET-change-sys_id__company-entry-chg_req}{#change-GET-change-sys_id__conflict_last_run-entry-chg_req}{#change-GET-change-sys_id__conflict_status-entry-chg_req}{#change-GET-change-sys_id__contact_type-entry-chg_req}{#change-GET-change-sys_id__contract-entry-chg_req}{#change-GET-change-sys_id__corr_display-entry-chg_req}{#change-GET-change-sys_id__corr_id-entry-chg_req}{#change-GET-change-sys_id__delivery_plan-entry-chg_req}{#change-GET-change-sys_id__delivery_task-entry-chg_req}{#change-GET-change-sys_id__description-entry-chg_req}{#change-GET-change-sys_id__end_date-entry-chg_req}{#change-GET-change-sys_id__escalation-entry-chg_req}{#change-GET-change-sys_id__expected_start-entry-chg_req}{#change-GET-change-sys_id__follow_up-entry-chg_req}{#change-GET-change-sys_id__group_list-entry-chg_req}{#change-GET-change-sys_id__impact-entry-chg_req}{#change-GET-change-sys_id__imp_plan-entry-chg_req}{#change-GET-change-sys_id__justification-entry-chg_req}{#change-GET-change-sys_id__knowledge-entry-chg_req}{#change-GET-change-sys_id__location-entry-chg_req}{#change-GET-change-sys_id__made_sla-entry-chg_req}{#change-GET-change-sys_id__needs_attention-entry-chg_req}{#change-GET-change-sys_id__number-entry-chg_req}{#change-GET-change-sys_id__on_hold-entry-chg_req}{#change-GET-change-sys_id__on_hold_reason-entry-chg_req}{#change-GET-change-sys_id__on_hold_task-entry-chg_req}{#change-GET-change-sys_id__opened_at-entry-chg_req}{#change-GET-change-sys_id__opened_by-entry-chg_req}{#change-GET-change-sys_id__order-entry-chg_req}{#change-GET-change-sys_id__outside_maint_sched-entry-chg_req}{#change-GET-change-sys_id__parent-entry-chg_req}{#change-GET-change-sys_id__phase-entry-chg_req}{#change-GET-change-sys_id__phase_state-entry-chg_req}{#change-GET-change-sys_id__priority-entry-chg_req}{#change-GET-change-sys_id__prod_system-entry-chg_req}{#change-GET-change-sys_id__reason-entry-chg_req}{#change-GET-change-sys_id__reassign_count-entry-chg_req}{#change-GET-change-sys_id__rejection_goto-entry-chg_req}{#change-GET-change-sys_id__requested_by-entry-chg_req}{#change-GET-change-sys_id__requested_by_date-entry-chg_req}{#change-GET-change-sys_id__review_comments-entry-chg_req}{#change-GET-change-sys_id__review_date-entry-chg_req}{#change-GET-change-sys_id__review_status-entry-chg_req}{#change-GET-change-sys_id__risk-entry-chg_req}{#change-GET-change-sys_id__risk_impact_analysis-entry-chg_req}{#change-GET-change-sys_id__route_reason-entry-chg_req}{#change-GET-change-sys_id__scope-entry-chg_req}{#change-GET-change-sys_id__sevice_offering-entry-chg_req}{#change-GET-change-sys_id__short_desc-entry-chg_req}{#change-GET-change-sys_id__skills-entry-chg_req}{#change-GET-change-sys_id__sla_due-entry-chg_req}{#change-GET-change-sys_id__start_date-entry-chg_req}{#change-GET-change-sys_id__state-entry-chg_req}{#change-GET-change-sys_id__std_chg_prodversion-entry-chg_req}{#change-GET-change-sys_id__sys_class_name-entry-chg_req}{#change-GET-change-sys_id__sys_create_by-entry-chg_req}{#change-GET-change-sys_id__sys_created_on-entry-chg_req}{#change-GET-change-sys_id__sys_domain-entry-chg_req}{#change-GET-change-sys_id__sys_domain_path-entry-chg_req}{#change-GET-change-sys_id__sys_id-entry-chg_req}{#change-GET-change-sys_id__sys_mod_count-entry-chg_req}{#change-GET-change-sys_id__sys_updated_by-entry-chg_req}{#change-GET-change-sys_id__sys_updated_on-entry-chg_req}{#change-GET-change-sys_id__task_eff_number-entry-chg_req}{#change-GET-change-sys_id__task_for-entry-chg_req}{#change-GET-change-sys_id__test_plan-entry-chg_req}{#change-GET-change-sys_id__time_worked-entry-chg_req}{#change-GET-change-sys_id__type-entry-chg_req}{#change-GET-change-sys_id__unauthorized-entry-chg_req}{#change-GET-change-sys_id__universal_request-entry-chg_req}{#change-GET-change-sys_id__upon_approval-entry-chg_req}{#change-GET-change-sys_id__upon_reject-entry-chg_req}{#change-GET-change-sys_id__urgency-entry-chg_req}{#change-GET-change-sys_id__user_input-entry-chg_req}{#change-GET-change-sys_id__variables-entry-chg_req}{#change-GET-change-sys_id__watch_list-entry-chg_req}{#change-GET-change-sys_id__wf_activity-entry-chg_req}{#change-GET-change-sys_id__work_end-entry-chg_req}{#change-GET-change-sys_id__work_notes-entry-chg_req}{#change-GET-change-sys_id__work_notes_list-entry-chg_req}{#change-GET-change-sys_id__work_start-entry-chg_req} | 要素 | 説明 | |-|-| | result | 1 つ以上の変更要求レコードオブジェクトを含むリスト。各オブジェクトは変更要求を表します。変更要求オブジェクトの各要素は、変更要求 \[change_request\] テーブルの関連付けられたレコードのフィールドに対応します。 すべての要素には、value および display_value の名前と値のペアが含まれています。日付フィールドには、display_value_internal の名前と値のペアが含まれています。 データタイプ：アレイ | | action_status | 関連する変更要求の現在のアクションステータス。 可能な値： * 1：社内でブロック済み * 2：顧客によりブロック済み * 3：社内でおよび顧客によりブロック済み * 4：要注意 {#change-GET-change-sys_id__ul_nhd_tc3_2hb} データタイプ：数値 | | active | 変更要求がアクティブかどうかを示すフラグ。 可能な値： * true：変更要求はアクティブです * false：変更要求はアクティブではありません {#change-GET-change-sys_id__ul_dqy_5jb_2hb} データタイプ：ブール デフォルト：true | | activity_due | 関連付けられたケースの完了予定日時。 データタイプ：文字列 | | additional_assignee_list | 変更要求の作業にアサインされた追加のユーザーの sys_id のリスト。 データタイプ：アレイ | | approval | 必要な承認プロセスのタイプ。 データタイプ：文字列 デフォルト：not requested | | approval_history | 最新の承認履歴ジャーナルエントリ。 データタイプ：文字列 | | approval_set | 関連するアクションが承認された日時。 データタイプ：文字列 | | assigned_to | 変更要求にアサインされたユーザーの sys_id。 データタイプ：文字列 | | assignment_group | 変更要求にアサインされたグループの sys_id。 データタイプ：文字列 | | backout_plan | 変更を取り消す必要がある場合に実行する計画の説明。 データタイプ：文字列 | | business_duration | 変更の完了までにかかったスケジュールされた作業時間、作業日数、および作業週数。 データタイプ：文字列 | | business_service | 変更要求に関連付けられたビジネスサービスの sys_id。サービス \[cmdb_ci_service\] テーブルにあります。 データタイプ：文字列 | | cab_date | 変更諮問委員会 (CAB) の会議の日付。 データタイプ：文字列 | | cab_delegate | CAB 会議中に CAB マネージャーの代理を務めることができるユーザーの sys_id。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 | | cab_recommendation | 変更要求の CAB の提言の説明。 データタイプ：文字列 最大長：4,000 | | cab_required | CAB が必須かどうかを示すフラグ 。 可能な値： * true：変更諮問委員会が必要です。 * false：変更諮問委員会は必要ではありません。 {#change-GET-change-sys_id__ul_jbv_tb4_tnb} データタイプ：ブール デフォルト値：false | | calendar_duration | 現在 変更管理 で使用されていません。 データタイプ：文字列 | | category | 変更のカテゴリ (たとえば、ハードウェア、ネットワーク、ソフトウェアなどです)。 データタイプ：文字列 デフォルト：Other | | change_plan | 変更要求を管理および制御するためのアクティビティとロール。 データタイプ：文字列 | | chg_model | 関連する変更要求の基になった変更モデルの sys_id。変更モデル \[chg_model\] テーブルにあります。変更モデルは、変更要求に対して完了する必要があるステータスフロー、移行、およびプロセスアクティビティを定義します。 データタイプ：文字列 | | closed_at | 関連する変更要求がクローズされた日時。 データタイプ：文字列 | | closed_by | 変更要求をクローズしたユーザーの sys_id。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 | | close_code | 変更要求がクローズされたときに変更要求に割り当てられたコード。たとえば、成功、成功 (問題あり)、不成功などです。 データタイプ：文字列 | | close_notes | ユーザーが変更要求をクローズしたときに入力したメモ。 データタイプ：文字列 | | cmdb_ci | 変更要求に関連付けられた構成アイテムの sys_id。構成アイテム \[cmdb_ci\] テーブルにあります。 データタイプ：文字列 | | コメント | 関連する変更要求に入力された顧客向け作業メモのリスト。 データタイプ：アレイ | | comments_and_work_notes | 関連する変更要求に入力された内部および顧客向けの両方の作業メモのリスト。 データタイプ：アレイ 最大長：4,000 | | company | 変更要求と関連付けられた会社の sys_id。会社 \[core_company\] テーブルにあります。 データタイプ：文字列 | | conflict_last_run | 変更要求で競合の検出スクリプトが最後に実行された日時。 データタイプ：文字列 | | conflict_status | 競合の検出スクリプトによって検出された現在の競合ステータス (競合、未実行など)。 データタイプ：文字列 最大長：40 デフォルト：未実行 | | contact_type | 変更要求が最初に要求された方法。 可能な値： * chat * email * phone * social * web データタイプ：文字列 | | contract | 変更要求と関連付けられた契約の sys_id。契約 \[ast_contract\] テーブルにあります。 データタイプ：文字列 | | correlation_display | correlation_id のユーザーに分かりやすい名前。 データタイプ：文字列 最大長：100 | | correlation_id | サードパーティシステム内の一致する変更要求レコードのグローバル一意識別子 (GUID)。 データタイプ：文字列 最大長：100 | | delivery_plan | 使用されなくなりました。変更要求と関連付ける配送計画の sys_id。実行計画 \[sc_cat_item_delivery_plan\] テーブルにあります。 データタイプ：文字列 | | delivery_task | 使用されなくなりました。変更要求と関連付ける配送タスクの sys_id。実行計画タスク \[sc_cat_item_delivery_task\] テーブルにあります。 データタイプ：文字列 | | description | 変更要求の詳細な説明。 データタイプ：文字列 最大長：4,000 | | due_date | タスクの期日。変更要求プロセスでは使用されません。 データタイプ：文字列 | | end_date | 変更要求が完了する日時。 データタイプ：文字列 | | escalation | 現在のエスカレーションレベル。 可能な値： * 0：通常 * 1：中 * 2：高 * 3：期限切れ {#change-GET-change-sys_id__ul_kkn_123_2hb} データタイプ：数値 (整数) デフォルト：0 | | expected_start | タスクを開始する日時。変更要求プロセスでは使用されません。 データタイプ：文字列 | | follow_up | ユーザーが変更要求を要求した人物をフォローアップした日時。 データタイプ：文字列 | | group_list | 変更要求に関連付けられたグループの sys_id と名前のリスト。 データタイプ：アレイ 最大長：4,000 | | impact | 変更要求が顧客に与える影響。 可能な値： * 1 ：高 * 2 ：中 * 3：低 {#change-GET-change-sys_id__ul_j2x_j23_2hb} データタイプ：数値 (整数) デフォルト値：3 | | implementation_plan | この変更を実装するために実行する段階的なステップ。また、ステップごとに、ステップとアサイニーの間の依存関係も含まれています。 データタイプ：文字列 最大長：4,000 | | 理由 | この変更を実装するメリットと、この変更が実装されない場合の影響。 データタイプ：文字列 最大長：4,000 | | knowledge | 変更要求に関連付けられたナレッジベース (KB) 記事があるかどうかを示すフラグ。 可能な値： * true：KB 記事が関連付けられています * false：KB 記事は関連付けられていません {#change-GET-change-sys_id__ul_ehz_hp1_wnb} データタイプ：ブール | | location | 変更要求で参照される機器の場所の sys_id と名前。場所 \[cmn_location\] テーブルにあります。 データタイプ：文字列 | | made_sla | 使用されなくなりました。変更要求が関連するサービスレベルアグリーメントに従って実装されたかどうかを示すフラグ。 データタイプ：ブール | | needs_attention | 変更要求に注意が必要かどうかを示すフラグ。 可能な値： * true：変更要求に追加の注意が必要です。 * false：変更要求に追加の注意は必要ありません。 {#change-GET-change-sys_id__ul_zzn_gnc_2hb} データタイプ：ブール デフォルト値：false | | number | システムによって変更要求に割り当てられた変更番号 (CHG0040007 など)。 データタイプ：文字列 | | on_hold | 変更要求が現在保留中かどうかを示すフラグ。 可能な値： * true：保留中 * false：保留中ではありません {#change-GET-change-sys_id__ul_xjn_nv1_wnb} データタイプ：ブール デフォルト値：false | | on_hold_reason | on_hold パラメーターが「true」の場合、変更要求が保留にされている理由の説明。 データタイプ：文字列 最大長：4,000 | | on_hold_task | on_hold パラメーターが「true」の場合、保留が解除される前に完了する必要があるタスクの sys_id のリスト。 データタイプ：文字列 最大長：4,000 | | open_at | 変更リリースが作成された日時。 データタイプ：文字列 | | opened_by | 変更リリースを作成したユーザーの sys_id と名前。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 | | order | 変更管理 では使用されていません。データベースからレコードを取得するときなどにレコードを並べ替える基準となるオプションの数値フィールド。 データタイプ：数値 (整数) | | outside_maintenance_schedule | 変更要求に対して外部の会社によるメンテナンスがスケジュールされているかどうかを示すフラグ。 可能な値： * true：外部メンテナンスがスケジュールされています * false：外部メンテナンスがスケジュールされていません データタイプ：ブール デフォルト値：false | | parent | この変更要求に対する親タスクの sys_id と名前 (存在する場合)。タスク \[task\] テーブルにあります。 データタイプ：文字列 | | phase | 変更要求の現在のフェーズ。これにより、変更の内容がより詳細に定義されます。 可能な値： * accept * build * プラン * requested データタイプ：文字列 | | phase_state | 変更のために作成する必要がある change_phase レコード。カテゴリに依存するので、変更のタイプごとに異なる change_phase レコードがある場合があります。各 change_phase にはスケジュールと一連の承認者を設定できるため、change_phase レコードは承認プロセスを制御する機会を提供します。 可能な値： * complete * on hold * open * rejected * requested * work in progress {#change-GET-change-sys_id__ul_rng_ly1_wnb} データタイプ：文字列 | | priority | 変更要求の優先度。 可能な値： * 1：重大 * 2：高 * 3：中 * 4：低 データタイプ：数値 (整数) デフォルト：4 | | production_system | 変更要求が本番環境の ServiceNow インスタンスに対するものかどうかを示すフラグ。 可能な値： * true：本番環境 * false：非本番環境 データタイプ：ブール | | reason | 変更要求が開始された理由の説明。 可能な値： * ビジネス要件 * ハードウェアのアップグレード * 法律 * 場所の変更 * ネットワーク要件 * 新規または削除された CI * その他 * 問題が解決された * 製品またはサービスが変更されました * ソフトウェアのアップグレード * ユーザー要求 データタイプ：文字列 最大長：40 | | reassignment_count | 変更要求が新しいオーナーに再アサインされた回数。 データタイプ：数値 (整数) デフォルト：0 | | rejection_goto | 変更要求が却下された場合に実行するタスクの sys_id。タスク \[task\] テーブルにあります。 データタイプ：文字列 | | requested_by | 変更を要求したユーザーの sys_id。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 | | requested_by_date | 変更の実装が要求された日時。 データタイプ：文字列 | | review_comments | 変更要求のレビュー時に入力されたコメント。 データタイプ：文字列 最大長：4,000 | | review_date | 変更要求がレビューされた日付。 データタイプ：文字列 | | review_status | 変更要求の要求されたレビューの現在のステータス。 データタイプ：文字列 | | risk | 変更要求に関連付けられたリスクのレベル。 有効な値： * 1 ：高 * 2 ：中 * 3：低 {#change-GET-change-sys_id__ul_ejt_tn4_wnb} データタイプ：数値 デフォルト値：3 | | risk_impact_analysis | 変更要求の実装に関するリスクと分析の説明。 データタイプ：文字列 最大長：4,000 | | route_reason | 現在 変更管理 で使用されていません。変更要求が転送された理由。 可能な値： * 1：解決する転送 * 9：解決しない転送 {#change-GET-change-sys_id__ul_yvl_cxq_znb} データタイプ：数値 | | scope | 変更要求のサイズ。 可能な値： * 1：大規模 * 2：大 * 3 ：中程度 * 4：小 * 5：非常に小さい {#change-GET-change-sys_id__ul_b3j_3xq_znb} データタイプ：数値 デフォルト値：3 | | service_offering | 変更要求に関連付けられたサービスオファリングの sys_id。サービスオファリングは、可用性、スコープ、価格設定、およびパッケージングのオプションに関して、サービスのレベルを一意に定義します。オファリング \[service_offering\] テーブルにあります。 データタイプ：文字列 | | short_description | 変更要求の説明。 データタイプ：文字列 最大長：40 | | skills | 変更要求を実装するために必要なすべてのスキルの sys_id のリスト。スキル \[cmn_skill\] テーブルにあります。 データタイプ：アレイ | | sla_due | 使用されなくなりました。関連するサービスレベルアグリーメントに基づいて変更要求を完了する必要がある日時。 データタイプ：文字列 | | sn_esign_document | 変更要求に添付された電子署名済みドキュメントの sys_id。添付ファイル \[sys_attachment\] テーブルにあります。 データタイプ：文字列 | | sn_esign_esignature_configuration | 関連するドキュメントに使用される電子署名テンプレートの sys_id。電子署名テンプレート \[sn_esign_configuration\] テーブルにあります。 データタイプ：文字列 | | start_date | 変更要求の実装開始が予定されている日時。 データタイプ：文字列 | | state | 変更要求の現在のステータス。可能な値は変更モデルで定義されます。 データタイプ：数値 (整数) デフォルト値：1 | | std_change_producer_version | 変更要求と関連付けるレコードプロデューサーおよび変更提案の sys_id。また、提案から作成された成功した変更要求と失敗した変更要求の数と割合も含まれます。標準的な変更テンプレートのバージョン \[std_change_producer_version\] テーブルにあります。 データタイプ：文字列 | | sys_class_name | 変更要求が配置されているテーブルの名前。 データタイプ：文字列 | | sys_created_by | 変更要求を最初に作成したユーザーの名前。 データタイプ：文字列 最大長：40 | | sys_created_on | 関連付けられた変更要求レコードが最初に作成された日時。 データタイプ：文字列 | | sys_domain | インスタンスでドメインを使用している場合は、変更モジュールレコードが関連付けられているドメインの名前。 データタイプ：文字列 | | sys_domain_path | インスタンスでドメインを使用している場合は、関連付けられた変更モジュールレコードが存在するドメインパス。 データタイプ：文字列 | | sys_id | 関連付けられた変更要求レコードの一意の識別子。 データタイプ：文字列 | | sys_mod_count | ケースが最初に作成されてからの更新回数。 データタイプ：数値 (整数) | | sys_updated_by | ケースを最後に更新したユーザー。 データタイプ：文字列 最大長：40 | | sys_updated_on | ケースが最後に更新された日時。 データタイプ：文字列 | | task_effective_number | ユニバーサル要求番号。 データタイプ：文字列 最大長：40 | | task_for | 変更管理 では使用されていません。タスクが作成されたユーザーの sys_id。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 | | test_plan | 変更に関連するテスト計画の説明。 データタイプ：文字列 最大長：4,000 | | time_worked | 変更要求の合計作業時間。 データタイプ：文字列 | | type | 変更要求のタイプ。 可能な値： * emergency * normal * standard データタイプ：文字列 最大長：40 | | unauthorized | 変更要求が認可されていないかどうかを示すフラグ。 可能な値： * true：認可されていない * false：認可済み {#change-GET-change-sys_id__ul_gd3_q1p_wnb} データタイプ：ブール | | universal_request | この変更要求が属する親ユニバーサル要求の sys_id。タスク \[task\] テーブルにあります。 データタイプ：文字列 | | upon_approval | 変更要求が承認された場合に実行するアクション。 可能な値： * do_nothing * proceed データタイプ：文字列 最大長：40 デフォルト：proceed | | upon_reject | 変更要求が却下された場合に実行するアクション。 可能な値： * cancel * goto {#change-GET-change-sys_id__ul_mnw_cg3_2hb} データタイプ：文字列 最大長：40 デフォルト：cancel | | urgency | 変更要求の緊急度。 可能な値： * 1 ：高 * 2 ：中 * 3：低 {#change-GET-change-sys_id__ul_td4_3g3_2hb} データタイプ：数値 (整数) デフォルト値：3 | | user_input | 追加のユーザー入力。 データタイプ：文字列 最大長：4,000 | | variables | 変更要求に関連付けられた変数の名前と値のペア。 データタイプ：文字列 最大長：40 | | watch_list | 追加のコメントが追加された場合、または変更要求のステータスが「解決済み」または「クローズ済み」に変更された場合に、この変更要求に関する通知を受信するユーザーの sys_id のリスト。ユーザー \[sys_user\] テーブルにあります。 データタイプ：アレイ | | wf_activity | 変更要求に関連付けられたワークフローアクティビティレコードの sys_id。ワークフローアクティビティ \[wf_activity\] テーブルにあります。 データタイプ：文字列 | | work_end | 変更要求の作業が終了した日時。 データタイプ：文字列 | | work_notes | 変更要求の解決方法に関する情報、または変更要求の解決手順。 データタイプ：文字列 最大長：4,000 | | work_notes_list | 作業メモが追加されたときに、この変更要求についての通知を受け取る内部ユーザーの sys_id のリスト。ユーザー \[sys_user\] テーブルにあります。 データタイプ：アレイ | | work_start | 変更要求の作業が開始された日時。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "reason": { "display_value": "", "value": "" }, "parent": { "display_value": "", "value": "" }, "watch_list": { "display_value": "", "value": "" }, "proposed_change": { "display_value": "", "value": "" }, "upon_reject": { "display_value": "Cancel all future Tasks", "value": "cancel" }, "sys_updated_on": { "display_value": "2015-07-06 11:59:27", "value": "2015-07-06 18:59:27", "display_value_internal": "2015-07-06 11:59:27" }, "type": { "display_value": "Standard", "value": "standard" }, "approval_history": { "display_value": "", "value": "" }, "skills": { "display_value": "", "value": "" }, "test_plan": { "display_value": "--Confirm that there are no monitoring alerts for the router", "value": "--Confirm that there are no monitoring alerts for the router" }, "number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "is_bulk": { "display_value": "false", "value": false }, "cab_delegate": { "display_value": "", "value": "" }, "requested_by_date": { "display_value": "", "value": "", "display_value_internal": "" }, "ci_class": { "display_value": "cmdb_ci", "value": "cmdb_ci" }, "state": { "display_value": "Closed", "value": 3.0 }, "sys_created_by": { "display_value": "admin", "value": "admin" }, "knowledge": { "display_value": "false", "value": false }, "order": { "display_value": "", "value": "" }, "phase": { "display_value": "Requested", "value": "requested" }, "cmdb_ci": { "display_value": "", "value": "" }, "delivery_plan": { "display_value": "", "value": "" }, "impact": { "display_value": "3 - Low", "value": 3.0 }, "contract": { "display_value": "", "value": "" }, "active": { "display_value": "false", "value": false }, "work_notes_list": { "display_value": "", "value": "" }, "priority": { "display_value": "4 - Low", "value": 4.0 }, "sys_domain_path": { "display_value": "/", "value": "/" }, "cab_recommendation": { "display_value": "", "value": "" }, "production_system": { "display_value": "false", "value": false }, "rejection_goto": { "display_value": "", "value": "" }, "review_date": { "display_value": "", "value": "", "display_value_internal": "" }, "requested_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "business_duration": { "display_value": "", "value": "" }, "group_list": { "display_value": "", "value": "" }, "change_plan": { "display_value": "", "value": "" }, "approval_set": { "display_value": "", "value": "", "display_value_internal": "" }, "wf_activity": { "display_value": "", "value": "" }, "implementation_plan": { "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform", "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform" }, "universal_request": { "display_value": "", "value": "" }, "end_date": { "display_value": "", "value": "", "display_value_internal": "" }, "short_description": { "display_value": "Clear BGP sessions on a Cisco router", "value": "Clear BGP sessions on a Cisco router" }, "correlation_display": { "display_value": "", "value": "" }, "work_start": { "display_value": "2015-07-06 11:56:04", "value": "2015-07-06 18:56:04", "display_value_internal": "2015-07-06 11:56:04" }, "delivery_task": { "display_value": "", "value": "" }, "outside_maintenance_schedule": { "display_value": "false", "value": false }, "additional_assignee_list": { "display_value": "", "value": "" }, "std_change_producer_version": { "display_value": "Clear BGP sessions on a Cisco router - 1", "value": "16c2273c47010200e90d87e8dee49006" }, "sys_class_name": { "display_value": "Change Request", "value": "change_request" }, "service_offering": { "display_value": "", "value": "" }, "closed_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "follow_up": { "display_value": "", "value": "", "display_value_internal": "" }, "review_status": { "display_value": "", "value": "" }, "reassignment_count": { "display_value": "2", "value": 2.0 }, "start_date": { "display_value": "", "value": "", "display_value_internal": "" }, "assigned_to": { "display_value": "", "value": "" }, "variables": { "display_value": "variable_pool", "value": "variable_pool" }, "sla_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments_and_work_notes": { "display_value": "", "value": "" }, "escalation": { "display_value": "Normal", "value": 0.0 }, "upon_approval": { "display_value": "Proceed to Next Task", "value": "proceed" }, "correlation_id": { "display_value": "", "value": "" }, "made_sla": { "display_value": "true", "value": true }, "backout_plan": { "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work", "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work" }, "conflict_status": { "display_value": "Not Run", "value": "Not Run" }, "task_effective_number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "opened_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "user_input": { "display_value": "", "value": "" }, "sys_created_on": { "display_value": "2015-07-06 11:55:46", "value": "2015-07-06 18:55:46", "display_value_internal": "2015-07-06 11:55:46" }, "on_hold_task": { "display_value": "", "value": "" }, "sys_domain": { "display_value": "global", "value": "global" }, "route_reason": { "display_value": "", "value": "" }, "closed_at": { "display_value": "2015-07-06 11:56:23", "value": "2015-07-06 18:56:23", "display_value_internal": "2015-07-06 11:56:23" }, "review_comments": { "display_value": "", "value": "" }, "business_service": { "display_value": "", "value": "" }, "time_worked": { "display_value": "", "value": "" }, "chg_model": { "display_value": "", "value": "" }, "expected_start": { "display_value": "", "value": "", "display_value_internal": "" }, "opened_at": { "display_value": "2015-06-09 11:55:46", "value": "2015-06-09 18:55:46", "display_value_internal": "2015-06-09 11:55:46" }, "work_end": { "display_value": "2015-07-06 11:56:10", "value": "2015-07-06 18:56:10", "display_value_internal": "2015-07-06 11:56:10" }, "phase_state": { "display_value": "Open", "value": "open" }, "cab_date": { "display_value": "", "value": "", "display_value_internal": "" }, "work_notes": { "display_value": "", "value": "" }, "close_code": { "display_value": "Successful", "value": "successful" }, "assignment_group": { "display_value": "Network", "value": "287ebd7da9fe198100f92cc8d1d2154e" }, "description": { "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n", "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n" }, "on_hold_reason": { "display_value": "", "value": "" }, "calendar_duration": { "display_value": "", "value": "" }, "close_notes": { "display_value": "Completed without issues", "value": "Completed without issues" }, "sys_id": { "display_value": "1766f1de47410200e90d87e8dee490f6", "value": "1766f1de47410200e90d87e8dee490f6" }, "contact_type": { "display_value": "Phone", "value": "phone" }, "cab_required": { "display_value": "false", "value": false }, "urgency": { "display_value": "3 - Low", "value": 3.0 }, "scope": { "display_value": "Medium", "value": 3.0 }, "company": { "display_value": "", "value": "" }, "justification": { "display_value": "", "value": "" }, "activity_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments": { "display_value": "", "value": "" }, "approval": { "display_value": "Approved", "value": "approved" }, "due_date": { "display_value": "", "value": "", "display_value_internal": "" }, "sys_mod_count": { "display_value": "10", "value": 10.0 }, "on_hold": { "display_value": "false", "value": false }, "sys_tags": { "display_value": "", "value": "" }, "conflict_last_run": { "display_value": "", "value": "", "display_value_internal": "" }, "risk_value": { "display_value": "", "value": "" }, "unauthorized": { "display_value": "false", "value": false }, "risk": { "display_value": "Moderate", "value": 3.0 }, "location": { "display_value": "", "value": "" }, "category": { "display_value": "Other", "value": "Other" }, "risk_impact_analysis": { "display_value": "", "value": "" } } } ## Change Management - GET /sn_chg_rest/change/{sys_id}/ci {#ariaid-title14} 指定された関連付けタイプに基づいて、指定された変更要求に関連付けられた複数の構成アイテム (CI) を取得します。 ### URL 形式 {#change-GET-ci__section_sb3_m5n_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id}/ci デフォルトの URL：/api/sn_chg_rest/change/{sys_id}/ci ### サポートされている要求パラメーター {#change-GET-ci__entry__2}{#change-GET-ci__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 関連付けられた CMDB CI を返す変更要求の sys_id。 データタイプ：文字列 | [表 : 73. パスパラメーター] {#change-GET-ci__entry__8}{#change-GET-ci__sysparm_offset-ph-RESTAPI} | 名前 | 説明 | |-|-| | association_type | 必須です。CMDB CI と変更要求の間の関連付けのタイプ。 有効な値： * affected：変更要求によって影響を受ける CI * impacted：変更要求によって影響を受けるサービス * offering：影響を受けるサービスオファリング {#change-GET-ci__ul_bp5_2sm_dhb} データタイプ：文字列 | | name-value pairs | 結果セットをフィルタリングするために使用する名前と値のペア。名前は、指定された値がフィルタリングされるフィールドです。このパラメーターは、sysparm_query と相互に排他的です。たとえば、`&sysparm_query=active=true` を使用する代わりに、`&active=true` を使用して呼び出しステートメントを簡素化できます。フィールドが選択フィールドや参照タイプフィールドの場合も、表示値を使用できます (`&state=7` の代わりに `&state=closed` など)。複数のキーと値のペアを指定するには、それぞれをアンパサンドで区切ります (`&active=true&assigned_to=john.smith` など)。 データタイプ：文字列 | | sysparm_limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：数値 デフォルト：500 | | sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「`sysparm_offset=sysparm_offset+sysparm_limit`」を使用します。{#change-GET-ci__sysparm_offset-p-RESTAPI} sysparm_offset パラメーターに負の数値を渡さないでください。 データタイプ：数値 デフォルト：0 | | sysparm_query | 結果セットをフィルタリングするために使用される[エンコードされたクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)。UI フィルターを使用して、適切にエンコードクエリーを取得できます。 構文：`sysparm_query=`。 * \：フィルターを適用するテーブル列の名前。 * \：次の値をサポートします。 * =：\ と完全一致します。 * !=：\ と一致しません。 * \^：複数のクエリステートメントの論理 AND。 * \^OR：複数のクエリステートメントの論理 OR。 * LIKE：指定された文字列が \ に含まれています。データタイプが文字列である \ フィールドに対してのみ機能します。 * STARTSWITH：\ は指定された文字列で始まります。データタイプが文字列である \ フィールドに対してのみ機能します。 * ENDSWITH：\ は指定した文字列で終了します。データタイプが文字列である \ フィールドに対してのみ機能します。 {#change-GET-ci__ul_bgf_5vz_mlb} \：照合する値。 {#change-GET-ci__ul_g2p_svz_mlb} すべてのパラメーターで大文字と小文字が区別されます。クエリには、sysparm_query=\\\\[\\\\\] のように、複数のエントリを含めることができます。 例： `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` エンコードクエリーは、機能別の順番もサポートしています。特定のフィールドに基づいて回答を並べ替えるには、`ORDERBY` と `ORDERBYDESC` の句を sysparm_query で使用します。 構文： * `ORDERBY` * `ORDERBYDESC` {#change-GET-ci__ul_sq4_rc1_nlb} 例：`sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` このクエリは、すべてのアクティブなレコードをフィルタリングし、結果を番号で昇順に並べ替えた後、カテゴリで降順に並べ替えます。 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ：文字列 | [表 : 74. クエリパラメーター] {#change-GET-ci__entry__20} | 名前 | 説明 | |-|-| | なし | | [表 : 75. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-ci__entry__24}{#change-GET-ci__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 76. 要求ヘッダー] {#change-GET-ci__entry__28} | ヘッダー | 説明 | |-|-| | なし | | [表 : 77. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-ci__entry__32}{#change-GET-ci__entry-200-status-code}{#change-GET-ci__entry-401-status-code}{#change-GET-ci__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 エラー応答には、問題のトラブルシューティングに役立つ関連メッセージが含まれています。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 78. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-ci__entry__42} | 名前 | 説明 | |-|-| | ci_item\|cmdb_ci_service | 関連付けタイプに応じて、ci_item または cmdb_ci_service 変数のいずれか。 データタイプ：アレイ ci_item|cmdb_ci_service : { display_value: "String", value: "String" } | | ci_item\|cmdb_ci_service.value | ci_item または cmdb_ci_service の sys_id。 データタイプ：文字列 | | ci_item\|cmdb_ci_service.display_value | ci_item または cmdb_ci_service の表示値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | \ | ci_item または cmdb_ci_service レコードのすべての有効なフィールド。関連タイプに基づくテーブル。 データタイプ：オブジェクト | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/ci?association_type=affected" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' { result: [ { sys_id: { value: "92b8544047810200e90d87e8dee490b0", display_value: "92b8544047810200e90d87e8dee490b0" }, ci_item|cmdb_ci_service : { value: "3a27d4370a0a0bb4006316812bf45439", display_value: "PS Apache01" }, ..., // all valid fields in record, table based on association type }, { // next record found }, ... // and so on ] } ## Change Management - GET /sn_chg_rest/change/{sys_id}/conflict {#ariaid-title15} 現在実行中の変更要求競合チェックプロセスのステータス、または指定された変更要求の最後に完了した競合チェックプロセスの結果を取得します。 ### URL 形式 {#change-GET-conflict__section_dhd_zln_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id}/conflict デフォルトの URL：/api/sn_chg_rest/change/{sys_id}/conflict ### サポートされている要求パラメーター {#change-GET-conflict__entry__2}{#change-GET-conflict__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 実行中/完了した競合チェックプロセスのステータスを返す変更要求の sys_id。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 79. パスパラメーター] {#change-GET-conflict__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 80. クエリパラメーター] {#change-GET-conflict__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 81. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-conflict__entry__16}{#change-GET-conflict__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 82. 要求ヘッダー] {#change-GET-conflict__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 83. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-conflict__entry__24}{#change-GET-conflict__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 競合チェックプロセスの現在のステータス (検出された場合は競合を含む)。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 84. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-conflict__entry__36} | 名前 | 説明 | |-|-| | conflicts | 見つかった変更要求の競合のリスト。オブジェクトが空の場合は、競合が検出されなかったことを示します。 データタイプ：アレイ | | job_status | 実際の競合チェックジョブのステータス。 データタイプ：文字列 | | last_run | 前回の競合チェックプロセスが開始された日時。 データタイプ：文字列 | | record_count | チェックされたレコードの数。 データタイプ：文字列 | | status | 「競合」または「未実行」などの競合チェックプロセスの結果。 注: 変更要求に競合がない場合でも、このフィールドは「競合」に設定されます。ただし、conflicts オブジェクトは空になります。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" 成功応答 - 競合なし { result: { status: "Conflict", last_run": "2018-08-30 12:58:05", record_count: "1", job_status: "2", conflicts: [] } } ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" 成功応答 - 競合あり { result: { status: "Conflict", last_run": "2018-08-30 12:58:05", record_count: "1", job_status: "2", conflicts: [ { change: { display_value: "CHG0030001", value: "afbffb24b758230096c3e4f6ee11a972" }, type: { display_value: "Not In Maintenance Window", value: "not_in_maintenance_window" } ..., // all valid fields in record, example below } ] } } ## Change Management - GET /sn_chg_rest/change/emergency {#ariaid-title16} 指定された基準に基づいて 1 つ以上の緊急の変更要求を取得します。 ### URL 形式 {#change-GET-emergency__section_hdm_cxs_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/emergency デフォルトの URL：/api/sn_chg_rest/change/emergency ### サポートされている要求パラメーター {#change-GET-emergency__entry__2}{#change-GET-emergency__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 85. パスパラメーター] {#change-GET-emergency__entry__6}{#change-GET-emergency__sysparm_offset-ph-RESTAPI} | 名前 | 説明 | |-|-| | order | 返された変更要求をソートするためのフィールド。デフォルト: number データタイプ：文字列 デフォルト：number | | sysparm_limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：数値 デフォルト：500 | | sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「`sysparm_offset=sysparm_offset+sysparm_limit`」を使用します。{#change-GET-emergency__sysparm_offset-p-RESTAPI} sysparm_offset パラメーターに負の数値を渡さないでください。 データタイプ：数値 デフォルト：0 | | sysparm_query | 結果セットをフィルタリングするために使用される[エンコードされたクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)。UI フィルターを使用して、適切にエンコードクエリーを取得できます。 構文：`sysparm_query=`。 * \：フィルターを適用するテーブル列の名前。 * \：次の値をサポートします。 * =：\ と完全一致します。 * !=：\ と一致しません。 * \^：複数のクエリステートメントの論理 AND。 * \^OR：複数のクエリステートメントの論理 OR。 * LIKE：指定された文字列が \ に含まれています。データタイプが文字列である \ フィールドに対してのみ機能します。 * STARTSWITH：\ は指定された文字列で始まります。データタイプが文字列である \ フィールドに対してのみ機能します。 * ENDSWITH：\ は指定した文字列で終了します。データタイプが文字列である \ フィールドに対してのみ機能します。 {#change-GET-emergency__ul_bgf_5vz_mlb} \：照合する値。 {#change-GET-emergency__ul_g2p_svz_mlb} すべてのパラメーターで大文字と小文字が区別されます。クエリには、sysparm_query=\\\\[\\\\\] のように、複数のエントリを含めることができます。 例： `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` エンコードクエリーは、機能別の順番もサポートしています。特定のフィールドに基づいて回答を並べ替えるには、`ORDERBY` と `ORDERBYDESC` の句を sysparm_query で使用します。 構文： * `ORDERBY` * `ORDERBYDESC` {#change-GET-emergency__ul_sq4_rc1_nlb} 例：`sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` このクエリは、すべてのアクティブなレコードをフィルタリングし、結果を番号で昇順に並べ替えた後、カテゴリで降順に並べ替えます。 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ：文字列 | | key-value pairs | 結果セットをフィルタリングするために使用する名前と値のペア。名前は、指定された値がフィルタリングされるフィールドです。このパラメーターは、sysparm_query と相互に排他的です。たとえば、`&sysparm_query=active=true` を使用する代わりに、`&active=true` を使用して呼び出しステートメントを簡素化できます。フィールドが選択フィールドや参照タイプフィールドの場合も、表示値を使用できます (`&state=7` の代わりに `&state=closed` など)。複数のキーと値のペアを指定するには、それぞれをアンパサンドで区切ります (`&active=true&assigned_to=john.smith` など)。 データタイプ：文字列 | | textSearch | すべての緊急の変更要求レコードフィールドを検索するために使用する文字列。この検索では、ServiceNow の全文検索プラットフォーム機能が使用され、デフォルトで `IR_AND_OR_QUERY` に設定されます。 データタイプ：文字列 | [表 : 86. クエリパラメーター] {#change-GET-emergency__table_dht_wnc_4mb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 87. 要求本文パラメーター (XML または JSON)] {#change-GET-emergency__table_dht_wnc_4mb} ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-emergency__entry__24}{#change-GET-emergency__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 88. 要求ヘッダー] {#change-GET-emergency__entry__28} | ヘッダー | 説明 | |-|-| | なし | | [表 : 89. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-emergency__entry__32}{#change-GET-emergency__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 90. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-emergency__entry__40} | 名前 | 説明 | |-|-| | name-value pairs | 関連する変更要求のすべてのフィールドの値。 データタイプ：オブジェクト | | state | 変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Emergency」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「emergency」です。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, state: { value: "-5", display_value: "New" }, type: { value: "emergency", display_value: "Emergency" }, ..., // all valid fields in record, example below short_description: { value: "Reboot server", display_value: "Reboot server" }, }, { // next record found }, ... // and so on ] } ## Change Management - GET /sn_chg_rest/change/emergency/{sys_id} {#ariaid-title17} 指定された sys_id で識別される緊急の変更要求を取得します。 ### URL 形式 {#change-GET-emergency-sys_id__section_ovg_gbt_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/emergency/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/emergency/{sys_id} ### サポートされている要求パラメーター {#change-GET-emergency-sys_id__entry__2}{#change-GET-emergency-sys_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更要求 \[change_request\] テーブルから取得する緊急の変更要求の sys_id。 データタイプ：文字列 | [表 : 91. パスパラメーター] {#change-GET-emergency-sys_id__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 92. クエリパラメーター] {#change-GET-emergency-sys_id__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 93. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-emergency-sys_id__entry__16}{#change-GET-emergency-sys_id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 94. 要求ヘッダー] {#change-GET-emergency-sys_id__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 95. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-emergency-sys_id__entry__24}{#change-GET-emergency-sys_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 96. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-emergency-sys_id__entry__36} | 名前 | 説明 | |-|-| | name-value pairs | 関連する変更要求のすべてのフィールドの値。 データタイプ：オブジェクト | | state | 変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Emergency」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「emergency」です。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "b0dbda5347c12200e0ef563dbb9a718f", display_value: "b0dbda5347c12200e0ef563dbb9a718f" }, state: { value: "-5", display_value: "New" }, type: { value: "emergency", display_value: "Emergency" }, ..., // all valid fields in record, example below short_description: { value: "Reboot server", display_value: "Reboot server" }, }, ] } ## Change Management - GET /sn_chg_rest/change/model {#ariaid-title18} 指定された基準に基づいて 1 つ以上の変更モデルを取得します。 このエンドポイントを使用して、作成しようとしている変更要求に最適な変更モデルを検索します。詳細については、「 [変更モデル](https://www.servicenow.com/docs/access?context=change-models&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。 ### URL 形式 バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/model デフォルトの URL：/api/sn_chg_rest/change/model ### サポートされている要求パラメーター {#change-GET-model__entry__2}{#change-GET-model__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 97. パスパラメーター] {#change-GET-model__entry__6}{#change-GET-model__sysparm_offset-ph-RESTAPI}{#change-GET-model__sysparm-query-RESTAPI} | 名前 | 説明 | |-|-| | name-value pairs | 結果セットをフィルタリングするために使用する名前と値のペア。名前は、指定された値がフィルタリングされるフィールドです。このパラメーターは、sysparm_query と相互に排他的です。たとえば、`&sysparm_query=active=true` を使用する代わりに、`&active=true` を使用して呼び出しステートメントを簡素化できます。フィールドが選択フィールドや参照タイプフィールドの場合も、表示値を使用できます (`&state=7` の代わりに `&state=closed` など)。複数のキーと値のペアを指定するには、それぞれをアンパサンドで区切ります (`&active=true&assigned_to=john.smith` など)。 データタイプ：文字列 | | order | 返された変更モデルをソートするためのフィールド。 データタイプ：文字列 デフォルト：name | | sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「`sysparm_offset=sysparm_offset+sysparm_limit`」を使用します。{#change-GET-model__sysparm_offset-p-RESTAPI} sysparm_offset パラメーターに負の数値を渡さないでください。 データタイプ：数値 デフォルト：0 | | sysparm_query | 結果セットをフィルタリングするために使用される[エンコードされたクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)。UI フィルターを使用して、適切にエンコードクエリーを取得できます。 構文：`sysparm_query=`。 * \：フィルターを適用するテーブル列の名前。 * \：次の値をサポートします。 * =：\ と完全一致します。 * !=：\ と一致しません。 * \^：複数のクエリステートメントの論理 AND。 * \^OR：複数のクエリステートメントの論理 OR。 * LIKE：指定された文字列が \ に含まれています。データタイプが文字列である \ フィールドに対してのみ機能します。 * STARTSWITH：\ は指定された文字列で始まります。データタイプが文字列である \ フィールドに対してのみ機能します。 * ENDSWITH：\ は指定した文字列で終了します。データタイプが文字列である \ フィールドに対してのみ機能します。 {#change-GET-model__ul_bgf_5vz_mlb} \：照合する値。 {#change-GET-model__ul_g2p_svz_mlb} すべてのパラメーターで大文字と小文字が区別されます。クエリには、sysparm_query=\\\\[\\\\\] のように、複数のエントリを含めることができます。 例： `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` エンコードクエリーは、機能別の順番もサポートしています。特定のフィールドに基づいて回答を並べ替えるには、`ORDERBY` と `ORDERBYDESC` の句を sysparm_query で使用します。 構文： * `ORDERBY` * `ORDERBYDESC` {#change-GET-model__ul_sq4_rc1_nlb} 例：`sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` このクエリは、すべてのアクティブなレコードをフィルタリングし、結果を番号で昇順に並べ替えた後、カテゴリで降順に並べ替えます。 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ：文字列 | | textSearch | すべての変更モデルレコードフィールドを検索するために使用する文字列。この検索では、ServiceNow の全文検索プラットフォーム機能を使用します。ServiceNow検索機能の詳細については、「[検索の管理](https://www.servicenow.com/docs/access?context=search-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 データタイプ：文字列 デフォルト：IR_AND_OR_QUERY | [表 : 98. クエリパラメーター] {#change-GET-model__entry__18} | 名前 | 説明 | |-|-| | なし | | [表 : 99. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-model__entry__22}{#change-GET-model__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 100. 要求ヘッダー] {#change-GET-model__entry__26} | ヘッダー | 説明 | |-|-| | なし | | [表 : 101. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-model__entry__30}{#change-GET-model__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 102. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-model__entry__38} | 名前 | 説明 | |-|-| | result | 1 つ以上の変更モデルレコードオブジェクトを含むリスト。各オブジェクトは変更モデルを表します。変更モデルオブジェクトの各要素は、変更モデル \[chg_model\] テーブルの関連レコードのフィールドに対応します。 すべての要素には、value および display_value の名前と値のペアが含まれています。一部の要素には、display_value_internal の名前と値のペアが含まれています。 データタイプ：アレイ | | result.active | 関連する変更モデルレコードがアクティブでインスタンス内で使用可能かどうかを示すフラグ。 有効な値： * true：変更モデルはアクティブです。 * false：変更モデルはアクティブではありません。 {#change-GET-model__ul_lg3_kls_vnb} データタイプ：ブール デフォルト：true | | result.available_in_ui | 関連する変更モデルレコードがユーザーインターフェイス内で使用可能かどうかを示すフラグ。 有効な値： * true：変更モデルはユーザーインターフェイスで使用できます。 * false：変更モデルはユーザーインターフェイスで使用できません。 {#change-GET-model__ul_srf_mls_vnb} データタイプ：ブール デフォルト：true | | result.color | 変更要求ランディングページの関連する変更モデルの色。 データタイプ：文字列 デフォルト：#cbcbcb | | result.default_change_model | 関連する変更モデルレコードがデフォルトの変更モデルかどうかを示すフラグ。 有効な値： * true：デフォルトです。 * false：デフォルトではありません {#change-GET-model__ul_bnb_vls_vnb} データタイプ：ブール デフォルト値：false | | result.description | 変更モデルの目的の簡単な説明。 データタイプ：文字列 最大長：4,000 | | result.name | 変更モデルの名前。 データタイプ：文字列 最大長：200 | | result.record_preset | 新しい変更要求レコードが作成されたときに、関連付けられた値とともに自動的に入力されるフィールドの名前と値のペア。値はキャレット記号で区切られます。 例： `"type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automated : Change^EQ" ` データタイプ：文字列 | | result.state_field | table_name での指定に基づいて選択肢を収集する選択リストフィールド。変更モデルの場合、これは常に「state」に設定されます。 データタイプ：文字列 | | result.sys_class_name | モジュールテーブル名を変更します。常に変更モデル/chg_model です。 データタイプ：文字列 | | result.sys_created_by | 関連する変更モジュールレコードを最初に作成したユーザーの名前。 データタイプ：文字列 | | result.sys_created_on | 変更モジュールレコードが最初に作成された日時。 データタイプ：文字列 | | result.sys_domain | インスタンスでドメインを使用している場合は、変更モジュールレコードが関連付けられているドメインの名前。 データタイプ：文字列 | | result.sys_domain_path | インスタンスでドメインを使用している場合は、関連付けられた変更モジュールレコードが存在するドメインパス。 データタイプ：文字列 | | result.sys_id | 関連する変更モデルレコードの一意の識別子。 データタイプ：文字列 | | result.sys_mod_count | 関連する変更モデルレコードが変更された回数。 データタイプ：数値 | | result.sys_name | 変更モデルの名前。常に name パラメーターと同じです。 データタイプ：文字列 | | result.sys_tags | 変更モデルレコードに関連付けられたシステムタグ。 データタイプ：文字列 | | result.sys_updated_by | 関連する変更モデルレコードを最後に更新したユーザーの名前。 データタイプ：文字列 最大長：40 | | result.sys_updated_on | 関連する変更モデルレコードが最後に更新された日時。 データタイプ：文字列 | | result.table_name | 選択肢の収集元の選択リストフィールドを定義するテーブル。変更モデルの場合、これは常に「change_request」に設定されます。 データタイプ：文字列 最大長：80 | [ ] ### cURL 要求 この例は、すべての変更モデルレコードを取得する要求を示しています。 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/model \ --request GET \ --header "Accept:application/json" \ --user "username":"password" 簡潔にするため、この応答には単一の変更モデルオブジェクトのみが表示されます。 { "result": [ { "record_preset": { "display_value": "type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automated : Change^EQ", "value": "type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automated : Change^EQ" }, "color": { "display_value": "#488df4", "value": "#488df4" }, "default_change_model": { "display_value": "false", "value": false }, "sys_mod_count": { "display_value": "6", "value": 6.0 }, "description": { "display_value": "This model is intended to capture a record of an automated change. There are no approvals associated with this change model.\r\n", "value": "This model is intended to capture a record of an automated change. There are no approvals associated with this change model.\r\n" }, "active": { "display_value": "true", "value": true }, "sys_updated_on": { "display_value": "2020-10-02 06:24:24", "value": "2020-10-02 13:24:24", "display_value_internal": "2020-10-02 06:24:24" }, "sys_tags": { "display_value": "", "value": "" }, "table_name": { "display_value": "change_request", "value": "change_request" }, "sys_class_name": { "display_value": "Change Model", "value": "chg_model" }, "sys_id": { "display_value": "7840d2515323101034d1ddeeff7b12a6", "value": "7840d2515323101034d1ddeeff7b12a6" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "available_in_ui": { "display_value": "false", "value": false }, "state_field": { "display_value": "state", "value": "state" }, "sys_created_on": { "display_value": "2020-09-28 07:33:25", "value": "2020-09-28 14:33:25", "display_value_internal": "2020-09-28 07:33:25" }, "name": { "display_value": "Change Registration", "value": "Change Registration" }, "sys_name": { "display_value": "Change Registration", "value": "Change Registration" }, "sys_created_by": { "display_value": "admin", "value": "admin" } } ] } ## Change Management - GET /sn_chg_rest/change/{sys_id} {#ariaid-title19} 指定された sys_id で識別される変更モデルを取得します。 この変更モデルを使用して、必要な変更要求を作成できます。変更モデルの詳細については、「 [変更モデル](https://www.servicenow.com/docs/access?context=change-models&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。 ### URL 形式 {#change-GET-model-sys_id__section_et4_vbs_4nb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/model/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/model/{sys_id} ### サポートされている要求パラメーター {#change-GET-model-sys_id__entry__2}{#change-GET-model-sys_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更モデル \[chg_model\] テーブルから取得する変更モデルレコードの sys_id。 データタイプ：文字列 | [表 : 103. パスパラメーター] {#change-GET-model-sys_id__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 104. クエリパラメーター] {#change-GET-model-sys_id__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 105. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-model-sys_id__entry__16}{#change-GET-model-sys_id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 106. 要求ヘッダー] {#change-GET-model-sys_id__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 107. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-model-sys_id__entry__24}{#change-GET-model-sys_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 108. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-model-sys_id__entry__36} | 名前 | 説明 | |-|-| | result | 要求された変更モデルレコードオブジェクト。このオブジェクトの各要素は、変更モデル \[chg_model\] テーブルのレコードのフィールドに対応します。 すべての要素には、value および display_value の名前と値のペアが含まれています。一部の要素には、display_value_internal の名前と値のペアが含まれています。 データタイプ：オブジェクト | | result.active | 関連する変更モデルレコードがアクティブでインスタンス内で使用可能かどうかを示すフラグ。 有効な値： * true：変更モデルはアクティブです。 * false：変更モデルはアクティブではありません。 {#change-GET-model-sys_id__ul_lg3_kls_vnb} データタイプ：ブール デフォルト：true | | result.available_in_ui | 関連する変更モデルレコードがユーザーインターフェイス内で使用可能かどうかを示すフラグ。 有効な値： * true：変更モデルはユーザーインターフェイスで使用できます。 * false：変更モデルはユーザーインターフェイスで使用できません。 {#change-GET-model-sys_id__ul_srf_mls_vnb} データタイプ：ブール デフォルト：true | | result.color | 変更要求ランディングページの関連する変更モデルの色。 データタイプ：文字列 デフォルト：#cbcbcb | | result.default_change_model | 関連する変更モデルレコードがデフォルトの変更モデルかどうかを示すフラグ。 有効な値： * true：デフォルトです。 * false：デフォルトではありません {#change-GET-model-sys_id__ul_bnb_vls_vnb} データタイプ：ブール デフォルト値：false | | result.description | 変更モデルの目的の簡単な説明。 データタイプ：文字列 最大長：4,000 | | result.name | 変更モデルの名前。 データタイプ：文字列 最大長：200 | | result.record_preset | 新しい変更要求レコードが作成されたときに、関連付けられた値とともに自動的に入力されるフィールドの名前と値のペア。値はキャレット記号で区切られます。 例： `"type=normal^assignment_group=a715cd759f2002002920bde8132e7018^short_description=Automated : Change^EQ" ` データタイプ：文字列 | | result.state_field | table_name での指定に基づいて選択肢を収集する選択リストフィールド。変更モデルの場合、これは常に「state」に設定されます。 データタイプ：文字列 | | result.sys_class_name | モジュールテーブル名を変更します。常に変更モデル/chg_model です。 データタイプ：文字列 | | result.sys_created_by | 関連する変更モジュールレコードを最初に作成したユーザーの名前。 データタイプ：文字列 | | result.sys_created_on | 変更モジュールレコードが最初に作成された日時。 データタイプ：文字列 | | result.sys_domain | インスタンスでドメインを使用している場合は、変更モジュールレコードが関連付けられているドメインの名前。 データタイプ：文字列 | | result.sys_domain_path | インスタンスでドメインを使用している場合は、関連付けられた変更モジュールレコードが存在するドメインパス。 データタイプ：文字列 | | result.sys_id | 関連する変更モデルレコードの一意の識別子。 データタイプ：文字列 | | result.sys_mod_count | 関連する変更モデルレコードが変更された回数。 データタイプ：数値 | | result.sys_name | 変更モデルの名前。常に name パラメーターと同じです。 データタイプ：文字列 | | result.sys_tags | 変更モデルレコードに関連付けられたシステムタグ。 データタイプ：文字列 | | result.sys_updated_by | 関連する変更モデルレコードを最後に更新したユーザーの名前。 データタイプ：文字列 最大長：40 | | result.sys_updated_on | 関連する変更モデルレコードが最後に更新された日時。 データタイプ：文字列 | | result.table_name | 選択肢の収集元の選択リストフィールドを定義するテーブル。変更モデルの場合、これは常に「change_request」に設定されます。 データタイプ：文字列 最大長：80 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/model/c0efda5347c12200e0ef563dbb9a81e3" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "record_preset": { "display_value": "type=emergency^EQ", "value": "type=emergency^EQ" }, "color": { "display_value": "#ea3423", "value": "#ea3423" }, "default_change_model": { "display_value": "false", "value": false }, "sys_mod_count": { "display_value": "2", "value": 2.0 }, "description": { "display_value": "ITIL Mode 1 Emergency Change", "value": "ITIL Mode 1 Emergency Change" }, "active": { "display_value": "true", "value": true }, "sys_updated_on": { "display_value": "2020-09-28 08:53:12", "value": "2020-09-28 15:53:12", "display_value_internal": "2020-09-28 08:53:12" }, "sys_tags": { "display_value": "", "value": "" }, "table_name": { "display_value": "change_request", "value": "change_request" }, "sys_class_name": { "display_value": "Change Model", "value": "chg_model" }, "sys_id": { "display_value": "c0efda5347c12200e0ef563dbb9a81e3", "value": "c0efda5347c12200e0ef563dbb9a81e3" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "available_in_ui": { "display_value": "true", "value": true }, "state_field": { "display_value": "state", "value": "state" }, "sys_created_on": { "display_value": "2020-09-04 09:16:03", "value": "2020-09-04 16:16:03", "display_value_internal": "2020-09-04 09:16:03" }, "name": { "display_value": "Emergency", "value": "Emergency" }, "sys_name": { "display_value": "Emergency", "value": "Emergency" }, "sys_created_by": { "display_value": "admin", "value": "admin" } } } ## Change Management - GET /sn_chg_rest/change/normal {#ariaid-title20} 指定された基準に基づいて 1 つ以上の通常の変更要求を取得します。 ### URL 形式 {#change-GET-normal__section_vpf_mlr_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/normal デフォルトの URL：/api/sn_chg_rest/change/normal ### サポートされている要求パラメーター {#change-GET-normal__entry__2}{#change-GET-normal__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 109. パスパラメーター] {#change-GET-normal__entry__6}{#change-GET-normal__sysparm_offset-ph-RESTAPI} | 名前 | 説明 | |-|-| | name-value pairs | 結果セットをフィルタリングするために使用する名前と値のペア。名前は、指定された値がフィルタリングされるフィールドです。このパラメーターは、sysparm_query と相互に排他的です。たとえば、`&sysparm_query=active=true` を使用する代わりに、`&active=true` を使用して呼び出しステートメントを簡素化できます。フィールドが選択フィールドや参照タイプフィールドの場合も、表示値を使用できます (`&state=7` の代わりに `&state=closed` など)。複数のキーと値のペアを指定するには、それぞれをアンパサンドで区切ります (`&active=true&assigned_to=john.smith` など)。 データタイプ：文字列 | | order | 返された変更要求をソートするためのフィールド。デフォルト: number データタイプ：文字列 | | sysparm_limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：数値 デフォルト：500 | | sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「`sysparm_offset=sysparm_offset+sysparm_limit`」を使用します。{#change-GET-normal__sysparm_offset-p-RESTAPI} sysparm_offset パラメーターに負の数値を渡さないでください。 データタイプ：数値 デフォルト：0 | | sysparm_query | 結果セットをフィルタリングするために使用される[エンコードされたクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)。UI フィルターを使用して、適切にエンコードクエリーを取得できます。 構文：`sysparm_query=`。 * \：フィルターを適用するテーブル列の名前。 * \：次の値をサポートします。 * =：\ と完全一致します。 * !=：\ と一致しません。 * \^：複数のクエリステートメントの論理 AND。 * \^OR：複数のクエリステートメントの論理 OR。 * LIKE：指定された文字列が \ に含まれています。データタイプが文字列である \ フィールドに対してのみ機能します。 * STARTSWITH：\ は指定された文字列で始まります。データタイプが文字列である \ フィールドに対してのみ機能します。 * ENDSWITH：\ は指定した文字列で終了します。データタイプが文字列である \ フィールドに対してのみ機能します。 {#change-GET-normal__ul_bgf_5vz_mlb} \：照合する値。 {#change-GET-normal__ul_g2p_svz_mlb} すべてのパラメーターで大文字と小文字が区別されます。クエリには、sysparm_query=\\\\[\\\\\] のように、複数のエントリを含めることができます。 例： `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` エンコードクエリーは、機能別の順番もサポートしています。特定のフィールドに基づいて回答を並べ替えるには、`ORDERBY` と `ORDERBYDESC` の句を sysparm_query で使用します。 構文： * `ORDERBY` * `ORDERBYDESC` {#change-GET-normal__ul_sq4_rc1_nlb} 例：`sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` このクエリは、すべてのアクティブなレコードをフィルタリングし、結果を番号で昇順に並べ替えた後、カテゴリで降順に並べ替えます。 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ：文字列 | | textSearch | すべての通常の変更要求レコードフィールドを検索するために使用する文字列。この検索では、ServiceNow の全文検索プラットフォーム機能が使用され、デフォルトで `IR_AND_OR_QUERY` に設定されます。 データタイプ：文字列 | [表 : 110. クエリパラメーター] {#change-GET-normal__entry__20} | 名前 | 説明 | |-|-| | なし | | [表 : 111. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-normal__entry__24}{#change-GET-normal__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 112. 要求ヘッダー] {#change-GET-normal__entry__28} | ヘッダー | 説明 | |-|-| | なし | | [表 : 113. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-normal__entry__32}{#change-GET-normal__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 114. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-normal__entry__40} | 名前 | 説明 | |-|-| | name-value pairs | 関連する変更要求のすべてのフィールドの値。 データタイプ：オブジェクト | | state | 削除前の変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Normal」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「normal」です。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, state: { value: "-5", display_value: "New" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" }, }, { // next record found }, ... // and so on ] } ## Change Management - GET /sn_chg_rest/change/{sys_id} {#ariaid-title21} 指定された sys_id で識別される通常の変更要求を取得します。 ### URL 形式 {#change-GET-normal-sys_id__section_q1h_nnr_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/normal/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/normal/{sys_id} ### サポートされている要求パラメーター {#change-GET-normal-sys_id__entry__2}{#change-GET-normal-sys_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更要求 \[change_request\] テーブルから取得する通常の変更要求の sys_id。 データタイプ：文字列 | [表 : 115. パスパラメーター] {#change-GET-normal-sys_id__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 116. クエリパラメーター] {#change-GET-normal-sys_id__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 117. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-normal-sys_id__entry__16}{#change-GET-normal-sys_id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 118. 要求ヘッダー] {#change-GET-normal-sys_id__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 119. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-normal-sys_id__entry__24}{#change-GET-normal-sys_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 120. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-normal-sys_id__entry__36} | 名前 | 説明 | |-|-| | name-value pairs | 関連する変更要求のすべてのフィールドの値。 データタイプ：オブジェクト | | state | 削除前の変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Normal」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「normal」です。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", state: { value: "-5", display_value: "New" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" }, }, ] } ## Change Management - GET /sn_chg_rest/change/standard {#ariaid-title22} 指定された基準に基づいて 1 つ以上の標準的な変更の要求を取得します。 ### URL 形式 {#change-GET-standard__section_q3c_ppv_wlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/standard デフォルトの URL：/api/sn_chg_rest/change/standard ### サポートされている要求パラメーター {#change-GET-standard__entry__2}{#change-GET-standard__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 121. パスパラメーター] {#change-GET-standard__entry__6}{#change-GET-standard__sysparm_offset-ph-RESTAPI} | 名前 | 説明 | |-|-| | name-value pairs | 結果セットをフィルタリングするために使用する名前と値のペア。名前は、指定された値がフィルタリングされるフィールドです。このパラメーターは、sysparm_query と相互に排他的です。たとえば、`&sysparm_query=active=true` を使用する代わりに、`&active=true` を使用して呼び出しステートメントを簡素化できます。フィールドが選択フィールドや参照タイプフィールドの場合も、表示値を使用できます (`&state=7` の代わりに `&state=closed` など)。複数のキーと値のペアを指定するには、それぞれをアンパサンドで区切ります (`&active=true&assigned_to=john.smith` など)。 データタイプ：文字列 | | order | 返された変更要求をソートするためのフィールド。デフォルト: number データタイプ：文字列 | | sysparm_limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：文字列 デフォルト：500 | | sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「`sysparm_offset=sysparm_offset+sysparm_limit`」を使用します。{#change-GET-standard__sysparm_offset-p-RESTAPI} sysparm_offset パラメーターに負の数値を渡さないでください。 データタイプ：数値 デフォルト：0 | | sysparm_query | 結果セットをフィルタリングするために使用される[エンコードされたクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)。UI フィルターを使用して、適切にエンコードクエリーを取得できます。 構文：`sysparm_query=`。 * \：フィルターを適用するテーブル列の名前。 * \：次の値をサポートします。 * =：\ と完全一致します。 * !=：\ と一致しません。 * \^：複数のクエリステートメントの論理 AND。 * \^OR：複数のクエリステートメントの論理 OR。 * LIKE：指定された文字列が \ に含まれています。データタイプが文字列である \ フィールドに対してのみ機能します。 * STARTSWITH：\ は指定された文字列で始まります。データタイプが文字列である \ フィールドに対してのみ機能します。 * ENDSWITH：\ は指定した文字列で終了します。データタイプが文字列である \ フィールドに対してのみ機能します。 {#change-GET-standard__ul_bgf_5vz_mlb} \：照合する値。 {#change-GET-standard__ul_g2p_svz_mlb} すべてのパラメーターで大文字と小文字が区別されます。クエリには、sysparm_query=\\\\[\\\\\] のように、複数のエントリを含めることができます。 例： `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` エンコードクエリーは、機能別の順番もサポートしています。特定のフィールドに基づいて回答を並べ替えるには、`ORDERBY` と `ORDERBYDESC` の句を sysparm_query で使用します。 構文： * `ORDERBY` * `ORDERBYDESC` {#change-GET-standard__ul_sq4_rc1_nlb} 例：`sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` このクエリは、すべてのアクティブなレコードをフィルタリングし、結果を番号で昇順に並べ替えた後、カテゴリで降順に並べ替えます。 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ：文字列 | | textSearch | すべての標準的な変更の要求レコードフィールドを検索するために使用する文字列。この検索では、ServiceNow の全文検索プラットフォーム機能が使用され、デフォルトで `IR_AND_OR_QUERY` に設定されます。 データタイプ：文字列 | [表 : 122. クエリパラメーター] {#change-GET-standard__entry__20} | 名前 | 説明 | |-|-| | なし | | [表 : 123. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-standard__entry__24}{#change-GET-standard__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 124. 要求ヘッダー] {#change-GET-standard__entry__28} | ヘッダー | 説明 | |-|-| | なし | | [表 : 125. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-standard__entry__32}{#change-GET-standard__entry-200-status-code}{#change-GET-standard__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 126. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-standard__entry__40} | 名前 | 説明 | |-|-| | name-value pairs | 識別された変更要求のすべてのフィールド (キー) とその関連付けられた値。 データタイプ：オブジェクト | | state | 削除前の変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Standard」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「standard」です。 データタイプ：文字列 | [ ] ### サンプル cURL 要求 curl "https://instance.service-now.com/api/sn_chg_rest/v1/change/standard?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, state: { value: "-5", display_value: "New" }, type: { value: "standard", display_value: "Standard" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" }, }, { // next record found }, ... // and so on ] } ## Change Management - GET /sn_chg_rest/change/standard/{sys_id} {#ariaid-title23} 指定された sys_id で識別される標準的な変更の要求を取得します。 ### URL 形式 {#change-GET-standard-sys_id__section_hgk_h1k_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/standard/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/standard/{sys_id} ### サポートされている要求パラメーター {#change-GET-standard-sys_id__section_bgs_31k_xlb} {#change-GET-standard-sys_id__table_cgs_31k_xlb__entry__2}{#change-GET-standard-sys_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更要求 \[change_request\] テーブルから取得する標準的な変更の要求の sys_id。 データタイプ：文字列 | [表 : 127. パスパラメーター] {#change-GET-standard-sys_id__table_cgs_31k_xlb} {#change-GET-standard-sys_id__table_yvb_r1k_xlb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 128. クエリパラメーター] {#change-GET-standard-sys_id__table_yvb_r1k_xlb} {#change-GET-standard-sys_id__table_uvn_xfw_nmb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 129. 要求本文パラメーター (XML または JSON)] {#change-GET-standard-sys_id__table_uvn_xfw_nmb} ### ヘッダー {#change-GET-standard-sys_id__section_tbj_gbk_xlb} 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-standard-sys_id__table_ubj_gbk_xlb__entry__2}{#change-GET-standard-sys_id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 130. 要求ヘッダー] {#change-GET-standard-sys_id__table_ubj_gbk_xlb} {#change-GET-standard-sys_id__table_vbj_gbk_xlb__entry__2} | ヘッダー | 説明 | |-|-| | なし | | [表 : 131. 応答ヘッダー] {#change-GET-standard-sys_id__table_vbj_gbk_xlb} ### ステータスコード {#change-GET-standard-sys_id__section_kp1_mbk_xlb} この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-standard-sys_id__table_wwn_rhd_ct__entry__2}{#change-GET-standard-sys_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 132. ステータスコード] {#change-GET-standard-sys_id__table_wwn_rhd_ct} ### 応答本文のパラメーター (JSON または XML) {#change-GET-standard-sys_id__table_mc1_pr1_tx__entry__2} | 名前 | 説明 | |-|-| | name-value pairs | 識別された変更要求のすべてのフィールド (キー) とその関連付けられた値。 データタイプ：オブジェクト | | state | 削除前の変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | [ ] {#change-GET-standard-sys_id__table_mc1_pr1_tx} ### cURL 要求 curl "https://https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/b0dbda5347c12200e0ef563dbb9a718f" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, state: { value: "-5", display_value: "New" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" }, }, ] } ## Change Management - GET /sn_chg_rest/change/standard/template {#ariaid-title24} 指定された基準に基づいて 1 つ以上の標準的な変更テンプレートを取得します。 ### URL 形式 {#change-GET-standard-temp__section_on3_mnl_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/standard/template デフォルトの URL：/api/sn_chg_rest/change/standard/template ### サポートされている要求パラメーター {#change-GET-standard-temp__entry__2}{#change-GET-standard-temp__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 133. パスパラメーター] {#change-GET-standard-temp__table_gdg_b4l_xlb__entry__2}{#change-GET-standard-temp__sysparm_offset-ph-RESTAPI} | 名前 | 説明 | |-|-| | name-value pairs | 結果セットをフィルタリングするために使用する名前と値のペア。名前は、指定された値がフィルタリングされるフィールドです。このパラメーターは、sysparm_query と相互に排他的です。たとえば、`&sysparm_query=active=true` を使用する代わりに、`&active=true` を使用して呼び出しステートメントを簡素化できます。フィールドが選択フィールドや参照タイプフィールドの場合も、表示値を使用できます (`&state=7` の代わりに `&state=closed` など)。複数のキーと値のペアを指定するには、それぞれをアンパサンドで区切ります (`&active=true&assigned_to=john.smith` など)。 データタイプ：文字列 | | order | 返された標準的な変更テンプレートをソートするためのフィールド。 データタイプ：文字列 デフォルト:数値 | | sysparm_limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 データタイプ：数値 デフォルト：500 | | sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「`sysparm_offset=sysparm_offset+sysparm_limit`」を使用します。{#change-GET-standard-temp__sysparm_offset-p-RESTAPI} sysparm_offset パラメーターに負の数値を渡さないでください。 データタイプ：数値 デフォルト：0 | | sysparm_query | 結果セットをフィルタリングするために使用される[エンコードされたクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)。UI フィルターを使用して、適切にエンコードクエリーを取得できます。 構文：`sysparm_query=`。 * \：フィルターを適用するテーブル列の名前。 * \：次の値をサポートします。 * =：\ と完全一致します。 * !=：\ と一致しません。 * \^：複数のクエリステートメントの論理 AND。 * \^OR：複数のクエリステートメントの論理 OR。 * LIKE：指定された文字列が \ に含まれています。データタイプが文字列である \ フィールドに対してのみ機能します。 * STARTSWITH：\ は指定された文字列で始まります。データタイプが文字列である \ フィールドに対してのみ機能します。 * ENDSWITH：\ は指定した文字列で終了します。データタイプが文字列である \ フィールドに対してのみ機能します。 {#change-GET-standard-temp__ul_bgf_5vz_mlb} \：照合する値。 {#change-GET-standard-temp__ul_g2p_svz_mlb} すべてのパラメーターで大文字と小文字が区別されます。クエリには、sysparm_query=\\\\[\\\\\] のように、複数のエントリを含めることができます。 例： `(sysparm_query=caller_id=javascript:gs.getUserID()^active=true)` エンコードクエリーは、機能別の順番もサポートしています。特定のフィールドに基づいて回答を並べ替えるには、`ORDERBY` と `ORDERBYDESC` の句を sysparm_query で使用します。 構文： * `ORDERBY` * `ORDERBYDESC` {#change-GET-standard-temp__ul_sq4_rc1_nlb} 例：`sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` このクエリは、すべてのアクティブなレコードをフィルタリングし、結果を番号で昇順に並べ替えた後、カテゴリで降順に並べ替えます。 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ：文字列 | | textSearch | すべての標準的な変更の要求レコードフィールドを検索するために使用する文字列。この検索では、ServiceNow の全文検索プラットフォーム機能が使用され、デフォルトで `IR_AND_OR_QUERY` に設定されます。 データタイプ：文字列 | [表 : 134. クエリパラメーター] {#change-GET-standard-temp__table_gdg_b4l_xlb} {#change-GET-standard-temp__entry__20} | 名前 | 説明 | |-|-| | なし | | [表 : 135. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-standard-temp__entry__24}{#change-GET-standard-temp__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 136. 要求ヘッダー] {#change-GET-standard-temp__entry__28} | ヘッダー | 説明 | |-|-| | なし | | [表 : 137. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-standard-temp__table_wwn_rhd_ct__entry__2}{#change-GET-standard-temp__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 138. ステータスコード] {#change-GET-standard-temp__table_wwn_rhd_ct} ### 応答本文のパラメーター (JSON または XML) {#change-GET-standard-temp__entry__40} | 名前 | 説明 | |-|-| | name-value pairs | 識別された標準的な変更テンプレートのすべてのフィールドとその関連付けられた値。 データタイプ：オブジェクト | | sys_id | 変更要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | | template | 標準的な変更テンプレートに関する情報。 データタイプ：オブジェクト template: { display_value: "String", value: "String" } | | template.display_value | UI に表示するテンプレート情報。 データタイプ：文字列 | | template.value | テンプレートの sys_id。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/template?sysparm_query=active=true^ORDERBYnumber" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "92b8544047810200e90d87e8dee490b0", display_value: "92b8544047810200e90d87e8dee490b0" }, template : { value: "1c8e02ec47410200e90d87e8dee49057", display_value: "Add network switch to datacenter cabinet" }, ..., // all valid fields in record, example below short_description: { value: "Standard change template to add network switch to cabinet", display_value: "Standard change template to add network switch to cabinet" }, }, { // next record found }, ... // and so on ] } ## Change Management - GET /sn_chg_rest/change/standard/template/{sys_id} {#ariaid-title25} 指定された sys_id で識別される標準的な変更テンプレートを取得します。 ### URL 形式 {#change-GET-standard-temp-sys_id__section_cvs_jbm_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/standard/template/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/standard/template/{sys_id} ### サポートされている要求パラメーター {#change-GET-standard-temp-sys_id__entry__2}{#change-GET-standard-temp-sys_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | \[std_change_record_producer\] テーブルから取得する標準的な変更テンプレートの sys_id。 データタイプ：文字列 | [表 : 139. パスパラメーター] {#change-GET-standard-temp-sys_id__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 140. クエリパラメーター] {#change-GET-standard-temp-sys_id__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 141. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-standard-temp-sys_id__entry__16}{#change-GET-standard-temp-sys_id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 142. 要求ヘッダー] {#change-GET-standard-temp-sys_id__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 143. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-standard-temp-sys_id__entry__24}{#change-GET-standard-temp-sys_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 144. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-standard-temp-sys_id__entry__36} | 名前 | 説明 | |-|-| | name-value pairs | 識別された標準的な変更テンプレートのすべてのフィールドとその関連付けられた値。 データタイプ：オブジェクト | | sys_id | 変更要求の sys_id。 データタイプ：文字列 | | template | 標準的な変更テンプレートに関する情報。 データタイプ：オブジェクト template: { display_value: "String", value: "String" } | | template.display_value | UI に表示するテンプレート情報。 データタイプ：文字列 | | template.value | テンプレートの sys_id。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/template/92b8544047810200e90d87e8dee490b0" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "92b8544047810200e90d87e8dee490b0", template : { value: "1c8e02ec47410200e90d87e8dee49057", display_value: "Add network switch to datacenter cabinet" }, ..., // all valid fields in record, example below short_description: { value: "Standard change template to add network switch to cabinet", display_value: "Standard change template to add network switch to cabinet" }, }, ] } ## Change Management - GET /sn_chg_rest/change/worker/{sys_id} {#ariaid-title26} 指定された非同期ワーカーの現在のステータス、情報、およびエラーを取得します。 ### URL 形式 {#change-GET-worker__section_vz2_g34_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/worker/{sys_id} デフォルトの URL：/api/sn_chg_rest/{change/worker/{sys_id} ### サポートされている要求パラメーター {#change-GET-worker__entry__2}{#change-GET-worker__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更管理非同期ワーカーの sys_id。Change Management ワーカー \[chg_mgt_worker\] テーブルにあります。 データタイプ：文字列 | [表 : 145. パスパラメーター] {#change-GET-worker__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 146. クエリパラメーター] {#change-GET-worker__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 147. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-worker__entry__16}{#change-GET-worker__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 148. 要求ヘッダー] {#change-GET-worker__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 149. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-GET-worker__entry__24}{#change-GET-worker__entry-200-status-code}{#change-GET-worker__entry-401-status-code}{#change-GET-worker__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 150. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-GET-worker__table_is2_n4s_jpb__entry__2}{#change-GET-worker__cmapi-worker-resp-messages-err-ph}{#change-GET-worker__cmapi-worker-resp-messages-info-ph}{#change-GET-worker__cmapi-worker-resp-messages-warn-ph} | 名前 | 説明 | |-|-| | messages | メッセージ情報。 データタイプ：オブジェクト "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | messages.errorMessages | 要求の処理中にエラーメッセージが表示されました。例： ``` 無効な CMDB_CI sys_id が指定されました ``` データタイプ：アレイ | | messages.infoMessages | 要求の処理中に情報メッセージが表示されました。例： ``` CMDB_CI sys_id が既に指定値に関連付けられています。 ``` データタイプ：アレイ | | messages.warningMessages | 要求の処理中に警告メッセージが表示されました。例： ``` 無効な CMDB_CI sys_id が指定されました。 ``` データタイプ：アレイ | | payload | スケジューリングエンドポイントの成功した応答本文からワーカー sys_id を使用するときに提供される一意のペイロード。 * [GET /ci/{cmdb_ci_sys_id}/schedule](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-c_id-schedule "構成アイテム ID と期間で利用可能なタイムスロットを取得できるようにします。オプションで予定開始時間を含めることができます。") * [GET /sn_chg_rest/change/{change_sys_id}/schedule](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-change-sys_id-sched "変更要求に利用可能なタイムスロットを取得できるようにします。") {#change-GET-worker__ul_orx_mts_npb} "payload": { "spans": [Array] } データタイプ：オブジェクト | | payload.spans | スケジュールエンドポイントで指定された期間内にタイムスパンが利用可能な場合、ワーカー API は利用可能なタイムスパンをリストします。 "payload": { "spans": [ { "start": {Object}, "end": {Object} } ] } データタイプ：アレイ | | payload.spans.start | "start": { "value": "String", "display_value": "String" } データタイプ：オブジェクト | | payload.spans.start.value | 変更要求の実装開始が予定されている日時。 データタイプ：文字列 | | payload.spans.start.display_value | 変更要求の開始時間の値を表示します。 時間形式：yyyy-mm-dd hh:mm:ss データタイプ：文字列 | | payload.spans.end | "end": { "value": "String", "display_value": "String" } データタイプ：オブジェクト | | payload.spans.end.value | 変更要求の完了が予定されている日時。 時間形式：yyyy-mm-dd hh:mm:ss データタイプ：文字列 | | payload.spans.end.display_value | 変更要求の完了時間の値を表示します。 データタイプ：文字列 | | 要求 | 元のエンドポイント要求。 データタイプ：文字列 | | state | ワーカーの現在のステータスに関する情報。 データタイプ：オブジェクト state: { display_value: "String", value: Number } | | state.display_value | ワーカーのステータス値を表示します。これらの値は state.value パラメーターに直接関連付けられています。 可能な値： * 完了 * エラー * 対応中 * 待機中 {#change-GET-worker__ul_ehh_nxy_jhb} データタイプ：文字列 | | state.value | ワーカーのステータスの数値。 可能な値： * 1 * 2 * 3 * 4 {#change-GET-worker__ul_zw1_fxy_jhb} データタイプ：数値 | | type | CMDB CI と変更要求の間の関連付けのタイプ。 データタイプ：文字列 | | worker | 関連付けられたワーカーに関する情報。 データタイプ：オブジェクト "worker": { "link": "String", "sysId": "String" } | | worker.link | 関連付けられたワーカーのステータスおよびその他のワーカー関連情報を取得するための URL。 データタイプ：文字列 | | worker.sysId | 変更要求と関連付けるワーカーの sys_id。 データタイプ：文字列 | | \ | プロセス固有のその他のパラメーター (ignored_cmdb_ci_sys_ids など)。 | [ ] {#change-GET-worker__table_is2_n4s_jpb} ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/worker/0644cd02dbec330084f07ffdbf9619c1" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "worker": { "sysId": "0644cd02dbec330084f07ffdbf9619c1", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/0644cd02dbec330084f07ffdbf9619c1" }, "request": "{\"task\":\"c286d61347c12200e0ef563dbb9a71df\"}", "state": { "value": 3, "display_value": "Complete" }, "type": "impacted", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] } } } ## Change Management - PATCH /sn_chg_rest/change/{sys_id} {#ariaid-title27} 指定された sys_id によって識別される変更要求を、要求本文または URL のキーと値のペアで更新します。
### URL 形式 バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/{sys_id} ### サポートされている要求パラメーター {#change-PATCH-change-sys_id__entry__2}{#change-PATCH-change-sys_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更する変更要求の sys_id。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 151. パスパラメーター] {#change-PATCH-change-sys_id__entry__8}{#change-PATCH-change-sys_id__encrypted_fields-chgmng-entry} | 名前 | 説明 | |-|-| | name-value pairs | 更新するフィールドを表す名前と値のペア。要求本文パラメーターは、URL パラメーターを上書きします。ただし、URL で必須のパラメーターを指定する必要があります。 データタイプ：文字列 | | encrypted_fields | 暗号化するカンマ区切りフィールドのリスト。これらのフィールドは、関連付けられたレコードに格納される前に暗号化されます。指定すると、エンドポイントは setValue() メソッドを呼び出す代わりに、GlideRecord setDisplayValue() メソッドを呼び出します。 このため、このパラメーターを使用して、sys_idsや値を渡す代わりに、参照フィールドや選択フィールドなどの暗号化されていないフィールドの表示値を渡すこともできます。 データタイプ：文字列 | [表 : 152. クエリパラメーター] {#change-PATCH-change-sys_id__entry__14}{#change-PATCH-change-sys_id__d2783e963} | 名前 | 説明 | |-|-| | data | 関連する変更要求で更新するフィールドを表す名前と値のペア。たとえば、簡単な説明のファイルを更新するには、次のような名前と値のペアを入力します。`--data "{\"short_description\": \"my short desc\" }" \` データタイプ：文字列 | | encrypted_fields | 暗号化するカンマ区切りフィールドのリスト。これらのフィールドは、関連付けられたレコードに格納される前に暗号化されます。指定すると、エンドポイントは setValue() メソッドを呼び出す代わりに、GlideRecord setDisplayValue() メソッドを呼び出します。 このため、このパラメーターを使用して、sys_idsや値を渡す代わりに、参照フィールドや選択フィールドなどの暗号化されていないフィールドの表示値を渡すこともできます。 データタイプ：文字列 | [表 : 153. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-change-sys_id__entry__20}{#change-PATCH-change-sys_id__accept-RESTAPI}{#change-PATCH-change-sys_id__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 154. 要求ヘッダー] {#change-PATCH-change-sys_id__entry__26} | ヘッダー | 説明 | |-|-| | なし | | [表 : 155. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-change-sys_id__entry__30}{#change-PATCH-change-sys_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 156. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-PATCH-change-sys_id__entry__42} | 名前 | 説明 | |-|-| | result | 更新された変更要求レコード。このオブジェクトの各要素は、変更要求 \[change_request\] テーブルのレコードのフィールドに対応します。 すべての要素には、value および display_value の名前と値のペアが含まれています。一部の要素には、display_value_internal の名前と値のペアが含まれています。 データタイプ：オブジェクト | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \ --request PATCH \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data "{\"short_desription\": \"Reboot the server at 6 am\" }" \ --user "username":"password" { "result": { "reason": { "display_value": "", "value": "" }, "parent": { "display_value": "", "value": "" }, "watch_list": { "display_value": "", "value": "" }, "proposed_change": { "display_value": "", "value": "" }, "upon_reject": { "display_value": "Cancel all future Tasks", "value": "cancel" }, "sys_updated_on": { "display_value": "2015-07-06 11:59:27", "value": "2015-07-06 18:59:27", "display_value_internal": "2015-07-06 11:59:27" }, "type": { "display_value": "Standard", "value": "standard" }, "approval_history": { "display_value": "", "value": "" }, "skills": { "display_value": "", "value": "" }, "test_plan": { "display_value": "--Confirm that there are no monitoring alerts for the router", "value": "--Confirm that there are no monitoring alerts for the router" }, "number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "is_bulk": { "display_value": "false", "value": false }, "cab_delegate": { "display_value": "", "value": "" }, "requested_by_date": { "display_value": "", "value": "", "display_value_internal": "" }, "ci_class": { "display_value": "cmdb_ci", "value": "cmdb_ci" }, "state": { "display_value": "Closed", "value": 3.0 }, "sys_created_by": { "display_value": "admin", "value": "admin" }, "knowledge": { "display_value": "false", "value": false }, "order": { "display_value": "", "value": "" }, "phase": { "display_value": "Requested", "value": "requested" }, "cmdb_ci": { "display_value": "", "value": "" }, "delivery_plan": { "display_value": "", "value": "" }, "impact": { "display_value": "3 - Low", "value": 3.0 }, "contract": { "display_value": "", "value": "" }, "active": { "display_value": "false", "value": false }, "work_notes_list": { "display_value": "", "value": "" }, "priority": { "display_value": "4 - Low", "value": 4.0 }, "sys_domain_path": { "display_value": "/", "value": "/" }, "cab_recommendation": { "display_value": "", "value": "" }, "production_system": { "display_value": "false", "value": false }, "rejection_goto": { "display_value": "", "value": "" }, "review_date": { "display_value": "", "value": "", "display_value_internal": "" }, "requested_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "business_duration": { "display_value": "", "value": "" }, "group_list": { "display_value": "", "value": "" }, "change_plan": { "display_value": "", "value": "" }, "approval_set": { "display_value": "", "value": "", "display_value_internal": "" }, "wf_activity": { "display_value": "", "value": "" }, "implementation_plan": { "display_value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform", "value": "-- Place router into maintenance mode in the monitoring platform\r\n-- Logon to router through SSH\r\n-- Run the following command\r\n\r\nrouter(config-router)#router bgp 12345\r\nrouter(config-router)#neighbor {neighbor ip} soft-reconfig [inbound]\r\nrouter#clear ip bgp {neighbor ip} soft in\r\n\r\n-- Confirm the sessions have been cleared\r\n-- Place router back into operational mode in the monitoring platform" }, "universal_request": { "display_value": "", "value": "" }, "end_date": { "display_value": "", "value": "", "display_value_internal": "" }, "short_description": { "display_value": "Reboot the server at 6 am", "value": "Reboot the server at 6 am" }, "correlation_display": { "display_value": "", "value": "" }, "work_start": { "display_value": "2015-07-06 11:56:04", "value": "2015-07-06 18:56:04", "display_value_internal": "2015-07-06 11:56:04" }, "delivery_task": { "display_value": "", "value": "" }, "outside_maintenance_schedule": { "display_value": "false", "value": false }, "additional_assignee_list": { "display_value": "", "value": "" }, "std_change_producer_version": { "display_value": "Clear BGP sessions on a Cisco router - 1", "value": "16c2273c47010200e90d87e8dee49006" }, "sys_class_name": { "display_value": "Change Request", "value": "change_request" }, "service_offering": { "display_value": "", "value": "" }, "closed_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "follow_up": { "display_value": "", "value": "", "display_value_internal": "" }, "review_status": { "display_value": "", "value": "" }, "reassignment_count": { "display_value": "2", "value": 2.0 }, "start_date": { "display_value": "", "value": "", "display_value_internal": "" }, "assigned_to": { "display_value": "", "value": "" }, "variables": { "display_value": "variable_pool", "value": "variable_pool" }, "sla_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments_and_work_notes": { "display_value": "", "value": "" }, "escalation": { "display_value": "Normal", "value": 0.0 }, "upon_approval": { "display_value": "Proceed to Next Task", "value": "proceed" }, "correlation_id": { "display_value": "", "value": "" }, "made_sla": { "display_value": "true", "value": true }, "backout_plan": { "display_value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work", "value": "Due to the limited number of commands in the implementation plan it is not possible to backout the change.\r\n\r\nIf required you are authorized to reboot the router if BGP fails to work" }, "conflict_status": { "display_value": "Not Run", "value": "Not Run" }, "task_effective_number": { "display_value": "CHG0000024", "value": "CHG0000024" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "opened_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "user_input": { "display_value": "", "value": "" }, "sys_created_on": { "display_value": "2015-07-06 11:55:46", "value": "2015-07-06 18:55:46", "display_value_internal": "2015-07-06 11:55:46" }, "on_hold_task": { "display_value": "", "value": "" }, "sys_domain": { "display_value": "global", "value": "global" }, "route_reason": { "display_value": "", "value": "" }, "closed_at": { "display_value": "2015-07-06 11:56:23", "value": "2015-07-06 18:56:23", "display_value_internal": "2015-07-06 11:56:23" }, "review_comments": { "display_value": "", "value": "" }, "business_service": { "display_value": "", "value": "" }, "time_worked": { "display_value": "", "value": "" }, "chg_model": { "display_value": "", "value": "" }, "expected_start": { "display_value": "", "value": "", "display_value_internal": "" }, "opened_at": { "display_value": "2015-06-09 11:55:46", "value": "2015-06-09 18:55:46", "display_value_internal": "2015-06-09 11:55:46" }, "work_end": { "display_value": "2015-07-06 11:56:10", "value": "2015-07-06 18:56:10", "display_value_internal": "2015-07-06 11:56:10" }, "phase_state": { "display_value": "Open", "value": "open" }, "cab_date": { "display_value": "", "value": "", "display_value_internal": "" }, "work_notes": { "display_value": "", "value": "" }, "close_code": { "display_value": "Successful", "value": "successful" }, "assignment_group": { "display_value": "Network", "value": "287ebd7da9fe198100f92cc8d1d2154e" }, "description": { "display_value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n", "value": "Resend the complete BGP table to neighboring routers\r\n\r\n--Both neighbors need to support soft reset route refresh capability.\r\n--Stores complete BGP table of you neighbor in router memory.\r\n--Not a good idea on a peering router with full feed, due to the memory requirements.\r\n" }, "on_hold_reason": { "display_value": "", "value": "" }, "calendar_duration": { "display_value": "", "value": "" }, "close_notes": { "display_value": "Completed without issues", "value": "Completed without issues" }, "sys_id": { "display_value": "b0dbda5347c12200e0ef563dbb9a718f", "value": "b0dbda5347c12200e0ef563dbb9a718f" }, "contact_type": { "display_value": "Phone", "value": "phone" }, "cab_required": { "display_value": "false", "value": false }, "urgency": { "display_value": "3 - Low", "value": 3.0 }, "scope": { "display_value": "Medium", "value": 3.0 }, "company": { "display_value": "", "value": "" }, "justification": { "display_value": "", "value": "" }, "activity_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "comments": { "display_value": "", "value": "" }, "approval": { "display_value": "Approved", "value": "approved" }, "due_date": { "display_value": "", "value": "", "display_value_internal": "" }, "sys_mod_count": { "display_value": "10", "value": 10.0 }, "on_hold": { "display_value": "false", "value": false }, "sys_tags": { "display_value": "", "value": "" }, "conflict_last_run": { "display_value": "", "value": "", "display_value_internal": "" }, "risk_value": { "display_value": "", "value": "" }, "unauthorized": { "display_value": "false", "value": false }, "risk": { "display_value": "Moderate", "value": 3.0 }, "location": { "display_value": "", "value": "" }, "category": { "display_value": "Other", "value": "Other" }, "risk_impact_analysis": { "display_value": "", "value": "" } } } ### cURL 要求 {#change-PATCH-change-sys_id__example_t5g_p5c_5xb} 次の例は、要求本文で暗号化されたフィールドを渡す方法を示しています。 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"encrypted_fields\":\"short_description,description\", \"short_description\":\"my short desc\", \"description\":\"my desc\" }" \ --user "username":"password" ### cURL 要求 {#change-PATCH-change-sys_id__example_a4f_z5c_5xb} 次の例は、暗号化されたフィールドをクエリパラメーターとして渡す方法を示しています。 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/b0dbda5347c12200e0ef563dbb9a718f?encrypted_fields=short_description%2Cdescription&short_description=my%20short%20desc&description=my%20desc" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{}" \ --user "username":"password" ## Change Management - PATCH /sn_chg_rest/change/{sys_id}/approvals {#ariaid-title28} 現在のユーザーが、指定された変更要求の変更要求承認レコードを承認または却下できるようにします。 ### URL 形式 {#change-PATCH-approvals__section_ord_srn_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id}/approvals デフォルトの URL：/api/sn_chg_rest/change/{sys_id}/approvals ### サポートされている要求パラメーター {#change-PATCH-approvals__entry__2}{#change-PATCH-approvals__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 承認/却下が適用される変更要求の sys_id。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 157. パスパラメーター] {#change-PATCH-approvals__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 158. クエリパラメーター] {#change-PATCH-approvals__entry__12} | 名前 | 説明 | |-|-| | comments | state が `rejected` の場合は必須です。変更が却下された理由。 データタイプ：文字列 | | state | 必須です。承認ステータス。 例：`--data "{\"state\": \"approved\"}" ` 有効な値： * 承認済み * が却下されました {#change-PATCH-approvals__ul_zcf_tpz_tkb} データタイプ：文字列 | [表 : 159. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-approvals__entry__18}{#change-PATCH-approvals__accept-RESTAPI}{#change-PATCH-approvals__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 160. 要求ヘッダー] {#change-PATCH-approvals__entry__24} | ヘッダー | 説明 | |-|-| | なし | | [表 : 161. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-approvals__entry__28}{#change-PATCH-approvals__entry-200-status-code}{#change-PATCH-approvals__entry-401-status-code}{#change-PATCH-approvals__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 400 | 要求が正しくありません。不適切な要求タイプを示します (変更要求を承認または却下する権限がないユーザーなど)。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 162. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-PATCH-approvals__entry__38} | 名前 | 説明 | |-|-| | name-value pairs | 関連する変更要求のすべてのフィールドの値。 データタイプ：オブジェクト | | state | 変更要求の現在のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 承認/却下される変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 可能な値： * 緊急 * 通常 * 標準 {#change-PATCH-approvals__ul_czn_btz_tkb} データタイプ：文字列 | | type.value | 内部タイプの値。 可能な値： * emergency * normal * standard {#change-PATCH-approvals__ul_upd_cn5_wlb} データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/approvals" \ --request POST \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data "{\"state\": \"approved\"}" \ --user "username":"password" { result: [ { sys_id: "0f4ac6c4b750230096c3e4f6ee11a9fe", state: { value: "-2", display_value: "Scheduled" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, single parameter example below short_description: { value: "Remove server", display_value: "Remove server" } } ] } ## Change Management - PATCH /sn_chg_rest/change/{change_sys_id}/schedule/first_available {#ariaid-title29} 最初に見つかった利用可能なタイムスロットを使用して、変更要求の予定開始時間と予定終了時間を更新します。 必要なロール： sn_change_writer 注: 応答本文の worker.link プロパティにあるリンクを使用して、スケジュールステータスを表示します。 関連項目： * [GET /sn_chg_rest/change/ci/{cmdb_ci_sys_id}/schedule](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-c_id-schedule "構成アイテム ID と期間で利用可能なタイムスロットを取得できるようにします。オプションで予定開始時間を含めることができます。") * [GET /sn_chg_rest/change/{change_sys_id}/schedule](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-change-sys_id-sched "変更要求に利用可能なタイムスロットを取得できるようにします。") {#change-PATCH-c_id-sched-first__ul_orx_mts_npb} ### URL 形式 バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{change_sys_id}/schedule/first_available デフォルトの URL：/api/sn_chg_rest/change/{change_sys_id}/schedule/first_available ### サポートされている要求パラメーター {#change-PATCH-c_id-sched-first__entry__2}{#change-PATCH-c_id-sched-first__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | change_sys_id | 次の利用可能なタイムスロットを更新する変更要求の sys_id。変更要求 \[change_request\] テーブルにあります。選択した変更要求には、構成アイテム (cmdb_ci) が必要です。 | [表 : 163. パスパラメーター] {#change-PATCH-c_id-sched-first__table_fd4_yhf_jpb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 164. クエリパラメーター] {#change-PATCH-c_id-sched-first__table_fd4_yhf_jpb} {#change-PATCH-c_id-sched-first__entry__12} | 名前 | 説明 | |-|-| | duration_in_seconds | 変更の期間 (秒)、つまり、変更要求タスクの完了に必要な時間。 データタイプ：整数 | | planned_start_time | オプション。変更要求の実装開始が予定されている日時 (UTC)。 この時間以降の利用可能なタイムスロットの開始時間を取得します。指定しない場合、現在の時刻が開始時間として使用されます。 時間形式：yyyy-mm-dd hh:mm:ss データタイプ：文字列 | [表 : 165. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-c_id-sched-first__entry__18}{#change-PATCH-c_id-sched-first__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 166. 要求ヘッダー] {#change-PATCH-c_id-sched-first__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 167. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-c_id-sched-first__entry__26} | ステータスコード | 説明 | |-|-| | 202 | システムが要求を承認しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 考えられる問題： * duration_in_seconds 本文パラメーター値が無効であるか、指定されていません。{#change-PATCH-c_id-sched-first__change-schedule-400-duration} {#change-PATCH-c_id-sched-first__change-schedule-400-duration} * 無効な planned_start_time 本文パラメーター値が指定されました。{#change-PATCH-c_id-sched-first__change-schedule-400-invalid-parm} {#change-PATCH-c_id-sched-first__change-schedule-400-invalid-parm} * 指定した変更要求には、関連付けられた構成アイテム (cmdb_ci) がありません。 * ユーザーに変更要求のフィールドへの読み取りアクセス権がありません。 {#change-PATCH-c_id-sched-first__ul_rpf_3sk_npb} | | 403 | 禁止されています。ユーザーに、変更要求の開始予定日と終了予定日の値への書き込みアクセス権がありません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 考えられる問題： * 指定された情報に基づく変更要求を見つけることができません。 * ユーザーにはこのレコードへの読み取りアクセス権がありません。 {#change-PATCH-c_id-sched-first__ul_ery_g1j_rpb} | [表 : 168. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-PATCH-c_id-sched-first__section_p33_ccf_jpb} {#change-PATCH-c_id-sched-first__table_is2_n4s_jpb__entry__2}{#change-PATCH-c_id-sched-first__row-result-error-cmdb}{#change-PATCH-c_id-sched-first__row-result-error_detail-cmdb}{#change-PATCH-c_id-sched-first__row-result-error_message-cmdb} | 名前 | 説明 | |-|-| | error | エンドポイント要求の処理中に発生したエラーに関する情報。 データタイプ：オブジェクト "error": { "detail": "String", "message": "String", "status": "String" } | | error.detail | エラーに関する追加情報。 データタイプ：文字列 | | error.message | エラーを識別するメッセージ。 データタイプ：文字列 | | messages | メッセージ情報。 データタイプ：オブジェクト "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | messages.errorMessages | 要求の処理中にエラーメッセージが表示されました。 データタイプ：アレイ | | messages.infoMessages | 要求の処理中に情報メッセージが表示されました。 データタイプ：アレイ | | messages.warningMessages | 要求の処理中に警告メッセージが表示されました。 データタイプ：アレイ | | 要求 | 元のエンドポイント要求。 データタイプ：文字列 | | state | ワーカーの現在のステータスに関する情報。 データタイプ：オブジェクト state: { display_value: "String", value: Number } | | state.display_value | ワーカーのステータス値を表示します。これらの値は state.value パラメーターに直接関連付けられています。 可能な値： * 完了 * エラー * 対応中 * 待機中 {#change-PATCH-c_id-sched-first__ul_ehh_nxy_jhb} データタイプ：文字列 | | state.value | ワーカーのステータスの数値。 可能な値： * 1 * 2 * 3 * 4 {#change-PATCH-c_id-sched-first__ul_zw1_fxy_jhb} データタイプ：数値 | | type | 要求のタイプを示します。 有効な値：schedule データタイプ：文字列 | | worker | 関連付けられたワーカーに関する情報。 データタイプ：オブジェクト "worker": { "link": "String", "sysId": "String" } | | worker.link | 変更要求のスケジュールのステータスを取得するためのリンク。結果を表示するには、[GET /sn_chg_rest/change/worker/{sys_id}](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-worker "指定された非同期ワーカーの現在のステータス、情報、およびエラーを取得します。") で sys_id を使用します。 データタイプ：文字列 | | worker.sysId | 変更要求と関連付けるワーカーの sys_id。 データタイプ：文字列 | | status | エラーが発生した場合にのみ表示されます。エンドポイント処理のステータス。 可能な値：failure データタイプ：文字列 | [ ] {#change-PATCH-c_id-sched-first__table_is2_n4s_jpb} ### 変更要求のスケジュールのステータスの取得 {#change-PATCH-c_id-sched-first__cmapi-sched-get-change-status} worker.link に指定された値を使用して、変更レコードが最初の利用可能なタイムスロットに正常にスケジュールされたかどうかを判断します。値の形式は次のとおりです。 https://instance.service-now.com/api/sn_chg_rest/change/worker/\ 結果を表示するには、worker.link の詳細を使用して、[GET /sn_chg_rest/change/worker/{sys_id}](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-worker "指定された非同期ワーカーの現在のステータス、情報、およびエラーを取得します。") で提供された sys_id を実行します。 応答の本文にはステータスが含まれ、処理が完了すると結果が提供されます。 利用可能なタイムスロットが見つかった場合、システムは最初の利用可能なスロットで変更要求を更新します。ステータスが完了になると、最初の利用可能なタイムスロットが設定されていることが messages.infoMessages によって示されます。 messages.infoMessages に対する次のいずれかのスケジューリング応答値が応答本文で指定されています。 * `変更が更新されました`：タイムスロットの変更要求が更新されました。 * `今から 日間のスロットが見つかりません`：スケジュール枠で定義された日数内に指定された変更要求期間に利用可能なタイムスロットはありません。 注: 変更要求スケジューリングタイムスロットのデフォルト値は 90 日です。この値を変更するには、change.conflict.next_available.schedule_window プロパティを変更します。詳細については、「 [競合分析プロパティの構成](https://www.servicenow.com/docs/access?context=configure-conflict-properties&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。 {#change-PATCH-c_id-sched-first__ul_kb2_rhy_npb} 次の GET /sn_chg_rest/change/worker/{sys_id} の例は、worker.link の詳細で指定された ID を使用して提供された出力を示しています。結果は、処理が完了し、最初の利用可能なタイムスロットで変更要求が更新されたことを示しています。 { "result": { "worker": { "sysId": "355c62e0a4c87010f87712198fe9cacf", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/355c62e0a4c87010f87712198fe9cacf" }, "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 3, "display_value": "Complete" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [ "Change has been updated" ] } } } ### cURL 要求 curl "https://instance.service-now.com/api/sn_chg_rest/change/87ae5e900a0a2c3e263e8304e727c646/schedule/first_available" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{\"duration_in_seconds\":\"10800\"}" \ --user "username":"password" 結果には、GET /sn_chg_rest/change/worker/endpoint で提供された sys_id を実行するために使用できる worker.link の詳細が含まれています。 { "result": { "worker": { "sysId": "355c62e0a4c87010f87712198fe9cacf", "link": "https://instance.service-now.com/api/sn_chg_rest/change/worker/355c62e0a4c87010f87712198fe9cacf" }, "request": "{\"change_sys_id\":\"87ae5e900a0a2c3e263e8304e727c646\",\"duration_in_seconds\":10800,\"timezone\":\"America/Los_Angeles\"}", "state": { "value": 1, "display_value": "Waiting" }, "type": "schedule", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] } } } ## Change Management - PATCH /sn_chg_rest/change/{change_sys_id}/task/{task_sys_id} {#ariaid-title30} 指定された sys_id によって識別される変更要求タスクを、要求本文または URL のキーと値のペアで更新します。 ### URL 形式 {#change-PATCH-c_id-task-t_id__section_lv1_rzm_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{change_sys_id}/task/{task_sys_id} デフォルトの URL：/api/sn_chg_rest/change/{change_sys_id}/task/{task_sys_id} ### サポートされている要求パラメーター {#change-PATCH-c_id-task-t_id__entry__2}{#change-PATCH-c_id-task-t_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | change_sys_id | タスクが関連付けられている変更要求の sys_id。指定された変更要求に指定されたタスクが関連付けられているかどうかを確認します。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | | task_sys_id | 変更するタスクの sys_id。変更タスク \[change_task\] テーブルにあります。 データタイプ：文字列 | [表 : 169. パスパラメーター] {#change-PATCH-c_id-task-t_id__entry__10} | 名前 | 説明 | |-|-| | key-value pairs | 更新するフィールドを表す名前と値のペア。要求本文パラメーターは、URL パラメーターを上書きします。ただし、URL で必須のパラメーターを指定する必要があります。 データタイプ：文字列 | [表 : 170. クエリパラメーター] {#change-PATCH-c_id-task-t_id__entry__14} | 名前 | 説明 | |-|-| | data | 関連する変更要求で更新するフィールドを表す名前と値のペア。たとえば、簡単な説明のファイルを更新するには、次のような名前と値のペアを入力します。`--data "{\"short_description\": \"my short desc\" }" \` データタイプ：文字列 | [表 : 171. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-c_id-task-t_id__entry__18}{#change-PATCH-c_id-task-t_id__accept-RESTAPI}{#change-PATCH-c_id-task-t_id__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 172. 要求ヘッダー] {#change-PATCH-c_id-task-t_id__entry__24} | ヘッダー | 説明 | |-|-| | なし | | [表 : 173. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-c_id-task-t_id__entry__28}{#change-PATCH-c_id-task-t_id__entry-200-status-code}{#change-PATCH-c_id-task-t_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 174. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-PATCH-c_id-task-t_id__entry__40} | 名前 | 説明 | |-|-| | name-value pairs | 削除前に識別された変更要求タスクのすべてのフィールド (キー) とその関連付けられた値。 データタイプ：オブジェクト | | sys_id | 変更要求タスクの sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求タスクの sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求タスクの sys_id。 データタイプ：文字列 | | parent | このタスクに関連付けられた変更要求の一意の識別子情報。 データタイプ：オブジェクト parent: { display_value: "String", value: "String" } | | parent.display_value | UI に表示するタスク情報。 データタイプ：文字列 | | parent.value | 親タスクの sys_id。 データタイプ：文字列 | | __meta.ignoredFields | 呼び出しで渡されたが、ベースレコードに存在しないか、フィールドが読み取り専用であるため、変更要求に適用されなかったキーと値のペア。 データタイプ：アレイ | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task/12629ec4b750230096c3e4f6ee11a9d5?short_description=Retire both nodes" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type: application/json" \ --data "{\"state\": \"assess\", \"no_such_field\": \"this will be ignored\" }" \ --user "username":"password" { result: [ { sys_id: { value: "12629ec4b750230096c3e4f6ee11a9d5", display_value: "12629ec4b750230096c3e4f6ee11a9d5" }, parent: { value: "0f4ac6c4b750230096c3e4f6ee11a9fe", display_value: "CHG0033046 " }, ..., // all valid fields in record, example below short_description: { value: "Retire both nodes", display_value: "Retire both nodes" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change Management - PATCH /sn_chg_rest/change/emergency/{sys_id} {#ariaid-title31} 指定された sys_id によって識別される緊急の変更要求を、要求本文または URL のキーと値のペアで更新します。 ### URL 形式 {#change-PATCH-emergency__section_xvk_cgt_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/emergency/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/emergency/{sys_id} ### サポートされている要求パラメーター {#change-PATCH-emergency__entry__2}{#change-PATCH-emergency__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更する変更要求の sys_id。\[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 175. パスパラメーター] {#change-PATCH-emergency__entry__8} | 名前 | 説明 | |-|-| | name-value pairs | 更新するフィールドを表す名前と値のペア。要求本文パラメーターは、URL パラメーターを上書きします。ただし、URL で必須のパラメーターを指定する必要があります。 データタイプ：文字列 | [表 : 176. クエリパラメーター] {#change-PATCH-emergency__entry__12} | 名前 | 説明 | |-|-| | data | 関連する変更要求で更新するフィールドを表す名前と値のペア。たとえば、簡単な説明のファイルを更新するには、次のような名前と値のペアを入力します。`--data "{\"short_description\": \"my short desc\" }" \` データタイプ：文字列 | [表 : 177. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-emergency__entry__16}{#change-PATCH-emergency__accept-RESTAPI}{#change-PATCH-emergency__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 178. 要求ヘッダー] {#change-PATCH-emergency__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 179. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-emergency__entry__26}{#change-PATCH-emergency__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 180. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-PATCH-emergency__entry__38} | 名前 | 説明 | |-|-| | name-value pairs | 関連する変更要求のすべてのフィールドの値。 データタイプ：文字列 | | state | 変更要求の現在のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Emergency」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「emergency」です。 データタイプ：文字列 | | __meta.ignoredFields | 呼び出しで渡されたが、ベースレコードに存在しないか、フィールドが読み取り専用であるため、変更要求に適用されなかった名前と値のペア。 データタイプ：アレイ | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency/b0dbda5347c12200e0ef563dbb9a718f" \ --request PATCH \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data "{\"no_such_field\": \"this will be ignored\", }" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", }, state: { value: "-4", display_value: "Assess" }, type: { value: "emergency", display_value: "Emergency" }, ..., // all valid fields in record, example below short_description: { value: "Reboot server", display_value: "Reboot server" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change Management - PATCH /sn_chg_rest/change/normal/{sys_id} {#ariaid-title32} 指定された sys_id によって識別される通常の変更要求を、要求本文または URL のパラメーターで更新します。 ### URL 形式 {#change-PATCH-normal__section_ksd_x2s_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/normal/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/normal/{sys_id} ### サポートされている要求パラメーター {#change-PATCH-normal__entry__2}{#change-PATCH-normal__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更する変更要求の sys_id。\[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 181. パスパラメーター] {#change-PATCH-normal__entry__8} | 名前 | 説明 | |-|-| | name-value pairs | 更新するフィールドを表す名前と値のペア。要求本文パラメーターは、URL パラメーターを上書きします。ただし、URL で必須のパラメーターを指定する必要があります。 データタイプ：文字列 | [表 : 182. クエリパラメーター] {#change-PATCH-normal__entry__12} | 名前 | 説明 | |-|-| | data | 関連する変更要求で更新するフィールドを表す名前と値のペア。たとえば、簡単な説明のファイルを更新するには、次のような名前と値のペアを入力します。`--data "{\"short_description\": \"my short desc\" }" \` データタイプ：文字列 | [表 : 183. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-normal__entry__16}{#change-PATCH-normal__accept-RESTAPI}{#change-PATCH-normal__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | Accept | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 184. 要求ヘッダー] {#change-PATCH-normal__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 185. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-normal__entry__26}{#change-PATCH-normal__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 186. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-PATCH-normal__entry__38} | 名前 | 説明 | |-|-| | name-value pairs | 関連する変更要求のすべてのフィールドの値。 データタイプ：オブジェクト | | state | 変更要求の現在のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Normal」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「normal」です。 データタイプ：文字列 | | __meta.ignoredFields | 呼び出しで渡されたが、ベースレコードに存在しないか、フィールドが読み取り専用であるため、変更要求に適用されなかった名前と値のペア。 データタイプ：アレイ | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal/b0dbda5347c12200e0ef563dbb9a718f?state=assess" \ --request PATCH \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --data "{\"state\": \"assess\", \"no_such_field\": \"this will be ignored\" }" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", state: { value: "-4", display_value: "Assess" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, example below short_description: { value: "Remove server", display_value: "Remove server" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change Management - PATCH /sn_chg_rest/change/standard/{sys_id} {#ariaid-title33} 指定された sys_id によって識別される標準的な変更の要求を、要求本文または URL のパラメーターで更新します。 ### URL 形式 {#change-PATCH-standard__section_dz5_j5k_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/standard/{sys_id} デフォルトの URL：/api/sn_chg_rest/change/standard/{sys_id} ### サポートされている要求パラメーター {#change-PATCH-standard__entry__2}{#change-PATCH-standard__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 変更する変更要求の sys_id。\[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 187. パスパラメーター] {#change-PATCH-standard__entry__8} | 名前 | 説明 | |-|-| | name-value pairs | 更新するフィールドを表す名前と値のペア。要求本文パラメーターは、URL パラメーターを上書きします。ただし、URL で必須のパラメーターを指定する必要があります。 データタイプ：文字列 | [表 : 188. クエリパラメーター] {#change-PATCH-standard__entry__12} | 名前 | 説明 | |-|-| | data | 関連する変更要求で更新するフィールドを表す名前と値のペア。たとえば、簡単な説明のファイルを更新するには、次のような名前と値のペアを入力します。`--data "{\"short_description\": \"my short desc\" }" \` データタイプ：文字列 | [表 : 189. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-standard__entry__16}{#change-PATCH-standard__accept-RESTAPI}{#change-PATCH-standard__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 190. 要求ヘッダー] {#change-PATCH-standard__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 191. 応答ヘッダー] ### ステータスコード {#change-PATCH-standard__section_vzh_nvk_xlb} この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-standard__table_wwn_rhd_ct__entry__2}{#change-PATCH-standard__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 192. ステータスコード] {#change-PATCH-standard__table_wwn_rhd_ct} ### 応答本文のパラメーター (JSON または XML) {#change-PATCH-standard__entry__38} | 名前 | 説明 | |-|-| | name-value pairs | 識別された変更要求のすべてのフィールド (キー) とその関連付けられた値。 データタイプ：オブジェクト | | state | 変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 データタイプ：文字列 | | state.value | 内部ステータスの値。 データタイプ：文字列 | | sys_id | 変更要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/standard/1c87925347c12200e0ef563dbb9a7177?description=Reboot my email server" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{\"short_description\": \"my short desc\" }" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, state: { value: "-5", display_value: "New" }, ..., // all valid fields in record, example below short_description: { value: "Reboot my email server", display_value: "Reboot my email server" }, } ] } ## Change Management - PATCH /sn_chg_rest/change/standard/{sys_id}/risk {#ariaid-title34} リスク条件の評価に基づいて、指定された標準変更のリスクと影響度を計算します。 Change Risk Assessment プラグインがインストールされている場合は、リスクアセスメントが完了すると累積最大リスクも計算されます。 ### URL 形式 {#change-PATCH-standard-risk__section_k5j_sgl_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id}/risk デフォルトの URL：/api/sn_chg_rest/change/{sys_id}/risk ### サポートされている要求パラメーター {#change-PATCH-standard-risk__entry__2}{#change-PATCH-standard-risk__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 評価する標準変更の sys_id。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 193. パスパラメーター] {#change-PATCH-standard-risk__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 194. クエリパラメーター] {#change-PATCH-standard-risk__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 195. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-standard-risk__entry__16}{#change-PATCH-standard-risk__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 196. 要求ヘッダー] {#change-PATCH-standard-risk__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 197. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-PATCH-standard-risk__entry__24}{#change-PATCH-standard-risk__entry-401-status-code}{#change-PATCH-standard-risk__entry-404-status-code}{#change-PATCH-standard-risk__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | リスクアセスメントが正常に完了しました。 | | 400 | リスクアセスメントが失敗しました。失敗のタイプの詳細はエラーデータに含まれています。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。要求アイテムが見つかりませんでした。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 198. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-PATCH-standard-risk__entry__36} | 名前 | 説明 | |-|-| | impact | 指定された標準変更に関連する影響度。 データタイプ：オブジェクト impact: { display_value: "String", value: "String" } | | impact.display_value | UI に表示する影響度情報。 データタイプ：文字列 | | impact.value | 内部影響度の値。 データタイプ：文字列 | | name-value pairs | 標準変更レコード内のすべての有効なフィールド。 データタイプ：オブジェクト | | risk | 指定された標準変更について計算されたリスク。 データタイプ：オブジェクト risk: { display_value: "String", value: "String" } | | risk.display_value | UI に表示するリスク情報。 データタイプ：文字列 | | risk.value | 内部リスク値。 データタイプ：文字列 | | sys_id | 標準的な変更の要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求の sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求の sys_id。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/1c87925347c12200e0ef563dbb9a7177/risk" \ --request PATCH \ --header "Accept:application/json" \ --user "username":"password" { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, risk: { value: "4", display_value: "Low" }, impact: { value: "3", display_value: "3 - Low" } ..., // all valid fields in record } ## Change Management - POST /sn_chg_rest/change {#ariaid-title35} 変更要求に基づいて変更要求レコードを作成します。1 回の呼び出し内で複数の変更要求を作成することはサポートされていません。 [Change Management - GET /sn_chg_rest/change/model](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-model "指定された基準に基づいて 1 つ以上の変更モデルを取得します。") または [Change Management - GET /sn_chg_rest/change/{sys_id}](https://servicenow-prod.fluidtopics.net/gx266BZK4kXTPENrR~wMig#change-GET-model-sys_id "指定された sys_id で識別される変更モデルを取得します。") エンドポイントを使用して、利用可能な変更モデルのリストを取得できます。 変更要求を作成するときは、変更モデル (chg_model) または typeを設定します。chg_modelとtypeの両方が設定されている場合、タイプは単に変更の分類です。これらの値を 1 つも指定しないと、デフォルト設定がリリースによって変更される可能性があります。これらの値のうち少なくとも 1 つを設定することを強くお勧めします。 値は、クエリ パラメーターまたは要求本文パラメーターとして設定できます。 ### URL 形式 バージョニングされた URL：/api/sn_chg_rest/{api_version}/change デフォルトの URL：/api/sn_chg_rest/change ### サポートされている要求パラメーター {#change-POST-change-sys_id__entry__2}{#change-POST-change-sys_id__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 199. パスパラメーター] {#change-POST-change-sys_id__entry__6}{#change-POST-change-sys_id__encrypted_fields-chgmng-entry} | 名前 | 説明 | |-|-| | name-value pairs | 更新するフィールドを表す名前と値のペア。要求本文パラメーターは、URL パラメーターを上書きします。ただし、URL で必須のパラメーターを指定する必要があります。 代わりに、同じ値を要求本文パラメーターとして設定できます。 注: 変更要求を作成するときは、変更モデル (chg_model) または typeを設定します。chg_modelとtypeの両方が設定されている場合、タイプは単に変更の分類です。これらの値を 1 つも指定しないと、デフォルト設定がリリースによって変更される可能性があります。これらの値のうち少なくとも 1 つを設定することを強くお勧めします。 データタイプ：文字列 | | chg_model | 変更モデル \[chg_model\] テーブルにリストされている変更モデルの名前。 `chg_model=Normal` の形式で提供されます。 詳細については、「 [変更モデル](https://www.servicenow.com/docs/access?context=change-models&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。 注: 変更モデル (chg_model) または type 値を指定しない場合、デフォルト設定はリリースによって変更される可能性があります。これらの値のうち少なくとも 1 つを設定することを強くお勧めします。 データタイプ：文字列 | | encrypted_fields | 暗号化するカンマ区切りフィールドのリスト。これらのフィールドは、関連付けられたレコードに格納される前に暗号化されます。指定すると、エンドポイントは setValue() メソッドを呼び出す代わりに、GlideRecord setDisplayValue() メソッドを呼び出します。 このため、このパラメーターを使用して、sys_idsや値を渡す代わりに、参照フィールドや選択フィールドなどの暗号化されていないフィールドの表示値を渡すこともできます。 データタイプ：文字列 | | type | 選択肢 \[sys_choice\] テーブルにリストされている変更要求タイプの名前。chg_modelも入力されている場合、このフィールドは変更の分類としてのみ使用されます。 `type=Normal` の形式で提供されます。 詳細については、「 [新しい変更要求タイプの追加](https://www.servicenow.com/docs/access?context=t_AddNewChangeType&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」をご参照ください。 注: 変更モデル (chg_model) または type 値を指定しない場合、デフォルト設定はリリースによって変更される可能性があります。これらの値のうち少なくとも 1 つを設定することを強くお勧めします。 データタイプ：文字列 | [表 : 200. クエリパラメーター] {#change-POST-change-sys_id__entry__16} | 名前 | 説明 | |-|-| | オブジェクト | 関連する変更要求で更新するフィールドを表す名前と値のペア。たとえば、簡単な説明のファイルを更新するには、次のような名前と値のペアを入力します。`--data "{\"short_description\": \"my short desc\" }" \` 代わりに、同じプロパティをクエリ パラメーターとして設定できます。 データタイプ：文字列 | | Object.chg_model | 変更モデル \[chg_model\] テーブルにリストされている変更モデルの名前。 次の形式で名前と値のペアとして指定されます: `{"chg_model" : "Cloud Infrastructure"}` 詳細については、「 [変更モデル](https://www.servicenow.com/docs/access?context=change-models&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。 注: 変更モデル (chg_model) または type 値を指定しない場合、デフォルト設定はリリースによって変更される可能性があります。これらの値のうち少なくとも 1 つを設定することを強くお勧めします。 データタイプ：文字列 | | Object.encrypted_fields | 暗号化するカンマ区切りフィールドのリスト。これらのフィールドは、関連付けられたレコードに格納される前に暗号化されます。指定すると、エンドポイントは setValue() メソッドを呼び出す代わりに、GlideRecord setDisplayValue() メソッドを呼び出します。 このため、このパラメーターを使用して、sys_idsや値を渡す代わりに、参照フィールドや選択フィールドなどの暗号化されていないフィールドの表示値を渡すこともできます。 データタイプ：文字列 | | Object.type | 選択肢 \[sys_choice\] テーブルにリストされている変更要求タイプの名前。chg_modelも入力されている場合、このフィールドは変更の分類としてのみ使用されます。 名前と値のペアとして次の形式で指定されます: `{"type" : "emergency"}` 詳細については、「 [新しい変更要求タイプの追加](https://www.servicenow.com/docs/access?context=t_AddNewChangeType&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」をご参照ください。 注: 変更モデル (chg_model) または type 値を指定しない場合、デフォルト設定はリリースによって変更される可能性があります。これらの値のうち少なくとも 1 つを設定することを強くお勧めします。 データタイプ：文字列 | [表 : 201. 要求本文パラメーター (JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-change-sys_id__entry__26}{#change-POST-change-sys_id__accept-RESTAPI}{#change-POST-change-sys_id__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 202. 要求ヘッダー] {#change-POST-change-sys_id__entry__32} | ヘッダー | 説明 | |-|-| | なし | | [表 : 203. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-change-sys_id__entry__36}{#change-POST-change-sys_id__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 204. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-POST-change-sys_id__entry__48} | 名前 | 説明 | |-|-| | result | 新しい変更要求レコード。このオブジェクトの要素は、変更要求 \[change_request\] テーブルのレコード形式に対応します。要求で指定されていないすべての値は、デフォルトに設定されているか、空/null です。 データタイプ：オブジェクト | [ ] ### cURL 要求 次の例は、標準的な変更モデルと標準的なタイプに基づいて変更要求レコードを作成する方法を示しています。この例では、変更要求はモデルによって駆動され、タイプフィールドはカテゴリ化としてのみ使用されます。 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"chg_model\" : \"Standard\", \"description\" : \"Describes the change request.\", \"short_description\" : \"My change request\", \"type\" : \"Standard\" }" \ --user "username":"password" 結果は、レコードが \[変更要求 \[change_request\] テーブルに値が CHG0030022 で正常に追加されたことを示しています。 { "result": "upon_reject": { "display_value": "Cancel all future Tasks", "value": "cancel" }, "sys_updated_on": { "display_value": "2022-12-08 17:18:57", "value": "2022-12-09 01:18:57", "display_value_internal": "2022-12-08 17:18:57" }, "type": { "display_value": "Standard", "value": "standard" } "number": { "display_value": "CHG0030022", "value": "CHG0030022" }, "is_bulk": { "display_value": "false", "value": false } "ci_class": { "display_value": "cmdb_ci", "value": "cmdb_ci" }, "state": { "display_value": "New", "value": -5 }, "sys_created_by": { "display_value": "admin", "value": "admin" }, "knowledge": { "display_value": "false", "value": false }, "phase": { "display_value": "Requested", "value": "requested" } "impact": { "display_value": "3 - Low", "value": 3 }, "active": { "display_value": "true", "value": true }, "priority": { "display_value": "4 - Low", "value": 4 }, "sys_domain_path": { "display_value": "/", "value": "/" }, "production_system": { "display_value": "false", "value": false }, "requested_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" } "short_description": { "display_value": "My change request", "value": "My change request" }, "sys_class_name": { "display_value": "Change Request", "value": "change_request" }, "reassignment_count": { "display_value": "0", "value": 0 }, "variables": { "display_value": "variable_pool", "value": "variable_pool" }, "sla_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "escalation": { "display_value": "Normal", "value": 0 }, "upon_approval": { "display_value": "Proceed to Next Task", "value": "proceed" }, "conflict_status": { "display_value": "Not Run", "value": "Not Run" }, "task_effective_number": { "display_value": "CHG0030022", "value": "CHG0030022" }, "sys_updated_by": { "display_value": "admin", "value": "admin" }, "opened_by": { "display_value": "System Administrator", "value": "6816f79cc0a8016401c5a33be04be441" }, "sys_created_on": { "display_value": "2022-12-08 17:18:57", "value": "2022-12-09 01:18:57", "display_value_internal": "2022-12-08 17:18:57" }, "sys_domain": { "display_value": "global", "value": "global" }, "chg_model": { "display_value": "Standard", "value": "e55d0bfec343101035ae3f52c1d3ae49" }, "opened_at": { "display_value": "2022-12-08 17:18:57", "value": "2022-12-09 01:18:57", "display_value_internal": "2022-12-08 17:18:57" }, "description": { "display_value": "Describes the change request.", "value": "Describes the change request." }, "sys_id": { "display_value": "2ac52dd77c6b1510f877be3b096e64fe", "value": "2ac52dd77c6b1510f877be3b096e64fe" }, "cab_required": { "display_value": "false", "value": false }, "urgency": { "display_value": "3 - Low", "value": 3 }, "scope": { "display_value": "Medium", "value": 3 }, "activity_due": { "display_value": "UNKNOWN", "value": "", "display_value_internal": "" }, "approval": { "display_value": "Not Yet Requested", "value": "not requested" }, } } ### cURL 要求 {#change-POST-change-sys_id__example_t5g_p5c_5xb} 次の例は、要求本文で暗号化されたフィールドを渡す方法を示しています。 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"encrypted_fields\":\"short_description,description\", \"short_description\":\"my short desc\", \"description\":\"my desc\" }" \ --user "username":"password" ### cURL 要求 {#change-POST-change-sys_id__example_a4f_z5c_5xb} 次の例は、暗号化されたフィールドをクエリパラメーターとして渡す方法を示しています。 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change?encrypted_fields=short_description%2Cdescription&short_description=my%20short%20desc&description=my%20desc" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{}" \ --user "username":"password" ## Change Management - POST /sn_chg_rest/change/{sys_id}/ci {#ariaid-title36} 変更要求と 構成管理データベース (CMDB) 構成アイテム (CI) の関連付けを作成します。 関連付けの作成は非同期で行われます。つまり、応答はすぐに提供され、ワーカーの詳細を含みます。ワーカーは、応答後に実際の作業を行います。 ### URL 形式 {#change-POST-ci__section_gjg_rxn_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id}/ci デフォルトの URL：/api/sn_chg_rest/change/{sys_id}/ci ### サポートされている要求パラメーター {#change-POST-ci__entry__2}{#change-POST-ci__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | CMDB CI と関連付ける変更要求の sys_id。 データタイプ：文字列 | [表 : 205. パスパラメーター] {#change-POST-ci__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 206. クエリパラメーター] {#change-POST-ci__entry__12} | 名前 | 説明 | |-|-| | association_type | 必須です。CMDB CI と変更要求の間の関連付けのタイプ。 有効な値： * affected：変更要求によって影響を受ける CI * impacted：変更要求によって影響を受けるサービス * offering：影響を受けるサービスオファリング {#change-POST-ci__ul_bp5_2sm_dhb} データタイプ：文字列 | | cmdb_ci_sys_ids | 必須です。変更要求に関連付ける CMDB CI sys_id のリスト。 データタイプ：アレイまたはカンマ区切りの文字列 | | refresh_impacted_services | 影響を受ける CI のリストに基づいて、影響を受けるサービスを `association_type=affected` で入力するときに使用されるフラグ。 有効な値： * true：影響を受ける CI に基づいて、影響を受けるサービスを入力します。 * false：影響を受けるサービスを自動的に入力しません。 {#change-POST-ci__ul_uxb_xvm_dhb} データタイプ：ブーリアン デフォルト値：false | [表 : 207. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-ci__entry__20}{#change-POST-ci__accept-RESTAPI}{#change-POST-ci__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 208. 要求ヘッダー] {#change-POST-ci__entry__26} | ヘッダー | 説明 | |-|-| | なし | | [表 : 209. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-ci__entry__30}{#change-POST-ci__entry-401-status-code}{#change-POST-ci__entry-404-status-code}{#change-POST-ci__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 202 | 受け入れ済み。処理要求が受け入れられました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 エラー応答には、問題のトラブルシューティングに役立つ関連メッセージが含まれています。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。要求アイテムが見つかりませんでした。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 210. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-POST-ci__entry__42} | 名前 | 説明 | |-|-| | messages | メッセージ情報。 データタイプ：オブジェクト "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | messages.errorMessages | 要求の処理中にエラーメッセージが表示されました。例： ``` 無効な CMDB_CI sys_id が指定されました ``` データタイプ：アレイ | | messages.infoMessages | 要求の処理中に情報メッセージが表示されました。例： ``` CMDB_CI sys_id が既に指定値に関連付けられています。 ``` データタイプ：アレイ | | messages.warningMessages | 要求の処理中に警告メッセージが表示されました。例： ``` 無効な CMDB_CI sys_id が指定されました。 ``` データタイプ：アレイ | | request | 元のエンドポイント要求。 データタイプ：文字列 | | state | ワーカーの現在のステータスに関する情報。 state: { display_value: "String", value: "String" } | | state.display_value | ワーカーのステータス値を表示します。これらの値は state.value 要素に直接関連付けられています。 可能な値： * 完了 * エラー * 対応中 * 待機中 {#change-POST-ci__ul_ehh_nxy_jhb} データタイプ：文字列 | | state.value | ワーカーのステータスの数値。 可能な値： * 1 * 2 * 3 * 4 {#change-POST-ci__ul_zw1_fxy_jhb} データタイプ：数値 | | type | CMDB CI と変更要求の間の関連付けのタイプ。 データタイプ：文字列 | | worker | 関連付けられたワーカーに関する情報。 データタイプ：オブジェクト "worker": { "link": "String", "sysId": "String" } | | worker.link | 関連付けられたワーカーのステータスおよびその他のワーカー関連情報を取得するための URL。 データタイプ：文字列 | | worker.sysId | 変更要求と関連付けるワーカーの sys_id。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/ci" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{cmdb_ci_sys_ids:'caf043a3b7fb23000999e4f6ee11a9c0,06f043a3b7fb23000999e4f6ee11a9c1', association_type:'affected'}" \ --user "username":"password" { "result": { "worker": { "sysId": "f490f4c6dbac330084f07ffdbf961952", "link": "instance.service-now.com/api/sn_chg_rest/change/worker/f490f4c6dbac330084f07ffdbf961952" }, "request": "{\"cmdb_ci_sys_ids\":[\"caf043a3b7fb23000999e4f6ee11a9c0\",\"06f043a3b7fb23000999e4f6ee11a9c1\"],\"association_type\":\"affected\",\"task\":\"c286d61347c12200e0ef563dbb9a71df\"}", "state": { "value": 1, "display_value": "Waiting" }, "type": "affected", "messages": { "errorMessages": [], "warningMessages": [], "infoMessages": [] } } } ## Change Management - POST /sn_chg_rest/change/{sys_id}/conflict {#ariaid-title37} 指定された変更要求 (sys_id) の変更要求競合チェックプロセスを開始します。 ### URL 形式 {#change-POST-conflict__section_m3g_gkn_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id}/conflict デフォルトの URL：/api/sn_chg_rest/change/{sys_id}/conflict ### サポートされている要求パラメーター {#change-POST-conflict__entry__2}{#change-POST-conflict__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 競合チェックプロセスを開始する変更管理要求の sys_id。変更要求 \[change_request\] テーブルにあります。競合チェック プロセスの詳細については、「 [競合の検出](https://www.servicenow.com/docs/access?context=c_ConflictDetection&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。 データタイプ：文字列 | [表 : 211. パスパラメーター] {#change-POST-conflict__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 212. クエリパラメーター] {#change-POST-conflict__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 213. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-conflict__entry__16}{#change-POST-conflict__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 214. 要求ヘッダー] {#change-POST-conflict__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 215. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-conflict__entry__24}{#change-POST-conflict__entry-200-status-code}{#change-POST-conflict__entry-401-status-code}{#change-POST-conflict__entry-404-status-code}{#change-POST-conflict__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。解決できないエラーのため、要求を開始できませんでした。返されたメッセージに追加の詳細が記載されている場合があります。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。要求アイテムが見つかりませんでした。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 216. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-POST-conflict__entry__36} | 名前 | 説明 | |-|-| | result | 変更要求競合チェックプロセスの sys_id。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/0f4ac6c4b750230096c3e4f6ee11a9fe/conflict" \ --request POST \ --header "Accept:application/json" \ --user "username":"password" { result: "c0b5afe4b710230096c3e4f6ee11a93f" } ## Change Management - POST /sn_chg_rest/change/emergency {#ariaid-title38} デフォルトの緊急変更要求レコードに基づいて、緊急の変更要求を作成します。単一の呼び出し内での複数の緊急変更要求の作成はサポートされていません。 ### URL 形式 {#change-POST-emergency__section_evv_brs_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/emergency デフォルトの URL：/api/sn_chg_rest/change/emergency ### サポートされている要求パラメーター {#change-POST-emergency__entry__2}{#change-POST-emergency__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 217. パスパラメーター] {#change-POST-emergency__entry__6} | 名前 | 説明 | |-|-| | key-value pairs | 要求の作成時に変更するフィールドのキーと値のペア。キーはテンプレート内のフィールド名で、値はフィールドに入力する情報です。 変更できず、渡された場合に無視されるフィールド： * ビジネスルール * ACL で定義されている読み取り専用フィールド * 存在しないフィールド {#change-POST-emergency__ul_zz1_qdz_tkb} データタイプ：文字列 | [表 : 218. クエリパラメーター] {#change-POST-emergency__entry__10} | 名前 | 説明 | |-|-| | なし | | [表 : 219. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-emergency__entry__14}{#change-POST-emergency__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 220. 要求ヘッダー] {#change-POST-emergency__entry__18} | ヘッダー | 説明 | |-|-| | なし | | [表 : 221. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-emergency__entry__22}{#change-POST-emergency__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 222. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-POST-emergency__entry__32} | 名前 | 説明 | |-|-| | name-value pairs | 緊急の変更要求で作成されたフィールドの名前と値のペア。 データタイプ：オブジェクト | | state | 削除前の変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 値は常に「New」です。 データタイプ：文字列 | | state.value | 内部ステータスの値。 値は常に「-5」です。 データタイプ：文字列 | | sys_id | 新しく作成された緊急の変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Emergency」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「emergency」です。 データタイプ：文字列 | | __meta.ignoredFields | 呼び出しで渡されたが、ベースレコードに存在しないか、フィールドが読み取り専用であるため、変更要求に適用されなかったキーと値のペア。 データタイプ：アレイ | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/emergency?no_such_field=something&description=test&short_description=Reboot server" \ --request POST \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", state: { value: "-5", display_value: "New" }, type: { value: "emergency", display_value: "Emergency" }, ..., // all valid fields in record, example below short_description: { value: "Reboot server", display_value: "Reboot server" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change Management - POST /sn_chg_rest/change/normal {#ariaid-title39} デフォルトの通常の変更要求レコードに基づいて、1 つの通常の変更要求を作成します。単一の呼び出し内での複数の通常の変更要求の作成はサポートされていません。 ### URL 形式 {#change-POST-normal__section_kgy_w3r_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/normal デフォルトの URL：/api/sn_chg_rest/change/normal ### サポートされている要求パラメーター {#change-POST-normal__entry__2}{#change-POST-normal__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 223. パスパラメーター] {#change-POST-normal__entry__6} | 名前 | 説明 | |-|-| | key-value pairs | 要求の作成時に変更するフィールド。キーはテンプレート内のフィールド名で、値はフィールドに入力する情報です。 変更できず、渡された場合に無視されるフィールド： * ビジネスルール * ACL で定義されている読み取り専用フィールド * 存在しないフィールド {#change-POST-normal__ul_sj1_fyy_tkb} データタイプ：文字列 | [表 : 224. クエリパラメーター] {#change-POST-normal__entry__10} | 名前 | 説明 | |-|-| | なし | | [表 : 225. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-normal__entry__14}{#change-POST-normal__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 226. 要求ヘッダー] {#change-POST-normal__entry__18} | ヘッダー | 説明 | |-|-| | なし | | [表 : 227. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-normal__entry__22}{#change-POST-normal__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 228. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-POST-normal__entry__32} | 名前 | 説明 | |-|-| | name-value pairs | 関連する変更要求のすべてのフィールドの値。 データタイプ：オブジェクト | | state | 新しく作成された変更要求のステータス。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | UI に表示するステータス。 値は常に「New」です。 データタイプ：文字列 | | state.value | 内部ステータスの値。 値は常に「-5」です。 データタイプ：文字列 | | sys_id | 新しく作成された通常の変更要求の sys_id。 データタイプ：文字列 | | type | 変更要求のタイプ。 データタイプ：オブジェクト type: { display_value: "String", value: "String" } | | type.display_value | UI に表示する変更のタイプ。 値は常に「Normal」です。 データタイプ：文字列 | | type.value | 内部タイプの値。 値は常に「normal」です。 データタイプ：文字列 | | __meta.ignoredFields | 呼び出しで渡されたが、ベースレコードに存在しないか、フィールドが読み取り専用であるため、変更要求に適用されなかったキーと値のペア。 データタイプ：アレイ | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/normal?no_such_field=something&description=test&short_description=Remove server" \ --request POST \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: "b0dbda5347c12200e0ef563dbb9a718f", state: { value: "-5", display_value: "New" }, type: { value: "normal", display_value: "Normal" }, ..., // all valid fields in record, example below short_description: { value: "Remove server", display_value: "Remove server" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change Management - POST /sn_chg_rest/change/{sys_id}/refresh_impacted_services {#ariaid-title40} プライマリ CI に基づいて、影響を受ける services/configuration アイテム (CI) 関連リストに値が入力されます。 プライマリ CI が、変更要求フォームと影響を受ける CI 関連リストに表示されます。 注: このエンドポイントのすべての作業アイテムは非同期で実行されます。 ### URL 形式 {#change-POST-refresh_impact_srvcs__section_sh4_2r4_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{sys_id}/refresh_impacted_services デフォルトの URL：/api/sn_chg_rest/change/{sys_id}/refresh_impacted_services ### サポートされている要求パラメーター {#change-POST-refresh_impact_srvcs__entry__2}{#change-POST-refresh_impact_srvcs__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | sys_id | 影響を受けるサービスを更新するために使用する変更要求の sys_id。 データタイプ：文字列 | [表 : 229. パスパラメーター] {#change-POST-refresh_impact_srvcs__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 230. クエリパラメーター] {#change-POST-refresh_impact_srvcs__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 231. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-refresh_impact_srvcs__entry__16}{#change-POST-refresh_impact_srvcs__accept-RESTAPI}{#change-POST-refresh_impact_srvcs__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 232. 要求ヘッダー] {#change-POST-refresh_impact_srvcs__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 233. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-refresh_impact_srvcs__entry__26}{#change-POST-refresh_impact_srvcs__entry-200-status-code}{#change-POST-refresh_impact_srvcs__entry-401-status-code}{#change-POST-refresh_impact_srvcs__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 234. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-POST-refresh_impact_srvcs__entry__36} | 名前 | 説明 | |-|-| | messages | メッセージ情報。 データタイプ：オブジェクト "messages": { "errorMessages": [Array], "infoMessages": [Array], "warningMessages": [Array] } | | messages.errorMessages | 要求の処理中にエラーメッセージが表示されました。例： ``` 無効な CMDB_CI sys_id が指定されました ``` データタイプ：アレイ | | messages.infoMessages | 要求の処理中に情報メッセージが表示されました。例： ``` CMDB_CI sys_id が既に指定値に関連付けられています。 ``` データタイプ：アレイ | | messages.warningMessages | 要求の処理中に警告メッセージが表示されました。例： ``` 無効な CMDB_CI sys_id が指定されました。 ``` データタイプ：アレイ | | request | 元のエンドポイント要求。 データタイプ：文字列 | | state | ワーカーの現在のステータスに関する情報。 データタイプ：オブジェクト state: { display_value: "String", value: "String" } | | state.display_value | ワーカーのステータス値を表示します。これらの値は state.value 要素に直接関連付けられています。 可能な値： * 完了 * エラー * 対応中 * 待機中 {#change-POST-refresh_impact_srvcs__ul_ehh_nxy_jhb} データタイプ：文字列 | | state.value | ワーカーのステータスの数値。 可能な値： * 1 * 2 * 3 * 4 {#change-POST-refresh_impact_srvcs__ul_zw1_fxy_jhb} データタイプ：数値 | | type | CMDB CI と変更要求の間の関連付けのタイプ。 データタイプ：文字列 | | worker | 関連付けられたワーカーに関する情報。 データタイプ：オブジェクト "worker": { "link": "String", "sysId": "String" } | | worker.link | 関連付けられたワーカーのステータスおよびその他のワーカー関連情報を取得するための URL。 データタイプ：文字列 | | worker.sysId | 変更要求と関連付けるワーカーの sys_id。 データタイプ：文字列 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/sn_chg_rest/v1/change/c286d61347c12200e0ef563dbb9a71df/refresh_impacted_services" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --user "username":"password" { result: { worker: { sysId: "aa31c308b75033000999e4f6ee11a9c2", link: "http://instance.service-now.com/api/sn_chg_rest/change/worker/aa31c308b75033000999e4f6ee11a9c2" }, request: "", state: { value: 1, display_value: "Waiting" }, type: "impacted", messages: { errorMessages: [], warningMessages: [], infoMessages: [] } } } ## Change Management - POST /sn_chg_rest/change/standard/{standard_change_template_id} {#ariaid-title41} 渡されたテンプレート sys_id で指定された既存の標準的な変更テンプレートに基づいて、1 つの標準的な変更の要求を作成します。単一の呼び出し内での複数の標準的な変更の要求の作成はサポートされていません。 ### URL 形式 {#change-POST-standard__section_bqr_fk2_xlb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/standard/{standard_change_template_id} デフォルトの URL：/api/sn_chg_rest/change/standard/{standard_change_template_id} ### サポートされている要求パラメーター {#change-POST-standard__section_n5l_xk2_xlb} {#change-POST-standard__table_o5l_xk2_xlb__entry__2}{#change-POST-standard__version-RESTAPI} | パラメーター | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | standard_change_template_id | 新しい標準的な変更の要求のベースとなる標準的な変更テンプレートの sys_id。標準的な変更テンプレート \[std_change_record_producer\] テーブルにあります。 データタイプ：文字列 | [表 : 235. パスパラメーター] {#change-POST-standard__table_o5l_xk2_xlb} {#change-POST-standard__table_i2g_hl2_xlb__entry__2} | パラメーター | 説明 | |-|-| | name-value pairs | 要求の作成時に変更する、指定された標準的な変更テンプレート内のフィールド。キーはテンプレート内のフィールド名で、値はフィールドに入力する情報です。 変更できず、渡された場合に無視されるフィールド： * 説明 * 切り戻し計画 * テスト計画 * 実装計画 * ACL で定義されている読み取り専用フィールド * 指定された標準的な変更テンプレートに存在しないフィールド {#change-POST-standard__ul_j2g_hl2_xlb} データタイプ：文字列 | [表 : 236. クエリパラメーター] {#change-POST-standard__table_i2g_hl2_xlb} {#change-POST-standard__table_g3k_dkf_mmb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 237. 要求本文パラメーター (XML または JSON)] {#change-POST-standard__table_g3k_dkf_mmb} ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-standard__table_ajc_wm2_xlb__entry__2}{#change-POST-standard__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 238. 要求ヘッダー] {#change-POST-standard__table_ajc_wm2_xlb} {#change-POST-standard__table_m25_xm2_xlb__entry__2} | ヘッダー | 説明 | |-|-| | なし | | [表 : 239. 応答ヘッダー] {#change-POST-standard__table_m25_xm2_xlb} ### ステータスコード {#change-POST-standard__section_tm2_w4j_xlb} 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-standard__table_wwn_rhd_ct__entry__2}{#change-POST-standard__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 240. ステータスコード] {#change-POST-standard__table_wwn_rhd_ct} ### 応答本文 {#change-POST-standard__section_ikl_bn2_xlb} API は、次の JSON または XML 要素を応答本文で返します。 {#change-POST-standard__table_mc1_pr1_tx__entry__2} | 要素 | 説明 | |-|-| | name-value pairs | 標準的な変更の要求で作成されたフィールドの名前と値のペア。 データタイプ：オブジェクト | | sys_id | 新しく作成された標準的な変更の要求の sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する標準的な変更の要求の sys_id。 データタイプ：文字列 | | sys_id.value | 標準的な変更の要求の sys_id。 データタイプ：文字列 | | __meta.ignoredFields | 呼び出しで渡されたが、ベースレコードに存在しないか、フィールドが読み取り専用であるため、変更要求に適用されなかったキーと値のペア。 データタイプ：アレイ | [表 : 241. 応答本文で返される要素] {#change-POST-standard__table_mc1_pr1_tx} ### サンプル cURL 要求 curl "https://instance.servicenow.com" \ --request POST \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "1c87925347c12200e0ef563dbb9a7177", display_value: "1c87925347c12200e0ef563dbb9a7177" }, ..., // all valid fields in record, example below short_description: { value: "Add network switch to cabinet", display_value: "Add network switch to cabinet" } __meta: { ignoredFields: ["no_such_field"] } } ] } ## Change Management - POST /sn_chg_rest/change/{change_sys_id}/task {#ariaid-title42} デフォルトの変更要求タスクレコードに基づいて 1 つの変更要求タスクを作成し、それを指定された変更要求に関連付けます。単一の呼び出し内での複数の変更要求タスクの作成はサポートされていません。 ### URL 形式 {#change-POST-task__section_elk_15m_ylb} バージョニングされた URL：/api/sn_chg_rest/{api_version}/change/{change_sys_id}/task デフォルトの URL：/api/sn_chg_rest/change/{change_sys_id}/task ### サポートされている要求パラメーター {#change-POST-task__entry__2}{#change-POST-task__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | | change_sys_id | このタスクを関連付ける変更要求の sys_id。変更要求 \[change_request\] テーブルにあります。 データタイプ：文字列 | [表 : 242. パスパラメーター] {#change-POST-task__entry__8} | 名前 | 説明 | |-|-| | key-value pairs | 要求の作成時に変更するフィールド。キーはテンプレート内のフィールド名で、値はフィールドに入力する情報です。 変更できず、渡された場合に無視されるフィールド： * ビジネスルール * ACL で定義されている読み取り専用フィールド * 存在しないフィールド {#change-POST-task__ul_d5q_zyy_tkb} データタイプ：文字列 | [表 : 243. クエリパラメーター] {#change-POST-task__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 244. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-task__entry__16}{#change-POST-task__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 245. 要求ヘッダー] {#change-POST-task__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 246. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#change-POST-task__entry__24}{#change-POST-task__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 200 | 要求が正常に完了しました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 404 | 見つかりません。指定されたレコードが見つかりませんでした。 | | 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 | [表 : 247. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#change-POST-task__entry__36} | 名前 | 説明 | |-|-| | name-value pairs | 変更要求タスクで作成されたフィールドの名前と値のペア。 データタイプ：オブジェクト | | parent | タスクに関連付けられた変更要求の情報。 データタイプ：オブジェクト parent: { display_value: "String", value: "String" } | | parent.display_value | タスクに関連付けられた変更要求の UI に表示される情報。 データタイプ：文字列 | | parent.value | タスクに関連付けられた変更要求の sys_id。 データタイプ：文字列 | | sys_id | 新しく作成された変更要求タスクの sys_id 情報。 データタイプ：オブジェクト sys_id: { display_value: "String", value: "String" } | | sys_id.display_value | UI に表示する変更要求タスクの sys_id。 データタイプ：文字列 | | sys_id.value | 変更要求タスクの sys_id。 データタイプ：文字列 | | __meta.ignoredFields | 呼び出しで渡されたが、ベースレコードに存在しないか、フィールドが読み取り専用であるため、変更要求に適用されなかったキーと値のペア。 データタイプ：アレイ | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/now/change/0f4ac6c4b750230096c3e4f6ee11a9fe/task?short_description=Retire node&no_such_field=test" \ --request POST \ --header "Accept:application/json" \ --user "username":"password" { result: [ { sys_id: { value: "12629ec4b750230096c3e4f6ee11a9d5", display_value: "12629ec4b750230096c3e4f6ee11a9d5" }, parent: { value: "0f4ac6c4b750230096c3e4f6ee11a9fe ", display_value: "CHG0033046 " }, ..., // all valid fields in record, example below short_description: { value: "Retire node", display_value: "Retire node" } __meta.ignoredFields": ["no_such_field"] } ] }