--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # SAM:ソフトウェア使用状況データ統合 API # SAM:ソフトウェア使用状況データ統合 API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：9分 SAM-ソフトウェア使用状況データ統合 API は、ソフトウェア使用状況 \[samp_sw_usage\] テーブルのレコードを作成および更新するためのエンドポイントを提供します。この API を使用するには、ソフトウェア資産管理プロフェッショナル (com.snc.samp) プラグインのアクティベーションが必要です。また、エンドポイントにアクセスするための sam_admin ロールまたは sam_developer ロールのいずれかも必要です。 ## SAM-ソフトウェア使用状況データ統合 - POST /sam_software_usage_integration/createOrUpdate {#ariaid-title2} ソフトウェア使用 \[samp_sw_usage\] テーブルの指定されたレコードを作成または更新します。 1 回の呼び出しで 1 つ以上のソフトウェア使用レコードを作成/更新できます。 ### URL 形式バージョニングされた URL: /api/now/{api_version}/sam_software_usage_integration/createOrUpdate デフォルト URL: /api/now/sam_software_usage_integration/createOrUpdate 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#sam_soft_us_int-POST-createOrUpdate__entry__2}{#sam_soft_us_int-POST-createOrUpdate__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | [表 : 1. パスパラメーター] {#sam_soft_us_int-POST-createOrUpdate__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 2. クエリパラメーター] {#sam_soft_us_int-POST-createOrUpdate__entry__10} | 名前 | 説明 | |-|-| | アイテム | ソフトウェア使用レコードに保存する各フィールドの列名と値のリスト。渡す必要がある列情報は、\[ reclamation_type \] に指定する値 (必須フィールド) によって異なります。渡す必要がある可能な reclamation_type 値と列情報: * total_usage: * configuration_item * last_used_time * month_used * norm_product * 年 {#sam_soft_us_int-POST-createOrUpdate__ul_cvy_2qh_zlb} * last_used_date: * configuration_item * norm_product {#sam_soft_us_int-POST-createOrUpdate__ul_pxb_jqh_zlb} {#sam_soft_us_int-POST-createOrUpdate__ul_rk3_zrc_zlb} これらのフィールドの組み合わせにより、レコードを一意に識別します。レコードがテーブルに見つからない場合は、指定したフィールドを持つ新しいレコードが作成されます。それ以外の場合は、既存のレコードが更新されます。データタイプ：アレイ | [表 : 3. 要求本文パラメーター (XML または JSON)] ### ヘッダー次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")を参照してください。 {#sam_soft_us_int-POST-createOrUpdate__entry__14}{#sam_soft_us_int-POST-createOrUpdate__accept-RESTAPI}{#sam_soft_us_int-POST-createOrUpdate__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | [表 : 4. 要求ヘッダー] {#sam_soft_us_int-POST-createOrUpdate__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")」を参照してください。 {#sam_soft_us_int-POST-createOrUpdate__entry__24}{#sam_soft_us_int-POST-createOrUpdate__entry-200-status-code}{#sam_soft_us_int-POST-createOrUpdate__entry-401-status-code}{#sam_soft_us_int-POST-createOrUpdate__entry-404-status-code}{#sam_soft_us_int-POST-createOrUpdate__entry-405-status-code}{#sam_soft_us_int-POST-createOrUpdate__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 405 | メソッドが無効です。機能が無効になっています。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 6. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#sam_soft_us_int-POST-createOrUpdate__entry__36} | 名前 | 説明 | |-|-| | アイテム | ソフトウェア使用レコード内のすべてのフィールドの名前と値のペアのリスト。データタイプ:アレイ (内容はさまざま) | [ ] ### cURL 要求次の例は、新しいソフトウェア使用レコードを作成する方法を示しています。 curl -X POST "https://instance.servicenow/api/now/sam_software_usage_integration/createOrUpdate" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d "{'items': [\ { 'configuration_item':'eaa9604d3790200044e0bfc8bcbe5dc1',\ 'month_used':2,\ 'norm_product':'40209c060b3022002d6c650d37673a89',\ 'norm_publisher':'24dcccc20b3022002d6c650d37673ab3',\ 'reclamation_type':'total_usage',\ 'usage_count': 13,\ 'total_usage_time':13,\ 'year':2020 }\ ]}"
{ "result": { "reply": { "items": [ { "configuration_item": "eaa9604d3790200044e0bfc8bcbe5dc1", "month_used": 2, "norm_product": "40209c060b3022002d6c650d37673a89", "norm_publisher": "24dcccc20b3022002d6c650d37673ab3", "reclamation_type": "total_usage", "usage_count": 13, "total_usage_time": 13, "year": 2020, "sysId": "13d15fe59d511010f8772c637e39afe5", "status": "INSERT" } ] }, "message": "Ok" } } 次の例は、1 回の呼び出しで複数のソフトウェア使用レコードを更新する方法を示しています。 curl -X POST "https://instance.servicenow/api/now/sam_software_usage_integration/createOrUpdate" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d "{'items': [\ {\ 'configuration_item': 'eaa9604d3790200044e0bfc8bcbe5dc1',\ 'month_used': 2,\ 'norm_product': '40209c060b3022002d6c650d37673a89',\ 'norm_publisher': '24dcccc20b3022002d6c650d37673ab3',\ 'reclamation_type': 'total_usage',\ 'usage_count': 13,\ 'total_usage_time': 13,\ 'year': 2020 }, {\ 'configuration_item': '0aa9e80d3790200044e0bfc8bcbe5da0',\ 'month_used': 2,\ 'norm_product': '40209c060b3022002d6c650d37673a89',\ 'norm_publisher': '24dcccc20b3022002d6c650d37673ab3',\ 'reclamation_type': 'total_usage',\ 'usage_count': 19,\ 'total_usage_time': 19,\ 'year': 2020 }, {\ 'configuration_item': 'a0a9a80d3790200044e0bfc8bcbe5d3c',\ 'month_used': 2,\ 'norm_product': '40209c060b3022002d6c650d37673a89',\ 'norm_publisher': '24dcccc20b3022002d6c650d37673ab3',\ 'reclamation_type': 'total_usage',\ 'usage_count': 7,\ 'total_usage_time': 7,\ 'year': 2020}, {\ 'configuration_item': '48a9280d3790200044e0bfc8bcbe5d55',\ 'month_used': 2,\ 'norm_product': '40209c060b3022002d6c650d37673a89',\ 'norm_publisher': '24dcccc20b3022002d6c650d37673ab3',\ 'reclamation_type': 'total_usage',\ 'usage_count': 1,\ 'total_usage_time': 1,\ 'year': 2020}, {\ 'configuration_item': '61a9680d3790200044e0bfc8bcbe5d11',\ 'month_used': 2,\ 'norm_product': '40209c060b3022002d6c650d37673a89',\ 'norm_publisher': '24dcccc20b3022002d6c650d37673ab3',\ 'reclamation_type': 'total_usage',\ 'usage_count': 18,\ 'total_usage_time': 18,\ 'year': 2020} ]}"
{ "result": { "reply": { "items": [ { "configuration_item": "eaa9604d3790200044e0bfc8bcbe5dc1", "month_used": 2, "norm_product": "40209c060b3022002d6c650d37673a89", "norm_publisher": "24dcccc20b3022002d6c650d37673ab3", "reclamation_type": "total_usage", "usage_count": 13, "total_usage_time": 13, "year": 2020, "sysId": "13d15fe59d511010f8772c637e39afe5", "status": "INSERT" }, { "configuration_item": "0aa9e80d3790200044e0bfc8bcbe5da0", "month_used": 2, "norm_product": "40209c060b3022002d6c650d37673a89", "norm_publisher": "24dcccc20b3022002d6c650d37673ab3", "reclamation_type": "total_usage", "usage_count": 19, "total_usage_time": 19, "year": 2020, "sysId": "2cd15fe59d521010f9772c637e39aff4", "status": "UPDATE" }, { ... }, ] }, "message": "Ok" } }