StartProjectVersion - Amazon Rekognition

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

StartProjectVersion

モデルのバージョンの実行を開始します。モデルの起動が完了するまでに時間がかかる場合があります。モデルの現在の状態を確認するには、以下を使用します。 DescribeProjectVersions

モデルが実行されたら、新しいイメージのカスタムラベルを検出するには、 DetectCustomLabels

注記

モデルの実行時間に対して課金されます。実行中のモデルを停止するには StopProjectVersion

このオペレーションには rekognition:StartProjectVersion アクションを実行するアクセス許可が必要です。

リクエストの構文

{ "MinInferenceUnits": number, "ProjectVersionArn": "string" }

リクエストパラメータ

リクエストは以下のデータを JSON 形式で受け入れます。

MinInferenceUnits

使用する推定単位の最小数。1 つの推論単位は 1 時間の処理を表し、最大 5 つのトランザクション/秒 (TPS) をサポートできます。モデルの TPS スループットを向上させるには、大きい値を使用します。推論単位の数に対して課金されます。

Type: 整数

有効範囲: 最小値は 1 です。

必須: はい

ProjectVersionArn

起動するモデルバージョンの Amazon リソースネーム (ARN)。

Type: 文字列

長さの制限: 最小長は 20 です。 最大長は 2048 です。

Pattern: (^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

Errors

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

以下の資料も参照してください。

言語固有の API のいずれかでこの API を使用する方法の詳細については、AWSSDK については、以下を参照してください。