翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CLI と SDKs AWS を使用したアダプターの管理
Rekognition では、事前トレーニングされたコンピュータビジョンモデルを活用した、複数の機能を利用できます。これらのモデルを使用すると、ラベル検出やコンテンツモデレーションなどのタスクを実行できます。また、こうした特定のモデルを、アダプターを使用してカスタマイズすることもできます。
Rekognition のプロジェクト作成およびプロジェクト管理 API ([CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html) や [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)) を使用すると、アダプターの作成およびトレーニングが行えます。以下のページでは、 API オペレーションを使用して、 AWS コンソール、選択した AWS SDK、または AWS CLI を使用してアダプターを作成、トレーニング、管理する方法について説明します。
アダプターをトレーニングした後は、サポートされている機能を使って推論を行う際にこれを使用できます。現在、アダプターはコンテンツモデレーション機能を使用するときにサポートされています。
AWS SDK を使用してアダプターをトレーニングするときは、グラウンドトゥルースラベル (画像注釈) をマニフェストファイルの形式で指定する必要があります。または、Rekognition コンソールを使用して、アダプターを作成しトレーニングすることもできます。
**注記**
アダプターはコピーできません。コピーできるのは、Rekognition Custom Labels のプロジェクトバージョンのみです。
**Topics**
+ [アダプターのステータス](#managing-adapters-project-versions-statuses)
+ [プロジェクトの作成](managing-adapters-create-project.md)
+ [プロジェクトの記述](managing-adapters-describe-projects.md)
+ [プロジェクトの削除](managing-adapters-delete-project.md)
+ [プロジェクトバージョンの作成](managing-adapters-create-project-version.md)
+ [プロジェクトバージョンの記述](managing-adapters-describe-project.md)
+ [プロジェクトバージョンの削除](managing-adapters-delete-project-version.md)
## アダプターのステータス
カスタムモデレーションアダプター (プロジェクトバージョン) は、以下のいずれかのステータスになります。
+ TRAINING\$1IN\$1PROGRESS - アダプターは、トレーニングドキュメントとして提供したファイルでトレーニング中です。
+ TRAINING\$1COMPLETED - トレーニングが正常に完了し、アダプターはパフォーマンスの確認準備ができています。
+ TRAINING\$1FAILED - アダプターは何らかの理由でトレーニングを完了できませんでした。失敗の原因について、出力マニフェストファイルと出力マニフェスト概要を確認してください。
+ DELETING - アダプターは削除中です。
+ DEPRECATED - アダプターはコンテンツモデレーション基本モデルの古いバージョンでトレーニングされています。猶予期間中であり、基本モデルの新しいバージョンのリリースから 60〜90 日以内に期限切れになります。猶予期間中も、アダプターを [DetectModerationLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectModerationLabels.html) または [StartMediaAnalysisJob](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartMediaAnalysisJob.html) API オペレーションで推論に使用できます。アダプターの有効期限については、「カスタムモデレーションコンソール」を参照してください。
+ EXPIRED - アダプターは、古いバージョンのコンテンツモデレーション基本モデルでトレーニングされており、DetectModerationLabels または StartMediaAnalysisJob API オペレーションでカスタム結果を取得するために使用できなくなりました。期限切れのアダプターを推論リクエストで指定した場合は無視され、代わりに最新バージョンのカスタムモデレーション基本モデルからレスポンスが返されます。
# プロジェクトの作成
[CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html) オペレーションでは、Rekognition のラベル検出オペレーション用のアダプターを含むプロジェクトを作成できます。プロジェクトとはリソースのグループであり、DetectModerationLabels のようなラベル検出オペレーションの場合、ベースの Rekognition モデルのカスタマイズに使用できるアダプターを、プロジェクトを使って保存できます。CreateProject を呼び出すときに、作成するプロジェクトの名前を、ProjectName 引数で指定します。
AWS コンソールを使用してプロジェクトを作成するには:
+ Rekognition コンソールにサインインします。
+ **[カスタムモデレーション]** をクリックします。
+ **[プロジェクトを作成]** を選択します。
+ **[新しいプロジェクトを作成]** または **[既存のプロジェクトに追加]** を選択します。
+ **[プロジェクト名]** を追加します。
+ **[アダプター名]** を追加します。
+ 必要に応じて説明を追加します。
+ トレーニングイメージのインポート方法 (マニフェストファイル、S3 バケットから、コンピュータから) を選択します。
+ トレーニングデータを自動分割するか、マニフェストファイルをインポートするか、いずれかを選択します。
+ プロジェクトを自動的に更新するか否かを選択します。
+ **[プロジェクトを作成]** をクリックします。
CLI と SDK AWS を使用してプロジェクトを作成するには:
1. まだインストールしていない場合は、 AWS CLI と AWS SDKs をインストールして設定します。詳細については、「[ステップ 2: AWS CLI と AWS SDKsを設定する](setup-awscli-sdk.md)」を参照してください。
1. 次のコードを実行してプロジェクトを作成します。
------
#### [ CLI ]
```
# Request
# Creating Content Moderation Project
aws rekognition create-project \
--project-name "project-name" \
--feature CONTENT_MODERATION \
--auto-update ENABLED
--profile profile-name
```
------
# プロジェクトの記述
[DescribeProjects](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjects.html) API を使用することで、プロジェクトに関する情報 (プロジェクトに関連付けられているすべてのアダプターに関する情報など) を取得できます。
CLI と SDK AWS を使用してプロジェクトを記述するには:
1. まだインストールしていない場合は、 CLI と AWS SDKs AWS をインストールして設定します。詳細については、「[ステップ 2: AWS CLI と AWS SDKsを設定する](setup-awscli-sdk.md)」を参照してください。
1. 次のコードを実行してプロジェクトを記述します。
------
#### [ CLI ]
```
# Request
# Getting CONTENT_MODERATION project details
aws rekognition describe-projects \
--features CONTENT_MODERATION
--profile profile-name
```
------
# プロジェクトの削除
プロジェクトは、Amazon Rekognition コンソールを使用するか、[DeleteProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProject.html) API を使用することで削除できます。プロジェクトを削除するには、先に、関連付けられたアダプターをすべて削除する必要があります。一度削除したプロジェクトまたはモデルは、元に戻せません。
AWS コンソールでプロジェクトを削除するには:
+ Rekognition コンソールにサインインします。
+ **[カスタムモデレーション]** をクリックします。
+ プロジェクト自体を削除するときは、先に、それに関連付けられたアダプターを削除する必要があります。プロジェクトに関連付けられているアダプターをすべて削除するには、アダプターを選択して **[削除]** を選択します。
+ プロジェクトを選択し、**[削除]** をクリックします。
CLI と SDK AWS を使用してプロジェクトを削除するには:
1. まだインストールしていない場合は、 CLI と AWS SDKs AWS をインストールして設定します。詳細については、「[ステップ 2: AWS CLI と AWS SDKsを設定する](setup-awscli-sdk.md)」を参照してください。
1. 次のコードを実行してプロジェクトを削除します。
------
#### [ CLI ]
```
aws rekognition delete-project
--project-arn project_arn \
--profile profile-name
```
------
# プロジェクトバージョンの作成
アダプターをデプロイ用にトレーニングするには、[CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html) オペレーションを使用します。CreateProjectVersion は、最初に、プロジェクトに関連付けられたアダプターの新しいバージョンを作成し、その後、アダプターのトレーニングを開始します。CreateProjectVersion のレスポンスは、当該モデルのバージョンの Amazon リソースネーム (ARN) です。トレーニングが完了するまでしばらく時間がかかります。現在のステータスは、DescribeProjectVersions を呼び出すことで確認できます。モデルをトレーニングするとき、Rekognition は、プロジェクトに関連付けられたトレーニングデータセットとテストデータセットを使用します。データセットはコンソールで作成できます。詳細については、データセットのセクションを参照してください。
Rekognition コンソールでプロジェクトを作成するには
+ AWS Rekognition コンソールにサインインします。
+ [カスタムモデレーション] をクリックします。
+ プロジェクトを選択します。
+ [プロジェクトの詳細] ページで、**[アダプターを作成]** を選択します。
+ [プロジェクトを作成] ページで、[プロジェクトの詳細]、[トレーニング画像]、[テスト画像] に必要な情報を入力し、**[プロジェクトを作成]** を選択します。
+ [画像にラベルを割り当てる] ページで、イメージにラベルを追加し、完了したら **[トレーニングを開始]** を選択します。
CLI と SDK AWS を使用してプロジェクトバージョンを作成するには:
1. まだインストールしていない場合は、 CLI と AWS SDKs AWS をインストールして設定します。詳細については、「[ステップ 2: AWS CLI と AWS SDKsを設定する](setup-awscli-sdk.md)」を参照してください。
1. 次のコードを実行してプロジェクトバージョンを作成します。
------
#### [ CLI ]
```
# Request
aws rekognition create-project-version \
--project-arn project-arn \
--training-data '{Assets=[GroundTruthManifest={S3Object="amzn-s3-demo-source-bucket",Name="manifest.json"}]}' \
--output-config S3Bucket=amzn-s3-demo-destination-bucket,S3KeyPrefix=my-results \
--feature-config "ContentModeration={ConfidenceThreshold=70}"
--profile profile-name
```
------
# プロジェクトバージョンの記述
プロジェクトに関連付けられているアダプターを一覧表示して記述するには、[DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions.html) オペレーションを使用します。ProjectVersionArns では最大 10 個のモデルバージョンを指定できます。値を指定しないと、プロジェクト内のすべてのモデルバージョンの説明が返されます。
CLI と SDK AWS を使用してプロジェクトバージョンを記述するには:
1. まだインストールしていない場合は、 CLI と AWS SDKs AWS をインストールして設定します。詳細については、「[ステップ 2: AWS CLI と AWS SDKsを設定する](setup-awscli-sdk.md)」を参照してください。
1. 次のコードを実行してプロジェクトバージョンを記述します。
------
#### [ CLI ]
```
aws rekognition describe-project-versions
--project-arn project_arn \
--version-names [versions]
```
------
# プロジェクトバージョンの削除
プロジェクトに関連付けられている Rekognition アダプターを削除するには、[DeleteProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectVersion.html) オペレーションを使用してます。実行中またはトレーニング中のアダプターは削除できません。アダプターのステータスを確認するには、DescribeProjectVersions オペレーションを呼び出し、そのオペレーションによって返されるステータスフィールドを確認します。実行中のアダプターを停止するには、StopProjectVersion を呼び出します。モデルがトレーニング中の場合は、トレーニングが終了した後に削除します。プロジェクト自体を削除するときは、先に、それに関連付けられたアダプターを削除する必要があります。
Rekognition コンソールでプロジェクトバージョンを削除するには
+ Rekognition コンソールにサインインします。
+ [カスタムモデレーション] をクリックします。
+ [プロジェクト] タブでは、すべてのプロジェクトと関連するアダプターを確認できます。アダプターを選択し、**[削除]** をクリックします。
CLI と SDK AWS を使用してプロジェクトバージョンを削除するには:
1. まだインストールしていない場合は、 CLI と AWS SDKs AWS をインストールして設定します。詳細については、「[ステップ 2: AWS CLI と AWS SDKsを設定する](setup-awscli-sdk.md)」を参照してください。
1. 次のコードを実行してプロジェクトバージョンを削除します。
------
#### [ CLI ]
```
# Request
aws rekognition delete-project-version
--project-version-arn model_arn \
--profile profile-name
```
------