--- 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 --- # DevOps コンフィグ API # DevOps コンフィグ API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：24分 DevOps コンフィグ API は、アプリケーションを管理するためのエンドポイントを提供します。この API には DevOps コンフィグアプリケーションが必要であり、 `sn_devops_config` 名前空間内で提供されます。 DELETE、PATCH、および POST 操作の場合、呼び出し元ユーザーには sn_devops_config.admin ロールが必要です。GET 操作の場合、呼び出し元ユーザーには sn_devops_config.viewer または sn_devops_config.admin ロールが必要です。アプリケーションライフサイクル管理に DevOps コンフィグ API を使用します。DevOps コンフィグを使用したアプリケーションの管理の詳細については、「[DevOps コンフィグの構成](https://www.servicenow.com/docs/access?context=setting-up-devops-config-validation&version=australia&pubname=australia-it-service-management&ft:locale=en-US)」を参照してください。 ## DevOps コンフィグ:削除 /devops_config/application/{appid} {#ariaid-title2} アプリケーションを削除します。 ### URL 形式バージョニングされた URL: /api/sn_devops_config/{api_version}/devops_config/application/{appid} デフォルト URL: /api/sn_devops_config/devops_config/application/{appid} 注: 使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#devops-config-DELETE-app__entry__2}{#devops-config-DELETE-app__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | | appid | 削除するアプリケーションのSys_id。データタイプ：文字列テーブル:CDM アプリケーション \[sn_cdm_application\] | [表 : 1. パスパラメーター] {#devops-config-DELETE-app__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 2. クエリパラメーター] {#devops-config-DELETE-app__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 3. 要求本文パラメーター (JSON)] ### ヘッダー次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")を参照してください。 {#devops-config-DELETE-app__table_kwn_v1r_fvb__entry__2}{#devops-config-DELETE-app__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 4. 要求ヘッダー] {#devops-config-DELETE-app__table_kwn_v1r_fvb} {#devops-config-DELETE-app__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")」を参照してください。 {#devops-config-DELETE-app__table_egh_yyl_gvb__entry__2}{#devops-config-DELETE-app__entry-200-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。アプリケーション ID が無効です。 | | 403 | 禁止されました。ユーザーには API にアクセスする権限がありません。 | [表 : 6. ステータスコード] {#devops-config-DELETE-app__table_egh_yyl_gvb} ### 応答本文のパラメーター (JSON) {#devops-config-DELETE-app__table_z3v_z5d_gvb__entry__2} | 名前 | 説明 | |-|-| | エラー | エラー情報。このパラメーターは、要求が失敗した場合にのみ返されます。データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 要求が失敗した理由に関するその他の詳細。データタイプ：文字列 | | error.message | 要求が失敗した理由を含むエラーメッセージ。データタイプ：文字列 | | result | 要求に関する情報を含む結果オブジェクト。データタイプ: オブジェクト "result": { "errors": [Array], "success": [Array] } | | result.errors | 要求からのエラーのアレイ。要求が成功した場合、アレイは空です。データタイプ：アレイ | | result.success | 要求の成功メッセージ。失敗した要求の場合、アレイは空です。データタイプ：アレイ | | status | 要求のステータス。このパラメーターは、要求が失敗した場合にのみ返されます。可能な値:失敗データタイプ：文字列 | [ ] {#devops-config-DELETE-app__table_z3v_z5d_gvb} ### cURL 要求この例では、アプリケーションを削除します。 curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ --request DELETE \ --header "Accept:application/json" \ --user 'username':'password' 応答本文。 { "result": { "errors": [], "success": [ "CDM Application Demo Application 1234 has been deleted successfully." ] } } ### cURL 要求 {#devops-config-DELETE-app__example_ssd_qph_hvb} この例は、ユーザーに API へのアクセス権限がない場合のエラー応答を示しています。 curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ --request DELETE \ --header "Accept:application/json" \ --user 'username':'password' エラー応答。 { "error": { "message": "User Not Authorized", "detail": "Failed API level ACL Validation" }, "status": "failure" } ## DevOps コンフィグ:GET /devops_config/application/{appid} {#ariaid-title3} アプリケーションを取得します。 ### URL 形式バージョニングされた URL: /api/sn_devops_config/{api_version}/devops_config/application/{appid} デフォルト URL: /api/sn_devops_config/devops_config/application/{appid} 注: 使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#devops-config-GET-app__entry__2}{#devops-config-GET-app__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | | appid | 取得するアプリケーションのSys_id。データタイプ：文字列テーブル:CDM アプリケーション \[sn_cdm_application\] | [表 : 7. パスパラメーター] {#devops-config-GET-app__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 8. クエリパラメーター] {#devops-config-GET-app__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 9. 要求本文パラメーター (JSON)] ### ヘッダー次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")を参照してください。 {#devops-config-GET-app__table_kwn_v1r_fvb__entry__2}{#devops-config-GET-app__accept-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 10. 要求ヘッダー] {#devops-config-GET-app__table_kwn_v1r_fvb} {#devops-config-GET-app__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 11. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")」を参照してください。 {#devops-config-GET-app__entry__24}{#devops-config-GET-app__entry-200-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。アプリケーション ID が無効です。 | | 403 | 禁止されました。ユーザーには API にアクセスする権限がありません。 | [表 : 12. ステータスコード] ### 応答本文のパラメーター (JSON) {#devops-config-GET-app__table_z3v_z5d_gvb__entry__2} | 名前 | 説明 | |-|-| | エラー | エラー情報。このパラメーターは、要求が失敗した場合にのみ返されます。データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 要求が失敗した理由に関するその他の詳細。データタイプ：文字列 | | error.message | 要求が失敗した理由を含むエラーメッセージ。データタイプ：文字列 | | result | 要求に関する情報を含む結果オブジェクト。データタイプ: オブジェクト "result": { "data": {Object}, "message": "String", "status": Number } | | result.data | アプリケーションのデータ。データタイプ: オブジェクト "data": { "appDescription": "String", "appId": "String", "appManagedByGroups": [Array], "appManufacturerId": "String", "appManufacturerName": "String", "appModelId": "String", "appModelName": "String", "appModelOwnerId": "String", "appModelOwnerName": "String", "appName": "String", "sdlcType": "String" } | | result.data.appDescription | アプリケーションの説明データタイプ：文字列 | | result.data.appId | アプリケーションのSys_id。データタイプ：文字列テーブル:CDM アプリケーション \[sn_cdm_application\] | | result.data.appManagedByGroups | アプリケーションを管理するグループのsys_idsのカンマ区切りリスト。データタイプ：文字列テーブル： Group \[sys_user_group\] | | result.data.appManufacturerId | メーカーのSys_id。データタイプ：文字列テーブル:会社 \[core_company\] | | result.data.appManufacturerName | メーカーの名前。データタイプ：文字列 | | result.data.appModelId | アプリケーションモデルのSys_id。データタイプ：文字列テーブル:アプリケーションモデル \[cmdb_application_product_model\] | | result.data.appModelName | アプリケーションモデルの名前。データタイプ：文字列テーブル:アプリケーションモデル \[cmdb_application_product_model\] | | result.data.appModelOwnerId | アプリケーションモデルオーナーのSys_id。データタイプ：文字列テーブル：ユーザー \[sys_user\] | | result.data.appModelOwnerName | アプリケーションモデルオーナーの名前。データタイプ：文字列 | | result.data.appName | アプリケーションの名前。データタイプ：文字列 | | result.data.error | エラー情報。このパラメーターは、要求が失敗した場合にのみ返されます。データタイプ：文字列 | | result.data.sdlcType | アプリケーションのタイプ。可能な値： * アプリケーション * インフラストラクチャ {#devops-config-GET-app__ul_rt4_x3q_dvb} データタイプ：文字列 | | result.message | 要求の成功または失敗の結果に関する情報。データタイプ：文字列 | | result.status | 要求のステータスコード。可能な値： * 200 * 400 * 403 {#devops-config-GET-app__ul_cvg_nkh_hvb} データタイプ：数値 | | status | 要求のステータス。このパラメーターは、要求が失敗した場合にのみ返されます。可能な値:失敗データタイプ：文字列 | [ ] {#devops-config-GET-app__table_z3v_z5d_gvb} ### cURL 要求この例では、アプリケーションを取得します。 curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' 応答本文。 { "result": { "status": 200, "message": "Success", "data": { "appName": "Demo Application 1234", "appId": "38e17dc3473d111072566862736d43c7", "appDescription": "Updated description of Demo Application created from REST API", "sdlcType": "application", "appModelId": "a4e13dc3473d111072566862736d4307", "appModelName": "Demo Application 1234", "appManufacturerId": "262702654725d950a34a3085d36d435e", "appManufacturerName": "", "appModelOwnerId": "6816f79cc0a8016401c5a33be04be441", "appModelOwnerName": "System Administrator", "appManagedByGroups": [] } } } ### cURL 要求 {#devops-config-GET-app__example_wfs_2qh_hvb} この例は、ユーザーが無効なアプリケーション ID を指定した場合のエラー応答を示しています。 curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/18a17de3283d15107256686277777777" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' エラー応答。 { "result": { "status": 400, "message": "No valid Application", "data": { "error": "No valid Application" } } } ## DevOps コンフィグ:PATCH /devops_config/application/{appid} {#ariaid-title4} アプリケーションを更新します。 ### URL 形式バージョニングされた URL: /api/sn_devops_config/{api_version}/devops_config/application/{appid} デフォルト URL: /api/sn_devops_config/devops_config/application/{appid} 注: 使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#devops-config-PATCH-app__entry__2}{#devops-config-PATCH-app__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | | appid | 更新するアプリケーションのSys_id。データタイプ：文字列テーブル:CDM アプリケーション \[sn_cdm_application\] | [表 : 13. パスパラメーター] {#devops-config-PATCH-app__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 14. クエリパラメーター] {#devops-config-PATCH-app__entry__12}{#devops-config-PATCH-app__app-descr}{#devops-config-PATCH-app__app-mfct}{#devops-config-PATCH-app__app-owner-id} | 名前 | 説明 | |-|-| | appDescription | アプリケーションの説明データタイプ：文字列 | | appManagedByGroup | アプリケーションを管理するグループのsys_idsのカンマ区切りリスト。呼び出し元ユーザーは、これらのグループに属している必要があります。 "appManagedByGroups": "sys_id, sys_id" データタイプ：文字列テーブル： Group \[sys_user_group\] | | appManufacturerId | メーカーのSys_id。データタイプ：文字列テーブル:会社 \[core_company\] | | appModelOwnerId | アプリケーションモデルオーナーのSys_id。データタイプ：文字列テーブル：ユーザー \[sys_user\] | [表 : 15. 要求本文パラメーター (JSON)] ### ヘッダー次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")を参照してください。 {#devops-config-PATCH-app__table_kwn_v1r_fvb__entry__2}{#devops-config-PATCH-app__accept-JSON-only-entry-RESTAPI}{#devops-config-PATCH-app__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 16. 要求ヘッダー] {#devops-config-PATCH-app__table_kwn_v1r_fvb} {#devops-config-PATCH-app__entry__28} | ヘッダー | 説明 | |-|-| | なし | | [表 : 17. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")」を参照してください。 {#devops-config-PATCH-app__table_jk3_y1r_fvb__entry__2} | ステータスコード | 説明 | |-|-| | 200 | アプリケーションが正常に更新されました。 | | 403 | 禁止されました。ユーザーには API にアクセスする権限がありません。 | | 404 | アプリケーションが更新されていません。result オブジェクトの message プロパティには、エラーに関する追加情報が含まれています。 | [表 : 18. ステータスコード] {#devops-config-PATCH-app__table_jk3_y1r_fvb} ### 応答本文のパラメーター (JSON) {#devops-config-PATCH-app__section_y3v_z5d_gvb} {#devops-config-PATCH-app__table_z3v_z5d_gvb__entry__2} | 名前 | 説明 | |-|-| | エラー | エラー情報。このパラメーターは、要求が失敗した場合にのみ返されます。データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 要求が失敗した理由に関するその他の詳細。データタイプ：文字列 | | error.message | 要求が失敗した理由を含むエラーメッセージ。データタイプ：文字列 | | result | アプリケーションに関する情報を含む結果オブジェクト。データタイプ: オブジェクト "result": { "data": "String", "message": "String" } | | result.data | アプリケーションのSys_id。データタイプ：文字列テーブル:CDM アプリケーション \[sn_cdm_application\] | | result.message | 要求の成功または失敗の結果に関する情報。データタイプ：文字列 | | status | 要求のステータス。このパラメーターは、要求が失敗した場合にのみ返されます。可能な値:失敗データタイプ：文字列 | [ ] {#devops-config-PATCH-app__table_z3v_z5d_gvb} ### cURL 要求この例では、既存のアプリケーションを更新します。 curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application/38e17dc3473d111072566862736d43c7" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"appDescription\": \"Updated description of Demo Application created from REST API\", \"appManufacturerId\": \"262702654725d950a34a3085d36d435e\", \"appModelOwnerId\": \"6816f79cc0a8016401c5a33be04be441\" }" \ --user 'username':'password' 応答本文。 { "result": { "message": "Application with name Demo Application 1234 updated successfully.", "data": "38e17dc3473d111072566862736d43c7" } } ## DevOps コンフィグ:POST /devops_config/application {#ariaid-title5} アプリケーションを作成します。 ### URL 形式バージョニングされた URL: /api/sn_devops_config/{api_version}/devops_config/application デフォルト URL: /api/sn_devops_config/devops_config/application 注: 使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#devops-config-POST-app__entry__2}{#devops-config-POST-app__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | [表 : 19. パスパラメーター] {#devops-config-POST-app__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 20. クエリパラメーター] {#devops-config-POST-app__entry__10}{#devops-config-POST-app__app-descr}{#devops-config-POST-app__app-mfct}{#devops-config-POST-app__app-owner-id} | 名前 | 説明 | |-|-| | appDescription | アプリケーションの説明データタイプ：文字列 | | appManagedByGroup | アプリケーションを管理するグループのsys_idsのカンマ区切りリスト。呼び出し元ユーザーは、これらのグループに属している必要があります。 "appManagedByGroups": "sys_id, sys_id" データタイプ：文字列テーブル： Group \[sys_user_group\] | | appManufacturerId | メーカーのSys_id。データタイプ：文字列テーブル:会社 \[core_company\] | | appModelId | アプリケーションの作成に使用する既存のアプリケーションモデルのSys_id。このパラメーターを指定する場合は、 appName、 appModelName、 appServiceName、 appServiceId、または technicalServiceId のパラメーターを指定しないでください。データタイプ：文字列テーブル:アプリケーションモデル \[cmdb_application_product_model\] | | appModelName | アプリケーションの作成に使用する既存のアプリケーションモデルの名前。このパラメーターを指定する場合は、 appName、 appModelId、 appServiceName、 appServiceId、または technicalServiceId のパラメーターを指定しないでください。データタイプ：文字列テーブル:アプリケーションモデル \[cmdb_application_product_model\] | | appModelOwnerId | アプリケーションモデルオーナーのSys_id。データタイプ：文字列テーブル：ユーザー \[sys_user\] | | appName | アプリケーションの名前。既存のアプリケーションと同じ名前を使用しないでください。このパラメーターを指定する場合は、 appModelName、 appModelId、 appServiceName、 appServiceId、または technicalServiceId のパラメーターを指定しないでください。データタイプ：文字列 | | appServiceId | アプリケーションの作成に使用する既存のアプリケーションサービスのSys_id。このパラメーターは、 type が アプリケーションである場合にのみ使用します。このパラメーターを指定する場合は、 appName、 appModelName、 appModelId、 appServiceName、または technicalServiceId のパラメーターを指定しないでください。データタイプ：文字列テーブル:サービスインスタンス \[cmdb_ci_service_auto\] | | appServiceName | アプリケーションの作成に使用する既存のアプリケーションサービスの名前。このパラメーターは、 type が アプリケーションである場合にのみ使用します。このパラメーターを指定する場合は、 appName、 appModelName、 appModelId、 appServiceId、または technicalServiceId のパラメーターを指定しないでください。データタイプ：文字列テーブル:サービスインスタンス \[cmdb_ci_service_auto\] | | technicalServiceId | アプリケーションの作成に使用する既存の動的 CI グループのSys_id。このパラメーターは、 type が インフラストラクチャの場合にのみ使用します。このパラメーターを指定する場合は、 appName、 appModelName、 appModelId、 appServiceName、または appServiceId のパラメーターを指定しないでください。データタイプ：文字列テーブル:ダイナミック CI グループ \[cmdb_ci_query_based_service\] | | type | 必須です。作成するアプリケーションのタイプ。有効な値： * アプリケーション * インフラストラクチャ {#devops-config-POST-app__ul_rt4_x3q_dvb} データタイプ：文字列 | [表 : 21. 要求本文パラメーター (JSON)] ### ヘッダー次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")を参照してください。 {#devops-config-POST-app__entry__34}{#devops-config-POST-app__accept-JSON-only-entry-RESTAPI}{#devops-config-POST-app__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 22. 要求ヘッダー] {#devops-config-POST-app__entry__40} | ヘッダー | 説明 | |-|-| | なし | | [表 : 23. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")」を参照してください。 {#devops-config-POST-app__entry__44} | ステータスコード | 説明 | |-|-| | 201 | アプリケーションが正常に作成されました。 | | 403 | 禁止されました。ユーザーには API にアクセスする権限がありません。 | | 404 | アプリケーションが作成されていません。result オブジェクトの message プロパティには、エラーに関する追加情報が含まれています。 | [表 : 24. ステータスコード] ### 応答本文のパラメーター (JSON) {#devops-config-POST-app__section_y3v_z5d_gvb} {#devops-config-POST-app__table_z3v_z5d_gvb__entry__2} | 名前 | 説明 | |-|-| | エラー | エラー情報。このパラメーターは、要求が失敗した場合にのみ返されます。データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 要求が失敗した理由に関するその他の詳細。データタイプ：文字列 | | error.message | 要求が失敗した理由を含むエラーメッセージ。データタイプ：文字列 | | result | アプリケーションに関する情報を含む結果オブジェクト。データタイプ: オブジェクト "result": { "data": "String", "message": "String" } | | result.data | アプリケーションのSys_id。データタイプ：文字列テーブル:CDM アプリケーション \[sn_cdm_application\] | | result.message | 要求の成功または失敗の結果に関する情報。データタイプ：文字列 | | status | 要求のステータス。このパラメーターは、要求が失敗した場合にのみ返されます。可能な値:失敗データタイプ：文字列 | [ ] {#devops-config-POST-app__table_z3v_z5d_gvb} ### cURL 要求この例では、新しいアプリケーションを作成する方法を示します。 curl "https://instance.service-now.com/api/sn_devops_config/devops_config/application" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"type\": \"application\", \"appName\": \"Demo Application 1234\", \"appDescription\": \"Description of Demo Application created from REST API\", \"appManufacturerId\": \"262702654725d950a34a3085d36d435e\", \"appModelOwnerId\": \"6816f79cc0a8016401c5a33be04be441\" }" \ --user 'username':'password' 応答本文。 { "result": { "message": "Application with name Demo Application 1234 created successfully.", "data": "38e17dc3473d111072566862736d43c7" } }