翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
StartLabelDetection
保存した動画内のラベルの非同期検出を開始します。
Amazon Rekognition Video では、動画内のラベルを検出できます。ラベルは、実世界のエンティティのインスタンスです。これには、花、木、テーブルなどのオブジェクト、結婚式、卒業、誕生日パーティーなどのイベント、風景、夕方、自然などの概念、車から降りる人やスキーなどのアクティビティが含まれます。
ビデオは Amazon S3 バケットに保存されている必要があります。を使用するVideoをクリックして動画のバケット名とファイル名を指定します。StartLabelDetectionジョブ識別子を返します (JobId) を使用すると、オペレーションの結果を取得できます。ラベルの検出が完了すると、Amazon Rekognition Video は、「」で指定した Amazon 簡易通知サービスのトピックに完了ステータスを公開します。NotificationChannel。
ラベル検出操作の結果を取得するには、まず Amazon SNS トピックに発行されたステータス値がSUCCEEDED。もしそうなら、電話してくださいGetLabelDetectionジョブ識別子を渡します (JobId) の最初の呼び出しからStartLabelDetection。
リクエストの構文
{
"ClientRequestToken": "string",
"JobTag": "string",
"MinConfidence": number,
"NotificationChannel": {
"RoleArn": "string",
"SNSTopicArn": "string"
},
"Video": {
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
}リクエストパラメータ
リクエストは以下の JSON 形式のデータを受け入れます。
- ClientRequestToken
-
開始リクエストを識別するために使用されるべき等トークン。同じトークンを複数で使用する場合
StartLabelDetectionリクエスト、同じJobIdが返されます。を使用するClientRequestToken同じジョブが誤って複数回開始されないようにするためです。Type: 文字列
長さの制約: 最小長は 1 です｡ 最大長は 64 です。
パターン:
^[a-zA-Z0-9-_]+$: 必須 いいえ
- JobTag
-
Amazon 簡易通知サービスのトピックに公開される完了通知で返される、指定した識別子。例えば、次を使用できます。
JobTag関連するジョブをグループ化し、完了通知で特定します。Type: 文字列
長さの制約: 最小長は 1 です｡ 最大長は 256 です。
パターン:
[a-zA-Z0-9_.\-:]+: 必須 いいえ
- MinConfidence
-
検出されたラベルを返すために Amazon Rekognition Video が必要とする最低限の信頼度を指定します。信頼度は、ラベルが正しく識別されていることの Amazon Rekognition がどの程度あるかを表します。0 は最低の信頼度です。100 が最も高い信頼度です。Amazon Rekognition Video は、この指定された値よりも低い信頼水準のラベルを返しません。
指定しない場合
MinConfidenceの場合、信頼値が 50% 以上のラベルが返されます。Type: 浮動小数点
有効範囲: 最小値は 0 です。最大値は 100 です。
: 必須 いいえ
- NotificationChannel
-
Amazon Rekognition Video でラベル検出操作の完了ステータスを公開する Amazon SNS トピック ARN。Amazon SNS トピックには、で始まるトピック名が必要です。AmazonRekognitionAmazonRekognitionServiceRole アクセス権限ポリシーを使用している場合。
型: NotificationChannel オブジェクト
: 必須 いいえ
- Video
-
ラベルを検出するビデオ。ビデオは Amazon S3 バケットに保存されている必要があります。
型: Video オブジェクト
: 必須 はい
レスポンスの構文
{
"JobId": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- JobId
-
ラベル検出ジョブの識別子。を使用する
JobId以降の呼び出しでジョブを識別するにはGetLabelDetection。Type: 文字列
長さの制約: 最小長は 1 です｡ 最大長は 64 です。
パターン:
^[a-zA-Z0-9-_]+$
エラー
- AccessDeniedException
-
アクションを実行する権限がありません。
HTTP ステータスコード: 400
- IdempotentParameterMismatchException
-
ある
ClientRequestToken入力パラメータがオペレーションに再利用されましたが、他の入力パラメータの少なくとも 1 つが、オペレーションに対する前回の呼び出しとは異なります。HTTP ステータスコード: 400
- InternalServerError
-
Amazon Rekognition でサービスの問題が発生しました。もう一度やり直してください。
HTTP ステータスコード: 500
- InvalidParameterException
-
入力パラメータが制約に違反しています。API オペレーションを再度呼び出す前にパラメータを検証します。
HTTP ステータスコード: 400
- InvalidS3ObjectException
-
Amazon Rekognition は、リクエストで指定された S3 オブジェクトにアクセスできません。
HTTP ステータスコード: 400
- LimitExceededException
-
Amazon Rekognition サービスの制限を超えました。たとえば、Amazon Rekognition Video ジョブを同時に開始しすぎると、オペレーションの開始を呼び出します (
StartLabelDetection、例えば）が上げるLimitExceededExceptionの例外 (HTTP ステータスコード:400) を同時に実行するジョブの数が Amazon Rekognition のサービスの制限を下回るまで、HTTP ステータスコード: 400
- ProvisionedThroughputExceededException
-
お客様のスループット制限を超えたリクエストの数。この上限を引き上げる場合は、Amazon Rekognition にお問い合わせください。
HTTP ステータスコード: 400
- ThrottlingException
-
Amazon Rekognition は一時的にリクエストを処理できませんでした。もう一度やり直してください。
HTTP ステータスコード: 500
- VideoTooLargeException
-
指定されたメディアのファイルサイズが大きすぎるか、時間が長すぎます。最大ファイルサイズは 10 GB です。最大期間は6時間です。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください：
