

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

# Device Farm でのアーティファクトのダウンロード
<a name="artifacts"></a>

Device Farm では、レポート、ログファイル、画像などのアーティファクトを各実行テストで収集します。

テスト実行中に作成されたアーティファクトはダウンロードできます:

**ファイル**  
テスト実行中に生成されたファイル (例: Device Farm レポート)。詳細については、「[Device Farm でのテストレポートの表示](how-to-use-reports.md)」を参照してください。

**ログ**  
テスト実行の各テストの出力。

**スクリーンショット**  
テスト実行のテストごとに記録されるスクリーン画像。

![\[Workflow diagram showing Project, Run, Job (device), Test suite, and Test stages in AWS クラウド.\]](http://docs.aws.amazon.com/ja_jp/devicefarm/latest/developerguide/images/hierarchy.png)


## アーティファクトのダウンロード (コンソール)
<a name="artifacts-console"></a>

1. テスト実行のレポートページで、**[デバイス]** からモバイルデバイスを選択します。

1. ファイルをダウンロードするには、**[ファイル]** からいずれかを選択します。

1. テスト実行からログをダウンロードするには、**[ログ]** から **[ログをダウンロード]** を選択します。

1. スクリーンショットをダウンロードするには、**[スクリーンショット]** からスクリーンショットを選択します。

カスタムのテスト環境におけるアーティファクトのダウンロードの詳細については、「[カスタムテスト環境でのアーティファクトのダウンロード](using-artifacts-custom.md)」を参照してください。

## アーティファクトのダウンロード (AWS CLI)
<a name="artifacts-cli"></a>

を使用して AWS CLI 、テストランアーティファクトを一覧表示できます。

**Topics**
+ [ステップ 1: Amazon リソースネーム (ARN) を取得する](#artifacts-cli-step1)
+ [ステップ 2: アーティファクトをリストする](#artifacts-cli-step2)
+ [ステップ 3: アーティファクトをダウンロードする](#artifacts-cli-step3)

### ステップ 1: Amazon リソースネーム (ARN) を取得する
<a name="artifacts-cli-step1"></a>

アーティファクトは、実行、ジョブ、テストスイート、またはテストごとにリストできます。対応する ARN を指定する必要があります。この表は、各 AWS CLI リストコマンドの入力 ARN を示しています。


| AWS CLI コマンドを一覧表示する | 必須 ARN | 
| --- | --- | 
| list-projects | このコマンドは、すべてのプロジェクトを返し、ARN を必要としません。 | 
| list-runs | project | 
| list-jobs | run | 
| list-suites | job | 
| list-tests | suite | 

例えば、テスト ARN を見つけるには、テストスイート ARN を入力パラメータとして使用して **list-tests** を実行します。

例:

```
aws devicefarm list-tests –-arn arn:MyTestSuiteARN
```

この応答には、テストスイートにある各テストのテスト ARN が含まれます。

```
{
    "tests": [
        {
            "status": "COMPLETED",
            "name": "Tests.FixturesTest.testExample",
            "created": 1537563725.116,
            "deviceMinutes": {
                "unmetered": 0.0,
                "total": 1.89,
                "metered": 1.89
            },
            "result": "PASSED",
            "message": "testExample passed",
            "arn": "arn:aws:devicefarm:us-west-2:123456789101:test:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
            "counters": {
                "skipped": 0,
                "warned": 0,
                "failed": 0,
                "stopped": 0,
                "passed": 1,
                "errored": 0,
                "total": 1
            }
        }
    ]
}
```

### ステップ 2: アーティファクトをリストする
<a name="artifacts-cli-step2"></a>

 AWS CLI [list-artifacts](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-artifacts.html) コマンドは、ファイル、スクリーンショット、ログなどのアーティファクトのリストを返します。各アーティファクトには URL が含まれ、ファイルをダウンロードできます。
+ 実行、ジョブ、テストスイート、またはテスト ARN を指定して、**list-artifacts** を呼び出します。タイプ (ファイル、ログ、またはスクリーンショット) を指定します。

  この例は、各テストで使用できる各アーティファクトの ダウンロード用 URL を返します:

  ```
  aws devicefarm list-artifacts --arn arn:MyTestARN --type "FILE"
  ```

  この応答には、各アーティファクトのダウンロード用 URL が含まれます。

  ```
  {
      "artifacts": [
          {
              "url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
              "extension": "txt",
              "type": "APPIUM_JAVA_OUTPUT",
              "name": "Appium Java Output",
              "arn": "arn:aws:devicefarm:us-west-2:123456789101:artifact:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
          }
      ]
  }
  ```

### ステップ 3: アーティファクトをダウンロードする
<a name="artifacts-cli-step3"></a>
+ 前のステップの URL を使用して、アーティファクトをダウンロードします。この例では、**curl** を使用して、Android Appium Java 出力ファイルをダウンロードします:

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

## アーティファクトのダウンロード (API)
<a name="artifacts-api"></a>

Device Farm API の [[ListArtifacts]](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListArtifacts.html) メソッドは、ファイル、スクリーンショット、ログなどのアーティファクトのリストを返します。各アーティファクトには URL が含まれ、ファイルをダウンロードできます。

# カスタムテスト環境でのアーティファクトのダウンロード
<a name="using-artifacts-custom"></a>

カスタムテスト環境で、Device Farm は、カスタムレポート、ログファイル、画像などのアーティファクトを収集します。これらのアーティファクトは、テスト実行でデバイスごとに表示されます。

テスト実行中に作成されるこれらのアーティファクトはダウンロードできます:

**テスト仕様出力**  
テスト仕様 YAML ファイル内のコマンドの実行による出力。

**お客様のアーティファクト**  
テスト実行のアーティファクトを含む ZIP ファイル。テスト仕様 YAML ファイルの **[アーティファクト:]** セクションで構成されます。

**テスト仕様シェルスクリプト**  
YAML ファイルから作成される中間シェルスクリプト。このシェルスクリプトファイルはテスト実行で使用されるため、YAML ファイルのデバッグに使用できます。

**テスト仕様ファイル**  
テスト実行で使用される YAML ファイル。

詳細については、「[Device Farm でのアーティファクトのダウンロード](artifacts.md)」を参照してください。

![\[カスタムテスト環境でのオペレーションの Device Farm 階層\]](http://docs.aws.amazon.com/ja_jp/devicefarm/latest/developerguide/images/hierarchy.png)
