

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Device Farm でのテスト実行の作成
<a name="how-to-create-test-run"></a>

Device Farm コンソール AWS CLI、または Device Farm API を使用してテストランを作成できます。また、サポートされているプラグイン (例: Device Farm 用の Jenkins または Gradle プラグイン) も使用できます。プラグインの詳細については、「[ツールとプラグイン](aws-device-farm-tools-plugins.md)」を参照してください。実行に関しては、「[実行](test-runs.md)」を参照してください。

**Topics**
+ [前提条件](#how-to-create-test-run-prerequisites)
+ [テスト実行を作成 (コンソール)](#how-to-create-test-run-console)
+ [テスト実行を作成 (AWS CLI)](#how-to-create-test-run-cli)
+ [テスト実行を作成 (API)](#how-to-create-test-run-api)
+ [次の手順](#how-to-create-test-run-console-next-steps)

## 前提条件
<a name="how-to-create-test-run-prerequisites"></a>

Device Farm にプロジェクトが作成されている必要があります。「[AWS Device Farm でのプロジェクトの作成](how-to-create-project.md)」の指示に従ってから、このページに戻ります。

## テスト実行を作成 (コンソール)
<a name="how-to-create-test-run-console"></a>

1. [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm) で Device Farm コンソールにサインインします。

1. ナビゲーションペインで、 **[モバイルデバイスのテスト]** を選択し、そして次に、**[プロジェクト]** を選択します。

1. すでにプロジェクトがある場合は、テストをそのプロジェクトにアップロードできます。それ以外の場合は、**[新規プロジェクト]** を選択し、**[プロジェクト名]** を入力して、そして次に、**[作成]** を選択します。

1. プロジェクトを開き、**[実行を作成]** を選択します。

1. (オプション) **[実行設定]** の **[実行名]** セクションに、実行の名前を入力します。名前が指定されていない場合、Device Farm コンソールはデフォルトで実行に「My Device Farm run」という名前を付けます。

1. (オプション) **[実行設定]** の **[ジョブタイムアウト]** セクションで、テスト実行の実行タイムアウトを指定できます。無制限のテストスロットを使用している場合は、**[課金方法]** で **[計測対象外]** が選択されていることを確認します。

1. **[実行設定]** の **[実行タイプ]** セクションで、実行タイプを選択します。Android アプリをテストする準備が整っていない場合、または Android (.apk) アプリをテストする場合は、**[Android アプリ]** を選択します。iOS (.ipa) アプリをテストする場合は、**[iOS アプリ]** を選択します。ウェブアプリケーションをテストする場合は、**[ウェブアプリケーション]** を選択します。

1. **[アプリを選択]** の **[アプリの選択オプション]** セクションで、テストに使用できるアプリがない場合は、**[Device Farm が提供するサンプルアプリを選択]** を選択します。独自のアプリを持ち込む場合は、**[独自のアプリをアップロード]** を選択し、アプリケーションファイルを選択します。iOS アプリをアップロードする場合は、シミュレーターではなく、必ず **[iOS デバイス]** を選択してください。

1. **[テストを設定]** で、使用可能なテストフレームワークのいずれかを選択します。
**注記**  
利用可能なテストがない場合は、**[ビルトイン: ファズ]** を選択して、標準のビルトインテストスイートを実行します。**[ビルトイン: Fuzz]** を選択して、**[イベント数]**、**[イベント調整]**、および **[ランダマイザーシード]** ボックスが表示されたら、値を変更するか、そのままにしておくことができます。

   使用できるテストスイートの詳細については、「[AWS Device Farm のテストフレームワークと組み込みテスト](test-types.md)」を参照してください。

1. **[ビルトイン: Fuzz]** を選択しなかった場合は、**[テストパッケージを選択]** で **[ファイルを選択]** を選びます。テストが含まれているファイルを参照して選択します。

1. テスト環境では、**[標準環境でテストを実行]** または **[カスタム環境でテストを実行]** を選択します。詳細については、「[AWS Device Farm でのテスト環境](test-environments.md)」を参照してください。

1. カスタムテスト環境を使用している場合は、オプションで以下を実行できます。
   + カスタムのテスト環境でデフォルトのテスト仕様を編集する場合は、**[編集]** を選択して、デフォルトの YAML 仕様を更新します。
   + テスト仕様を変更した場合、**[新規として保存]** を選択し、それを更新します。
   + 環境変数を設定できます。ここで提供される変数は、親プロジェクトで設定できる変数よりも優先されます。

1. **[デバイスを選択]** で、次のいずれかを実行します。
   + ビルトインのデバイスプールを選択して **[デバイスプール]** に対してテストを実行するには、**[上位デバイス]** を選択します。
   + 独自のデバイスプールを作成してそのテストを実行するには、「[デバイスプールの作成](how-to-create-device-pool.md)」の手順に従って操作を行った後、このページに戻ります。
   + **[デバイスプール]** ですでに独自のデバイスプールを作成した場合は、自分のデバイスプールを選択します。
   + **[デバイスを手動で選択]** を選択し、実行したいデバイスを選択します。この設定は保存されません。

   詳細については、「[AWS Device Farm でのデバイスサポートデバイス](devices.md)」を参照してください。

1. (オプション) 設定を追加するには、**[追加設定]** ドロップダウンを開きます。このセクションで、次のいずれかの方法を実行できます。
   + 実行ロール ARN を指定するか、親プロジェクトで設定された実行ロール ARN を上書きするには、実行ロール ARN フィールドを使用します。
   + 実行中に Device Farm が使用する他のデータを提供するには、**[別途データを追加]** の横の **[ファイルを選択** を選択後、データが含まれる .zip ファイルを参照して選択します。
   + 実行中に Device Farm が使用する追加のアプリケーションをインストールするには、**[他のアプリをインストール]** の横の **[ファイルを選択]** を選択し、アプリを含む .apk または .ipa ファイルを参照して選択します。インストールする他のアプリケーションにもこの手順を繰り返します。インストール順序を変更するには、アップロードした後にアプリケーションをドラッグアンドドロップします。
   + 実行中に Wi-Fi、Bluetooth、GPS、または NFC を有効にするかどうか指定するには、**[無線状態を設定]** の横にある適切なボックスを選択します。
   + 実行用のデバイスの緯度と経度をプリセットするには、**[デバイスの場所]** の横に座標を入力します。
   + 実行用のデバイスロケールをプリセットするには、**[デバイスロケール]** でロケールを選択します。
   + テスト中に動画を記録にするには、**[録画を有効化]** を選択します。
   + デバイスのパフォーマンスデータをキャプチャするには、**[アプリケーションのパフォーマンスデータキャプチャを有効化]** を選びます。
**注記**  
デバイスの無線状態とロケールの設定は、現時点では Android ネイティブテストでのみ使用できます。
**注記**  
プライベートデバイスがある場合は、[プライベートデバイス専用の構成] も表示されます。

1. ページの下部で、**[実行を作成]** を選択して実行をスケジュールします。

Device Farm は、デバイスが利用可能になると、通常数分以内に実行を開始します。テスト実行中、Device Farm コンソールが実行テーブルに保留中アイコン ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/ja_jp/devicefarm/latest/developerguide/images/df-run-calendar.png) を表示します。実行中の各デバイスも保留中アイコンで起動し、テストが開始されると実行中アイコン ![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/ja_jp/devicefarm/latest/developerguide/images/df-run-progress.png) に切り替わります。各テストが終了すると、テスト結果アイコンがデバイス名の横に表示されます。すべてのテストが完了すると、実行の横にある保留中アイコンがテスト結果アイコンに変わります。

テスト実行を停止したい場合は、「[AWS Device Farm での実行の停止](how-to-stop-test-runs.md)」を参照してください。

## テスト実行を作成 (AWS CLI)
<a name="how-to-create-test-run-cli"></a>

を使用してテストラン AWS CLI を作成できます。

**Topics**
+ [ステップ 1: プロジェクトを選択する](#how-to-create-test-run-cli-step1)
+ [ステップ 2: デバイスプールを選択する](#how-to-create-test-run-cli-step2)
+ [ステップ 3: アプリケーションファイルをアップロードする](#how-to-create-test-run-cli-step3)
+ [ステップ 4: テストスクリプトパッケージをアップロードする](#how-to-create-test-run-cli-step4)
+ [ステップ 5: (オプション) カスタムテスト仕様をアップロードする](#how-to-create-test-run-cli-step5)
+ [ステップ 6: テスト実行をスケジュール設定する](#how-to-create-test-run-cli-step6)

### ステップ 1: プロジェクトを選択する
<a name="how-to-create-test-run-cli-step1"></a>

テスト実行は Device Farm プロジェクトに関連付ける必要があります。

1. Device Farm プロジェクトを一覧表示するには、**list-projects** を実行します。プロジェクトがない場合は、「[AWS Device Farm でのプロジェクトの作成](how-to-create-project.md)」を参照してください。

   例:

   ```
   aws devicefarm list-projects
   ```

   このレスポンスには、Device Farm プロジェクトのリストが含まれています。

   ```
   {
       "projects": [
           {
               "name": "MyProject",
               "arn": "arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
               "created": 1503612890.057
           }
       ]
   }
   ```

1. プロジェクトを選択してテスト実行を関連付け、その Amazon Reソース Name (ARN) を書き留めます。

### ステップ 2: デバイスプールを選択する
<a name="how-to-create-test-run-cli-step2"></a>

デバイスプールを選択して、テスト実行を関連付ける必要があります。

1. デバイスプールを表示するには、プロジェクト ARN を指定して **list-device-pools** を実行します。

   例:

   ```
   aws devicefarm list-device-pools --arn arn:MyProjectARN
   ```

   このレスポンスには、ビルトイン Device Farm デバイスプール (例: **Top Devices** や、このプロジェクト用に以前作成したデバイスプール) が含まれます。

   ```
   {
       "devicePools": [
           {
               "rules": [
                   {
                       "attribute": "ARN",
                       "operator": "IN",
                       "value": "[\"arn:aws:devicefarm:us-west-2::device:example1\",\"arn:aws:devicefarm:us-west-2::device:example2\",\"arn:aws:devicefarm:us-west-2::device:example3\"]"
                   }
               ],
               "type": "CURATED",
               "name": "Top Devices",
               "arn": "arn:aws:devicefarm:us-west-2::devicepool:example",
               "description": "Top devices"
           },
           {
               "rules": [
                   {
                       "attribute": "PLATFORM",
                       "operator": "EQUALS",
                       "value": "\"ANDROID\""
                   }
               ],
               "type": "PRIVATE",
               "name": "MyAndroidDevices",
               "arn": "arn:aws:devicefarm:us-west-2:605403973111:devicepool:example2"
           }
       ]
   }
   ```

1. デバイスプールを選択し、その ARN を書き留めておきます。

   また、デバイスプールを作成し、その後、このステップに戻ることもできます。詳細については、「[デバイスプールを作成する (AWS CLI)](how-to-create-device-pool.md#how-to-create-device-pool-cli)」を参照してください。

### ステップ 3: アプリケーションファイルをアップロードする
<a name="how-to-create-test-run-cli-step3"></a>

アップロードリクエストを作成し、Amazon Simple Storage Service (Amazon S3) の署名付きアップロード URL を取得するには、以下が必要です:
+ プロジェクト ARN。
+ アプリケーションファイルの名前。
+ アップロードのタイプ。

詳細については、「[https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-upload.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-upload.html)」を参照してください。

1. ファイルをアップロードするには、`–-project-arn`、`--name`、および `--type` パラメータにより、**create-upload** を実行します。

   この例では、Android アプリケーション用のアップロードを作成します:

   ```
   aws devicefarm create-upload -–project-arn arn:MyProjectArn -–name MyAndroid.apk -–type ANDROID_APP
   ```

   このレスポンスには、アプリケーションアップロード ARN と署名付き URL が含まれます。

   ```
   {
       "upload": {
           "status": "INITIALIZED",
           "name": "MyAndroid.apk",
           "created": 1535732625.964,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
           "type": "ANDROID_APP",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
       }
   }
   ```

1. アプリケーションアップロード ARN と署名付き URL を書き留めます。

1. Amazon S3 の署名付き URL を使用してアプリケーションファイルをアップロードします。この例では、**curl** を使用して、Android .apk ファイルをアップロードします:

   ```
   curl -T MyAndroid.apk "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
   ```

   詳細については、「*Amazon Simple Storage Service ユーザーガイド*」の「[署名付き URL を使用したオブジェクトのアップロード](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PresignedUrlUploadObject.html)」を参照してください。

1. アプリケーションアップロードのステータスを確認するには、**get-upload** を実行し、アプリアップロードの ARN を指定します。

   ```
   aws devicefarm get-upload –-arn arn:MyAppUploadARN
   ```

   レスポンスのステータスが **SUCCEEDED** になるまで待ってから、テストスクリプトパッケージをアップロードします。

   ```
   {
       "upload": {
           "status": "SUCCEEDED",
           "name": "MyAndroid.apk",
           "created": 1535732625.964,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL", 
           "type": "ANDROID_APP",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
           "metadata": "{"valid": true}"
       }
   }
   ```

### ステップ 4: テストスクリプトパッケージをアップロードする
<a name="how-to-create-test-run-cli-step4"></a>

次に、テストスクリプトパッケージをアップロードします。

1. アップロードリクエストを作成し、Amazon S3 の署名付きアップロード URL を取得するには、`–-project-arn`、`--name`、および `--type` パラメータを使用して **create-upload** を実行します。

   この例では、Appium Java TestNG テストパッケージアップロードを作成します:

   ```
   aws devicefarm create-upload –-project-arn arn:MyProjectARN -–name MyTests.zip –-type APPIUM_JAVA_TESTNG_TEST_PACKAGE
   ```

   このレスポンスには、テストパッケージのアップロード ARN および署名付き URL が含まれます。

   ```
   {
       "upload": {
           "status": "INITIALIZED",
           "name": "MyTests.zip",
           "created": 1535738627.195,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
           "type": "APPIUM_JAVA_TESTNG_TEST_PACKAGE",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
       }    
   }
   ```

1. テストパッケージアップロード ARN と署名付き URL を書き留めます。

1. Amazon S3 の署名付き URL を使用して、テストスクリプトパッケージファイルをアップロードします。この例では、**curl** を使用して、圧縮された TestNG スクリプトファイルをアップロードします:

   ```
   curl -T MyTests.zip "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
   ```

1. テストスクリプトパッケージアップロードのステータスを確認するには、**get-upload** を実行し、ステップ 1 からテストパッケージアップロード ARN を指定します。

   ```
   aws devicefarm get-upload –-arn arn:MyTestsUploadARN
   ```

   レスポンスのステータスが **SUCCEEDED** となるまで待ってから、次のオプションのステップに進みます。

   ```
   {
       "upload": {
           "status": "SUCCEEDED",
           "name": "MyTests.zip",
           "created": 1535738627.195,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL", 
           "type": "APPIUM_JAVA_TESTNG_TEST_PACKAGE",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
           "metadata": "{"valid": true}"
       }
   }
   ```

### ステップ 5: (オプション) カスタムテスト仕様をアップロードする
<a name="how-to-create-test-run-cli-step5"></a>

標準のテスト環境でテストを実行している場合、このステップはスキップします。

Device Farm では、サポートされているテストタイプごとに、デフォルトのテスト仕様ファイルを保持しています。次に、デフォルトのテスト仕様をダウンロードし、カスタムのテスト環境でテストを実行するために必要なカスタムテスト仕様アップロードを作成します。詳細については、「[AWS Device Farm でのテスト環境](test-environments.md)」を参照してください。

1. デフォルトのテスト仕様のアップロード ARN を検索するには、**list-uploads** を実行してプロジェクト ARN を指定します。

   ```
   aws devicefarm list-uploads --arn arn:MyProjectARN
   ```

   このレスポンスには、デフォルトのテスト仕様ごとのエントリが含まれます:

   ```
   {
       "uploads": [
           {
   
               {
                   "status": "SUCCEEDED",
                   "name": "Default TestSpec for Android Appium Java TestNG",
                   "created": 1529498177.474,
                   "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL", 
                   "type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
                   "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
               }
           }
       ]
   }
   ```

1. リストからデフォルトのテスト仕様を選択します。アップロード ARN を書き留めます。

1. デフォルトのテスト仕様をダウンロードするには、アップロード ARN を指定して **get-upload** を実行します。

   例:

   ```
   aws devicefarm get-upload –-arn arn:MyDefaultTestSpecARN
   ```

   このレスポンスには、デフォルトのテスト仕様をダウンロードできる署名付き URL が含まれます。

1. この例では、**curl** を使用してデフォルトのテスト仕様をダウンロードし、`MyTestSpec.yml` という名前で保存します:

   ```
   curl "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL" > MyTestSpec.yml
   ```

1. デフォルトのテスト仕様を編集して、テスト要件を満たします。以降のテスト実行では変更後のテスト仕様を使用します。このステップをスキップして、デフォルトのテスト仕様をカスタムのテスト環境でそのまま使用します。

1. カスタムのテスト仕様のアップロードを作成するには、テスト仕様名、テスト仕様タイプ、およびプロジェクト ARN を指定して、**create-upload** を実行します。

   この例では、Appium Java TestNG のカスタムテスト仕様のアップロードを作成します:

   ```
   aws devicefarm create-upload --name MyTestSpec.yml --type APPIUM_JAVA_TESTNG_TEST_SPEC --project-arn arn:MyProjectARN
   ```

   このレスポンスには、テスト仕様のアップロード ARN および署名付き URL が含まれます:

   ```
   {
       "upload": {
           "status": "INITIALIZED",
           "category": "PRIVATE",
           "name": "MyTestSpec.yml",
           "created": 1535751101.221,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL", 
           "type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
       }
   }
   ```

1. テスト仕様のアップロード ARN と署名付き URL を書き留めます。

1. Amazon S3 の署名付き URL を使用してテスト仕様ファイルをアップロードします。この例では、**curl** を使用して、Appium JavaTestNG テスト仕様をアップロードします:

   ```
   curl -T MyTestSpec.yml "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
   ```

1. テスト仕様アップロードのステータスを確認するには、**get-upload** を実行し、アップロードの ARN を指定します。

   ```
   aws devicefarm get-upload –-arn arn:MyTestSpecUploadARN
   ```

   レスポンスのステータスが **SUCCEEDED** になるまで待ってから、テスト実行のスケジュール設定を行います。

   ```
   {
       "upload": {
           "status": "SUCCEEDED",
           "name": "MyTestSpec.yml",
           "created": 1535732625.964,
           "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL", 
           "type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
           "arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
           "metadata": "{"valid": true}"
       }
   }
   ```

   カスタムのテスト仕様をアップデートするには、このテスト仕様のアップロード ARN を指定して、**update-upload** を実行します。詳細については、「[https://docs.aws.amazon.com/cli/latest/reference/devicefarm/update-upload.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/update-upload.html)」を参照してください。

### ステップ 6: テスト実行をスケジュール設定する
<a name="how-to-create-test-run-cli-step6"></a>

を使用してテスト実行をスケジュールするには AWS CLI、以下を指定して **schedule-run**を実行します。
+ [ステップ 1](#how-to-create-test-run-cli-step1) からのプロジェクト ARN。
+ [ステップ 2](#how-to-create-test-run-cli-step2) からのデバイスプール ARN。
+ [ステップ 3](#how-to-create-test-run-cli-step3) からのアプリケーションアップロード ARN。
+ [ステップ 4](#how-to-create-test-run-cli-step4) からのテストパッケージアップロード ARN。

 カスタムテスト環境でテストを実行している場合は、[ステップ 5](#how-to-create-test-run-cli-step5) からのテスト仕様 ARN も必要です。

**標準のテスト環境での実行をスケジュール設定するには**
+ プロジェクト ARN、デバイスプール ARN、アプリケーションアップロード ARN、テストパッケージ情報を指定して、**schedule-run** を実行します。

  例:

  ```
  aws devicefarm schedule-run --project-arn arn:MyProjectARN --app-arn arn:MyAppUploadARN --device-pool-arn arn:MyDevicePoolARN --name MyTestRun --test type=APPIUM_JAVA_TESTNG,testPackageArn=arn:MyTestPackageARN
  ```

  このレスポンスには、テスト実行のステータスの確認に使用する実行 ARN が含まれます。

  ```
  {
      "run": {
          "status": "SCHEDULING",
          "appUpload": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345appEXAMPLE",
          "name": "MyTestRun",
          "radios": {
              "gps": true,
              "wifi": true,
              "nfc": true,
              "bluetooth": true
          },
          "created": 1535756712.946,
          "totalJobs": 179,
          "completedJobs": 0,
          "platform": "ANDROID_APP",
          "result": "PENDING",
          "devicePoolArn": "arn:aws:devicefarm:us-west-2:123456789101:devicepool:5e01a8c7-c861-4c0a-b1d5-12345devicepoolEXAMPLE",
          "jobTimeoutMinutes": 150,
          "billingMethod": "METERED",
          "type": "APPIUM_JAVA_TESTNG",
          "testSpecArn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345specEXAMPLE",
          "arn": "arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-12345runEXAMPLE",
          "counters": {
              "skipped": 0,
              "warned": 0,
              "failed": 0,
              "stopped": 0,
              "passed": 0,
              "errored": 0,
              "total": 0
          }
      }
  }
  ```

  詳細については、「[https://docs.aws.amazon.com/cli/latest/reference/devicefarm/schedule-run.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/schedule-run.html)」を参照してください。

**カスタムテスト環境での実行をスケジュール設定するには**
+ ステップは、`--test` パラメータの追加 `testSpecArn` 属性を伴い、標準テスト環境用のステップとほとんど同じです。

  例:

  ```
  aws devicefarm schedule-run --project-arn arn:MyProjectARN --app-arn arn:MyAppUploadARN --device-pool-arn arn:MyDevicePoolARN --name MyTestRun --test testSpecArn=arn:MyTestSpecUploadARN,type=APPIUM_JAVA_TESTNG,testPackageArn=arn:MyTestPackageARN
  ```

**テスト実行のステータスを確認するには**
+ **get-run** コマンドを使い、以下の実行 ARN を指定します:

  ```
  aws devicefarm get-run --arn arn:aws:devicefarm:us-west-2:111122223333:run:5e01a8c7-c861-4c0a-b1d5-12345runEXAMPLE
  ```

詳細については、「[https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html)」を参照してください。で Device Farm を使用する方法については AWS CLI、「」を参照してください[AWS CLI リファレンス](cli-ref.md)。

## テスト実行を作成 (API)
<a name="how-to-create-test-run-api"></a>

手順は、 AWS CLI 「」セクションで説明されている手順と同じです。「[テスト実行を作成 (AWS CLI)](#how-to-create-test-run-cli)」を参照してください。

以下の情報は、[https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ScheduleRun.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ScheduleRun.html) API を呼び出すために必要です:
+ プロジェクト ARN。「[プロジェクトを作成する (API)](how-to-create-project.md#how-to-create-project-api)」および「[https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateProject.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateProject.html)」を参照してください。
+ アプリケーションアップロード ARN。「[https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html)」を参照してください。
+ テストパッケージアップロード ARN。[https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html) を参照してください。
+ デバイスプール ARN。「[デバイスプールの作成](how-to-create-device-pool.md)」および「[https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html)」を参照してください。

**注記**  
カスタムのテスト環境でテストを実行している場合は、テスト仕様アップロード ARN も必要です。詳細については、「[ステップ 5: (オプション) カスタムテスト仕様をアップロードする](#how-to-create-test-run-cli-step5)」および「[https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html)」を参照してください。

Device Farm APIの使用についての詳細は、「[Device Farm の自動化](api-ref.md)」を参照してください。

## 次の手順
<a name="how-to-create-test-run-console-next-steps"></a>

Device Farm コンソールでテスト実行が完了すると、クロックアイコン ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/ja_jp/devicefarm/latest/developerguide/images/df-run-calendar.png) が成功などの結果アイコン ![\[The test succeeded.\]](http://docs.aws.amazon.com/ja_jp/devicefarm/latest/developerguide/images/df-run-success.png) に変わります。テストが完了した時点で実行のレポートが表示されます。詳細については、「[AWS Device Farm でのレポートレポート](reports.md)」を参照してください。

レポートを使用するには、「[Device Farm でのテストレポートの表示](how-to-use-reports.md)」の手順に従います。