翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
StartProjectVersion
モデルのバージョンの実行を開始します。モデルの開始が完了するまで少し時間がかかります。モデルの現在の状態を確認するには、DescribeProjectVersions。
モデルの実行後は、を呼び出して、新しいイメージのカスタムラベルを検出できます。DetectCustomLabels。
注記
モデルの実行時間に対して課金されます。モデルの実行を停止するには、StopProjectVersion。
このオペレーションには rekognition:StartProjectVersion アクションを実行するアクセス許可が必要です。
リクエストの構文
{
"MinInferenceUnits": number,
"ProjectVersionArn": "string"
}リクエストパラメータ
リクエストは以下の JSON 形式のデータを受け入れます。
- MinInferenceUnits
-
使用する推論ユニットの最小数。1 つの推論ユニットは 1 時間の処理を表し、最大 5 秒あたりのトランザクション (TPS) をサポートできます。大きい数値を使用すると、モデルの TPS スループットが向上します。使用する推論ユニットの数に対して課金されます。
Type: 整数
有効範囲: 最小値は 1 です。
: 必須 はい
- ProjectVersionArn
-
開始したいモデルバージョンの Amazon リソースネーム (ARN)。
Type: 文字列
長さの制約: 最小長は 20 です｡ 最大長は 2,048 です。
パターン:
(^arn:[a-z\d-]+:rekognition:[a-z\d-]+:\d{12}:project\/[a-zA-Z0-9_.\-]{1,255}\/version\/[a-zA-Z0-9_.\-]{1,255}\/[0-9]+$): 必須 はい
レスポンスの構文
{
"Status": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- Status
-
モデルの現在の実行ステータス。
Type: 文字列
有効な値:
TRAINING_IN_PROGRESS | TRAINING_COMPLETED | TRAINING_FAILED | STARTING | RUNNING | FAILED | STOPPING | STOPPED | DELETING
エラー
- AccessDeniedException
-
アクションを実行する権限がありません。
HTTP ステータスコード: 400
- InternalServerError
-
Amazon Rekognition でサービスの問題が発生しました。もう一度やり直してください。
HTTP ステータスコード: 500
- InvalidParameterException
-
入力パラメータが制約に違反しています。API オペレーションを再度呼び出す前にパラメータを検証します。
HTTP ステータスコード: 400
- LimitExceededException
-
Amazon Rekognition のサービスの制限を超えました。たとえば、Amazon Rekognition Video ジョブを同時に開始しすぎると、オペレーションの開始を呼び出します (
StartLabelDetection、例えば）が上げるLimitExceededExceptionの例外 (HTTP ステータスコード:400)。同時に実行されるジョブの数が Amazon Rekognition のサービスの制限を下回るまで、の例外 (HTTP ステータスコード:400) を受け取ります。HTTP ステータスコード: 400
- ProvisionedThroughputExceededException
-
お客様のスループット制限を超えたリクエストの数。この制限を引き上げる場合は、Amazon Rekognition までお問い合わせください。
HTTP ステータスコード: 400
- ResourceInUseException
-
指定されたリソースはすでに使用されています。
HTTP ステータスコード: 400
- ResourceNotFoundException
-
リクエストで指定されたリソースが見つかりません。
HTTP ステータスコード: 400
- ThrottlingException
-
Amazon Rekognition は一時的にリクエストを処理できませんでした。もう一度やり直してください。
HTTP ステータスコード: 500
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください：
