翻訳状態の取得
リファレンス
サービス: Azure AI ドキュメント翻訳
API バージョン: v1.1
翻訳状態の取得メソッドは、ドキュメント翻訳要求の状態を返します。 状態には、要求の全体的な状態と、その要求の一部として翻訳されているドキュメントの状態が含まれます。
要求 URL
GET
要求の送信先は次のとおりです。
GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}
カスタム ドメイン名を見つける方法について説明します。
重要
- ドキュメント翻訳サービスへのすべての API 要求には、カスタム ドメイン エンドポイントが必要です。
- ドキュメント翻訳への HTTP 要求を行うために、Azure portal リソースの [キーとエンドポイント] ページで見つかるエンドポイントも、グローバル Translator エンドポイント
api.cognitive.microsofttranslator.com
も使用することはできません。
要求パラメーター
クエリ文字列に渡される要求パラメーターを次に示します。
Query parameter (クエリ パラメーター) | 必須 | 説明 |
---|---|---|
id |
True | 操作 ID。 |
要求ヘッダー
要求ヘッダーを次に示します。
ヘッダー | 説明 |
---|---|
Ocp-Apim-Subscription-Key | 必要な要求ヘッダー |
応答状態コード
要求によって返される可能性のある HTTP 状態コードを次に示します。
状態コード | 説明 |
---|---|
200 | OK です。 要求が成功して、バッチ翻訳操作の状態を返します。 HeadersRetry-After: integerETag: string |
401 | 権限がありません。 資格情報を確認してください。 |
404 | リソースが見つかりません。 |
500 | 内部サーバー エラー。 |
その他の状態コード | • 要求が多すぎます • サーバーの一時的な利用不可 |
翻訳状態の取得の応答
翻訳状態の取得の応答に成功
成功した応答では、次の情報が返されます。
名前 | 種類 | 説明 |
---|---|---|
id |
string | 操作の ID。 |
createdDateTimeUtc | string | 操作が作成された日時。 |
lastActionDateTimeUtc | string | 操作の状態が更新された日時。 |
status | String | ジョブまたはドキュメントで使用可能な状態の一覧: •キャンセル •キャンセル •失敗 しました • NotStarted •実行 •成功 • ValidationFailed |
まとめ | StatusSummary | 一覧表示された詳細を含む概要です。 |
summary.total | 整数 (integer) | 総数。 |
summary.failed | 整数 (integer) | 失敗数 |
summary.success | 整数 (integer) | 成功した数。 |
summary.inProgress | 整数 (integer) | 進行中の数。 |
summary.notYetStarted | 整数 (integer) | まだ開始されていない数。 |
summary.cancelled | 整数 (integer) | 取り消された数。 |
summary.totalCharacterCharged | 整数 (integer) | API によって課金される文字数合計。 |
エラー応答
名前 | 種類 | 説明 |
---|---|---|
code | string | 高レベルのエラー コードを含む列挙型。 指定できる値 • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •不正 |
message | string | 高レベルのエラー メッセージを取得します。 |
ターゲット (target) | string | エラーのソースを取得します。 たとえば、無効なドキュメントの場合には documents か document id になります。 |
innerError | InnerTranslationError | Azure AI サービス API のガイドラインに準拠した新しい内部エラー形式。 このエラー メッセージには、必須プロパティ ErrorCode、message、および省略可能なプロパティ ターゲット、details(キー値ペア)、内部エラー (入れ子にできます) が含まれています。 |
innerError.code | string | コード エラー文字列を取得します。 |
innerError.message | string | 高レベルのエラー メッセージを取得します。 |
innerError.target | string | エラーのソースを取得します。 たとえば、無効なドキュメントの場合には documents か document id になります。 |
例
成功した応答の例
次の JSON オブジェクトは、成功時の応答の例です。
{
"id": "727bf148-f327-47a0-9481-abae6362f11e",
"createdDateTimeUtc": "2020-03-26T00:00:00Z",
"lastActionDateTimeUtc": "2020-03-26T01:00:00Z",
"status": "Succeeded",
"summary": {
"total": 10,
"failed": 1,
"success": 9,
"inProgress": 0,
"notYetStarted": 0,
"cancelled": 0,
"totalCharacterCharged": 0
}
}
エラー応答の例
次の JSON オブジェクトは、エラー応答の例です。 他のエラー コードのスキーマも同じです。
状態コード: 401
{
"error": {
"code": "Unauthorized",
"message": "User is not authorized",
"target": "Document",
"innerError": {
"code": "Unauthorized",
"message": "Operation is not authorized"
}
}
}
次のステップ
クイックスタートに従って、ドキュメント翻訳とクライアント ライブラリの使用について学習します。