--- 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 --- # クラウドランナーテストランナー REST API # クラウドランナーテストランナー REST API {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：12分 自動テストフレームワーク (ATF) のクラウドランナーで実行するテストを管理します。 クラウドランナーテストランナー API には [ATF Test Generator and Cloud Runner](https://www.servicenow.com/docs/access?context=atf-tg-cr-intro&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) (sn_atf_tg) プラグインが必要です。この API で利用可能なメソッドは now 名前空間で実行され、REST API Explorer (REST API エクスプローラー) の API Name (API 名)、 One-click regression testing for ATF (ATF のワンクリック回帰テスト) を使用して呼び出すことができます。この API にアクセスするには、admin ロールが必要です。 この API は、次のタスクに使用できます。 * Cloud Runner ブラウザーで ATF テストまたはテストスイートを開始します。 * テストジョブの進行状況を確認します。 * テストジョブをキャンセルします。 {#cloudrunner-testrunner-api__cloudrnr-TestRunnerAPI-scoped_ul_vwb_wvn_31c} Cloud Runner Test Runner API は、[クラウドランナーテスト生成 REST API](https://servicenow-prod.fluidtopics.net/U9y2N9VJ58h67SIF3sVvxA#cloudrunner-testgeneration-api "自動テストフレームワーク (ATF) のクラウドランナーで実行するテストジョブの生成を管理します。") および [クラウドランナーテストユーザー REST API](https://servicenow-prod.fluidtopics.net/5frRlgdanuUP6UZ5xbv3rQ#cloudrunner-testuser-api "自動テストフレームワーク (ATF) のクラウドランナーで実行されるテストユーザージョブを管理します。") と組み合わせて使用できます。たとえば、テスト (Cloud Runner Test Generation API) を生成し、ブラウザーオーケストレーションキュー (Cloud Runner TEST Generation API) でテストの進行状況を取得して、合格または失敗したテストの数を確認できます。 この API のサーバー API リファレンス ドキュメントを表示するには、「 [クラウドランナー TestRunnerApi -- スコープ対象、グローバル](https://servicenow-prod.fluidtopics.net/GKh0rg8wLZXF6vQ_LjLzSw#cloudrnr-TestRunnerAPI-scoped "自動テストフレームワーク (ATF) のクラウドランナーで実行するテストを管理します。 この API は、CloudRunnerApi スクリプトインクルードの一部です。")」を参照してください。 ## クラウドランナーテストランナー - GET /now/sn_atf_tg/test_runner_progress {#ariaid-title2} 指定されたブラウザオーケストレーションキュー (BOQ) レコードに対して実行された各テストのステータスを提供します。 ### URL 形式 デフォルト URL:GET /api/now/sn_atf_tg/test_runner_progress ### サポートされている要求パラメーター {#cr-TestRunnerAPI-GET-test-run-progress__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 1. パスパラメーター] {#cr-TestRunnerAPI-GET-test-run-progress__entry__6} | 名前 | 説明 | |-|-| | snboqId | 必須。進捗状況を取得するテスト ランナー ジョブの BOQ レコード sys_id。BOQ \[sn_atf_tg_sn_boq\] テーブルにあります。 データタイプ：文字列 | [表 : 2. クエリパラメータ] {#cr-TestRunnerAPI-GET-test-run-progress__entry__10} | 名前 | 説明 | |-|-| | なし | | [表 : 3. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#cr-TestRunnerAPI-GET-test-run-progress__entry__14}{#cr-TestRunnerAPI-GET-test-run-progress__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 4. 要求ヘッダー] {#cr-TestRunnerAPI-GET-test-run-progress__entry__18} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#cr-TestRunnerAPI-GET-test-run-progress__table_vdy_gwz_31c__entry__2} | ステータスコード | 説明 | |-|-| | 200 | BOQ ジョブの進捗状況を正常に取得しました。 | | 400 | BOQ レコードステータスの取得中にエラーが発生しました。次のいずれかのメッセージを返します。 * BOQ ID が渡されませんでした -- BOQ ID が指定されていません。BOQ ID を要求本文に追加します。 * BOQ レコードが見つかりません:無効な Sys ID。BOQ レコードのsys_idが有効であり、レコードが存在することを確認します。 {#cr-TestRunnerAPI-GET-test-run-progress__ul_d5p_btk_p1c} | | 403 | エンドポイントへのユーザーアクセスの許可中にエラーが発生しました。ユーザーに admin ロールがあることを確認します。 | [表 : 6. ステータスコード] {#cr-TestRunnerAPI-GET-test-run-progress__table_vdy_gwz_31c} ### 応答本文のパラメーター (JSON または XML) {#cr-TestRunnerAPI-GET-test-run-progress__entry__30} | 名前 | 説明 | |-|-| | 結果 | テスト ランナー ジョブの進行状況の結果、または要求が失敗した理由を説明するメッセージを含むオブジェクト。 データタイプ: オブジェクト "result": { "progress": 100, "state": "completed" } または： { "result": { "message": "String" } } | | result.message | テストランナーの進捗状況を取得できない理由を詳述したエラーメッセージ。メッセージ・パラメーターは、正常な応答では返されません。 データタイプ：文字列 | | result.progress | 実行中のテストがどの程度完了に近づいたかを示すパーセンテージ。 データタイプ：数値 | | result.state | BOQ レコードの現在のステータス。可能な値： * 保留中 -- 要求されたテストアクティビティが作成され、実行を待機しています。 * 処理中:インスタンスはレコードをスキャンして、リクエストがクラウドインフラストラクチャに送信される前に、実行トラッカーが Cloud Runner 用にマークされていることを確認します。 * 要求されたブラウザー -- テスト生成またはテスト実行のためにブラウザーを起動する要求がクラウドインフラストラクチャに送信されました。 * 実行中 -- クラウドインフラストラクチャのブラウザは、保留中のテストを検出して実行します。 * 完了 -- テストタスクが完了しました。 * \[Failed (失敗)\] ステータス -- テストタスクが失敗しました。 {#cr-TestRunnerAPI-GET-test-run-progress__ul_hph_y5h_41c} データタイプ：文字列 | [ ] ### cURL 要求 次の要求は、BOQ レコードのテスト ランナー ジョブの進行状況を取得します。 curl "http://instance.service-now.com/api/now/sn_atf_tg/test_runner_progress?snboqId=" \ --request GET \ --header "Accept:application/json" \ --user "username:password" この応答は、テストが 100% 完了したことを示しています。 { "result": { "progress": 100, "state": "completed" } } 次の例では、BOQ ID が渡されない場合に 400 エラー メッセージを返します。 curl "http://instance.service-now.com/api/now/sn_atf_tg/test_runner_progress" \ --request GET \ --header "Accept:application/json" \ --user "username:password" 応答： { "result": { "message": "No SNBOQ ID passed in, add snboqId to request body" } } 次の例では、無効な BOQ ID が渡された場合に 400 エラー メッセージを返します。 curl "http://instance.service-now.com/api/now/sn_atf_tg/test_runner_progress?snboqId=invalid_sys_id" \ --request GET \ --header "Accept:application/json" \ --user "username:password" 応答： { "result": { "message": "Invalid SNBOQ sys_id passed in" } } ## クラウドランナーテストランナー:/now/sn_atf_tg/cancel_test_runner を POST {#ariaid-title3} テストランナージョブを完了ステータスに設定し、実行中の生成されたテストのルートトラッカーをキャンセルします。 ### URL 形式 デフォルト URL:GET /now/sn_atf_tg/cancel_test_runner ### サポートされている要求パラメーター {#cr-TestRunnerAPI-POST-cancel-test-runner__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 7. パスパラメーター] {#cr-TestRunnerAPI-POST-cancel-test-runner__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 8. クエリパラメータ] {#cr-TestRunnerAPI-POST-cancel-test-runner__entry__10} | 名前 | 説明 | |-|-| | snboqId | キャンセルするテスト ランナージョブに関連付けられたブラウザオーケストレーションキュー(BOQ)レコード(sn_atf_tg_sn_boq)のSys_id。BOQ \[sn_atf_tg_sn_boq\] テーブルにあります。 | [表 : 9. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#cr-TestRunnerAPI-POST-cancel-test-runner__table_ism_z2j_41c__entry__2}{#cr-TestRunnerAPI-POST-cancel-test-runner__accept-RESTAPI}{#cr-TestRunnerAPI-POST-cancel-test-runner__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 10. 要求ヘッダー] {#cr-TestRunnerAPI-POST-cancel-test-runner__table_ism_z2j_41c} {#cr-TestRunnerAPI-POST-cancel-test-runner__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 11. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#cr-TestRunnerAPI-POST-cancel-test-runner__entry__24}{#cr-TestRunnerAPI-POST-cancel-test-runner__entry-200-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | ジョブのキャンセル中にエラーが発生しました。次のいずれかのメッセージを返します。 * BOQ ID が渡されませんでした -- BOQ ID が指定されていません。BOQ ID を要求本文に追加します。 * BOQ レコードが見つかりません:無効な Sys ID。BOQ レコードのsys_idが有効であり、レコードが存在することを確認します。 {#cr-TestRunnerAPI-POST-cancel-test-runner__ul_fzp_ztk_p1c} | | 403 | エンドポイントへのユーザーアクセスの許可中にエラーが発生しました。ユーザーに admin ロールがあることを確認します。 | [表 : 12. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#cr-TestRunnerAPI-POST-cancel-test-runner__entry__32} | 名前 | 説明 | |-|-| | 結果 | 要求の結果を含むオブジェクト。 "result": { "message": String } {#cr-TestRunnerAPI-POST-cancel-test-runner__codeblock_hhp_4k2_p1c} データタイプ: オブジェクト | | result.message | テストのキャンセルが成功したかどうかを示すメッセージ。 データタイプ：文字列 | [ ] ### cURL 要求 次の例は、BOQ レコードのsys_idに従ってテスト ランナーのキャンセル要求を形成する方法を示しています。 curl "https://instance.service-now.com/api/now/sn_atf_tg/cancel_test_runner" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{\"snboqId\":\"\"}" \ --user "username:password" テストランナーが正常にキャンセルされたことを示す応答メッセージ。 { "result": { "message": "success" } } ## クラウドランナーテストランナー:/now/sn_atf_tg/test_runner を POST {#ariaid-title4} 指定されたテストまたはテストスイートの BOQ \[sn_atf_tg_sn_boq\] テーブルにテストランナージョブを挿入し、クラウドランナーで実行します。 ### URL 形式 デフォルト URL:POST api/now/sn_atf_tg/test_runner ### サポートされている要求パラメーター {#cr-TestRunnerAPI-POST-test-runner__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 13. パスパラメーター] {#cr-TestRunnerAPI-POST-test-runner__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 14. クエリパラメータ] {#cr-TestRunnerAPI-POST-test-runner__entry__10} | 名前 | 説明 | |-|-| | testId | Cloud Runner で実行するテスト \[sys_atf_test\] またはテストスイート \[sys_atf_test_suite\] のSys_id。 | [表 : 15. 要求本文パラメーター (XML または JSON)] ### ヘッダー 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#cr-TestRunnerAPI-POST-test-runner__table_gcx_1fj_41c__entry__2}{#cr-TestRunnerAPI-POST-test-runner__accept-RESTAPI}{#cr-TestRunnerAPI-POST-test-runner__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json | [表 : 16. 要求ヘッダー] {#cr-TestRunnerAPI-POST-test-runner__table_gcx_1fj_41c} {#cr-TestRunnerAPI-POST-test-runner__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 17. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#cr-TestRunnerAPI-POST-test-runner__entry__24} | ステータスコード | 説明 | |-|-| | 200 | テストランナー BOQ ジョブが正常に挿入されました。 | | 400 | テスト ランナー ジョブの開始中にエラーが発生しました。次のいずれかのメッセージを返します。 * Unable to find test or test suite with Sys ID \:テスト ID が無効です。テスト (sys_atf_test) またはテストスイート (sys_atf_test_suite) レコードのsys_idが有効であり、レコードが存在することを確認してください。 * テスト ID が渡されませんでした -- テスト ID が渡されませんでした。テスト ID を要求本文に追加します。 {#cr-TestRunnerAPI-POST-test-runner__ul_uht_ttk_p1c} | | 403 | エンドポイントへのユーザーアクセスの許可中にエラーが発生しました。ユーザーに admin ロールがあることを確認します。 | [表 : 18. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#cr-TestRunnerAPI-POST-test-runner__entry__32} | 名前 | 説明 | |-|-| | 結果 | 要求の結果を含むオブジェクト。 { "result": { "snboqId": "String" } } {#cr-TestRunnerAPI-POST-test-runner__codeblock_n5d_sxk_p1c} または： "result": { "message": "String" } {#cr-TestRunnerAPI-POST-test-runner__codeblock_hhp_4k2_p1c} データタイプ: オブジェクト | | result.snboqId | テストランナーの起動時に挿入される BOQ レコードのSys_id。BOQ \[sn_atf_tg_sn_boq\] テーブルにあります。 | | result.message | テストランナーを開始できない理由を詳述したエラーメッセージ。 | [ ] ### cURL 要求 次の要求は、テスト ランナー ジョブを BOQ \[sn_atf_tg_sn_boq\] テーブルに挿入します。 curl "https://instance.service-now.com/api/now/sn_atf_tg/test_runner" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{\"testId\":\"\"}" \ --user "username:password" 応答本文は、正常に挿入されたテスト ランナー ジョブのsys_idを返します。 { "result": { "snboqId": "" } } {#cr-TestRunnerAPI-POST-test-runner__codeblock_bhq_np3_41c}