---
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) 所要時間：18分

自動テストフレームワーク (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 は、次のタスクに使用できます。

* ユーザーテストジョブを開始します。
* クラウドユーザーを設定します。
* 指定されたユーザーが有効かどうかを確認します。
* ユーザーテストジョブの進捗状況を確認します。
* テストジョブをキャンセルします。
{#cloudrunner-testuser-api__cloudrnr-TestUserAPI-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 リファレンス ドキュメントを表示するには、「 [クラウドランナー TestUserApi -- スコープ指定、グローバル](https://servicenow-prod.fluidtopics.net/OsQ0gpbe3VIO5sbw~IeHfA#cloudrnr-TestUserAPI-scoped "自動テストフレームワーク (ATF) のクラウドランナーで実行されるテストユーザージョブを管理します。 この API は、CloudRunnerApi スクリプトインクルードの一部です。")」を参照してください。

## クラウドランナーテストユーザー:GET /now/sn_atf_tg/test_user_progress {#ariaid-title2}

指定されたブラウザオーケストレーションキュー (BOQ) レコードのテストユーザージョブのステータスを提供します。

### URL 形式

デフォルト URL:GET /api/now/sn_atf_tg/test_user_progress

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

{#cr-TestUserAPI-GET-test-user-progress__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 1. パスパラメーター]

{#cr-TestUserAPI-GET-test-user-progress__entry__6}

| 名前 | 説明 |
|-|-|
| snboqId | 必須。進捗状況を取得するテストユーザージョブの BOQ レコードsys_id。BOQ \[sn_atf_tg_sn_boq\] テーブルにあります。 データタイプ：文字列 |
[表 : 2. クエリパラメータ]

{#cr-TestUserAPI-GET-test-user-progress__entry__10}

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

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#cr-TestUserAPI-GET-test-user-progress__entry__14}{#cr-TestUserAPI-GET-test-user-progress__accept-RESTAPI}

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

{#cr-TestUserAPI-GET-test-user-progress__entry__18}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#cr-TestUserAPI-GET-test-user-progress__table_u3v_zh3_j1c__entry__2}

| ステータスコード | 説明 |
|-|-|
| 200 | テストユーザージョブの進捗状況を正常に取得しました。 |
| 400 | BOQ レコードステータスの取得中にエラーが発生しました。次のいずれかのメッセージを返します。 * BOQ ID が渡されませんでした -- BOQ ID が指定されていません。BOQ ID を要求本文に追加します。 * BOQ レコードが見つかりません:無効な Sys ID。BOQ レコードのsys_idが有効であり、レコードが存在することを確認します。 {#cr-TestUserAPI-GET-test-user-progress__ul_d5p_btk_p1c} |
| 403 | エンドポイントへのユーザーアクセスの許可中にエラーが発生しました。ユーザーに admin ロールがあることを確認します。 |
[表 : 6. ステータスコード]

{#cr-TestUserAPI-GET-test-user-progress__table_u3v_zh3_j1c}

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

{#cr-TestUserAPI-GET-test-user-progress__entry__30}

| 名前 | 説明 |
|-|-|
| 結果 | テスト ランナー ジョブの進行状況の結果、または要求が失敗した理由を説明するメッセージを含むオブジェクト。 "result": { "progress": 100, "state": "completed" } {#cr-TestUserAPI-GET-test-user-progress__codeblock_tqb_gth_41c} または： "result": { "message": "String" } データタイプ: オブジェクト |
| result.message | テストランナーの進捗状況を取得できない理由を詳述したエラーメッセージ。メッセージ・パラメーターは、正常な応答では返されません。 データタイプ：文字列 |
| result.progress | 実行中のテストがどの程度完了に近づいたかを示すパーセンテージ。 データタイプ：数値 |
| result.state | BOQ レコードの現在のステータス。 可能な値： * 保留中 -- 要求されたテストアクティビティが作成され、実行を待機しています。 * 処理中:インスタンスはレコードをスキャンして、リクエストがクラウドインフラストラクチャに送信される前に、実行トラッカーが Cloud Runner 用にマークされていることを確認します。 * 要求されたブラウザー -- テスト生成またはテスト実行のためにブラウザーを起動する要求がクラウドインフラストラクチャに送信されました。 * 実行中 -- クラウドインフラストラクチャのブラウザは、保留中のテストを検出して実行します。 * 完了 -- テストタスクが完了しました。 * \[Failed (失敗)\] ステータス -- テストタスクが失敗しました。 {#cr-TestUserAPI-GET-test-user-progress__ul_hph_y5h_41c} データタイプ：文字列 |
[ ]

### cURL 要求

次の要求例は、テストユーザージョブの進行状況を確認する方法を示しています。

    curl "https://instance.service-now.com/api/now/sn_atf_tg/test_user_progress?snboqId=<sys_id of SNBOQ record>" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username:password"

応答本文：

    { 
      "result": { 
        "progress": 100, 
        "state": "completed" 
      } 
    }

## クラウドランナーテストユーザー:GET /now/sn_atf_tg/is_valid_cloud_user {#ariaid-title3}

指定されたユーザーが有効なクラウドユーザーであるかどうかを確認します。
このメソッドは、ユーザーが次の基準を満たしているかどうかを確認します。

* 存在
* アクティブである、
* ロックアウトされていない、
* パスワードのリセットが必要です。
* 管理者である、
* 読み取り専用、
* Web サービスのみである

### URL 形式

デフォルト URL:GET /api/now/sn_atf_tg/is_valid_cloud_user

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

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 7. パスパラメーター]

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__6}

| 名前 | 説明 |
|-|-|
| username | 必須。ユーザーが次のベースライン基準を満たしているかどうかを確認するsys_userのユーザー名。 * 存在 * アクティブである、 * ロックアウトされていない、 * パスワードのリセットが必要です。 * 管理者である、 * 読み取り専用、 * Web サービスのみである {#cr-TestUserAPI-GET-is_valid_cloud_user__ul_orh_qnl_p1c} これらの条件のいずれかが満たされない場合、API は false ブール値と、どの条件が失敗したかを示すメッセージを返します。 データタイプ：文字列 |
[表 : 8. クエリパラメータ]

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__10}

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

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__14}{#cr-TestUserAPI-GET-is_valid_cloud_user__accept-RESTAPI}

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

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__18}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 11. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#cr-TestUserAPI-GET-is_valid_cloud_user__table_u3v_zh3_j1c__entry__2}

| ステータスコード | 説明 |
|-|-|
| 200 | ユーザーが有効であり、クラウドユーザー基準を満たしている場合は、true または false を返します。 |
| 403 | エンドポイントへのユーザーアクセスの許可中にエラーが発生しました。ユーザーに admin ロールがあることを確認します。 |
[表 : 12. ステータスコード]

{#cr-TestUserAPI-GET-is_valid_cloud_user__table_u3v_zh3_j1c}

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

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__28}

| 名前 | 説明 |
|-|-|
| 結果 | 要求の結果を含むオブジェクト。 "result": { "validUser": Boolean } {#cr-TestUserAPI-GET-is_valid_cloud_user__codeblock_hhp_4k2_p1c} データタイプ: オブジェクト |
| result.validUser | ユーザーがクラウドユーザー基準を満たしているかどうかを示すフラグ。true の場合、ユーザーは基準を満たしています。 データタイプ：ブーリアン |
[ ]

### cURL 要求

次の要求は、指定されたsys_userがクラウド機能を使用するための基準を満たしているかどうかを確認します。

    curl "http://instance.service-now.com/api/now/sn_atf_tg/is_valid_cloud_user?username=<username of sys_user to check>" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username:password"

応答本文：

    { 
      "result": { 
        "validUser": <Boolean value indicating whether user is valid cloud user> 
      } 
    }

## クラウドランナーテストユーザー:POST /now/sn_atf_tg/test_user {#ariaid-title4}

指定されたユーザー名の BOQ \[sn_atf_tg_sn_boq\] テーブルにテストユーザージョブを挿入し、Cloud Runner で実行します。

### URL 形式

デフォルト URL:POST /api/now/sn_atf_tg/test_user

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

{#cr-TestUserAPI-POST-test-user__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 13. パスパラメーター]

{#cr-TestUserAPI-POST-test-user__entry__6}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 14. クエリパラメータ]

{#cr-TestUserAPI-POST-test-user__entry__10}

| 名前 | 説明 |
|-|-|
| username | 必須。Cloud Runner のエンドツーエンドインフラストラクチャをテストするsys_userのユーザー名。 データタイプ：文字列 |
[表 : 15. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#cr-TestUserAPI-POST-test-user__table_xh4_cfj_41c__entry__2}{#cr-TestUserAPI-POST-test-user__accept-RESTAPI}{#cr-TestUserAPI-POST-test-user__content_type-RESTAPI}

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

{#cr-TestUserAPI-POST-test-user__table_xh4_cfj_41c} {#cr-TestUserAPI-POST-test-user__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 17. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#cr-TestUserAPI-POST-test-user__entry__24}

| ステータスコード | 説明 |
|-|-|
| 200 | テストユーザーの BOQ ジョブが正常に挿入されました。 |
| 400 | テストユーザージョブの開始中にエラーが発生しました。 空のユーザー名が指定されている場合、またはテーブルsys_userユーザーが見つからない場合、サーバーはエラーをスローします。 |
| 403 | エンドポイントへのユーザーアクセスの許可中にエラーが発生しました。ユーザーに admin ロールがあることを確認します。 |
[表 : 18. ステータスコード]

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

{#cr-TestUserAPI-POST-test-user__entry__32}

| 名前 | 説明 |
|-|-|
| 結果 | 要求の結果を含むオブジェクト。 "result": { "snboqId": String } または： "result": { "message": "String" } データタイプ: オブジェクト |
| result.message | ユーザー名にテスト機能をアサインできない理由を詳述したエラーメッセージ。メッセージ・パラメーターは、正常な応答では返されません。 データタイプ：文字列 |
| result.snboqId | テストユーザージョブが正常に開始されたときに挿入される BOQ レコードのSys_id。BOQ \[sn_atf_tg_sn_boq\] テーブルにあります。 データタイプ：文字列 |
[ ]

### cURL 要求

次の要求例は、特定のユーザー名の BOQ \[sn_atf_tg_sn_boq\] テーブルにテストユーザージョブを挿入する方法を示しています。

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"username\":\"<username of sys_user to test cloud infrastructure>\"}" \ 
    --user "username:password"

応答は、テストユーザージョブの開始時に挿入される BOQ レコードのsys_idを返します。

    { 
      "result": { 
        "snboqId": "<sys_id of newly inserted BOQ record>" 
      } 
    }

次の例では、ユーザー名が渡されない場合、または無効なユーザー名が渡された場合に、400 エラーメッセージが返されます。

    curl "https://instance.service-now.com/api/now/sn_atf_tg/test_user" \
    --request POST \
    --header "Accept:application/json" \
    --user "username:password"

応答：

    {
      "result": {
        "message": "Unable to set cloud user as cloud user not valid"
      }
    }

## クラウドランナーテストユーザー:/now/sn_atf_tg/cancel_test_user を POST {#ariaid-title5}

ブラウザーオーケストレーションキュー (BOQ) \[sn_atf_tg_sn_boq\] テーブルのテストユーザージョブステータスを完了に設定します。

### URL 形式

デフォルト URL:POST /api/now/sn_atf_tg/cancel_test_user

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

{#cr-TestUserAPI-POST-cancel-test-user__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 19. パスパラメーター]

{#cr-TestUserAPI-POST-cancel-test-user__entry__6}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 20. クエリパラメータ]

{#cr-TestUserAPI-POST-cancel-test-user__entry__10}

| 名前 | 説明 |
|-|-|
| snboqId | 必須。テストユーザージョブに関連付けられたキャンセルする BOQ レコードのSys_id。SNBOQ \[sn_atf_tg_sn_boq\] テーブルにあります。 データタイプ：文字列 |
[表 : 21. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#cr-TestUserAPI-POST-cancel-test-user__table_m4k_dfj_41c__entry__2}{#cr-TestUserAPI-POST-cancel-test-user__accept-RESTAPI}{#cr-TestUserAPI-POST-cancel-test-user__content_type-RESTAPI}

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

{#cr-TestUserAPI-POST-cancel-test-user__table_m4k_dfj_41c} {#cr-TestUserAPI-POST-cancel-test-user__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 23. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#cr-TestUserAPI-POST-cancel-test-user__table_u3v_zh3_j1c__entry__2}

| ステータスコード | 説明 |
|-|-|
| 200 | BOQ ジョブが正常にキャンセルされました。 |
| 400 | ジョブのキャンセル中にエラーが発生しました。次のいずれかのメッセージを返します。 * BOQ ID が渡されませんでした -- BOQ ID が指定されていません。BOQ ID を要求本文に追加します。 * BOQ レコードが見つかりません:無効な Sys ID。BOQ レコードのsys_idが有効であり、レコードが存在することを確認します。 {#cr-TestUserAPI-POST-cancel-test-user__ul_fzp_ztk_p1c} |
| 403 | エンドポイントへのユーザーアクセスの許可中にエラーが発生しました。ユーザーに admin ロールがあることを確認します。 |
[表 : 24. ステータスコード]

{#cr-TestUserAPI-POST-cancel-test-user__table_u3v_zh3_j1c}

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

{#cr-TestUserAPI-POST-cancel-test-user__entry__32}

| 名前 | 説明 |
|-|-|
| 結果 | 要求の結果を含むオブジェクト。 "result": { "message": String } {#cr-TestUserAPI-POST-cancel-test-user__codeblock_hhp_4k2_p1c} データタイプ: オブジェクト |
| result.message | テストユーザーのキャンセルが成功したかどうかを示すメッセージ。 データタイプ：文字列 |
[ ]

### cURL 要求

次の要求は、ブラウザーオーケストレーションキュー \[sn_atf_tg_sn_boq\] テーブルのテストユーザージョブをキャンセルする方法を示しています。

    curl "https://instance.service-now.com/api/now/sn_atf_tg/cancel_test_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"snboqId\":\"<sys_id of BOQ record>\"}" \ 
    --user "username:password"

Successful response body (成功した応答本文):

    { 
      "result": { 
        "message": "success" 
      } 
    }

## クラウドランナーテストユーザー:POST /now/sn_atf_tg/select_cloud_user {#ariaid-title6}

Cloud Runner でエンドツーエンドのテストユーザージョブを開始します。ユーザーが admin ロールでログインできる場合、クラウドユーザープロパティは、将来のテスト実行およびテスト生成において、デフォルトでこのユーザーに設定されます。

### URL 形式

デフォルト URL:POST /api/now/sn_atf_tg/select_cloud_user

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

{#cr-TestUserAPI-POST-select-cloud-user__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 25. パスパラメーター]

{#cr-TestUserAPI-POST-select-cloud-user__entry__6}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 26. クエリパラメータ]

{#cr-TestUserAPI-POST-select-cloud-user__entry__10}

| 名前 | 説明 |
|-|-|
| username | 必須。テストするsys_userのユーザー名。今後のテストランナーとテスト生成ジョブのためにクラウドユーザーを設定します。 データタイプ：文字列 |
[表 : 27. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#cr-TestUserAPI-POST-select-cloud-user__table_g43_2fj_41c__entry__2}{#cr-TestUserAPI-POST-select-cloud-user__accept-RESTAPI}{#cr-TestUserAPI-POST-select-cloud-user__content_type-RESTAPI}

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

{#cr-TestUserAPI-POST-select-cloud-user__table_g43_2fj_41c} {#cr-TestUserAPI-POST-select-cloud-user__entry__20}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 29. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#cr-TestUserAPI-POST-select-cloud-user__table_u3v_zh3_j1c__entry__2}

| ステータスコード | 説明 |
|-|-|
| 200 | エンドツーエンドのクラウドランナーインフラストラクチャのテストに成功し、将来のテスト実行およびテスト生成ジョブのクラウドユーザーを設定しました。 |
| 400 | 完全なエンドツーエンドのクラウドランナーインフラストラクチャのテストとクラウドユーザーの設定中にエラーが発生しました。ユーザー名が空でないこと、または指定されたユーザー名のsys_userテーブルにユーザーが存在することを確認します。 |
| 403 | エンドポイントへのユーザーアクセスの許可中にエラーが発生しました。ユーザーに admin ロールがあることを確認します。 |
[表 : 30. ステータスコード]

{#cr-TestUserAPI-POST-select-cloud-user__table_u3v_zh3_j1c}

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

{#cr-TestUserAPI-POST-select-cloud-user__entry__32}

| 名前 | 説明 |
|-|-|
| 結果 | 要求の結果を含むオブジェクト。 "result": { "message": "String" } {#cr-TestUserAPI-POST-select-cloud-user__codeblock_hhp_4k2_p1c} データタイプ: オブジェクト |
| result.message | Cloud Runner インフラストラクチャでの今後のテスト実行とテスト生成のためにユーザーが正常に選択されたかどうかを詳述するメッセージ。 データタイプ：文字列 |
[ ]

### cURL 要求

次の例は、Cloud Runner インフラストラクチャでの将来のテスト実行とテスト生成のために、特定のユーザーの選択をリクエストする方法を示しています。

    curl "https://instance.service-now.com/api/now/sn_atf_tg/select_cloud_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"username\":\"<username of sys_user to set as cloud user>\"}" \ 
    --user "username:password"

応答本文は、クラウドユーザーがテストの実行と生成のために正常に選択されたことを示す成功メッセージを返します。

    { 
      "result": { 
        "message": "success" 
      } 
    }