翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ストリーミングラベル付けジョブにデータを送信する
必要に応じて、入力マニフェストファイルを使用してラベル付けジョブを作成するときに、ストリーミングラベル付けジョブに入力データを送信できます。ラベル付けジョブが開始され、状態が InProgress
の場合、Amazon SNS 入力トピックと Amazon S3 イベント通知を使用して、新しいデータオブジェクトをラベル付けジョブにリアルタイムで送信できます。
ラベル付けジョブ 開始時にデータオブジェクトを送信する (1 回):
-
入力マニフェストファイルを使用する - 必要に応じて、ストリーミングラベル付けジョブを作成するときに、
ManifestS3Uri
で入力マニフェストファイルの Amazon S3 URI を指定できます。Ground Truth は、ラベル付けジョブが開始されるとすぐに、ラベル付けのために、マニフェストファイル内の各データオブジェクトをワーカーに送信します。詳細についてはマニフェストファイルを作成する (オプション)を参照してください。ストリーミングラベル付けジョブを作成するリクエストを送信すると、ステータスは
Initializing
になります。ラベル付けジョブがアクティブになると、状態はInProgress
に変わり、リアルタイムオプションを使用して、ラベル付け用に追加のデータオブジェクトを送信できます。
データオブジェクトをリアルタイムで送信する:
-
Amazon SNS メッセージを使用してデータオブジェクトを送信する - Amazon SNS メッセージを送信することで、Ground Truth の新しいデータオブジェクトをラベルに送信できます。このメッセージを Amazon SNS 入力トピックに送信します。このトピックは、ストリーミングラベル付けジョブの作成時に作成して指定します。詳細については、「Amazon SNS を使用してデータオブジェクトを送信する」を参照してください。
-
データオブジェクトを Amazon S3 バケットに配置して送信する - Amazon S3 バケットに新しいデータオブジェクトを追加するたびに、Ground Truth がそのオブジェクトをラベル処理するように促すことができます。これを行うには、バケットにイベント通知を追加して、新しいオブジェクトが追加されるたび (または作成されるたび) に、そのバケット Amazon SNS 入力トピックに通知します。詳細については、「Amazon S3 を使用してデータオブジェクトを送信する」を参照してください。このオプションは、テキスト分類や固有表現認識などのテキストベースのラベル付けジョブでは使用できません。
重要
Amazon S3 の設定を使用する場合は、入力データ設定と出力データに同じ Amazon S3 の場所を使用しないでください。ラベル付けジョブの作成時に、出力データの S3 プレフィックスを指定します。
Amazon SNS を使用してデータオブジェクトを送信する
Amazon Simple Notification Service (Amazon SNS) を使用して、ストリーミングラベル付けジョブにデータオブジェクトを送信できます。Amazon SNS は、エンドポイント (E メールアドレスや AWS Lambda 関数など) との間のメッセージの配信を調整および管理するウェブサービスです。Amazon SNS トピックは、2 つ以上のエンドポイント間の通信チャネルとして機能します。Amazon SNS を使用して、新しいデータオブジェクトを、InputConfig
の CreateLabelingJob
パラメータ SnsTopicArn
で指定したトピックに送信するか発行します。これらのメッセージの形式は、入力マニフェストファイルからの 1 行と同じです。
例えば、テキストを入力トピックに発行することで、アクティブなテキスト分類ラベル付けジョブにテキストの一部を送信できます。発行するメッセージは、次のようになります。
{"source": "Lorem ipsum dolor sit amet"}
新しいイメージオブジェクトをイメージ分類ラベル付けジョブに送信するには、メッセージは次のようになります。
{"source-ref": "s3://
amzn-s3-demo-bucket
/example-image.jpg"}
注記
カスタム重複排除 ID と重複排除キーを Amazon SNS メッセージに含めることもできます。詳細については重複メッセージの処理を参照してください。
Ground Truth がストリーミングラベル付けジョブを作成すると、Amazon SNS 入力トピックにサブスクライブされます。
Amazon S3 を使用してデータオブジェクトを送信する
1 つ以上の新しいデータオブジェクトを Amazon SNS イベント通知で設定された Amazon S3 バケットに配置することで、ストリーミングラベル付けジョブに送信できます。バケットに新しいオブジェクトが作成されるたびに、Amazon SNS 入力トピックに通知するイベントを設定できます。この同じ Amazon SNS 入力トピックを InputConfig
の CreateLabelingJob
パラメータ SnsTopicArn
で指定する必要があります。
Amazon SNS に通知を送信するように Amazon S3 バケットを設定すると、Ground Truth はテストイベント "s3:TestEvent"
を発行し、トピックが存在することと、指定した Amazon S3 バケットの所有者に、指定したトピックに対して発行するアクセス許可があることを確認します。ストリーミングラベル付けジョブを開始する前に、Amazon SNS と Amazon S3 の接続を設定することをお勧めします。これを行わない場合、このテストイベントがデータオブジェクトとして登録され、ラベル付けのために Ground Truth に送信されることがあります。
重要
Amazon S3 の設定を使用する場合は、入力データ設定と出力データに同じ Amazon S3 の場所を使用しないでください。ラベル付けジョブの作成時に、出力データの S3 プレフィックスを指定します。
イメージベースのラベル付けジョブでは、Ground Truth ですべての S3 バケットに CORS ポリシーがアタッチされている必要があります。詳細については入力イメージデータの CORS 要件を参照してください。
Amazon S3 バケットを設定し、ラベル付けジョブを作成したら、バケットにオブジェクトを追加できます。Ground Truth はそのオブジェクトをワーカーに送信するか、Amazon SQS キューに配置します。
詳細についてはラベル付けジョブで定義された Amazon SNS に基づいて Amazon S3 ベースのバケットイベント通知を作成する Amazon SNS を参照してください。
重要
このオプションは、テキスト分類や固有表現認識などのテキストベースのラベル付けジョブでは使用できません。