

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

# データリポジトリタスクの使用
<a name="managing-data-repo-task"></a>

以下のセクションでは、データリポジトリタスクの管理に関する詳細情報について説明します。Amazon FSx コンソール、CLI、または API を使用して、データリポジトリタスクの作成、複製、詳細の表示、およびキャンセルを行うことができます。

**Topics**
+ [データリポジトリタスクの作成](creating-data-repo-task.md)
+ [タスクの複製](recreate-task.md)
+ [データリポジトリタスクへのアクセス](view-data-repo-tasks.md)
+ [データリポジトリタスクのキャンセル](cancel-data-repo-task.md)

# データリポジトリタスクの作成
<a name="creating-data-repo-task"></a>

Amazon FSx コンソール、CLI、または API を使用してデータリポジトリタスクを作成できます。タスクを作成したら、コンソール、CLI、または API を使用してタスクの進行状況とステータスを確認できます。

データリポジトリタスクには、次の 3 種類のデータリポジトリタスクを作成できます。
+ データリポジトリの **[エクスポート]** タスクは、Lustre ファイルシステムからリンクされた S3 バケットにエクスポートします。詳細については、「[データリポジトリのタスクを使用した変更のエクスポート](export-data-repo-task-dra.md)」を参照してください。
+ データリポジトリの **[インポート]** タスクは、リンクされた S3 バケットから Lustre ファイルシステムにインポートします。詳細については、「[データリポジトリのタスクを使用して変更をインポートする](import-data-repo-task-dra.md)」を参照してください。
+ データリポジトリの **[リリース]** タスクは、リンクされている S3 バケットにエクスポートされたファイルを Lustre ファイルシステムからリリースします。詳細については、「[データリポジトリタスクを使用してファイルをリリースする](release-files-task.md)」を参照してください。

# タスクの複製
<a name="recreate-task"></a>

Amazon FSx コンソールで、既存のデータリポジトリタスクを複製できます。タスクを複製すると、既存のタスクの正確なコピーが **インポートデータリポジトリタスクの作成** または **エクスポートデータリポジトリタスクの作成** ページに表示されます。新しいタスクを作成して実行する前に、必要に応じてエクスポートまたはインポートするパスを変更できます。

**注記**  
そのタスクの正確なコピーがすでに実行されている場合、重複タスクを実行するリクエストは失敗します。すでに実行されているタスクの正確なコピーには、エクスポートタスクの場合は同じファイルシステムパスが含まれ、インポートタスクの場合は同じデータリポジトリパスが含まれます。

タスクは、タスクの詳細ビュー、ファイルシステムの **[Data Repository]** (データリポジトリ) タブの **[Data Repository Tasks]** (データリポジトリタスク) ペイン、または **[Data Repository Tasks]** (データリポジトリタスク) ページから複製できます。

**既存のタスクを複製するには**

1. ファイルシステムの **[Data Repository]** (データリポジトリ) タブの **[Data Repository Tasks]** (データリポジトリタスク) ペインでタスクを選択します。

1. **[Duplicate task]** (タスクの複製) を選択します。選択したタスクのタイプに応じて、**インポートデータリポジトリの作成** タスクまたは **エクスポートデータリポジトリの作成** タスクページが表示されます。新しいタスクの設定はすべて、複製するタスクの設定と同じです。

1. インポート元またはエクスポート先のパスを変更または追加します。

1. **[Create]** (作成) を選択します。

# データリポジトリタスクへのアクセス
<a name="view-data-repo-tasks"></a>

データリポジトリタスクを作成したら、Amazon FSx コンソール、CLI、API を使用して、タスク、およびアカウント内のすべての既存のタスクにアクセスできます。Amazon FSx は、次の詳細なタスク情報を提供します。
+ 既存のすべてのタスク。
+ 特定のファイルシステムに関するすべてのタスク。
+ 特定のデータリポジトリ関連付けに関するすべてのタスク。
+ 特定のライフサイクルステータスを持つすべてのタスク。タスクのライフサイクルステータス値の詳細については、「[タスクのステータスと詳細を理解する](data-repo-task-status.md)」を参照してください。

以下に記載されているように、Amazon FSx コンソール、CLI、または API を使用して、アカウント内のすべての既存のデータリポジトリタスクにアクセスできます。

## データリポジトリのタスクとタスクの詳細を表示するには (コンソール)
<a name="access-all-tasks-console"></a>

1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。

1. ナビゲーションページで、データリポジトリタスクを表示するファイルシステムを選択します。ファイルシステムの詳細ページが表示されます。

1. ファイルシステムの詳細ページで、**[Data repository]** (データリポジトリ) タブを選択します。このファイルシステムのタスクはすべて、**[Data Repository Tasks]** (データリポジトリタスク) パネルに表示されます。

1. タスクの詳細を表示するには、**[データリポジトリタスク]** パネルで **[タスク ID]** または **[タスク名]** を選択します。タスクの詳細ページが表示されます。  
![\[データリポジトリタスクページ\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/LustreGuide/images/task-details-rprt.png)

## データリポジトリのタスクとタスクの詳細を取得するには (CLI)
<a name="task-details-cli"></a>

Amazon FSx [https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-data-repository-tasks.html](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-data-repository-tasks.html) CLI コマンドを使用すると、アカウント内のすべてのデータリポジトリタスクとその詳細を表示できます。[https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeDataRepositoryTasks.html](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeDataRepositoryTasks.html) は、同等の API コマンドです。
+ アカウント内のすべてのデータリポジトリタスクオブジェクトを確認するには、次のコマンドを使用します。

  ```
  aws fsx describe-data-repository-tasks
  ```

  コマンドが成功すると、Amazon FSx は JSON 形式でレスポンスを返します。

  ```
  {
      "DataRepositoryTasks": [
          {
              "Lifecycle": "EXECUTING",
              "Paths": [],
              "Report": {
                  "Path":"s3://dataset-01/reports",
                  "Format":"REPORT_CSV_20191124",
                  "Enabled":true,
                  "Scope":"FAILED_FILES_ONLY"
              },
              "StartTime": 1591863862.288,
              "EndTime": ,
              "Type": "EXPORT_TO_REPOSITORY",
              "Tags": [],
              "TaskId": "task-0123456789abcdef3",
              "Status": {
                  "SucceededCount": 4255,
                  "TotalCount": 4200,
                  "FailedCount": 55,
                  "LastUpdatedTime": 1571863875.289
              },
              "FileSystemId": "fs-0123456789a7",
              "CreationTime": 1571863850.075,
              "ResourceARN": "arn:aws:fsx:us-east-1:1234567890:task/task-0123456789abcdef3"
          },
          {
              "Lifecycle": "FAILED",
              "Paths": [],
              "Report": {
                  "Enabled": false,
              },
              "StartTime": 1571863862.288,
              "EndTime": 1571863905.292,
              "Type": "EXPORT_TO_REPOSITORY",
              "Tags": [],
              "TaskId": "task-0123456789abcdef1",
              "Status": {
                  "SucceededCount": 1153,
                  "TotalCount": 1156,
                  "FailedCount": 3,
                  "LastUpdatedTime": 1571863875.289
              },
              "FileSystemId": "fs-0123456789abcdef0",
              "CreationTime": 1571863850.075,
              "ResourceARN": "arn:aws:fsx:us-east-1:1234567890:task/task-0123456789abcdef1"
          },
          {
              "Lifecycle": "SUCCEEDED",
              "Paths": [],
              "Report": {
                  "Path":"s3://dataset-04/reports",
                  "Format":"REPORT_CSV_20191124",
                  "Enabled":true,
                  "Scope":"FAILED_FILES_ONLY"
              },
              "StartTime": 1571863862.288,
              "EndTime": 1571863905.292,
              "Type": "EXPORT_TO_REPOSITORY",
              "Tags": [],
              "TaskId": "task-04299453935122318",
              "Status": {
                  "SucceededCount": 258,
                  "TotalCount": 258,
                  "FailedCount": 0,
                  "LastUpdatedTime": 1771848950.012,
              },
              "FileSystemId": "fs-0123456789abcdef0",
              "CreationTime": 1771848950.012,
              "ResourceARN": "arn:aws:fsx:us-east-1:1234567890:task/task-0123456789abcdef0"
          }
      ]
  }
  ```

## ファイルシステムによるタスクの表示
<a name="view-tasks-by-fs"></a>

以下に記載されているように、Amazon FSx コンソール、CLI、または API を使用して、特定のファイルシステムのすべてのタスクを表示できます。

### ファイルシステム別にタスクを表示するには (コンソール)
<a name="tasks-by-fs-console"></a>

1. ナビゲーションペインで **[File systems]** (ファイルシステム) を選択します。**[File systems]** (ファイルシステム) ページが表示されます。

1. データリポジトリタスクを表示するファイルシステムを選択します。ファイルシステムの詳細ページが表示されます。

1. ファイルシステムの詳細ページで、**[Data repository]** (データリポジトリ) タブを選択します。このファイルシステムのタスクはすべて、**[Data Repository Tasks]** (データリポジトリタスク) パネルに表示されます。

### ファイルシステム別にタスクを取得するには (CLI)
<a name="task-by-fs-cli"></a>
+ 次のコマンドを使用して、ファイルシステム `fs-0123456789abcdef0` のすべてのデータリポジトリタスクを表示します。

  ```
  aws fsx describe-data-repository-tasks \
      --filters Name=file-system-id,Values=fs-0123456789abcdef0
  ```

  コマンドが成功すると、Amazon FSx は JSON 形式でレスポンスを返します。

  ```
  {
      "DataRepositoryTasks": [
          {
              "Lifecycle": "FAILED",
              "Paths": [],
              "Report": {
                  "Path":"s3://dataset-04/reports",
                  "Format":"REPORT_CSV_20191124",
                  "Enabled":true,
                  "Scope":"FAILED_FILES_ONLY"
              },
              "StartTime": 1571863862.288,
              "EndTime": 1571863905.292,
              "Type": "EXPORT_TO_REPOSITORY",
              "Tags": [],
              "TaskId": "task-0123456789abcdef1",
              "Status": {
                  "SucceededCount": 1153,
                  "TotalCount": 1156,
                  "FailedCount": 3,
                  "LastUpdatedTime": 1571863875.289
              },
              "FileSystemId": "fs-0123456789abcdef0",
              "CreationTime": 1571863850.075,
              "ResourceARN": "arn:aws:fsx:us-east-1:1234567890:task/task-0123456789abcdef1"
          },
          {
              "Lifecycle": "SUCCEEDED",
              "Paths": [],
              "Report": {
                  "Enabled": false,
              },
              "StartTime": 1571863862.288,
              "EndTime": 1571863905.292,
              "Type": "EXPORT_TO_REPOSITORY",
              "Tags": [],
              "TaskId": "task-0123456789abcdef0",
              "Status": {
                  "SucceededCount": 258,
                  "TotalCount": 258,
                  "FailedCount": 0,
                  "LastUpdatedTime": 1771848950.012,
              },
              "FileSystemId": "fs-0123456789abcdef0",
              "CreationTime": 1771848950.012,
              "ResourceARN": "arn:aws:fsx:us-east-1:1234567890:task/task-0123456789abcdef0"
          }
      ]
  }
  ```

# データリポジトリタスクのキャンセル
<a name="cancel-data-repo-task"></a>

データリポジトリタスクを、保留中または実行中状態のときにキャンセルできます。タスクをキャンセルすると、次のことが発生します。
+ Amazon FSx は、処理対象のキューにあるファイルを処理しません。
+ Amazon FSx は、現在処理中のファイルの処理を続行します。
+ Amazon FSx は、タスクが既に処理したファイルを元に戻せません。

## データリポジトリタスクをキャンセルするには (コンソール)
<a name="w2aac13c33c17c13b7b1"></a>

1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。

1. データリポジトリタスクをキャンセルするファイルシステムをクリックします。

1. **[Data Repository]** (データリポジトリ) タブを開き、下にスクロールして **データリポジトリタスク** パネルを表示します。

1. キャンセルしたいタスクの **[Task ID]** (タスク ID) または **[Task name]** (タスク名) を選択します。

1. **[Cancel task]** (タスクのキャンセル) を選択してタスクをキャンセルします。

1. タスク ID を入力して、キャンセルリクエストを確認します。

## データリポジトリタスクをキャンセルするには (CLI)
<a name="w2aac13c33c17c13b7b3"></a>

Amazon FSx [https://docs.aws.amazon.com/cli/latest/reference/fsx/cancel-data-repository-task.html](https://docs.aws.amazon.com/cli/latest/reference/fsx/cancel-data-repository-task.html) CLI コマンドを使用して、タスクをキャンセルします。[https://docs.aws.amazon.com/fsx/latest/APIReference/API_CancelDataRepositoryTask.html](https://docs.aws.amazon.com/fsx/latest/APIReference/API_CancelDataRepositoryTask.html) は、同等の API コマンドです。
+ 次のコマンドを使用して、データリポジトリのタスクをキャンセルします。

  ```
  aws fsx cancel-data-repository-task \
      --task-id task-0123456789abcdef0
  ```

  コマンドが成功すると、Amazon FSx は JSON 形式でレスポンスを返します。

  ```
  {
      "Status": "CANCELING",
      "TaskId": "task-0123456789abcdef0"
  }
  ```