テーブル API

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

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

URL 形式

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

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

注:

使用可能なバージョンは、REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

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

表 : 1. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
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. 要求ヘッダー
ヘッダー	説明
承認	応答本文のデータフォーマット。サポートされるタイプ：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}

注:

使用可能なバージョンは、REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

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

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

表 : 8. クエリパラメーター
名前	説明
名前と値のペア	結果セットのフィルタリングに使用する名前と値のペア。このパラメーターは sysparm_queryと相互に排他的です。たとえば、 `&sysparm_query=active=true` を使用する代わりに、 `&active=true` を使用して呼び出し元ステートメントを簡略化できます。フィールドが選択タイプまたは参照タイプのフィールドである場合は、`&state=7` ではなく `&state=closed` のように表示値を使用することもできます。複数のキーと値のペアを指定するには、それぞれをアンパサンドで区切ります ( `例:&active=true&assigned_to=john.smith`)。データタイプ：文字列
sysparm_display_value	返されるデータのタイプ (データベースからの実際の値またはフィールドの表示値) を決定します。表示値は、データベースの実際の値とユーザーまたはシステムの設定と設定に基づいて操作されます。表示値を返す場合、返される値はフィールドタイプに依存します。選択肢フィールド:データベース値は数値でもかまいませんが、表示値はよりわかりやすいものになります。日付フィールド:データベース値は UTC 形式で、表示値はユーザーのタイムゾーンに基づいています。暗号化テキスト:データベース値は暗号化されますが、表示される値はユーザーの暗号化コンテキストに基づいて暗号化されません。参照フィールド:データベース値はsys_idですが、表示値は参照レコードの表示フィールドです。データタイプ：文字列有効な値： true:すべてのフィールドの表示値を返します。 false:データベースから実際の値を返します。 all:実際の値と表示値の両方を返します。デフォルト値：false 注: このパラメーターを設定するための推奨される方法はありません。ただし、表示値を指定すると、データベースから直接読み取るわけではなく、他のフィールドやレコードの参照が含まれる可能性があるため、パフォーマンスの問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。
sysparm_exclude_reference_link	参照フィールドのテーブル API リンクを除外するかどうかを示すフラグ。有効な値： true:参照フィールドのテーブル API リンクを除外します。 false:参照フィールドにテーブル API リンクを含めます。データタイプ：ブーリアンデフォルト値：false
sysparm_fields	応答で返すフィールドのカンマ区切りリスト。無効なフィールドは無視されます。データタイプ：文字列デフォルト:すべてのフィールドを返します。
sysparm_limit	返されるレコードの最大数。このレコード数を超える要求の場合は、 sysparm_offset パラメーターを使用してレコード取得をページネーションします。この制限は、ACL 評価の前に適用されます。アクセス権のあるレコードを含めて、レコードが返されない場合は、アクセス権のあるレコードが最初に返されるようにレコードの順序を並べ替えます。注: sysparm_limit値が異常に大きいと、システムのパフォーマンスに影響を与える可能性があります。データタイプ：数値デフォルト：10000
sysparm_no_count	テーブルで `select count()` クエリを実行して、関連するテーブルの行数を返すかどうかを示すフラグ。有効な値： true: `select count()` を実行しません。 false: `select count(*)` を実行します。データタイプ：ブーリアンデフォルト値：false
sysparm_offset	レコード取得を開始する開始レコードインデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。たとえば、このエンドポイントを初めて呼び出すとき、 sysparm_offset は「0」に設定されます。使用可能なすべてのレコードを単純にページングするには、すべてのレコードの最後に到達するまで `sysparm_offset=sysparm_offset+sysparm_limit` を使用します。 sysparm_offset パラメーターに負の数を渡さないでください。データタイプ：数値デフォルト：0
sysparm_query	結果セットのフィルタリングに使用されるエンコードクエリ。UI フィルターを使用して、適切にエンコードされたクエリを取得できます。構文: `sysparm_query=<col_name><operator><value>`。列名、演算子、および値は大文字と小文字を区別します。 <col_name>:フィルターを適用するテーブル列の名前。 <operator>:次の値をサポートします。 `=`:<col_name>は<値>と完全に一致します。 `!=`:<col_name> が <value> と一致しません。 `LIKE:`<col_name>には指定された文字列 <value> が含まれています。データタイプが文字列である<col_name>フィールドでのみ機能します。 `STARTSWITH:`<col_name>は、指定された文字列 <value> で始まります。データタイプが文字列である<col_name>フィールドでのみ機能します。 `ENDSWITH`:<col_name>は指定された文字列 <value> で終わります。データタイプが文字列である<col_name>フィールドでのみ機能します。 `^`:クエリ条件を追加するための AND 演算子。結果セットに含まれるレコードは両方の条件に一致します。 `^OR`:クエリ条件を追加するための OR 演算子。結果セットに含まれるレコードは、少なくとも 1 つの条件に一致します。 <value>:フィルターを適用する値。演算子の詳細については、「Operators available for filters and queries」を参照してください。クエリには複数の条件を含めることができます。たとえば、次のクエリは、発信者が現在のユーザーであり、レコードがアクティブなレコードを返します。 `sysparm_query=caller_id=javascript:gs.getUserID()^active=true` エンコードクエリでは、昇順および降順による並べ替えの機能もサポートされています。特定のフィールドに基づいて応答をソートするには、sysparm_queryで `ORDERBY` 句と `ORDERBYDESC` 句を使用します。構文: `ORDERBY<col_name>` `ORDERBYDESC<col_name>` たとえば、次のクエリでは、すべてのアクティブなレコードを取得し、結果を番号の昇順に並べ替え、次にカテゴリ別に降順に並べ替えます。 `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCカテゴリ` デフォルトでは、無効なフィールド名など、クエリの一部が無効な場合、インスタンスは無効な部分を無視します。次に、クエリの有効な部分のみを使用して行を返します。プロパティ glide.invalid_query.returns_no_rows を `true` に設定すると、代わりに無効なクエリに対して行を返さないようにします。注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンス全体のすべてのクエリの動作を制御します。データタイプ：文字列
sysparm_query_category	クエリーに使用するカテゴリの名前。データタイプ：文字列
sysparm_query_no_domain	レコード検索を、ログインユーザーが構成されているドメインのみに制限するかどうかを示すフラグ。有効な値： false:現在ログインしているユーザーがアクセスするように設定されていないドメインにあるレコードを除外します。 true:現在ログインしているユーザーがアクセスするように設定されていないドメインに存在する場合でも、レコードを含めます。データタイプ：ブーリアンデフォルト値：false 注: sysparm_query_no_domain パラメーターは、システムアドミニストレーターまたは query_no_domain_table_api ロールを持つユーザーのみが使用できます。
sysparm_suppress_pagination_header	応答からリンクヘッダーを削除するかどうかを示すフラグ。リンクヘッダーは、返されたレコードセットをページネーションするために使用できる、レコードセット内の相対ページへのさまざまな URL を提供します。有効な値： true:応答からリンクヘッダーを削除します。 false:応答からリンクヘッダーを削除しません。データタイプ：ブーリアンデフォルト値：false
sysparm_view	データをレンダリングする UI ビュー。応答で返されるフィールドを決定します。有効な値：デスクトップ mobile both sysparm_fields パラメーターも指定する場合は、それが優先されます。データタイプ：文字列

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

ヘッダー

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

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

表 : 11. 応答ヘッダー
ヘッダー	説明
「リンク」	利用可能なレコードセットをページングするために使用できる、前の要求に基づく相対 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="前"`、 `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-合計-数	クエリによって返されたレコードの合計数。

ステータスコード

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

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

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


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

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}

注:

使用可能なバージョンは、REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

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

表 : 13. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	取得するレコードの sys_id。データタイプ：文字列
tableName	レコードの取得元のテーブルの名前。データタイプ：文字列

表 : 14. クエリパラメーター
名前	説明
sysparm_display_value	返されるデータのタイプ (データベースからの実際の値またはフィールドの表示値) を決定します。表示値は、データベースの実際の値とユーザーまたはシステムの設定と設定に基づいて操作されます。表示値を返す場合、返される値はフィールドタイプに依存します。選択肢フィールド:データベース値は数値でもかまいませんが、表示値はよりわかりやすいものになります。日付フィールド:データベース値は UTC 形式で、表示値はユーザーのタイムゾーンに基づいています。暗号化テキスト:データベース値は暗号化されますが、表示される値はユーザーの暗号化コンテキストに基づいて暗号化されません。参照フィールド:データベース値はsys_idですが、表示値は参照レコードの表示フィールドです。データタイプ：文字列有効な値： true:すべてのフィールドの表示値を返します。 false:データベースから実際の値を返します。 all:実際の値と表示値の両方を返します。デフォルト値：false 注: このパラメーターを設定するための推奨される方法はありません。ただし、表示値を指定すると、データベースから直接読み取るわけではなく、他のフィールドやレコードの参照が含まれる可能性があるため、パフォーマンスの問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。
sysparm_exclude_reference_link	参照フィールドのテーブル API リンクを除外するかどうかを示すフラグ。有効な値： true:参照フィールドのテーブル API リンクを除外します。 false:参照フィールドにテーブル API リンクを含めます。データタイプ：ブーリアンデフォルト値：false
sysparm_fields	応答で返すフィールドのカンマ区切りリスト。無効なフィールドは無視されます。データタイプ：文字列デフォルト:すべてのフィールドを返します。
sysparm_query_no_domain	レコード検索を、ログインユーザーが構成されているドメインのみに制限するかどうかを示すフラグ。有効な値： false:現在ログインしているユーザーがアクセスするように設定されていないドメインにあるレコードを除外します。 true:現在ログインしているユーザーがアクセスするように設定されていないドメインに存在する場合でも、レコードを含めます。データタイプ：ブーリアンデフォルト値：false 注: sysparm_query_no_domain パラメーターは、システムアドミニストレーターまたは query_no_domain_table_api ロールを持つユーザーのみが使用できます。
sysparm_view	データをレンダリングする UI ビュー。応答で返されるフィールドを決定します。有効な値：デスクトップ mobile both sysparm_fields パラメーターも指定する場合は、それが優先されます。データタイプ：文字列

表 : 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)


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

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}

注:

使用可能なバージョンは、REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

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

表 : 19. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	更新するレコードの sys_id。データタイプ：文字列
tableName	指定されたレコードが配置されているテーブルの名前。データタイプ：文字列

表 : 20. クエリパラメーター
名前	説明
sysparm_display_value	返されるデータのタイプ (データベースからの実際の値またはフィールドの表示値) を決定します。表示値は、データベースの実際の値とユーザーまたはシステムの設定と設定に基づいて操作されます。表示値を返す場合、返される値はフィールドタイプに依存します。選択肢フィールド:データベース値は数値でもかまいませんが、表示値はよりわかりやすいものになります。日付フィールド:データベース値は UTC 形式で、表示値はユーザーのタイムゾーンに基づいています。暗号化テキスト:データベース値は暗号化されますが、表示される値はユーザーの暗号化コンテキストに基づいて暗号化されません。参照フィールド:データベース値はsys_idですが、表示値は参照レコードの表示フィールドです。データタイプ：文字列有効な値： true:すべてのフィールドの表示値を返します。 false:データベースから実際の値を返します。 all:実際の値と表示値の両方を返します。デフォルト値：false 注: このパラメーターを設定するための推奨される方法はありません。ただし、表示値を指定すると、データベースから直接読み取るわけではなく、他のフィールドやレコードの参照が含まれる可能性があるため、パフォーマンスの問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。
sysparm_fields	応答で返すフィールドのカンマ区切りリスト。無効なフィールドは無視されます。データタイプ：文字列デフォルト:すべてのフィールドを返します。
sysparm_input_display_value	表示値または実際の値を使用してフィールド値を設定するかどうかを示すフラグ。さまざまなタイプのフィールドに応じて、エンドポイントは渡された表示値を操作して、適切な値をデータベースに格納できます。たとえば、参照フィールドの表示名を送信すると、エンドポイントはその値のsys_idをデータベースに保存します。日付と時刻のフィールドで、このパラメーターが true の場合、日付と時刻の値は現在のユーザーのタイムゾーンに合わせて調整されます。false の場合、日付と時刻の値は GMT タイムゾーンを使用して挿入されます。有効な値： true:入力値を表示値として扱い、データベースに適切に格納されるように操作します。 false:入力値を実際の値として扱い、操作せずにデータベースに格納します。データタイプ：ブーリアンデフォルト値:false - これは、データ取得 (GET メソッド) 中に返されるデータ型 (実際の値) と一致します。注: 暗号化フィールドの値を設定するには、このパラメーターを `true` に設定する必要があります。このパラメーターが true に設定されていない場合、暗号化フィールドに送信された値は保存されません。さらに、要求元ユーザーは、要求を送信する前に適切な暗号化コンテキストを持っている必要があります。適切な暗号化コンテキストのないユーザーに対しては、暗号化フィールドが非表示になります。フィールド暗号化の詳細については、「 Encryption」を参照してください。
sysparm_query_no_domain	レコード検索を、ログインユーザーが構成されているドメインのみに制限するかどうかを示すフラグ。有効な値： false:現在ログインしているユーザーがアクセスするように設定されていないドメインにあるレコードを除外します。 true:現在ログインしているユーザーがアクセスするように設定されていないドメインに存在する場合でも、レコードを含めます。データタイプ：ブーリアンデフォルト値：false 注: sysparm_query_no_domain パラメーターは、システムアドミニストレーターまたは query_no_domain_table_api ロールを持つユーザーのみが使用できます。
sysparm_view	データをレンダリングする UI ビュー。応答で返されるフィールドを決定します。有効な値：デスクトップ mobile both sysparm_fields パラメーターも指定する場合は、それが優先されます。データタイプ：文字列

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

ヘッダー

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

表 : 22. 要求ヘッダー
ヘッダー	説明
承認	応答本文のデータフォーマット。サポートされるタイプ：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)


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

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}

注:

使用可能なバージョンは、REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

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

表 : 25. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
tableName	レコードを保存するテーブルの名前。データタイプ：文字列

表 : 26. クエリパラメーター
名前	説明
sysparm_display_value	返されるデータのタイプ (データベースからの実際の値またはフィールドの表示値) を決定します。表示値は、データベースの実際の値とユーザーまたはシステムの設定と設定に基づいて操作されます。表示値を返す場合、返される値はフィールドタイプに依存します。選択肢フィールド:データベース値は数値でもかまいませんが、表示値はよりわかりやすいものになります。日付フィールド:データベース値は UTC 形式で、表示値はユーザーのタイムゾーンに基づいています。暗号化テキスト:データベース値は暗号化されますが、表示される値はユーザーの暗号化コンテキストに基づいて暗号化されません。参照フィールド:データベース値はsys_idですが、表示値は参照レコードの表示フィールドです。データタイプ：文字列有効な値： true:すべてのフィールドの表示値を返します。 false:データベースから実際の値を返します。 all:実際の値と表示値の両方を返します。デフォルト値：false 注: このパラメーターを設定するための推奨される方法はありません。ただし、表示値を指定すると、データベースから直接読み取るわけではなく、他のフィールドやレコードの参照が含まれる可能性があるため、パフォーマンスの問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。
sysparm_exclude_reference_link	参照フィールドのテーブル API リンクを除外するかどうかを示すフラグ。有効な値： true:参照フィールドのテーブル API リンクを除外します。 false:参照フィールドにテーブル API リンクを含めます。データタイプ：ブーリアンデフォルト値：false
sysparm_fields	応答で返すフィールドのカンマ区切りリスト。無効なフィールドは無視されます。データタイプ：文字列デフォルト:すべてのフィールドを返します。
sysparm_input_display_value	表示値または実際の値を使用してフィールド値を設定するかどうかを示すフラグ。さまざまなタイプのフィールドに応じて、エンドポイントは渡された表示値を操作して、適切な値をデータベースに格納できます。たとえば、参照フィールドの表示名を送信すると、エンドポイントはその値のsys_idをデータベースに保存します。日付と時刻のフィールドで、このパラメーターが true の場合、日付と時刻の値は現在のユーザーのタイムゾーンに合わせて調整されます。false の場合、日付と時刻の値は GMT タイムゾーンを使用して挿入されます。有効な値： true:入力値を表示値として扱い、データベースに適切に格納されるように操作します。 false:入力値を実際の値として扱い、操作せずにデータベースに格納します。データタイプ：ブーリアンデフォルト値:false - これは、データ取得 (GET メソッド) 中に返されるデータ型 (実際の値) と一致します。注: 暗号化フィールドの値を設定するには、このパラメーターを `true` に設定する必要があります。このパラメーターが true に設定されていない場合、暗号化フィールドに送信された値は保存されません。さらに、要求元ユーザーは、要求を送信する前に適切な暗号化コンテキストを持っている必要があります。適切な暗号化コンテキストのないユーザーに対しては、暗号化フィールドが非表示になります。フィールド暗号化の詳細については、「 Encryption」を参照してください。
sysparm_view	データをレンダリングする UI ビュー。応答で返されるフィールドを決定します。有効な値：デスクトップ mobile both sysparm_fields パラメーターも指定する場合は、それが優先されます。データタイプ：文字列

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

ヘッダー

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

表 : 28. 要求ヘッダー
ヘッダー	説明
承認	応答本文のデータフォーマット。サポートされるタイプ：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)


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

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}

注:

使用可能なバージョンは、REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

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

表 : 31. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	更新するレコードの一意の識別子。データタイプ：文字列
tableName	レコードが配置されているテーブルの名前。データタイプ：文字列

表 : 32. クエリパラメーター
名前	説明
sysparm_display_value	返されるデータのタイプ (データベースからの実際の値またはフィールドの表示値) を決定します。表示値は、データベースの実際の値とユーザーまたはシステムの設定と設定に基づいて操作されます。表示値を返す場合、返される値はフィールドタイプに依存します。選択肢フィールド:データベース値は数値でもかまいませんが、表示値はよりわかりやすいものになります。日付フィールド:データベース値は UTC 形式で、表示値はユーザーのタイムゾーンに基づいています。暗号化テキスト:データベース値は暗号化されますが、表示される値はユーザーの暗号化コンテキストに基づいて暗号化されません。参照フィールド:データベース値はsys_idですが、表示値は参照レコードの表示フィールドです。データタイプ：文字列有効な値： true:すべてのフィールドの表示値を返します。 false:データベースから実際の値を返します。 all:実際の値と表示値の両方を返します。デフォルト値：false 注: このパラメーターを設定するための推奨される方法はありません。ただし、表示値を指定すると、データベースから直接読み取るわけではなく、他のフィールドやレコードの参照が含まれる可能性があるため、パフォーマンスの問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。
sysparm_exclude_reference_link	参照フィールドのテーブル API リンクを除外するかどうかを示すフラグ。有効な値： true:参照フィールドのテーブル API リンクを除外します。 false:参照フィールドにテーブル API リンクを含めます。データタイプ：ブーリアンデフォルト値：false
sysparm_fields	応答で返すフィールドのカンマ区切りリスト。無効なフィールドは無視されます。データタイプ：文字列デフォルト:すべてのフィールドを返します。
sysparm_input_display_value	表示値または実際の値を使用してフィールド値を設定するかどうかを示すフラグ。有効な値： true:入力値を表示値として扱い、データベースに適切に格納できるように操作します。 false:入力値を実際の値として扱い、操作せずにデータベースに保存します。データタイプ：ブーリアンデフォルト値：false 注: このパラメーターが true に設定されている場合、入力値、特に日付値は、ユーザーのタイムゾーン設定によって指定されると解釈され、UTC 形式に変換されるため、注意してください。暗号化フィールドの値を設定するには、このパラメーターを `true` に設定する必要があります。このパラメーターが true に設定されていない場合、暗号化フィールドに送信された値は保存されません。さらに、要求元ユーザーは、要求を送信する前に適切な暗号化コンテキストを持っている必要があります。適切な暗号化コンテキストのないユーザーに対しては、暗号化フィールドが非表示になります。表示値と実際の値の詳細については、「テーブル API の FAQ (KB0534905)」を参照してください。フィールド暗号化の詳細については、「 Field Encryption」を参照してください。
sysparm_query_no_domain	レコード検索を、ログインユーザーが構成されているドメインのみに制限するかどうかを示すフラグ。有効な値： false:現在ログインしているユーザーがアクセスするように設定されていないドメインにあるレコードを除外します。 true:現在ログインしているユーザーがアクセスするように設定されていないドメインに存在する場合でも、レコードを含めます。データタイプ：ブーリアンデフォルト値：false 注: sysparm_query_no_domain パラメーターは、システムアドミニストレーターまたは query_no_domain_table_api ロールを持つユーザーのみが使用できます。
sysparm_view	データをレンダリングする UI ビュー。応答で返されるフィールドを決定します。有効な値：デスクトップ mobile both sysparm_fields パラメーターも指定する場合は、それが優先されます。データタイプ：文字列

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

ヘッダー

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

表 : 34. 要求ヘッダー
ヘッダー	説明
承認	応答本文のデータフォーマット。サポートされるタイプ：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)


名前	説明
名前と値のペア	すべてのフィールド (変更されただけでなく) と、変更要求に関連付けられた値。

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": ""
  }
}