テーブル API は、既存のテーブルでの作成、読み取り、更新、および削除 (CRUD) 操作の実行を可能にするエンドポイントを提供します。

呼び出し元ユーザーは、要求で指定されたテーブルのデータにアクセスするための十分なロールを持っている必要があります。

テーブル - DELETE /now/table/{tableName}/{sys_id}

指定されたテーブルから指定されたレコードを削除します。

URL 形式

バージョニングされた URL:/api/now/{api_version}/table/{tableName}/{sys_id}

デフォルトの URL:/api/now/table/{tableName}/{sys_id}

サポートされている要求パラメーター

表 : 1. パスパラメーター
名前 説明
api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

データタイプ:文字列

sys_id 削除するレコードの sys_id。

データタイプ:文字列

tableName 指定したレコードを削除するテーブルの名前 (「incident」や「asset」など)。

データタイプ:文字列

表 : 2. クエリパラメーター
名前 説明
sysparm_query_no_domain ログインユーザーが設定されているドメインだけにレコード検索を制限するかどうかを示すフラグ。

有効な値:

  • false:現在ログインしているユーザーにアクセス権がないドメインにあるレコードを除外します。
  • true:現在ログインしているユーザーにアクセス権がないドメインにあるレコードも含めます。

データタイプ:ブール

デフォルト値:false

注: sysparm_query_no_domain パラメーターは、システム管理者または、query_no_domain_table_api ロールを持つユーザーのみが利用できるパラメーターです。
表 : 3. 要求本文パラメーター (XML または JSON)
名前 説明
なし

ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

表 : 4. 要求ヘッダー
ヘッダー 説明
Accept 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

デフォルト: application/json

表 : 5. 応答ヘッダー
ヘッダー 説明
なし

ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

表 : 6. ステータスコード
ステータスコード 説明
204 要求が正常に完了したことを示します。

応答本文のパラメーター (JSON または XML)

名前 説明
なし

例: cURL 要求

インシデントテーブルからレコードを削除します。

curl "https://instance.servicenow.com/api/now/table/incident/d977b66a4f411200adf9f8e18110c7b2" \
--request DELETE \
--header "Accept:application/json" \
--user 'username':'password'

応答本文はありません。

None

テーブル - GET /now/table/{tableName}

指定されたテーブルの複数のレコードを取得します。

基本的な手順については、「 既存のインシデントを取得する」を参照してください。

URL 形式

バージョニングされた URL:/api/now/{api_version}/table/{tableName}

デフォルトの URL:/api/now/table/{tableName}

サポートされている要求パラメーター

表 : 7. パスパラメーター
名前 説明
api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。
このエンドポイントは、バージョンに応じて、有効なクエリに対して異なる結果を返します。
  • バージョン 1 は、結果なしでエラーコード 404 を返します。
  • バージョン 2 は、成功コード 200 と空の配列を応答本文として返します。

データタイプ:文字列

tableName レコードの取得元のテーブルの名前。

データタイプ:文字列

表 : 9. 要求本文パラメーター (XML または JSON)
名前 説明
なし

ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

表 : 10. 要求ヘッダー
ヘッダー 説明
承認 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

デフォルト: application/json

表 : 11. 応答ヘッダー
ヘッダー 説明
Link 前の要求に基づく相対 URL。利用可能なレコードセットのページングに使用できます。

たとえば、次のようになります。

https://<インスタンス名>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="next",

https://<インスタンス名>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="prev",

https://<インスタンス名>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=0&sysparm_limit=1000>;rel="first",

https://<インスタンス名>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=2780&sysparm_limit=1000>;rel="last"

rel パラメーターの詳細については、「https://html.spec.whatwg.org/multipage/links.html#linkTypes」を参照してください。
X-Total-Count クエリによって返されたレコードの合計数。

ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

表 : 12. ステータスコード
ステータスコード 説明
200 要求が正常に完了しました。有効なクエリで結果が返されなかった場合、応答の本文には空の結果配列のみが含まれます。

応答本文のパラメーター (JSON または XML)

パラメーター 説明
name-value pairs 指定されたレコード内のすべてのパラメーターのフィールド名と値、またはクエリパラメーターで指定されたフィールド名と値。

例: cURL 要求

問題テーブルから最初のレコードを取得します。

curl "https://instance.servicenow.com/api/now/table/problem?sysparm_limit=1" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

応答には、要求されたレコードの名前と値のペアが含まれます。

{
  "result": [
    {
      "parent": "",
      "made_sla": "true",
      "watch_list": "",
      "upon_reject": "cancel",
      "sys_updated_on": "2016-01-19 04:52:04",
      "approval_history": "",
      "number": "PRB0000050",
      "sys_updated_by": "glide.maint",
      "opened_by": {
        "link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
        "value": "glide.maint"
      },
      "user_input": "",
      "sys_created_on": "2016-01-19 04:51:19",
      "sys_domain": {
        "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
        "value": "global"
      },
      "state": "4",
      "sys_created_by": "glide.maint",
      "knowledge": "false",
      "order": "",
      "closed_at": "2016-01-19 04:52:04",
      "cmdb_ci": {
        "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/55b35562c0a8010e01cff22378e0aea9",
        "value": "55b35562c0a8010e01cff22378e0aea9"
      },
      "delivery_plan": "",
      "impact": "3",
      "active": "false",
      "work_notes_list": "",
      "business_service": "",
      "priority": "4",
      "sys_domain_path": "/",
      "time_worked": "",
      "expected_start": "",
      "rejection_goto": "",
      "opened_at": "2016-01-19 04:49:47",
      "business_duration": "1970-01-01 00:00:00",
      "group_list": "",
      "work_end": "",
      "approval_set": "",
      "wf_activity": "",
      "work_notes": "",
      "short_description": "Switch occasionally drops connections",
      "correlation_display": "",
      "delivery_task": "",
      "work_start": "",
      "assignment_group": "",
      "additional_assignee_list": "",
      "description": "Switch occasionally drops connections",
      "calendar_duration": "1970-01-01 00:02:17",
      "close_notes": "updated firmware",
      "sys_class_name": "problem",
      "closed_by": "",
      "follow_up": "",
      "sys_id": "04ce72c9c0a8016600b5b7f75ac67b5b",
      "contact_type": "phone",
      "urgency": "3",
      "company": "",
      "reassignment_count": "",
      "activity_due": "",
      "assigned_to": "",
      "comments": "",
      "approval": "not requested",
      "sla_due": "",
      "comments_and_work_notes": "",
      "due_date": "",
      "sys_mod_count": "1",
      "sys_tags": "",
      "escalation": "0",
      "upon_approval": "proceed",
      "correlation_id": "",
      "location": ""
    }
  ]
}

テーブル - GET /now/table/{tableName}/{sys_id}

指定されたテーブルから、指定された sys_id で識別されるレコードを取得します。

URL 形式

バージョニングされた URL:/api/now/{api_version}/table/{tableName}/{sys_id}

デフォルトの URL:/api/now/table/{tableName}/{sys_id}

サポートされている要求パラメーター

表 : 13. パスパラメーター
名前 説明
api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

データタイプ:文字列

sys_id 取得するレコードの sys_id。

データタイプ:文字列

tableName レコードの取得元のテーブルの名前。

データタイプ:文字列

表 : 15. 要求本文パラメーター (XML または JSON)
名前 説明
なし

ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

表 : 16. 要求ヘッダー
ヘッダー 説明
承認 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

デフォルト: application/json

表 : 17. 応答ヘッダー
ヘッダー 説明
なし

ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

表 : 18. ステータスコード
ステータスコード 説明
200 成功。要求が正常に処理されました。
404 見つかりません。要求アイテムが見つかりませんでした。

応答本文のパラメーター (JSON または XML)

パラメーター 説明
name-value pairs 指定されたレコード内のすべてのパラメーターのフィールド名と値、またはクエリパラメーターで指定されたフィールド名と値。

例: cURL 要求

インシデントテーブルからレコードを取得します。

curl "https://instance.servicenow.com/api/now/table/incident/a9e30c7dc61122760116894de7bcc7bd" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

応答には、要求されたレコードの名前と値のペアが含まれます。

{
  "result": {
    "upon_approval": "",
    "location": {
      "link": "https://instance.servicenow.com/api/now/table/cmn_location/105cf7f3c611227501e75e08b14a38ba",
      "value": "105cf7f3c611227501e75e08b14a38ba"
    },
    "expected_start": "",
    "reopen_count": "",
    "close_notes": "",
    "additional_assignee_list": "",
    "impact": "1",
    "urgency": "3",
    "correlation_id": "",
    "sys_tags": "",
    "sys_domain": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
      "value": "global"
    },
    "description": "",
    "group_list": "",
    "priority": "3",
    "delivery_plan": "",
    "sys_mod_count": "4",
    "work_notes_list": "",
    "business_service": "",
    "follow_up": "",
    "closed_at": "",
    "sla_due": "2015-11-11 22:04:15",
    "delivery_task": "",
    "sys_updated_on": "2015-11-01 22:37:27",
    "parent": "",
    "work_end": "",
    "number": "INC0000046",
    "closed_by": "",
    "work_start": "",
    "calendar_stc": "",
    "category": "software",
    "business_duration": "",
    "incident_state": "1",
    "activity_due": "",
    "correlation_display": "",
    "company": "",
    "active": "true",
    "due_date": "",
    "assignment_group": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a4dde73c6112278017a6a4baf547aa7",
      "value": "8a4dde73c6112278017a6a4baf547aa7"
    },
    "caller_id": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/46c6f9efa9fe198101ddf5eed9adf6e7",
      "value": "46c6f9efa9fe198101ddf5eed9adf6e7"
    },
    "knowledge": "false",
    "made_sla": "false",
    "comments_and_work_notes": "",
    "parent_incident": "",
    "state": "1",
    "user_input": "",
    "sys_created_on": "2015-11-01 22:05:30",
    "approval_set": "",
    "reassignment_count": "1",
    "rfc": "",
    "child_incidents": "",
    "opened_at": "2015-11-02 22:04:15",
    "short_description": "Can't access SFA software",
    "order": "",
    "sys_updated_by": "glide.maint",
    "resolved_by": "",
    "notify": "1",
    "upon_reject": "",
    "approval_history": "",
    "problem_id": {
      "link": "https://instance.servicenow.com/api/now/table/problem/a9e4890bc6112276003d7a5a5c774a74",
      "value": "a9e4890bc6112276003d7a5a5c774a74"
    },
    "work_notes": "",
    "calendar_duration": "",
    "close_code": "",
    "sys_id": "a9e30c7dc61122760116894de7bcc7bd",
    "approval": "not requested",
    "caused_by": "",
    "severity": "3",
    "sys_created_by": "admin",
    "resolved_at": "",
    "assigned_to": "",
    "business_stc": "",
    "wf_activity": "",
    "sys_domain_path": "/",
    "cmdb_ci": {
      "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/a9c0c8d2c6112276018f7705562f9cb0",
      "value": "a9c0c8d2c6112276018f7705562f9cb0"
    },
    "opened_by": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/46c6f9efa9fe198101ddf5eed9adf6e7",
      "value": "46c6f9efa9fe198101ddf5eed9adf6e7"
    },
    "subcategory": "",
    "rejection_goto": "",
    "sys_class_name": "incident",
    "watch_list": "",
    "time_worked": "",
    "contact_type": "phone",
    "escalation": "0",
    "comments": ""
  }
}

テーブル - PATCH /now/table/{tableName}/{sys_id}

指定されたレコードを要求本文に含まれる名前と値のペアで更新します。

URL 形式

バージョニングされた URL:/api/now/{api_version}/table/{tableName}/{sys_id}

デフォルトの URL:/api/now/table/{tableName}/{sys_id}

サポートされている要求パラメーター

表 : 19. パスパラメーター
名前 説明
api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

データタイプ:文字列

sys_id 更新するレコードの sys_id。

データタイプ:文字列

tableName 指定されたレコードがあるテーブルの名前。

データタイプ:文字列

表 : 21. 要求本文パラメーター (XML または JSON)
名前 説明
name-value pairs 指定されたレコードで更新する各パラメーターのフィールド名と新しい値。
注: レコード内のすべてのフィールドは更新できない場合があります。たとえば、「sys_」のプリフィックスを持つフィールドは、通常、自動的に生成されるシステムパラメーターであり、更新することはできません。

ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

表 : 22. 要求ヘッダー
ヘッダー 説明
Accept 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

デフォルト: application/json

Content-Type 要求本文のデータ形式。サポートされるタイプ:application/json または application/xml

デフォルト: application/json

X-no-response-body デフォルトでは、応答には変更されたレコードの詳細を示す本文コンテンツが含まれます。応答本文を抑制するには、この要求ヘッダーを true に設定します。
表 : 23. 応答ヘッダー
ヘッダー 説明
なし

ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

表 : 24. ステータスコード
ステータスコード 説明
200 成功。要求が正常に処理されました。
400 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。
404 見つかりません。要求アイテムが見つかりませんでした。

応答本文のパラメーター (JSON または XML)

名前 説明
name-value pairs 指定されたレコード内のすべてのパラメーターのフィールド名と値、またはクエリパラメーターで指定されたフィールド名と値。

例: cURL 要求

インシデントテーブルのレコードを更新します。

curl "https://instance.servicenow.com/api/now/table/incident/ef43c6d40a0a0b5700c77f9bf387afe3" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{'assigned_to':'681b365ec0a80164000fb0b05854a0cd','urgency':'1','comments':'Elevating urgency, this is a blocking issue'}" \
--user 'username':'password'

応答には、更新されたレコードの名前と値のペアが含まれます。

{
  "result": {
    "upon_approval": "proceed",
    "location": {
      "link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f",
      "value": "108752c8c611227501d4ab0e392ba97f"
    },
    "expected_start": "",
    "reopen_count": "",
    "close_notes": "",
    "additional_assignee_list": "",
    "impact": "1",
    "urgency": "1",
    "correlation_id": "",
    "sys_tags": "",
    "sys_domain": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
      "value": "global"
    },
    "description": "",
    "group_list": "",
    "priority": "1",
    "delivery_plan": "",
    "sys_mod_count": "7",
    "work_notes_list": "",
    "business_service": "",
    "follow_up": "",
    "closed_at": "",
    "sla_due": "2017-07-05 05:58:24",
    "delivery_task": "",
    "sys_updated_on": "2016-01-22 14:12:37",
    "parent": "",
    "work_end": "",
    "number": "INC0000050",
    "closed_by": "",
    "work_start": "",
    "calendar_stc": "",
    "category": "hardware",
    "business_duration": "",
    "incident_state": "2",
    "activity_due": "2016-01-22 16:12:37",
    "correlation_display": "",
    "company": {
      "link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec",
      "value": "31bea3d53790200044e0bfc8bcbe5dec"
    },
    "active": "true",
    "due_date": "",
    "assignment_group": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3",
      "value": "8a5055c9c61122780043563ef53438e3"
    },
    "caller_id": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c",
      "value": "5b7c200d0a640069006b3845b5d0fa7c"
    },
    "knowledge": "false",
    "made_sla": "true",
    "comments_and_work_notes": "",
    "parent_incident": "",
    "state": "2",
    "user_input": "",
    "sys_created_on": "2015-11-02 18:05:40",
    "approval_set": "",
    "reassignment_count": "0",
    "rfc": "",
    "child_incidents": "",
    "opened_at": "2015-11-02 21:58:24",
    "short_description": "Can't access Exchange server - is it down?",
    "order": "",
    "sys_updated_by": "admin",
    "resolved_by": "",
    "notify": "1",
    "upon_reject": "cancel",
    "approval_history": "",
    "problem_id": "",
    "work_notes": "",
    "calendar_duration": "",
    "close_code": "",
    "sys_id": "ef43c6d40a0a0b5700c77f9bf387afe3",
    "approval": "not requested",
    "caused_by": "",
    "severity": "3",
    "sys_created_by": "glide.maint",
    "resolved_at": "",
    "assigned_to": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd",
      "value": "681b365ec0a80164000fb0b05854a0cd"
    },
    "business_stc": "",
    "wf_activity": "",
    "sys_domain_path": "/",
    "cmdb_ci": {
      "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6",
      "value": "281190e3c0a8000b003f593aa3f20ca6"
    },
    "opened_by": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
      "value": "glide.maint"
    },
    "subcategory": "",
    "rejection_goto": "",
    "sys_class_name": "incident",
    "watch_list": "",
    "time_worked": "",
    "contact_type": "phone",
    "escalation": "3",
    "comments": ""
  }
}

テーブル - POST /now/table/{tableName}

指定されたテーブルに 1 つのレコードを挿入します。このメソッドでは、複数のレコードの挿入はサポートされていません。

URL 形式

バージョニングされた URL:/api/now/{api_version}/table/{tableName}

デフォルトの URL:/api/now/table/{tableName}

サポートされている要求パラメーター

表 : 25. パスパラメーター
名前 説明
api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

データタイプ:文字列

tableName レコードを保存するテーブルの名前。

データタイプ:文字列

表 : 27. 要求本文パラメーター (XML または JSON)
名前 説明
name-value pairs 指定されたレコードで定義する各パラメーターのフィールド名および関連付けられた値。
注: レコード内のすべてのフィールドは更新できない場合があります。たとえば、「sys_」のプリフィックスを持つフィールドは、通常、自動的に生成されるシステムパラメーターであり、更新することはできません。
指定されておらず、システムによって自動生成されないフィールドは、関連付けられたデータタイプの null 値に設定されます。

ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

表 : 28. 要求ヘッダー
ヘッダー 説明
Accept 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

デフォルト: application/json

Content-Type 要求本文のデータ形式。サポートされるタイプ:application/json または application/xml

デフォルト: application/json

X-no-response-body デフォルトでは、応答には新規レコードの詳細を示す本文コンテンツが含まれます。応答本文を抑制するには、要求内でこのヘッダーを true に設定します。
表 : 29. 応答ヘッダー
ヘッダー 説明
場所 作成されたリソースの場所。

ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

表 : 30. ステータスコード
ステータスコード 説明
201 要求が正常に完了したことを示します。
400 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。
404 見つかりません。要求アイテムが見つかりませんでした。

応答本文のパラメーター (JSON または XML)

名前 説明
name-value pairs 新しく作成されたレコード内のすべてのパラメーターのフィールド名と値、またはクエリパラメーターで指定されたフィールド名と値。

例: cURL 要求

新規レコードをインシデントテーブルに挿入します。

curl "https://instance.servicenow.com/api/now/table/incident" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{'short_description':'Unable to connect to office wifi','assignment_group':'287ebd7da9fe198100f92cc8d1d2154e','urgency':'2','impact':'2'}" \
--user 'username':'password'

応答には、新規レコードの名前と値のペアが含まれます。

{
  "result": {
    "upon_approval": "proceed",
    "location": "",
    "expected_start": "",
    "reopen_count": "0",
    "close_notes": "",
    "additional_assignee_list": "",
    "impact": "2",
    "urgency": "2",
    "correlation_id": "",
    "sys_tags": "",
    "sys_domain": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
      "value": "global"
    },
    "description": "",
    "group_list": "",
    "priority": "3",
    "delivery_plan": "",
    "sys_mod_count": "0",
    "work_notes_list": "",
    "business_service": "",
    "follow_up": "",
    "closed_at": "",
    "sla_due": "",
    "delivery_task": "",
    "sys_updated_on": "2016-01-22 14:28:24",
    "parent": "",
    "work_end": "",
    "number": "INC0010002",
    "closed_by": "",
    "work_start": "",
    "calendar_stc": "",
    "category": "inquiry",
    "business_duration": "",
    "incident_state": "1",
    "activity_due": "",
    "correlation_display": "",
    "company": "",
    "active": "true",
    "due_date": "",
    "assignment_group": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/287ebd7da9fe198100f92cc8d1d2154e",
      "value": "287ebd7da9fe198100f92cc8d1d2154e"
    },
    "caller_id": "",
    "knowledge": "false",
    "made_sla": "true",
    "comments_and_work_notes": "",
    "parent_incident": "",
    "state": "1",
    "user_input": "",
    "sys_created_on": "2016-01-22 14:28:24",
    "approval_set": "",
    "reassignment_count": "0",
    "rfc": "",
    "child_incidents": "0",
    "opened_at": "2016-01-22 14:28:24",
    "short_description": "Unable to connect to office wifi",
    "order": "",
    "sys_updated_by": "admin",
    "resolved_by": "",
    "notify": "1",
    "upon_reject": "cancel",
    "approval_history": "",
    "problem_id": "",
    "work_notes": "",
    "calendar_duration": "",
    "close_code": "",
    "sys_id": "c537bae64f411200adf9f8e18110c76e",
    "approval": "not requested",
    "caused_by": "",
    "severity": "3",
    "sys_created_by": "admin",
    "resolved_at": "",
    "assigned_to": "",
    "business_stc": "",
    "wf_activity": "",
    "sys_domain_path": "/",
    "cmdb_ci": "",
    "opened_by": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/6816f79cc0a8016401c5a33be04be441",
      "value": "6816f79cc0a8016401c5a33be04be441"
    },
    "subcategory": "",
    "rejection_goto": "",
    "sys_class_name": "incident",
    "watch_list": "",
    "time_worked": "",
    "contact_type": "phone",
    "escalation": "0",
    "comments": ""
  }
}

テーブル - PUT /now/table/{tableName}/{sys_id}

要求本文で指定されたレコードを更新します。

URL 形式

バージョニングされた URL:/api/now/{api_version}/table/{tableName}/{sys_id}

デフォルトの URL:/api/now/table/{tableName}/{sys_id}

サポートされている要求パラメーター

表 : 31. パスパラメーター
名前 説明
api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

データタイプ:文字列

sys_id 更新するレコードの一意の識別子。

データタイプ:文字列

tableName レコードがあるテーブルの名前。

データタイプ:文字列

表 : 33. 要求本文パラメーター (XML または JSON)
名前 説明
name-value pairs 関連テーブルで更新するフィールドの名前と値のペア。たとえば、簡単な説明のファイルを更新するには、次のような名前と値のペアを入力します。--data "{\"short_description\": \"my short desc\" }" \

ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

表 : 34. 要求ヘッダー
ヘッダー 説明
Accept 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

デフォルト: application/json

Content-Type 要求本文のデータ形式。サポートされるタイプ:application/json または application/xml
X-no-response-body デフォルトでは、応答には変更されたレコードの詳細を示す本文コンテンツが含まれます。応答本文を抑制するには、要求内でこのヘッダーを true に設定します。
表 : 35. 応答ヘッダー
ヘッダー 説明
なし

ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

表 : 36. ステータスコード
ステータスコード 説明
200 成功。要求が正常に処理されました。
400 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。
404 見つかりません。要求アイテムが見つかりませんでした。

応答本文のパラメーター (JSON または XML)

名前 説明
name-value pairs 変更要求のすべてのフィールド (変更されたフィールド以外も含む) とその関連付けられた値。

例: cURL 要求

インシデントテーブルのレコードを更新します。

curl "https://instance.servicenow.com/api/now/table/incident/ef43c6d40a0a0b5700c77f9bf387afe3" \
--request PUT \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{'assigned_to':'681b365ec0a80164000fb0b05854a0cd','urgency':'1','comments':'Elevating urgency, this is a blocking issue'}" \
--user 'username':'password'

応答には、更新されたレコードの名前と値のペアが含まれます。

{
  "result": {
    "upon_approval": "proceed",
    "location": {
      "link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f",
      "value": "108752c8c611227501d4ab0e392ba97f"
    },
    "expected_start": "",
    "reopen_count": "",
    "close_notes": "",
    "additional_assignee_list": "",
    "impact": "1",
    "urgency": "1",
    "correlation_id": "",
    "sys_tags": "",
    "sys_domain": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
      "value": "global"
    },
    "description": "",
    "group_list": "",
    "priority": "1",
    "delivery_plan": "",
    "sys_mod_count": "7",
    "work_notes_list": "",
    "business_service": "",
    "follow_up": "",
    "closed_at": "",
    "sla_due": "2017-07-05 05:58:24",
    "delivery_task": "",
    "sys_updated_on": "2016-01-22 14:12:37",
    "parent": "",
    "work_end": "",
    "number": "INC0000050",
    "closed_by": "",
    "work_start": "",
    "calendar_stc": "",
    "category": "hardware",
    "business_duration": "",
    "incident_state": "2",
    "activity_due": "2016-01-22 16:12:37",
    "correlation_display": "",
    "company": {
      "link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec",
      "value": "31bea3d53790200044e0bfc8bcbe5dec"
    },
    "active": "true",
    "due_date": "",
    "assignment_group": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3",
      "value": "8a5055c9c61122780043563ef53438e3"
    },
    "caller_id": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c",
      "value": "5b7c200d0a640069006b3845b5d0fa7c"
    },
    "knowledge": "false",
    "made_sla": "true",
    "comments_and_work_notes": "",
    "parent_incident": "",
    "state": "2",
    "user_input": "",
    "sys_created_on": "2015-11-02 18:05:40",
    "approval_set": "",
    "reassignment_count": "0",
    "rfc": "",
    "child_incidents": "",
    "opened_at": "2015-11-02 21:58:24",
    "short_description": "Can't access Exchange server - is it down?",
    "order": "",
    "sys_updated_by": "admin",
    "resolved_by": "",
    "notify": "1",
    "upon_reject": "cancel",
    "approval_history": "",
    "problem_id": "",
    "work_notes": "",
    "calendar_duration": "",
    "close_code": "",
    "sys_id": "ef43c6d40a0a0b5700c77f9bf387afe3",
    "approval": "not requested",
    "caused_by": "",
    "severity": "3",
    "sys_created_by": "glide.maint",
    "resolved_at": "",
    "assigned_to": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd",
      "value": "681b365ec0a80164000fb0b05854a0cd"
    },
    "business_stc": "",
    "wf_activity": "",
    "sys_domain_path": "/",
    "cmdb_ci": {
      "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6",
      "value": "281190e3c0a8000b003f593aa3f20ca6"
    },
    "opened_by": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
      "value": "glide.maint"
    },
    "subcategory": "",
    "rejection_goto": "",
    "sys_class_name": "incident",
    "watch_list": "",
    "time_worked": "",
    "contact_type": "phone",
    "escalation": "3",
    "comments": ""
  }
}