サポートされるストレージ ソースの取得
リファレンス サービス: Azure AI ドキュメント翻訳 API バージョン: v1.1
サポートされるストレージ ソースの取得メソッドでは、ドキュメント翻訳サービスでサポートされているストレージ ソースおよびオプションの一覧が返されます。
要求 URL
GET
要求の送信先は次のとおりです。
GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources
カスタム ドメイン名を見つける方法について説明します。
重要
- ドキュメント翻訳サービスへのすべての API 要求には、カスタム ドメイン エンドポイントが必要です。
- ドキュメント翻訳への HTTP 要求を行うために、Azure portal リソースの [キーとエンドポイント] ページで見つかるエンドポイントも、グローバル Translator エンドポイント
api.cognitive.microsofttranslator.com
も使用することはできません。
要求ヘッダー
要求ヘッダーを次に示します。
ヘッダー | 説明 |
---|---|
Ocp-Apim-Subscription-Key | 必要な要求ヘッダー |
応答状態コード
要求によって返される可能性のある HTTP 状態コードを次に示します。
状態コード | 説明 |
---|---|
200 | OK です。 要求が成功して、ストレージ ソースの一覧を返します。 |
500 | 内部サーバー エラー。 |
その他の状態コード | • 要求が多すぎます • サーバーの一時的な利用不可 |
サポートされるストレージ ソースの取得の応答
サポートされるストレージ ソースの取得の成功した応答
一覧の基本データ型が、サポートされるストレージ ソースの取得 API で返されます。
名前 | 種類 | 説明 |
---|---|---|
value | string [] | オブジェクトの一覧です。 |
エラー応答
名前 | 種類 | 説明 |
---|---|---|
code | string | 高レベルのエラー コードを含む列挙型。 指定できる値 • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •不正 |
message | string | 高レベルのエラー メッセージを取得します。 |
innerError | InnerTranslationError | Azure AI サービス API のガイドラインに準拠した新しい内部エラー形式。 このエラー メッセージには、必須プロパティ ErrorCode、message、および省略可能なプロパティ ターゲット、details(キー値ペア)、内部エラー (入れ子にできます) が含まれています。 |
innerError.code | string | コード エラー文字列を取得します。 |
innerError.message | string | 高レベルのエラー メッセージを取得します。 |
innerError.target | string | エラーのソースを取得します。 たとえば、無効なドキュメントがあった場合には documents か document id になります。 |
例
成功した応答の例
次の JSON オブジェクトは、成功時の応答の例です。
{
"value": [
"AzureBlob"
]
}
エラー応答の例
次の JSON オブジェクトは、エラー応答の例です。 他のエラー コードのスキーマも同じです。
状態コード: 500
{
"error": {
"code": "InternalServerError",
"message": "Internal Server Error",
"innerError": {
"code": "InternalServerError",
"message": "Unexpected internal server error has occurred"
}
}
}
次のステップ
クイックスタートに従って、ドキュメント翻訳とクライアント ライブラリの使用について学習します。