翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ヒューマンループを削除する
ヒューマンループを削除すると、ステータスが `Deleting` に変わります。ヒューマンループが削除されると、関連付けられている人間によるレビュータスクをワーカーが使用できなくなります。ヒューマンループは、次のいずれかの状況で削除できます。
+ ワーカーユーザーインターフェイスの生成に使用されるワーカータスクテンプレートが正しくレンダリングされないか、想定どおりに機能していない。
+ 1 つのデータオブジェクトが誤ってワーカーに複数回送信された。
+ 人間によってレビューされたデータオブジェクトが不要になった。
ヒューマンループのステータスが `InProgress` の場合、削除する前にヒューマンループを停止する必要があります。ヒューマンループを停止すると、停止中にステータスは `Stopping` に変わります。ステータスが `Stopped` に変わると、ヒューマンループを削除できます。
人間のワーカーがすでにタスクに取り組んでいる場合に関連するヒューマンループを停止しても、そのタスクは完了するか期限が切れるまで引き続き使用できます。ワーカーがタスクで作業している限り、ヒューマンループのステータスは `Stopping` になります。これらのタスクが完了すると、結果は人間によるレビューワークフローで指定された Amazon S3 バケット URI に保存されます。ワーカーが作業を送信せずにタスクを離れると、そのタスクは停止され、ワーカーがタスクに戻ることはできません。タスクの作業を開始しているワーカーがいない場合は、すぐに停止されます。
ヒューマンループの作成に使用した AWS アカウントを削除すると、自動的に停止および削除されます。
## ヒューマンループのデータ保持と削除
人間のワーカーがレビュータスクを完了すると、その結果は、ヒューマンループの作成に使用される人間によるレビューワークフローで指定した Amazon S3 出力バケットに保存されます。ヒューマンループを削除または停止しても、S3 バケットからワーカーの回答は削除されません。
また、Amazon A2I は次の理由によりヒューマンループの入出力データを内部で一時的に保存します。
+ 1 つのデータオブジェクトがレビュー用に複数のワーカーに送信されるようにヒューマンループを設定した場合、Amazon A2I はすべてのワーカーがレビュータスクを完了するまで S3 バケットに出力データを書き込みません。S3 バケットに完全な結果を書き込むため、Amazon A2I は部分的な回答 (個々のワーカーからの回答) を内部で保存します。
+ 品質が低い人間によるレビュー結果をレポートすると、Amazon A2I でその問題を調査して対応できます。
+ ヒューマンループの作成に使用した人間によるレビューワークフローで指定した出力 S3 バケットへのアクセスを失うか削除すると、タスクがすでに 1 人以上のワーカーに送信されている場合、Amazon A2I には人間によるレビュー結果を一時的に保存する場所が必要になります。
ヒューマンループのステータスが `Deleted`、`Stopped`、`Completed` のいずれかに変わってから 30 日後に、Amazon A2I はこのデータを内部で削除します。つまり、ヒューマンループが完了、停止、削除されてから 30 日後にデータが削除されます。さらに、関連するヒューマンループの作成に使用した AWS アカウントを閉鎖すると、このデータは 30 日後に削除されます。
## コンソールまたは Amazon A2I API を使用してフロー定義を停止または削除する
Augmented AI コンソールで、または SageMaker API を使用してヒューマンループを停止および削除できます。ヒューマンループが削除されると、ステータスが `Deleted` に変わります。
**ヒューマンループを削除する (コンソール)**
1. Augmented AI コンソール ([https://console.aws.amazon.com/a2i/](https://console.aws.amazon.com/a2i)) に移動します。
1. ナビゲーションペインの **[Augmented AI]** セクションで、**[Human review workflows]** (人間によるレビューワークフロー) を選択します。
1. 削除するヒューマンループの作成に使用した人間によるレビューワークフローのハイパーリンク名を選択します。
1. ページ下部にある **[Human loops]** (ヒューマンループ) セクションで、停止および削除するヒューマンループを選択します。
1. ヒューマンループのステータスが `Completed`、`Stopped`、`Failed` の場合、**[Delete]** (削除) を選択します。
ヒューマンループの **[Status]** (ステータス) が `InProgress` の場合、**[Stop]** (停止) を選択します。ステータスが **Stopped** (停止) に変わったら、**[Delete]** (削除) をクリックします。
**ヒューマンループ (API) を削除する**
1. Augmented AI ランタイム API オペレーション `[DescribeHumanLoop](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_DescribeHumanLoop.html)` を使用してヒューマンループのステータスを確認します。次の表で、このオペレーションの使用例を参照してください。
------
#### [ AWS SDK for Python (Boto3) ]
次の例では SDK for Python (Boto3) を使用して {{example-human-loop}} という名前のヒューマンループを記述します。詳細については、*AWS SDK for Python (Boto) API リファレンス*の「[describe\_human\_loop](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-a2i-runtime.html#AugmentedAIRuntime.Client.describe_human_loop)」を参照してください。
```
import boto3
a2i_runtime_client = boto3.client('sagemaker-a2i-runtime')
response = a2i_runtime_client.describe_human_loop(HumanLoopName='{{example-human-loop}}')
human_loop_status = response['HumanLoopStatus']
print(f'example-human-loop status is: {human_loop_status}')
```
------
#### [ AWS CLI ]
次の例では、 CLI AWS を使用して example{{example-human-loop}}という名前のヒューマンループを記述します。詳細については、*[AWS CLI コマンドリファレンス](https://docs.aws.amazon.com/cli/latest/reference/)*の「[describe-human-loop](https://docs.aws.amazon.com/cli/latest/reference/sagemaker-a2i-runtime/describe-human-loop.html)」を参照してください。
```
$ aws sagemaker-a2i-runtime describe-human-loop --human-loop-name '{{example-human-loop}}'
```
------
1. フロー定義のステータスが `Completed`、`Stopped`、`Failed` の場合、Augmented AI ランタイム API オペレーション `[DeleteHumanLoop](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_DeleteHumanLoop.html)` を使用してフロー定義を削除します。
------
#### [ AWS SDK for Python (Boto3) ]
次の例では SDK for Python (Boto3) を使用して {{example-human-loop}} という名前のヒューマンループを削除します。詳細については、*AWS SDK for Python (Boto) API リファレンス*の「[delete\_human\_loop](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-a2i-runtime.html#AugmentedAIRuntime.Client.delete_human_loop)」を参照してください。
```
import boto3
a2i_runtime_client = boto3.client('sagemaker-a2i-runtime')
response = a2i_runtime_client.delete_human_loop(HumanLoopName='{{example-human-loop}}')
```
------
#### [ AWS CLI ]
次の例では、 CLI AWS を使用して example{{example-human-loop}} という名前のヒューマンループを削除します。詳細については、*[AWS CLI コマンドリファレンス](https://docs.aws.amazon.com/cli/latest/reference/)*の「[delete-human-loop](https://docs.aws.amazon.com/cli/latest/reference/sagemaker-a2i-runtime/delete-human-loop.html)」を参照してください。
```
$ aws sagemaker-a2i-runtime delete-human-loop --human-loop-name '{{example-human-loop}}'
```
------
ヒューマンループのステータスが `InProgress` の場合、`[StopHumanLoop](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_StopHumanLoop.html)` を使用してヒューマンループを停止してから、`DeleteHumanLoop` を使用して削除します。
------
#### [ AWS SDK for Python (Boto3) ]
次の例では SDK for Python (Boto3) を使用して {{example-human-loop}} という名前のヒューマンループを記述します。詳細については、*AWS SDK for Python (Boto) API リファレンス*の「[stop\_human\_loop](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-a2i-runtime.html#AugmentedAIRuntime.Client.stop_human_loop)」を参照してください。
```
import boto3
a2i_runtime_client = boto3.client('sagemaker-a2i-runtime')
response = a2i_runtime_client.stop_human_loop(HumanLoopName='{{example-human-loop}}')
```
------
#### [ AWS CLI ]
次の例では、 CLI AWS を使用して example{{example-human-loop}}という名前のヒューマンループを記述します。詳細については、*[AWS CLI コマンドリファレンス](https://docs.aws.amazon.com/cli/latest/reference/)*の「[stop-human-loop](https://docs.aws.amazon.com/cli/latest/reference/sagemaker-a2i-runtime/stop-human-loop.html)」を参照してください。
```
$ aws sagemaker-a2i-runtime stop-human-loop --human-loop-name '{{example-human-loop}}'
```
------